How to reformat reStructuredText?

Posted by wal-o-mat on Super User See other posts from Super User or by wal-o-mat
Published on 2012-12-17T07:52:27Z Indexed on 2012/12/17 11:05 UTC
Read the original article Hit count: 183

Filed under:

vim

|

restructuredtext

I'm writing reST in vim, which handles line breaks for me (after 80 chars). However, since I frequently go back and edit the text before, lines get ugly again. For example, in tables, it's sometimes annoying to re-format a complete table just because you need a line break in some place.

So I wish I had a program that reads my ugly-but-correct reStructuredText and outputs it nicely formatted and wrapped.

I found that pandoc in.rst -w rst mostly works, but it has some drawbacks. For example

:author: John Doe

becomes

author
    John Doe

and title formatting is changed as well. Sadly, there seems to be no rst2rst or something similar. Does anyone have some advice?

© Super User or respective owner

Related posts about vim

Vim: Use different ~/.vim/plugin/ directories for different versions of vim?

as seen on Super User - Search for 'Super User'
Like many of you, my custom Vim configuration is stored in my ~/.vimrc, with the plugins, colors, etc. stored under ~/.vim/plugins, ~/.vim/colors, etc. I want to share a single Vim configuration among many servers. Some of these servers run Vim 7, some run the older Vim 6. Most Vim plugins are intended… >>> More
Why isn't the scripts in my autoload folder being executed in Vim?

as seen on Super User - Search for 'Super User'
I'm trying to use Pathogen to manage my Vim extensions. My bundle folder looks like this: .../bundle/ +-- vim-pathogen ¦ +-- autoload ¦ +-- pathogen.vim +-- vim-smoothscroll +-- autoload +-- smooth_scroll.vim And my vimrc file includes this: let s:root = fnamemodify(resolve(expand(":p"))… >>> More
Cygwin vim doesn't load files in runtimepath

as seen on Super User - Search for 'Super User'
I created a custom syntax file, and but none of the files in $VIMRUNTIME seem to load. I followed these pieces of the documentation: http://vimdoc.sourceforge.net/htmldoc/filetype.html#new-filetype http://vimdoc.sourceforge.net/htmldoc/syntax.html#mysyntaxfile When I do :echo &runtimepath I… >>> More
Debugging matchit plugin in vim (under Cygwin)

as seen on Stack Overflow - Search for 'Stack Overflow'
The "matchit" plugin for vim is supposed to allow you to use the % key to jump between matching start/end tags when editing HTML, as well as /* and */ comment delimiters when editing other kinds of code. I've followed the exact instructions in ":help matchit", but % still doesn't work for me. It… >>> More
Vim: How to execute commands stored in a textfile opened in Vim

as seen on Super User - Search for 'Super User'
I store, commands found at http://www.commandlinefu.com/commands/browse, in a text file. If I open this text file in Vim and I want to execute the command where the cursor is actually located I do copy the line with Y, switching to command mode with : and !CTRL+r* Is there a more "lazy" possibility ;) >>> More

Related posts about restructuredtext

reStructuredText tool support

as seen on Stack Overflow - Search for 'Stack Overflow'
I love reStructuredText, however the tools that support it are scattered all over the Internet. The official tool list is incomplete and/or outdated, and can be updated only via commit privileges. For some time there was a comprehensive list at the Wikipedia reStructuredText page, but this apparently… >>> More
editors for tables in Sphinx/reStructuredText?

as seen on Stack Overflow - Search for 'Stack Overflow'
I'm looking at using Sphinx / reStructuredText for documentation, and it looks very promising, except tables look like a pain to do. Is there an editor that can help? >>> More
Sphinx, reStructuredText show\hide code snippets

as seen on Stack Overflow - Search for 'Stack Overflow'
Hi, I've been documenting a software package using Sphinx and reStructuredText. Within my documents, there are some long code snippets. I want to be able to have them hidden as default, with a little "Show\Hide" button that would expand them (Example). Is there a standard way to do that? If not… >>> More
How can I change from docbook to restructuredText?

as seen on Stack Overflow - Search for 'Stack Overflow'
I have a 30-ish page manual in docbook. However, working with docbook is so painful that I don't really update it. I want to switch to restructedText instead. I can't find any direct translator (the best I could find is ezComponents, but it fails on the docbook sgml). Maybe there is an indirect route… >>> More
Compare and contrast the lightweight markup languages (Textile, Markdown, and reStructuredText)

as seen on Stack Overflow - Search for 'Stack Overflow'
Please identify the most popular lightweight markup languages and compare their strengths and weaknesses. These languages should be general-purpose markup for technical prose, such as for documentation (for example, Haml doesn't count). See also: Markdown versus ReStructuredText >>> More