diff options
author | Anton Khirnov <anton@khirnov.net> | 2020-11-15 19:17:01 +0100 |
---|---|---|
committer | Anton Khirnov <anton@khirnov.net> | 2020-11-15 19:17:01 +0100 |
commit | a57f2bbad73ee62ec03800a4fcf8c686abdba5ea (patch) | |
tree | 9efc09002c7cb4efb192e86f7d55ac5d72a6d10e /vim/extline/README.rst | |
parent | 0c9f90667b0bf6edce29c444c7e57089c379d50e (diff) |
vim: add extline plugin
Allows easy over/under-lining text, useful mainly for ReST.
Imported directly, since it has no history to speak of.
Diffstat (limited to 'vim/extline/README.rst')
-rw-r--r-- | vim/extline/README.rst | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/vim/extline/README.rst b/vim/extline/README.rst new file mode 100644 index 0000000..470d81c --- /dev/null +++ b/vim/extline/README.rst @@ -0,0 +1,50 @@ +************************************************************** +Extline - plugin for extending lines (e.g., underlined titles) +************************************************************** + +When writing titles in a plain text document, a common convention is to use +repeated punctuation characters to draw lines under (and sometimes over) the +title text. This plugin helps maintain those title lines more easily, and +it provides support for standalone horizontal lines as well. + +Titles are marked up in a manner compatible with reStructuredText[1], and the +various heading levels are chosen to coincide with the Sphinx[2] project's +conventions as follows:: + + ############## + Part (level 9) + ############## + + ***************** + Chapter (level 0) + ***************** + + Section (level 1) + ================= + + Subsection (level 2) + -------------------- + + Subsubsection (level 3) + ^^^^^^^^^^^^^^^^^^^^^^^ + + Paragraph (level 4) + """"""""""""""""""" + + Level-5 heading + ''''''''''''''' + +Extline provides methods for adding these lines, adjusting them to fit as the +section names changes, and for converting one level to another. + +[1]: http://docutils.sourceforge.net/rst.html +[2]: http://sphinx-doc.org/ + +See documentation in doc/extline.txt for installation, customization, and +usage instructions. + +Developed by Michael Henry (vim at drmikehenry.com). + +Distributed under Vim's license. + +Git repository: https://github.com/drmikehenry/vim-extline |