2016-06-30 3 views
2

Я совершенно не знаком с этой штукой. Провел целый день, пытаясь выяснить «наиболее часто используемый» подход. То, что я хочу реализовать, - это что-то вроде readthedocs.org, но для частного клиента (и проприетарного проекта)Как разместить частную документацию с помощью ReadTheDocs или Sphinx

Почти все часто задаваемые вопросы, сообщения в блогах, howtos и т. Д. Описывают, как использовать хост (публикацию) документации либо с GitHub страницы, либо с readthedocs.org (.com)

Я пытался использовать Sphinx (NB: НЕ «Sphinx Search») на местном уровне, и я мог довольно легко создать образец демо-документы, но Я не совсем понимаю, как разместить решение с возможностью поиска, например, оно работает на http://www.sphinx-doc.org (похоже, что использует readthedocs.org в качестве поискового сервера)

Я попытался развернуть readthedocs.org локально, но

  1. «поиск» не работает (никто не слушает 127.0.0.1:9200)
  2. я не смог построить какую-либо документацию (версия не найден или проекта не найден)
  3. я не смог добавить проект из моего частного хранилища (SSH :)

(NB: Я пробовал его на Windows, и это может объяснить, пункты 1-2, но не 3, я считаю)

До сих пор мне кажется, что у меня закончились идеи.

Любые советы будут высоко оценены!

ответ

 Смежные вопросы

  • Нет связанных вопросов^_^