Вопросы по теме 'restructuredtext'
Сравните и сопоставьте облегченные языки разметки
Пожалуйста, определите самые популярные облегченные языки разметки и сравните их сильные и слабые стороны. Эти языки должны быть разметкой общего назначения для технической прозы, например, для документации (например, Haml не в счет).
См. также:...
23335 просмотров
schedule
13.08.2022
Как преобразовать 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 просмотров
schedule
11.01.2024
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 просмотров
schedule
16.12.2022
Извлечь список полей из 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 просмотров
schedule
18.04.2022
Применение 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