index.md

1> **Источник:** https://python-all.ru/3.0/documenting/index.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Документирование Python89Язык Python имеет обширную документацию, значительная часть которой написана разными авторами. Разметка, используемая для документации Python, – это [reStructuredText](https://python-all.ru/3.0/documenting/index.html), разработанный проектом [docutils](https://python-all.ru/3.0/documenting/index.html), дополненный собственными директивами и использующий набор инструментов [Sphinx](https://python-all.ru/3.0/documenting/index.html) для постобработки HTML-вывода.1011В этом документе описывается руководство по стилю для документации, специальная разметка reStructuredText, созданная для поддержки документации Python, и то, как её следует использовать, а также система сборки Sphinx.1213Если вы заинтересованы в участии в документации Python, вам не обязательно писать на reStructuredText, если вам это не подходит; обычный текст также приветствуется.1415- [Введение](https://python-all.ru/3.0/documenting/intro.html)16- [Руководство по стилю](https://python-all.ru/3.0/documenting/style.html)17- [Введение в reStructuredText](https://python-all.ru/3.0/documenting/rest.html)1819  - [Абзацы](https://python-all.ru/3.0/documenting/rest.html#paragraphs)20  - [Встроенная разметка](https://python-all.ru/3.0/documenting/rest.html#inline-markup)21  - [Списки и цитаты](https://python-all.ru/3.0/documenting/rest.html#lists-and-quotes)22  - [Исходный код](https://python-all.ru/3.0/documenting/rest.html#source-code)23  - [Гиперссылки](https://python-all.ru/3.0/documenting/rest.html#hyperlinks)2425    - [Внешние ссылки](https://python-all.ru/3.0/documenting/rest.html#external-links)26    - [Внутренние ссылки](https://python-all.ru/3.0/documenting/rest.html#internal-links)27  - [Разделы](https://python-all.ru/3.0/documenting/rest.html#sections)28  - [Явная разметка](https://python-all.ru/3.0/documenting/rest.html#explicit-markup)29  - [Директивы](https://python-all.ru/3.0/documenting/rest.html#directives)30  - [Сноски](https://python-all.ru/3.0/documenting/rest.html#footnotes)31  - [Комментарии](https://python-all.ru/3.0/documenting/rest.html#comments)32  - [Кодировка исходного кода](https://python-all.ru/3.0/documenting/rest.html#source-encoding)33  - [Подводные камни](https://python-all.ru/3.0/documenting/rest.html#gotchas)34- [Дополнительные конструкции разметки](https://python-all.ru/3.0/documenting/markup.html)3536  - [Разметка метаинформации](https://python-all.ru/3.0/documenting/markup.html#meta-information-markup)37  - [Разметка, специфичная для модулей](https://python-all.ru/3.0/documenting/markup.html#module-specific-markup)38  - [Информационные единицы](https://python-all.ru/3.0/documenting/markup.html#information-units)39  - [Примеры кода](https://python-all.ru/3.0/documenting/markup.html#showing-code-examples)40  - [Встроенная разметка](https://python-all.ru/3.0/documenting/markup.html#inline-markup)41  - [Разметка перекрёстных ссылок](https://python-all.ru/3.0/documenting/markup.html#cross-linking-markup)42  - [Разметка на уровне абзацев](https://python-all.ru/3.0/documenting/markup.html#paragraph-level-markup)43  - [Разметка оглавления](https://python-all.ru/3.0/documenting/markup.html#table-of-contents-markup)44  - [Разметка для создания указателя](https://python-all.ru/3.0/documenting/markup.html#index-generating-markup)45  - [Отображение грамматических правил](https://python-all.ru/3.0/documenting/markup.html#grammar-production-displays)46  - [Подстановки](https://python-all.ru/3.0/documenting/markup.html#substitutions)47- [Отличия от разметки LaTeX](https://python-all.ru/3.0/documenting/fromlatex.html)4849  - [Встроенная разметка](https://python-all.ru/3.0/documenting/fromlatex.html#inline-markup)50  - [Информационные единицы](https://python-all.ru/3.0/documenting/fromlatex.html#information-units)51  - [Структура](https://python-all.ru/3.0/documenting/fromlatex.html#structure)52