Включите --hyperlink-source для «cabal install»

StackOverflow https://stackoverflow.com/questions/2472630

  •  20-09-2019
  •  | 
  •  

Вопрос

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

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

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

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

Это было полезно?

Решение

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

Другие советы

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

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,
...

имея пикшаHцветной единственный важный (не обязательно менять остальные, если не хотите).

Установите обновленную библиотеку 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

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

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

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

Просто звоню cabal haddock --hyperlink-source должен сделать свое дело.

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

Лицензировано под: CC-BY-SA с атрибуция
Не связан с StackOverflow
scroll top