ReST, ReStructured Text, is a pure-text markup language to create documents with a rich set of markup elements. It is most useful for creating HTML files, but can also be used to produce man pages or LaTeX sources. The ReST sources can be compiled into the result files by using the suite of programs provided by the Python docutils package. I am using some augmentation of the ReST language meant to make it easy to keep different versions which are closely related to each other in sync, e.g. to provide i18n. In this asciinema terminal cast I am focussing on some indentation problems with vim-8.2.2653 when writing such “interleaved” files. In my use case, the automatic indentation makes it a little tedious to write these files. The problem appeared somewhen following vim-8.2.0510. I am proposing a simplification of vim’s ReST file mode which would solve my problem, would remove some slight dysfunction, has few implications to writing ordinary ReST files and might even be seen as an improvement for writing ReST files in general with vim in some respects.
