Как создать кодовый блок RST без предшествующих пробелов?

Question

Что мне действительно нравится в Markdown, так это то, что я могу делать следующее:

1. Запись ``` Введите
2. Вставить любой мусор, который есть в моембуфер обмена
3. Запись ```
4. Теперь у меня есть рабочий блок кода

В RST я должен сделать следующее:

1. Введите .. codeblock:: Введите Введите
2. Вставьте
3. Теперь мне нужно сделать отступ для всех строк, которые я ранее вставил

Есть ли в RST более простой способ использования кодового блока без необходимости использовать предшествующие четыре пробела?

Answer 1

В reST нет ничего похожего на встроенный кодовый блок markdown. Есть только эти опции :

Существует несколько способов отображения выделенных синтаксисом блоков литерального кода в Sphinx: использование reST блоков doctest ; использование буквенных блоков reST , необязательно в сочетании с директивой highlight ; используя директиву code-block ; и используя директиву literalinclude .

Если в вашем редакторе отсутствует возможность автоматического отступа code-block или вы не можете выбрать блок и сделать отступ в четыре пробела, тогда лучшим вариантом может быть literalinclude. Это особенно полезно, если вы ссылаетесь на один и тот же код несколько раз.

p.s. - Попробуйте сделать отступ через четыре пробела после второго return . Я попробовал в PyCharm, но он не отступ, но, возможно, ваш редактор сделает это. Есть несколько открытых вопросов для PyCharm .