Настройка документооборота на сайте readthedocs - PullRequest
0 голосов
/ 19 марта 2019

ReadTheDocs.org - отличный способ опубликовать html, созданный сфинксами, но есть несколько незначительных проблем, связанных с темой, которые я бы предпочел решать по-другому.После прочтения нескольких страниц здесь, я не уверен, могут ли они быть адресованы для документов, размещенных на RTFD.org, или только для локальных сборок, использующих тему ReadTheDocs.

Элементы, которые я предпочитаю из своей локальной сборки по умолчанию, следующие:

  • RTFD помещает весь текст в таблицы в одну строку и использует полосу прокрутки.Классно для узких столов, но не так, как я их использую.Я бы предпочел перенос текста.

  • сгенерированный сфинксом индекс - действительно хороший инструмент для людей, пишущих код (именно этим и помогают эти документы).Он есть в PDF, но он-лайн был бы более полезен.

  • индекс модулей - также хорошая функция, которую я хотел бы вернуть, хотя и менее ценную, чем предыдущаяиндекс.

Можно ли вообще их изменить?Если так, что идет в моем conf.py?

...