rst-buildhtml - Интернет в облаке

ПРОГРАММА:

ИМЯ

rst-buildhtml - конвертировать многие документы reST в HTML

СИНТАКСИС

rst-buildhtml [параметры] [ ...]

ОПИСАНИЕ

Создает .html из всех файлов .txt reStructuredText (включая PEP) в каждом
(по умолчанию это текущий каталог).

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Общие Документы Варианты
--title =TITLE
Укажите заголовок документа как метаданные.

--генератор, -g
Включите кредит и ссылку «Создано Docutils».

--нетогенератор
Не включайте кредит генератора.

--свидание, -d
Включите дату в конце документа (UTC).

--время, -t
Включите время и дату (UTC).

--no-datestamp.
Не включайте никакие отметки даты.

--исходная ссылка, -s
Включите ссылку «Просмотреть источник документа».

--source-url =
Использовать для ссылки на источник; подразумевает --source-link.

--нет ссылки на источник
Не включайте ссылку «Просмотр источника документа».

--toc-entry-обратные ссылки
Ссылка из заголовков разделов на записи оглавления. (дефолт)

--toc-top-обратные ссылки
Ссылка из заголовков разделов на верхнюю часть оглавления.

--no-toc-обратные ссылки
Отключить обратные ссылки на оглавление.

--сноска-обратные ссылки
Ссылка из сносок / цитат на ссылки. (дефолт)

--no-сноски-обратные ссылки
Отключите обратные ссылки из сносок и цитат.

- нумерация разделов
Включить нумерацию разделов с помощью Docutils. (дефолт)

--без нумерации разделов
Отключить нумерацию разделов с помощью Docutils.

--strip-комментарии
Удалите элементы комментариев из дерева документа.

--leave-комментарии
Оставьте элементы комментария в дереве документа. (дефолт)

--strip-elements-with-class =
Удалите все элементы с помощью classes = " "из дерева документов. Предупреждение:
потенциально опасно; используйте с осторожностью. (Возможность многократного использования.)

--strip-class =
Удалить все классы = " "атрибуты из элементов в дереве документа.
Предупреждение: потенциально опасно; используйте с осторожностью. (Возможность многократного использования.)

--report =, -r
Сообщать о системных сообщениях на уровне или выше : "информация" или "1", "предупреждение" / "2"
(по умолчанию), «ошибка» / «3», «серьезный» / «4», «нет» / «5»

--подробный, -v
Сообщать обо всех системных сообщениях. (То же, что и «--report = 1».)

--тихий, -q
Сообщать об отсутствии системных сообщений. (То же, что и «--report = 5».)

--halt =
Остановить выполнение при системных сообщениях на уровне или выше . Уровни как в --report.
По умолчанию: 4 (тяжелый).

--строгий
Остановитесь при малейшей проблеме. То же, что и "--halt = info".

--exit-status =
Включите ненулевой статус выхода для не останавливающих системных сообщений на уровне или выше .
По умолчанию: 5 (отключено).

--отлаживать
Включите системные сообщения и диагностику на уровне отладки.

--без отладки
Отключить отладочный вывод. (дефолт)

--warnings =
Отправить вывод системных сообщений на .

--Выслеживать
Включите трассировку Python при остановке Docutils.

- без трассировки
Отключите трассировку Python. (дефолт)

--input-encoding =, -i
Укажите кодировку и, при необходимости, обработчик ошибок вводимого текста. Дефолт:
:строгий.

--input-кодирования-обработчик-ошибок =Input_encoding_error_handler.
Укажите обработчик ошибок для недекодируемых символов. Выбор: «строгий» (по умолчанию),
«игнорировать» и «заменить».

--output-encoding =, -o
Укажите кодировку текста и, при необходимости, обработчик ошибок для вывода. Дефолт:
UTF-8: строгий.

--output-encoding-error-handler = - обработчик ошибок кодирования =Emput_encoding_error_handler.
Укажите обработчик ошибок для некодируемых выходных символов; "строгий" (по умолчанию),
"игнорировать", "заменить", "xmlcharrefreplace", "обратную косую черту".

--error-encoding =, -e
Укажите кодировку текста и обработчик ошибок для вывода ошибок. Дефолт:
ascii: обратная косая черта.

--error-encoding-error-handler = - обработчик ошибок кодирования =ОШИБКА_ENCODING_ERROR_HANDLER
Укажите обработчик ошибок для некодируемых символов в выводе ошибок. Дефолт:
обратная косая черта

--language =, -l
Укажите язык (как языковой тег BCP 47). По умолчанию: en.

--record-dependencies =
Записать зависимости выходного файла в .

--config =
Прочитать настройки конфигурации из , если он существует.

--версия, -V
Покажите номер версии этой программы и выйдите.

--Помогите, -h
Показать это справочное сообщение и выйти.

PEP читатель Опция По умолчанию
Параметры --pep-links и --rfc-links (для парсера reStructuredText) включены
по умолчанию.

ReStructuredText синтаксический анализатор Варианты
--pep-ссылки
Распознавать и ссылаться на отдельные ссылки PEP (например, «PEP 258»).

--pep-base-url =
Базовый URL для ссылок PEP (по умолчанию "http://www.python.org/dev/peps/").

--pep-file-url-template =
Шаблон для части URL-адреса PEP-файла. (по умолчанию "pep-% 04d")

--rfc-ссылки
Распознавать и ссылаться на отдельные ссылки на RFC (например, «RFC 822»).

--rfc-base-url =
Базовый URL для ссылок RFC (по умолчанию "http://www.faqs.org/rfcs/").

--tab-width =
Установите количество пробелов для раскрытия табуляции (по умолчанию 8).

