Я пытаюсь перенести наши документы API и схему генератора проприетарной документации в reStructuredText. Сложнее всего то, что у нас есть табличное представление деталей API, закодированное непосредственно в HTML, а-ля:...

Я использую reStructuredText для своего блога/веб-сайта и хочу добавить глобальный включаемый файл. У меня есть доступ, и я рад изменить файл настроек, который я использую для создания вывода html, я просто не могу понять синтаксис: добавление...

Я пытаюсь добавить изображение с внешней ссылкой. |facebook| |tw| .. |facebook| image:: http://www.summerbounce.ca/wp-content/uploads/2012/11/facebook-logo-small.png .. |tw| image::...

Я могу использовать docutils для анализа строк документации в формате reStructuredText, но он не анализирует сами директивы, принадлежащие домену Python. Например, :type path: unicode анализируется как: <field>...

Есть ли среда для упражнений по форматированию? Что-то типа .. exercise:: Count to 10 Write down all the numbers from 1 to (including 10) т.е. это для учебной документации, которая побуждает читателя работать с материалом.

Как сделать строковый литерал с двоеточием в restructuredText? Я пытаюсь задокументировать функцию Python, которая возвращает словарь, например, что-то вроде: def function(...): """ ... Returns: A dictionary mapping ``{id:...