Включить --hyperlink-source для установки клики

Команда cabal haddock имеет очень полезную опцию --hyperlink-source. Я хотел бы иметь гиперссылку на источник при создании документации с помощью cabal install.

Билет №517 как раз об этом: http://hackage.haskell.org/trac/hackage/ticket/517

Однако, возможно, можно установить этот флаг через файл ~/.cabal/config?

Если нет, то как мне получить работающую сборку cabal-install с патчем от #517 без установки Cabal-1.9, которая в настоящее время является обязательной (из-за одного декабрьского патча)?


person Tener    schedule 18.03.2010    source источник
comment
В чем проблема установить Cabal-0.9?   -  person SamB    schedule 29.03.2010


Ответы (3)


В настоящее время вы не можете получить эквивалент параметра --hyperlink-source при использовании команды «все в одном» cabal install. Билет, который вы цитируете, как раз об этом вопросе.

person Duncan Coutts    schedule 14.10.2010
comment
Это все еще так? - person Alex R; 29.01.2014
comment
В грядущем обновлении Cabal 1.20 исправлено: добавлен раздел haddock в ~/.cabal/config, где вы можете скажи hyperlink-source: True. - person nh2; 19.04.2014

Для меня это сработало:

cabal update
cabal install haddock

Изменить файл конфигурации ~/.cabal/config

Включить Documentation: True (удалить "--" в начале строки можно)


Библиотека Кабала:

cd ...someNicePlace...    

cabal unpack Cabal

Отредактируйте файл Distribution/Simple/Setup.hs, в нем найдите defaultHaddockFlags = ...

Я переключил некоторые из них с False на True:

... 
haddockHoogle       = Flag True,
...
haddockHtml         = Flag True,
...
haddockExecutables  = Flag True,
...
haddockHscolour     = Flag True,
...

наличие цвета пикши в качестве единственного важного (не нужно менять остальные, если вы этого не хотите).

Установите обновленную библиотеку Cabal:

sudo cabal install --global

cabal-install (команда оболочки Cabal)

Чтобы обновленная библиотека Cabal Libary работала в команде оболочки cabal, я также переустановил cabal-install:

cd ...someNicePlace...    

cabal unpack cabal-install

sudo cabal install --global

С тех пор команда оболочки cabal --version говорит мне:

cabal-install version 1.16.0.2 
using version 1.16.0.3 of the Cabal library 

И, как и требовалось, любая новая установка клики теперь устанавливает полную html-документацию пикши с исходными кодами, гиперссылками по умолчанию.

person Hartmut P.    schedule 14.08.2013

Билет № 517 касается передачи опций пикши через клику, например, если у вас есть особые потребности, такие как создание базы данных hoogle или использование другого CSS.

Однако большинство пользователей будут довольны стандартной пикшей и источниками с гиперссылками, что возможно с Cabal-1.8. Билет № 517, если у вас есть большие потребности.

Простой вызов cabal haddock --hyperlink-source должен помочь.

Если вы хотите, чтобы это было по умолчанию, вы можете отредактировать ~/.cabal/config, как вы упомянули.

person L. Kolmodin    schedule 29.04.2010
comment
Используется ли это значение по умолчанию, когда документ Haddock создается как часть вызова Cabal Install Some-Package? Я думаю, что это то, за чем последует ОП, и что, похоже, не работает. - person MtnViewMark; 29.04.2010
comment
Я никогда не хочу называть себя пикшей клики. Я хочу иметь возможность создавать и устанавливать программы с помощью «командной установки» и иметь гиперссылку на источник в процессе. - person Tener; 03.05.2010
comment
О, я вижу. Я не знаю такого решения. - person L. Kolmodin; 04.05.2010