lauchmelder/vim-sussify
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

Doc: explain dynamic custom headers in detail

Browse source
This commit is contained in:
Marco Hinz 2016-03-17 12:23:36 +01:00
parent f90594bb9a
commit 61daf3ab19
1 changed files with 44 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

47
doc/startify.txt
View file

@ -427,11 +427,11 @@ This is a list of strings to be shown before everything else. Every string
will be written on its own line, hence you can use empty strings for blank will be written on its own line, hence you can use empty strings for blank
lines. lines.
Simple example:~ Static example:~
> >
let g:startify_custom_header = ['line 1', '', 'line 3'] let g:startify_custom_header = ['line 1', '', 'line 3']
< <
More complex example:~ Static example #2:~
> >
let g:startify_custom_header = [ let g:startify_custom_header = [
\ ' ________ __ __ ', \ ' ________ __ __ ',
@ -443,11 +443,52 @@ More complex example:~
\ ' \/__/ \/_/\/_/\/_/\/_/ \// \/_/ \/_/ ', \ ' \/__/ \/_/\/_/\/_/\/_/ \// \/_/ \/_/ ',
\ ] \ ]
< <
Programmatic example:~ Dynamic example:~
> >
let g:startify_custom_header = let g:startify_custom_header =
\ map(split(system('fortune | cowsay'), '\n'), '" ". v:val') \ map(split(system('fortune | cowsay'), '\n'), '" ". v:val')
< <
If you go for a dynamic header, you might find the following functions useful:
startify#fortune#quote() raw random quote
startify#fortune#boxed() formatted random quote in a box
startify#fortune#cowsay() formatted random quote in a box + cow
Try them like this:
>
:echo join(startify#fortune#cowsay(), "\n")
<
Let's assume you like the default boxed random quote, but not the ASCII art
cow. You'd rather have another small ASCII art come before the quote. No
problem!
>
let g:ascii = [
\ ' __',
\ '.--.--.|__|.--------.',
\ '| | || || |',
\ ' \___/ |__||__|__|__|',
\ ''
\]
let g:startify_custom_header = g:ascii + startify#fortune#boxed()
<
Looks great! But it's not on the same column as the indices below which makes
it look awkward. Let's indent the header by 3 spaces:
>
let g:startify_custom_header =
\ map(g:ascii + startify#fortune#boxed(), '" ".v:val')
<
Ah, much better! There's only one issue left. If you set
g:startify_custom_header this way, it will only be done once. Hence spamming
:Startify will always show the same quote.
If you provide a string to it instead, Startify will evaluate it every time
:Startify is run:
>
let g:startify_custom_header =
\ 'map(g:ascii + startify#fortune#boxed(), "\" \".v:val")'
<
Happy customizing!
Also have a look at |startify-faq-08|. Also have a look at |startify-faq-08|.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------