Вики для sphinx+ сервер ReStructuredText
Я использовал sphinx в качестве движка документов для внутреннего сервера документов в моей компании. Он использует ReStructuredText в качестве языка разметки.
Сегодня мне нужно отредактировать исходные файлы вручную, скомпилировать HTML, проверить, что он работает, а затем загрузить его на внутренний сервер. Это утомительно, и мои коллеги воздерживаются от обновления документов.
Вики было бы отличным решением, но есть ли бесплатный вики-движок с открытым исходным кодом, который поддерживает ReStructuredText или хотя бы простой текст?
Спасибо,
Адам
1 ответ
Trac поддерживает reStructuredText. По умолчанию это так же просто, как:
{{{
#!rst
.. note:: I use reStructuredText all the time...
}}}
и вы также должны иметь возможность настроить его по умолчанию (но я не помню, требует ли это какого-либо взлома или нет)...
Я бы посчитал sphinx-autobuild, Он отслеживает изменения файлов в определенном каталоге (то есть в исходном каталоге Sphinx) и автоматически перестраивает документы Sphinx при обнаружении изменений. Не может быть идеальным решением, но достаточно, чтобы смягчить некоторые из упомянутых вами проблем.