Wie formatiert man reStructuredText neu?

767
wal-o-mat

Ich schreibe reST in vim, das Zeilenumbrüche für mich erledigt (nach 80 Zeichen). Da ich jedoch häufig den Text vorher noch einmal bearbeite, werden die Zeilen wieder hässlich. In Tabellen ist es zum Beispiel manchmal ärgerlich, eine komplette Tabelle neu zu formatieren, nur weil Sie an einer bestimmten Stelle einen Zeilenumbruch benötigen.

Ich wünschte, ich hätte ein Programm, das meinen hässlichen, aber korrekten reStructuredText liest und es schön formatiert und verpackt ausgibt.

Ich fand, dass das pandoc in.rst -w rstmeistens funktioniert, aber es hat einige Nachteile. Zum Beispiel

:author: John Doe 

wird

author John Doe 

und die Formatierung des Titels wird ebenfalls geändert. Leider scheint es nichts rst2rstoder ähnliches zu geben. Hat jemand einen Rat?

2

2 Antworten auf die Frage

1
qqx

Du könntest benutzen:

setlocal formatoptions+=a 

Aktivieren der automatischen Formatierung von Absätzen in vim. Wenn Sie diese Zeile zur ftplugin/rst.vimDatei in Ihrem vim-Konfigurationsverzeichnis hinzufügen, sollte dies automatisch geschehen, wenn Sie mit dem Bearbeiten einer .rstDatei beginnen.

Wenn dieses Format zu stark formatiert wird, kann es auch verbessert werden, wenn Sie die wOption hinzufügen . Dies führt dazu, dass vim berücksichtigt, dass sich ein Absatz nur auf die nächste Zeile erstreckt, wenn eine Zeile mit einem Leerzeichen endet. Es wird automatisch ein Leerzeichen an den Zeilenende eingefügt, die automatisch eingefügt werden.

1
John MacFarlane

Verwenden Sie -s mit Pandoc, wenn der Titelblock besser gehandhabt werden soll.