--trim-сноска-ссылка-пространство
Удалите пробелы перед ссылками на сноски.

--leave-сноска справочно-пространство
Перед ссылками на сноски оставляйте пробелы.

--no-file-insert
Отключить директивы, которые вставляют содержимое внешнего файла ("include" & "raw");
заменено системным сообщением "предупреждение".

--file-insert-enabled
Включите директивы, которые вставляют содержимое внешнего файла ("include" и "raw").
Включено по умолчанию.

- не сырой
Отключите "сырые" директивы; заменено системным сообщением "предупреждение".

--raw-включено
Включите "сырую" директиву. Включено по умолчанию.

--syntax-highlight =
Имя токена, установленное для синтаксического анализа кода с помощью Pygments: одно из «long», «short» или «none (no
parsing) ". По умолчанию" long ".

--smart-quotes =Smart_quotes.
Заменить прямые кавычки на типографскую форму: одно из «да», «нет»,
«alt [ernative]» (по умолчанию «нет»).

HTML-специфичный Варианты
--template =
Укажите файл шаблона (в кодировке UTF-8). По умолчанию
"/usr/доля/docutils/писатели/html4css1/template.txt".

--stylesheet =
Список URL-адресов таблиц стилей, разделенных запятыми. Заменяет предыдущие --stylesheet и
Параметры --stylesheet-path.

--stylesheet-path =
Список путей к таблицам стилей, разделенных запятыми. Относительные пути расширяются, если совпадают
файл находится в папке --stylesheet-dirs. С --link-stylesheet путь
переписан относительно выходного файла HTML. По умолчанию: «html4css1.css».

--встроить таблицу стилей
Вставьте таблицы стилей в выходной файл HTML. Файлы таблиц стилей должны быть
доступны во время обработки. Это значение по умолчанию.

--link-таблица стилей
Ссылка на таблицы стилей в выходном файле HTML. По умолчанию: вставлять таблицы стилей.

--stylesheet-dirs =
Разделенный запятыми список каталогов, в которых находятся таблицы стилей. Использован
--stylesheet-path при раскрытии аргументов относительного пути. Дефолт: "['.',
'Docutils / Writers / html4css1'] "

--initial-header-level =
Укажите начальный уровень заголовка. По умолчанию 1 для " ". Не влияет
заголовок и подзаголовок документа (см. --no-doc-title).

--field-name-limit =
Укажите максимальную ширину (в символах) для имен полей в один столбец. Дольше
Имена полей будут охватывать всю строку таблицы, используемую для отображения списка полей.
По умолчанию 14 символов. Используйте 0 для «без ограничений».

--option-limit =
Укажите максимальную ширину (в символах) для параметров в списках параметров. Дольше
Параметры будут охватывать всю строку таблицы, используемую для отображения списка параметров.
По умолчанию 14 символов. Используйте 0 для «без ограничений».

--footnote-links =
Формат ссылок на сноски: один из «надстрочных» или «квадратных скобок». По умолчанию
"скобки".

--attribution =
Формат атрибуции цитат блока: одно из "тире" (префикс длинного тире),
«круглые скобки» / «скобки» или «нет». По умолчанию - «тире».

--компакт-списки
Удалите лишние вертикальные пробелы между элементами "простых" маркированных списков и
нумерованные списки. По умолчанию: включено.

--no-компактные-списки
Отключите компактные простые маркированные и нумерованные списки.

--compact-field-списки
Удалите лишние вертикальные пробелы между элементами простых списков полей. Дефолт:
включен.

--no-compact-field-lists
Отключите компактные простые списки полей.

--table-style =ТАБЛИЦА_СТИЛЬ
Добавлены в стандартные классы таблиц. Определенные стили: «без полей». Дефолт: ""

--math-output =MATH_OUTPUT
Математический выходной формат, один из «MathML», «HTML», «MathJax» или «LaTeX». По умолчанию: «HTML
math.css "

--no-xml-декларация
Опустите объявление XML. Используйте с осторожностью.

--cloak-email-адреса
Скрывайте адреса электронной почты, чтобы сбить с толку комбайны, сохраняя при этом ссылки на электронную почту.
можно использовать в браузерах, соответствующих стандартам.

Специально для PEP / HTML Варианты
Для модуля записи PEP / HTML значение по умолчанию для параметра --stylesheet-path равно
"/usr/share/docutils/писатели/pep_html/pep.css", а значение по умолчанию для --template -
"/usr/share/docutils/writers/pep_html/template.txt". См. Параметры для HTML выше.

--python-home =
Домашний URL-адрес Python. По умолчанию "http://www.python.org".

--pep-home =
Префикс домашнего URL для PEP. По умолчанию "." (Текущий каталог).

Сборка-HTML Варианты
- рекурсивный
Рекурсивно сканировать подкаталоги для обработки файлов. Это значение по умолчанию.

--местный
Не сканируйте подкаталоги на наличие файлов для обработки.

--prune =
Не обрабатывать файлы в (паттерны подстановки оболочки, разделенные двоеточиями).
Эту опцию можно использовать более одного раза, чтобы указать несколько каталогов. Дефолт:
".hg: .bzr: .git: .svn: CVS".

--ignore =
Рекурсивно игнорировать файлы, соответствующие любому из заданных подстановочных знаков (подстановка оболочки)
шаблоны (разделенные двоеточиями).

--тихий
Работайте бесшумно (без сообщений о ходе выполнения). Независимо от "- тихо".

--прогон, репетиция
Не обрабатывать файлы, показывать файлы, которые будут обрабатываться.

RST-СТРОЙHTML(1)

Используйте rst-buildhtml в Интернете с помощью сервисов onworks.net