Как переформатировать reStructuredText?

Question

Я пишу reST в vim, который обрабатывает разрывы строк для меня (после 80 символов). Однако, поскольку я часто возвращаюсь и редактирую текст раньше, строки снова становятся безобразными. Например, в таблицах иногда раздражает переформатирование полной таблицы только потому, что вам нужен разрыв строки в каком-то месте.

Поэтому мне бы хотелось, чтобы у меня была программа, которая читает мой уродливый, но правильный reStructuredText и выводит его красиво отформатированным и упакованным.

Я обнаружил, что pandoc in.rst -w rst основном работает, но у него есть некоторые недостатки. Например

:author: John Doe

становится

author
    John Doe

и формат заголовка также изменен. К сожалению, кажется, что нет rst2rst или чего-то подобного. У кого-нибудь есть совет?

Answer 1

Вы можете использовать:

setlocal formatoptions+=a

включить автоматическое форматирование абзацев в vim. Добавление этой строки в файл ftplugin/rst.vim в вашем каталоге конфигурации vim должно делать это автоматически всякий раз, когда вы начинаете редактировать файл .rst .

Если это переформатирует слишком много, это может улучшить положение, также добавив параметр w . Это заставляет vim считать, что абзац продолжается до следующей строки, когда строка заканчивается пробелом. Это автоматически поместит пробел в концах строк, которые автоматически вставляются.

Answer 2

Используйте -s с pandoc, если вы хотите, чтобы блок заголовка обрабатывался лучше.