Я совершенно не знаком с этой штукой. Провел целый день, пытаясь выяснить «наиболее часто используемый» подход. То, что я хочу реализовать, - это что-то вроде readthedocs.org, но для частного клиента (и проприетарного проекта)Как разместить частную документацию с помощью ReadTheDocs или Sphinx
Почти все часто задаваемые вопросы, сообщения в блогах, howtos и т. Д. Описывают, как использовать хост (публикацию) документации либо с GitHub страницы, либо с readthedocs.org (.com)
Я пытался использовать Sphinx (NB: НЕ «Sphinx Search») на местном уровне, и я мог довольно легко создать образец демо-документы, но Я не совсем понимаю, как разместить решение с возможностью поиска, например, оно работает на http://www.sphinx-doc.org (похоже, что использует readthedocs.org в качестве поискового сервера)
Я попытался развернуть readthedocs.org локально, но
- «поиск» не работает (никто не слушает 127.0.0.1:9200)
- я не смог построить какую-либо документацию (версия не найден или проекта не найден)
- я не смог добавить проект из моего частного хранилища (SSH :)
(NB: Я пробовал его на Windows, и это может объяснить, пункты 1-2, но не 3, я считаю)
До сих пор мне кажется, что у меня закончились идеи.
Любые советы будут высоко оценены!