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

675
wal-o-mat

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

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

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

:author: John Doe 

становится

author John Doe 

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

2

2 ответа на вопрос

1
qqx

You could use:

setlocal formatoptions+=a 

to turn on automatic formatting of paragraphs in vim. Adding that line to the ftplugin/rst.vim file in your vim configuration directory should do it automatically whenever you start editing a .rst file.

If that reformats too much, it may improve things to also add the w option. That causes vim to only consider a paragraph to extend onto the next line when a line ends with a space. It will automatically put a space at the ends of lines that are automatically inserted.

1
John MacFarlane

Use -s with pandoc if you want the title block to be handled better.