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

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

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

я нашел это pandoc in.rst -w rst в основном работает, но имеет некоторые недостатки. Например

:author: John Doe

становится

author
    John Doe

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

2 ответа

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

setlocal formatoptions+=a

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

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

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

Другие вопросы по тегам