Хэддок для установленных Кабалом модулей?
Вопрос
Я использую GHC и установил несколько пакетов через Cabal.На веб-сайте одного из пакетов написано "зайдите посмотреть документацию по хэддоку".В haddock
команда, похоже, работает только с исходными файлами, и cabal haddock
кажется, работает только в каталоге верхнего уровня проекта с .cabal
файл сборки.Есть ли способ сказать "покажи мне пикшу" для модуля?
Я страстно желаю pydoc -p 12345
который запускает HTTP-сервер, предоставляющий документацию Python на основе того, что вы установили локально.
В качестве обходного пути я извлек архив с исходным кодом из-под ~/.cabal
и побежал cabal configure; cabal haddock
в исходном каталоге, но это своего рода проблема.
Решение
отредактируйте свой конфигурационный файл:
~/.cabal/конфигурация
существует опция, позволяющая включить установку документа по умолчанию:
Документация:Верно
чтобы установить doc существующих пакетов, используйте:
cabal установить xxx - переустановить
переустановите документы из базовых пакетов, а затем пакеты верхнего уровня, чтобы "гиперссылка" на другие модули была сгенерирована должным образом.
Другие советы
В --haddock
флаг у меня не сработал.Однако, заменяя --haddock
с --enable-documentation
сделал:
cabal install $project --enable-documentation
Теперь, если бы они могли позволить --hyperlink-source
флаг, чтобы проскочить в хэддок, я был бы очень рад.
Это такой известная проблема.В качестве обходного пути вы можете настроить свою установку Apache (если она у вас есть) для обслуживания вашего каталога doc с помощью этот небольшой PHP-скрипт.
Вы должны быть в состоянии сгенерировать локальную документацию с:
cabal install $project --haddock
Предполагая, что у вас установлен Haddock.