Como reformatar o reStructuredText?

Question

Estou escrevendo reST no vim, que lida com quebras de linha para mim (depois de 80 caracteres). No entanto, como frequentemente volto e edito o texto antes, as linhas ficam feias novamente. Por exemplo, em tabelas, às vezes é chato reformatar uma tabela completa só porque você precisa de uma quebra de linha em algum lugar.

Então, eu gostaria de ter um programa que leia o meu reStructuredText feio, mas correto, e que ele seja bem formatado e agrupado.

Descobri que pandoc in.rst -w rst funciona principalmente, mas tem algumas desvantagens. Por exemplo

:author: John Doe

torna-se

author
    John Doe

e a formatação do título também é alterada. Infelizmente, parece não haver rst2rst ou algo similar. Alguém tem algum conselho?

    

Answer 1

Você pode usar:

setlocal formatoptions+=a

para ativar a formatação automática de parágrafos no vim. Adicionar essa linha ao arquivo ftplugin/rst.vim em seu diretório de configuração do vim deve fazê-lo automaticamente sempre que você começar a editar um arquivo .rst .

Se isso reformatar demais, pode melhorar as coisas para também adicionar a opção w . Isso faz com que o vim considere apenas um parágrafo para estender a próxima linha quando uma linha termina com um espaço. Colocará automaticamente um espaço nas extremidades das linhas que são inseridas automaticamente.

    

Answer 2

Use -s com pandoc se quiser que o bloco de título seja tratado melhor.