Откуда такие сложности с wiki - ponyatov/nimbook GitHub Wiki
wiki
Откуда такие сложности с
GitHub предоставляет доступ к wiki проекта через git, но не включает поддержку всего механизма с pull request, GitHub форками, выгрузкой wiki в различных форматах, и т.п. При создании форка проекта не создаётся форк wiki.
Для удобного редактирования wiki предпочтительнее интерфейс github, и использование браузера -- wiki является рабочей копией, каталог /wiki
в проекте требуется для сравнения, pullrequestов, и генерации /docs/.html
В итоге, приходится включать в основной проект средства зеркалирования wiki, и скрипты получения различных производных форматов документации через пакет pandoc
и фильр-скрипты. pandoc
имеет неадекватно ограниченную поддержку разметки github markdown, поэтому приходится писать развесистые фильтры. В будущем есть возможность написать собственный полнофункциональный [процессор документации markdown]] -> html,epub,...
на Nim, или даже [базу знаний, но пока пришлось обойтись Python.