sponsor Vim development Vim logo Vim Book Ad

EightHeader : Easily create custom headlines, foldtext, toc, etc.

 script karma  Rating 7/4, Downloaded by 1868  Comments, bugs, improvements  Vim wiki

created by
Laszlo Bimba
 
script type
utility
 
description
https://github.com/BimbaLaszlo/vim-eightheader

To use EightHeader just move the cursor to the line which you want to modify (hereinafter line), then call it:

EightHeader( {length}, {align}, {oneline}, {decor}, {marker}, {str} )

{length}   Length of the header.
{align}    Alignment of text.
{oneline}  If false, then underline the {line} with {decor}.
{decor}    Decorator text to fill with.
{marker}   Extra content after decotRightEnd.
{str}      Replace the content of {line} with this.

An example with {oneline} set to true (1) (s:str means the original line, see EightHeaderVars for details):

call EightHeader( 78, 'center', 1, ['l ', 'decor', ' r'], ' m', '\=" ".s:str." "' )

l decordecordecordecordeco TEXT IN THE LINE cordecordecordecordecord r m

If you don't like the default 'foldtext' you can customize it by setting to
EightHeaderFolds().

For example the closed folds looks like this by default:

+-- 45 lines: Fold level one
+--- 67 lines: Fold level two

If you would like to change it to this kind:

Fold level one................45 lines
  Fold level two..............67 lines

... then you can use this function:

let &foldtext = "EightHeaderFolds( '\\=s:fullwidth-2', 'left', [ repeat( '  ', v:foldlevel - 1 ), '.', '' ], '\\= s:foldlines . \" lines\"', '' )"

An alternative usage for example formating a vimhelp table of contents:

Options;options
Default mappings;maps
  Launch nuclear strike;apocalypse

... to this:

Options........................................................|options|
Default mappings..................................................|maps|
  Launch nuclear strike.....................................|apocalypse|

Visually select the lines, than:

call EightHeader( 78, "left", 1, ".", "\\='|'.matchstr(s:str, ';\\@<=.*').'|'", "\\=matchstr(s:str, '.*;\\@=')" )
 
install details
Open in vim then run
:so %

... or use Vundle:

Add these lines to your .vimrc after 'call vundle#rc()' to install from the official repository (https://github.com/BimbaLaszlo/vim-eightheader):

Plugin 'bimbalaszlo/vim-eightheader'

Open vim again, then call ':PluginInstall'

Please rate if you using it!
 

rate this script Life Changing Helpful Unfulfilling 
script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
eightheader.vmb 1.0 2015-05-26 7.4 Laszlo Bimba clarified documentation
eightheader.vmb 1.0 2014-05-16 7.4 Laszlo Bimba Moved to github.
eightheader.vmb 1.0 2014-05-15 7.4 Laszlo Bimba "Please rate" advertisement.
eightheader.vmb 1.0 2014-04-30 7.4 Laszlo Bimba Help about comment handling.
eightheader.vmb 1.0 2014-04-30 7.4 Laszlo Bimba Previous vimballs was broken, sorry.
Added more help.
ip used for rating: 18.97.14.90

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.
   
Vim at Github