ReadTheDocs |Добавьте Bootstrap 4 и пользовательские стили в Sphinx Docs - PullRequest
0 голосов
/ 10 апреля 2019

Мы используем Sphinx для наших Документов, и это довольно слабый опыт, так как нам нужно настроить его внешний вид и функциональность.

Нам нужны некоторые вещи, и, поскольку в наших документах есть множество версий, я подумал, что было бы более эффективно стилизовать sphinx_rtd_theme вместо каждого отдельного выпуска, поскольку некоторым из них 4 года с совершенно разными стилями. каждый.

ПРОБЛЕМА: Мне нужно сделать некоторые вещи по умолчанию sphinx_rtd_theme, и документы довольно приличные, но они не покрывают некоторые случаи, в которых мои знания в настоящее время отсутствуют

Требования:

  1. Добавьте начальную загрузку 4 к sphinx_rtd_theme, css и js.

  2. Есть собственный CSS-файл, который позволит мне переопределить некоторые классы из начальной загрузки.

  3. Оберните все содержимое документов в контейнер-жидкость.

  4. Нужно ли мне репо sphinx_versioning, чтобы иметь несколько моих версий моих документов? Могу ли я настроить его?

Я знаю, что это могут быть вопросы сами по себе, но я действительно знаю Сфинкса, и у меня есть множество вопросов по этому поводу. Не стесняйтесь оставлять ресурсы или руководства my finding are pretty limited, и если бы вы могли ответить на мои вопросы, было бы здорово. Спасибо ..

...