В reStructuredText е обичайно да се използват препратки за връзка произволни местоположения в документ. Когато няма заглавие, е необходимо да се даде надпис с препратката. например: Some text in a paragraph. .. _my-reference: Some more...

Заглавието казва всичко... това работи за създаване на монопространствен текст: ``foo`` но тези не: `` foo`` ``foo `` Как мога да получа начални/крайни интервали в монопространствен текст? (преди някой да ми цитира XY проблем: това...

Търся автоматично документиране на някои функции в модул на Python, използвайки autofunction . Да кажем, например, че функциите са дефинирани в mylib/funcs/a.py и този файл изглежда по следния начин: def myfunc(arg): """ My function does...

Мога да създам съдържание по два начина: .. contents:: :local: depth: 1 or as .. toctree:: :maxdepth: 1 index Каква е разликата? Къде трябва да използвам tocttree и къде съдържанието?

Travis build: https://travis-ci.com/Laurentiu-Andronache/he/jobs/184044676 conf.py: https://github.com/Laurentiu-Andronache/he/blob/master/docs/source/conf.py tox.ini: https://github.com/Laurentiu-Andronache/he/blob/master/tox.ini (вижте...

Искам да генерирам PDF от sphinx, който е само черно-бял. Стандартът sphinx.sty използва \RequirePackage{color} и \RequirePackage{fancyvrb} . Ако просто премахна color , получавам цял списък с грешки. Не можах да намеря препратка в...

Бих искал да използвам пакета django-sphinxdoc за документация в моя django проект. Има сайт https://pypi.python.org/pypi/django-sphinxdoc/ от този пакет и казва: Документацията може да бъде намерена в директорията docs/. Не мога да...

Има ли някакъв начин да добавите заглавия на секции в лявото меню на документацията на Sphinx? Знам, че можете да го направите, ако използвате MkDocs (например тук ), но има ли начин да направите това в Sphinx и ReSTructured text? Искам да...

Използвам Sphinx с autodoc за документиране на моя Django проект. Момчетата от дизайна искат да имат страница(и) с документация за всички шаблонни тагове, които са дефинирани в проекта. Разбира се, мога да направя такава страница, като изброя на...

Как да направя вътрешна хипервръзка в документацията на Sphinx? Използвам: :role:`target` Но не работи.

Имам проект за ванилов сфинкс (Sphinx 1.2b3.), създаден с "sphinx-quickstart" Добавям основна страница.rst с 4 нива на заглавка. Мога да контролирам дълбочината на html toc в index.rst: .. toctree:: :maxdepth: 1 :numbered: page...

Имам таблица в rst и искам да добавя клас към нея, когато компилирам в HTML със Sphinx. Според документите , добавянето на директива .. class:: преди таблицата трябва добави класа към таблицата, но вместо това добавя списък с дефиниции. Кодът...