Вопросы по теме 'restructuredtext'

Сравните и сопоставьте облегченные языки разметки
Пожалуйста, определите самые популярные облегченные языки разметки и сравните их сильные и слабые стороны. Эти языки должны быть разметкой общего назначения для технической прозы, например, для документации (например, Haml не в счет). См. также:...
23335 просмотров

Как преобразовать reStructuredText в обычный текст
Я планирую использовать reStructuredText для написания документации с основной целью создания хороших HTML-страниц. Для этого я использую инструмент docutils rst2html.py. Однако мне также может понадобиться представить документацию в удобном...
3319 просмотров
schedule 13.11.2022

Как заставить реструктурированный текст добавить класс к каждому тегу html ‹p›?
Я использую пакет разметки Django для преобразования restructuredText в html. Есть ли способ настроить средство записи HTML для добавления атрибута класса к каждому тегу <p> ? Я мог бы использовать директиву класса для каждого абзаца, но...
1221 просмотров
schedule 04.04.2024

Как добавить Google Analytics в reStructuredText?
Я использую реструктурированный текст для создания простых веб-сайтов. Итак, у меня есть много файлов *.rst, в которые я хочу добавить код Google Analytics. Но насколько я знаю, что-то подобное добавить нельзя?! Я использую rst2html для...
591 просмотров
schedule 20.06.2022

Вывод нескольких страниц html из документа .rst в Django
Я пишу приложение Django для обслуживания документации, написанной в RestructuredText. У меня много документов, написанных в *.rst, каждый из них достаточно длинный, с большим количеством разделов, подразделов и так далее. Отображение всего...
1024 просмотров
schedule 10.05.2023

Как в Sphinx создать ссылочный раздел терминологии без огромных накладных расходов?
Я хочу создать раздел «терминология» с определениями терминов, которые я использую, чтобы каждый раз, когда я использую термины в этом разделе терминологии, создавалась ссылка, указывающая на определение. В настоящее время лучшее, что я могу...
2571 просмотров

rst2pdf: Ссылка на автоматически нумерованные цифры
В моем первом документе есть директивы, в которые вставляются цифры; и я использую директиву :counter: rst2pdf для их автоматической нумерации. .. figure:: Graphics\Manual_test_timeline.png :scale: 100% :align: center Figure...
610 просмотров
schedule 29.07.2022

Разделение исходного документа в Sphinx (т.е. управление иерархией файлов)
Каков правильный способ разделения исходного документа в Sphinx? У меня есть большой файл, назовем его file1.rst , структура которого такая: Section 1 ********* Subsection 1 ============ Subsection 2 ============ Subsection 3 ============...
1626 просмотров
schedule 01.08.2023

Ссылка на длинные имена с помощью Python Sphinx
Я работаю над документацией для своего модуля Python (используя Sphinx и reST) и обнаружил, что при перекрестных ссылках на другие объекты Python (модули, классы, функции и т. д.) полное имя объекта оказывается невероятно длинным. Часто он длиннее 80...
3043 просмотров

Извлечь список полей из reStructuredText
Скажем, у меня есть следующий ввод reST: Some text ... :foo: bar Some text ... То, что я хотел бы получить, это такой дикт: {"foo": "bar"} Я пытался использовать это: tree = docutils.core.publish_parts(text) Он анализирует...
1301 просмотров
schedule 03.05.2022

ссылки на таблицы в реструктурированном тексте
Есть ли способ сослаться на таблицу в RestructuredText? что-то вроде см. таблицу `referencetable`_ (я видел некоторые обходные пути для ссылок на цифры. Однако не смог найти способ сослаться на таблицу..) Спасибо!
394 просмотров
schedule 19.09.2022

Часть слова, выделенная жирным шрифтом в reStructuredText
Как сделать часть слова полужирным шрифтом в reStructuredText? Вот пример того, что мне нужно: «.rst означает r e s структурированный t ext».
3039 просмотров

Применение CSS и ролей для текстовых блоков вместо встроенных промежутков в Sphinx
Существует предыдущий вопрос , в котором объясняется, как добавить диапазон цветов в некоторый reStructuredText. Чтобы резюмировать процедуру: Во-первых, у вас есть роль. .. role:: red An example of using :red:`interpreted text` Это...
5529 просмотров
schedule 20.09.2022

Как получить документацию Python Sphinx в формате только данных?
Я работаю над очень большой базой кода, которая использует sphinx-apidoc для автоматического создания HTML-документации из строк документации в исходном коде Python. Строки документации используют следующий формат: : param message: сообщение для...
384 просмотров
schedule 07.03.2023

Списки параметров в reStructuredText для аргументов командной строки без префикса тире или косой черты
reStructuredText имеет хорошую поддержку для списков параметров . Например, rst2html.py переводит эту разметку RST. Options: --foo does a foo -b, --bar ABAR bar something в следующую хорошо...
816 просмотров
schedule 28.06.2022

Глобальная настройка linenothreshold
Опция linenothreshold позволяет контролировать минимальное количество строк, кодовый блок должен иметь, чтобы генерировать для него номера строк. Я хотел бы иметь возможность указать это глобально (например, в conf.py )?
102 просмотров
schedule 30.11.2022

Превратите поля в reStructuredText в html
Итак, у меня есть документ reStructuredText, который включает поля: :param foo: set this to do magic и я хочу превратить rST в html со специальной обработкой полей param (и других). Превратить rST в html можно с помощью...
92 просмотров
schedule 30.03.2024

Как сделать зачеркивание в файле reStructuredText, размещенном на GitHub?
Я конвертирую файл README.md в файл README.rst . Причина в том, что я собираюсь сделать пакет доступным для PyPi. Я вынужден использовать .rst . Мое преобразование почти завершено, но в моем файле уценки есть зачеркнутая строка, например:...
2351 просмотров
schedule 04.02.2024

Emacs, воспроизводящий функциональность M-RET организационного режима в первом режиме
В org-mode ввод M-RET в конце заголовка создаст новый заголовок того же уровня на новой строке. Могу ли я воспроизвести эту функцию в rst-mode (особенно для списков)? В настоящее время M-RET не определено, и было бы здорово, если бы я мог...
533 просмотров
schedule 10.06.2022

Есть ли какой-нибудь парсер reStructuredText для HTML (или, возможно, библиотека?), Написанный на JavaScript
У меня есть приложение для Android, которое должно отображать reStructuredText как HTML внутри WebView. Он уже поддерживает несколько других разметок с использованием библиотек javascript. Насколько мне известно, javascript-реализации...
2593 просмотров
schedule 09.07.2022