Описание тега restructuredtext

NoneRe StructuredText is a lightweight markup language intended to be highly readable in source format.
0 ответов

Как вы гиперссылки моноширинный текст в reStructuredText?

`pandoc &lt;https://github.com/jgm/pandoc&gt;`_ создает ссылку, которая выглядит как pandoc Но как мне создать ссылку на моноширинный текст: pandoc Если я попробую ` ``pandoc`` &lt;https://github.com/jgm/pandoc&gt;`_ Я получаю это грубое ` pandoc < …
19 апр '16 в 23:29
1 ответ

Предотвратить лишний перевод строки после перехода в md в первое преобразование

У меня есть некоторые файлы уценки, которые я хочу преобразовать в файлы reStructuredText. Я только начал использовать Pandoc для этого конкретного требования. Пока я использую следующую простую команду &gt; pandoc --from markdown --to rst --columns…
1 ответ

Можно ли вставить гиперссылки в литеральный блок ReST?

Я знаю, что такое поражение является целью буквального блока, однако мне было интересно, есть ли способ обойти это. Мой вариант использования - поместить гиперссылку в литерал блока псевдокода, чтобы ссылаться на детали в другом месте документа. При…
13 апр '17 в 09:26
1 ответ

Можно ли добавлять греческие буквы в документы Sphinx в качестве терминов глоссария?

Я хочу добавить переменные, которые определены как греческие буквы к моему глоссарию в документе сфинкса. Например: .. glossary:: :math:`{\alpha}` Definition for alpha Цель состоит в том, чтобы эти переменные появились в индексе документа. Кто-нибуд…
29 ноя '16 в 01:37
1 ответ

Стили reStructuredText

Я нашел это руководство для rst2pdf, чтобы узнать, как стилизовать файл reStructuredText в полученном документе PDF. Например, наличие в моей таблице стилей JSON следующего: оно успешно применяется ко всему документу: "pageSetup" : { "size": "A4", "…
17 апр '12 в 08:42
0 ответов

Сфинкс - эффективная ссылка на файлы.rst вне дерева?

Я хочу собрать документацию Sphinx для проекта со структурой, подобной этой: doc: index.rst conf.py Makefile modules: module1: README.rst module2: README.rst Я хотел бы легко включить предыдущие файлы README.rst в мою документацию по Sphinx. Однако …
30 янв '18 в 10:21
1 ответ

Скрыть определенные файлы из toctree

Я использую экземпляр readthedocs.org на своем локальном хосте для создания HTML-документации из моего репозитория github, и я хотел бы иметь возможность сделать следующее. В настоящее время у меня есть список файлов, которые читаются с помощью функ…
29 ноя '13 в 10:15
1 ответ

Vim - Как я могу просмотреть уценку как реструктурированный текст?

Vim - Как я могу просмотреть уценку как текст reStructuredText? Привет Я пишу в уценке и необходимо просмотреть как reStructuredText в браузере. Мои текущие шаги: Янки уценка в vim Открыть браузер Посетите http://pandoc.org/try/ Вставить уценку Прео…
24 ноя '17 в 10:41
1 ответ

Сфинкс зависает при попытке использовать возможности amxmath

Я хочу определить матрицу в математическом блоке в файле ReST, как это; .. math:: \[\begin{bmatrix}a_1 &amp; b_1\\ a_2 &amp; b_2\end{bmatrix}\] В моем conf.py я определил преамбулу, чтобы включить amsmath пакета LaTeX latex_elements = { # Additional…
30 окт '17 в 10:37
2 ответа

Используйте ReStructuredText для красивого списка исходного кода

Как спрашивают и отвечают в этом посте, можно использовать SyntaxHighlighter для красивого листинга кода. С ReStructuredText я могу использовать директиву raw следующим образом. .. raw:: html &lt;script type="text/javascript" src="http://alexgorbatc…
17 янв '11 в 19:10
3 ответа

Пусть Emacs отредактирует строки документации Python, используя rst-mode

Как мне заставить Emacs использовать rst-mode внутри строк документации в файлах Python? Я смутно помню, что возможны разные режимы в определенных областях файла, но я не помню, как это делается.
19 мар '13 в 06:59
0 ответов

Могу ли я заменить кодовый блок reStructuredText?

Есть ли способ сделать замену или замену переменной с replace в reStructuredText внутри code-block? Например, в .. code-block:: sh $ |script| args moreargs Some output $ another_script args moreargs Some more output с помощью .. |script| replace:: s…
14 ноя '15 в 19:23
2 ответа

Как я могу добавить внешний файл Python в мой реструктурированный текстовый документ?

Я хочу написать книгу, используя Sphinx и реструктурированный текст. Поскольку большая часть контента будет написана на Python, я хочу разделить текст и код. Есть ли команда для добавления внешних скриптов Python в мои реструктурированные текстовые …
14 сен '13 в 12:21
2 ответа

sphinx удалить заголовок главы в моем pdf с latexpdf?

Я генерирую документацию от первого к pdf с latexpdf и sphinx. Как я могу удалить заголовок главы перед каждой главой? ----------- CHAPTER ONE -----------
30 сен '14 в 12:16
1 ответ

Разбор reStructuredText в HTML

Я делаю фреймворк, в котором я позволяю разработчикам описывать свой пакет, используя reStructuredText. Я хочу разобрать этот reStructuredText в HTML, чтобы я мог показать его в графическом интерфейсе. Я знаком с отличным Сфинксом, но я никогда не а…
1 ответ

Как я могу сопоставить блок кода reStructuredText с Regex и Python?

Я пытаюсь извлечь code block из .rst документ с использованием Python и регулярных выражений. Блоки кода в документе определяются путем добавления .. code-block:: python директива к тексту, а затем отступ на несколько пробелов. Вот пример из моего т…
31 окт '18 в 12:06
4 ответа

Несколько строк текста в одной ячейке простой таблицы?

Я нашел этот вопрос, но я не хочу явного &lt;br&gt; в моей камере; Я просто хочу обернуть строку, где это необходимо. например, ================ ============ a short sentence second cell a much longer bottom right sentence ================ =========…
15 май '13 в 16:13
2 ответа

Использование make для перевода файлов reST

У меня есть куча текстовых файлов в help_pages/ каталог, все отформатированы в reST. Я пытаюсь добавить в мой GNU make Makefile пара правил, которые: Запустите каждый файл в help_pages каталог (и подкаталоги) с расширением.rst через приложение, кото…
09 янв '11 в 08:05
1 ответ

Сфинкс добавить форматирование кода для:ref:

Я хотел бы добавить форматирование кода для ссылки, как это: :ref:`__slots__ &lt;python:slots&gt;` мой intersphinx_mapping определяет python как это: intersphinx_mapping = { 'python': ('https://docs.python.org/3', None), } поэтому ссылка на https://…
17 авг '17 в 17:52
1 ответ

Исходный код в списках маркеров с reStructuredText

Я пытаюсь включить исходный код в списки с маркерами с reStructuredText; как это: - List item 1 :: code sample... code sample... - List item 2 :: code sample... code sample... Тем не менее, я получаю следующее предупреждение: System Message: WARNING…
17 ноя '10 в 16:05