-*- mode: org -*-
#+TITLE:       sisudoc spine (doc_reform) information files
#+DESCRIPTION: documents - structuring, various output representations & search
#+FILETAGS:    :spine:info:
#+AUTHOR:      Ralph Amissah
#+EMAIL:       [[mailto:ralph.amissah@gmail.com][ralph.amissah@gmail.com]]
#+COPYRIGHT:   Copyright (C) 2015 - 2024 Ralph Amissah
#+LANGUAGE:    en
#+STARTUP:     content hideblocks hidestars noindent entitiespretty
#+PROPERTY:    header-args  :exports code
#+PROPERTY:    header-args+ :noweb yes
#+PROPERTY:    header-args+ :results no
#+PROPERTY:    header-args+ :cache no
#+PROPERTY:    header-args+ :padline no
#+PROPERTY:    header-args+ :mkdirp yes
#+OPTIONS:     H:3 num:nil toc:t \n:t ::t |:t ^:nil -:t f:t *:t

- [[./doc-reform.org][doc-reform.org]]  [[./][org/]]

* Vim Syntax highlighting
** filetype

#+HEADER: :tangle "../sundry/misc/editor-syntax-etc/vim/filetype.vim"
#+BEGIN_SRC text
" SiSU filetype file
if exists("did_load_filetypes")
  finish
endif
augroup filetypedetect
  au! BufNewFile,BufRead *.sst,*.ssm,*.ssi,*.-sst setf sisu
  au! BufNewFile,BufRead *._sst,*.sst.meta,*.-sst.meta,*._sst.meta setf sisu
augroup END
#+END_SRC

** debian vim addon manager

#+HEADER: :tangle "../sundry/misc/editor-syntax-etc/vim/vim-sisu.yaml"
#+BEGIN_SRC text
#vim-addons: debian vim-addon-manager
addon: sisu
description: SiSU documents - structuring, publishing in multiple formats and search
basedir: /usr/share/vim-scripts/
files:
  - ftplugin/sisu.vim
  - syntax/sisu.vim
#+END_SRC

** color files
*** def.vim

#+HEADER: :tangle "../sundry/misc/editor-syntax-etc/vim/colors/def.vim"
#+BEGIN_SRC text
" Vim color file
" Name:            def
" Maintainer:      Ralph Amissah <ralph@amissah.com>
" Last Change:     2013-02-14
" URL:             <https://git.sisudoc.org/projects/?p=software/spine.git;a=blob;f=data/sisu/conf/editor-syntax-etc/vim/colors/def.vim;hb=HEAD>
" Note:            primarily 16 color cterm improved by tweaking of .Xdefaults
"                  (with occasional other colors selected from 256 color palate)
"                  .Xdefaults tweaking to make identical to def (256) provided,
"                  along with an alternative possibility using colors beyond
"                  256 color palate
:hi clear
if exists("syntax_on")
  syntax reset
endif
:set t_Co=256
:set background=dark
:let colors_name = "def"
" -------
" terminal def
" -------
:hi Normal                             ctermbg=0           ctermfg=7
":hi Cursor                             ctermbg=5           ctermfg=0
:hi lCursor        cterm=reverse
:hi StatusLine     cterm=bold,reverse
:hi StatusLineNC   cterm=reverse
:hi Search         cterm=none          ctermbg=57          ctermfg=0
:hi IncSearch      cterm=none          ctermbg=154         ctermfg=0
:hi SpecialKey                                             ctermfg=4
:hi Visual         cterm=reverse
:hi VisualNOS      cterm=bold,underline
:hi MoreMsg                                                ctermfg=2
:hi ModeMsg        cterm=bold
:hi Question                                               ctermfg=2
:hi Title          cterm=bold                              ctermfg=3
:hi NonText        cterm=bold                              ctermfg=4
:hi LineNr         cterm=bold          ctermbg=0           ctermfg=0*
:hi CursorLineNr   cterm=bold          ctermbg=166         ctermfg=0
:hi Directory                                              ctermfg=4
:hi WildMenu                           ctermbg=3           ctermfg=0
:hi VertSplit      cterm=reverse
:hi Folded         cterm=none          ctermbg=0           ctermfg=8
:hi FoldColumn                         ctermbg=7           ctermfg=4
:hi DiffAdd        cterm=none          ctermbg=2           ctermfg=0
:hi DiffChange     cterm=none          ctermbg=7           ctermfg=0
:hi DiffDelete     cterm=none          ctermbg=7           ctermfg=0
:hi DiffText       cterm=none          ctermbg=6           ctermfg=0
:hi String         cterm=none                              ctermfg=3
:hi Comment        cterm=none          ctermbg=0           ctermfg=4
:hi Constant                                               ctermfg=1
:hi Special                                                ctermfg=6
:hi Identifier                                             ctermfg=6
:hi Statement                                              ctermfg=2
:hi Operator                                               ctermfg=2
:hi PreProc                                                ctermfg=1
:hi Type           cterm=bold                              ctermfg=3
:hi Delimiter      cterm=none                              ctermfg=2
:hi Ignore         cterm=bold                              ctermfg=7
:hi Todo                               ctermbg=3           ctermfg=0
:hi Underlined     cterm=underline
:hi Include                                                ctermfg=1
:hi Define                                                 ctermfg=3
:hi Function                                               ctermfg=6
:hi Structure                                              ctermfg=2
:hi MatchParen     cterm=bold          ctermbg=4           ctermfg=7
:hi CursorLine     cterm=bold
:hi CursorColumn                       ctermbg=17
:hi ColorColumn                        ctermbg=17
:hi SpellBad       cterm=underline     ctermbg=0           ctermfg=5
:hi SpellCap       cterm=underline     ctermbg=0           ctermfg=5
:hi SpellLocal     cterm=underline     ctermbg=0           ctermfg=5
:hi SpellRare      cterm=underline     ctermbg=0           ctermfg=5
:hi TrailingWhitespace                 ctermbg=1
:hi ExtraWhitespace                    ctermbg=1
:hi WarningMsg                                             ctermfg=1
:hi ErrorMsg       cterm=bold          ctermbg=1           ctermfg=7
:hi Error          cterm=bold          ctermbg=1           ctermfg=7
" -------
" gui def
" -------
:hi Normal                             guibg=#000000       guifg=#D3D3D3
:hi Cursor                             guibg=#CC9966       guifg=#000000
:hi lCursor        gui=reverse
:hi StatusLine     gui=bold,reverse
:hi StatusLineNC   gui=reverse
:hi Search         gui=none            guibg=#5F00FF       guifg=#000000
:hi IncSearch      gui=none            guibg=#AFFF00       guifg=#000000
:hi SpecialKey                                             guifg=#5971AD
:hi Visual         gui=reverse
:hi VisualNOS      gui=bold,underline
:hi MoreMsg                                                guifg=#4E9A06
:hi ModeMsg        gui=bold
:hi Question                                               guifg=#4E9A06
:hi Title          gui=bold                                guifg=#C4A000
:hi NonText        gui=bold                                guifg=#5971AD
:hi LineNr         gui=bold            guibg=#000000       guifg=#808080
:hi CursorLineNr   gui=bold            guibg=#D75F00       guifg=#000000
:hi Directory                                              guifg=#5971AD
:hi WildMenu                           guibg=#C4A000       guifg=#000000
:hi VertSplit      gui=reverse
:hi Folded         gui=none            guibg=#000000       guifg=#808080
:hi FoldColumn                         guibg=#D3D3D3       guifg=#5971AD
:hi DiffAdd        gui=none            guibg=#4E9A06       guifg=#000000
:hi DiffChange     gui=none            guibg=#D3D3D3       guifg=#000000
:hi DiffDelete     gui=none            guibg=#D3D3D3       guifg=#000000
:hi DiffText       gui=none            guibg=#06989A       guifg=#000000
:hi String         gui=none                                guifg=#C4A000
:hi Comment        gui=none            guibg=#000000       guifg=#5971AD
:hi Constant                                               guifg=#CC0000
:hi Special                                                guifg=#06989A
:hi Identifier                                             guifg=#06989A
:hi Statement                                              guifg=#4E9A06
:hi Operator                                               guifg=#4E9A06
:hi PreProc                                                guifg=#CC0000
:hi Type           gui=bold                                guifg=#C4A000
:hi Delimiter      gui=none                                guifg=#4E9A06
:hi Ignore         gui=bold                                guifg=#D3D3D3
:hi Todo                               guibg=#C4A000       guifg=#000000
:hi Underlined     gui=underline
:hi Include                                                guifg=#CC0000
:hi Define                                                 guifg=#C4A000
:hi Function                                               guifg=#06989A
:hi Structure                                              guifg=#4E9A06
:hi MatchParen     gui=bold            guibg=#5971AD       guifg=#D3D3D3
:hi CursorLine     gui=bold
:hi CursorColumn                       guibg=#00005F
:hi ColorColumn                        guibg=#00005F
:hi SpellBad       gui=underline       guibg=#000000       guifg=#75507B
:hi SpellCap       gui=underline       guibg=#000000       guifg=#75507B
:hi SpellLocal     gui=underline       guibg=#000000       guifg=#75507B
:hi SpellRare      gui=underline       guibg=#000000       guifg=#75507B
:hi TrailingWhitespace                 guibg=#080000
:hi ExtraWhitespace                    guibg=#CC0000
:hi WarningMsg                                             guifg=#CC0000
:hi ErrorMsg       gui=bold            guibg=#CC0000       guifg=#D3D3D3
:hi Error          gui=bold            guibg=#CC0000       guifg=#D3D3D3
" -------
"256 color .Xdefaults vim: cterm giu
"<https://vim.wikia.com/wiki/Xterm256_color_names_for_console_Vim>
"<https://guns.github.com/xterm-color-table.vim/images/xterm-color-table-with-visible-rgb.png>
" -------
" 256 color .Xdefaults vim: cterm giu def
" -------
"      16 color     standard     altered 256     altered beyond 256
" black/dark grey
"        0        [ 0:#000000]                   #000000
"        8        [ 8:#808080]   [59:#5F5F5F]    #555555
" red
"        1        [ 1:#800000]   160:#DF0000     #CC0000
"        9        [ 9:#FF0000]                   #EF2929
" green
"        2        [ 2:#008000]   112:#87DF00     #4E9A06
"       10        [10:#00FF00]   154:#AFFF00     #8AE234
" yellow/orange
"        3        [ 3:#808000]   178:#DFAF00     #C4A000
"       11        [11:#FFFF00]   184:#DFDF00     #FC9E4F
" blue
"        4        [ 4:#000080]    24:#005F87     #5971AD
"       12        [12:#0000FF]    73:#5FAFAF     #729FCF
" magenta
"        5        [ 5:#800080]    90:#870087     #75507B
"       13        [13:#FF00FF]   126:#AF0087     #AD7FA8
" cyan
"        6        [ 6:#008080]    37:#00AFAF     #06989A
"       14        [14:#00FFFF]    87:#5FFFFF     #34E2E2
" white
"        7        [ 7:#C0C0C0]                   #D3D3D3
"       15        [15:#FFFFFF]                   #EEEEEE
" --------
" .Xdefaults (rxvt urxvt setting beyond 256 colors, vim colorscheme "def" gui settings)
" (vim colorscheme "def" cterm matches "def" gui if .Xdefaults set thus)
" --------
" ! black
" Rxvt.color0  : #000000
" Rxvt.color8  : #555555
" ! red
" Rxvt.color1  : #CC0000
" Rxvt.color9  : #EF2929
" ! green
" Rxvt.color2  : #4E9A06
" Rxvt.color10 : #8AE234
" ! yellow
" Rxvt.color3  : #C4A000
" Rxvt.color11 : #FCE94F
" ! blue
" Rxvt.color4  : #5971AD
" Rxvt.color12 : #729FCF
" ! magenta
" Rxvt.color5  : #75507B
" Rxvt.color13 : #AD7FA8
" ! cyan
" Rxvt.color6  : #06989A
" Rxvt.color14 : #34E2E2
" ! white
" Rxvt.color7  : #D3D7CF
" Rxvt.color15 : #EEEEEE
" --------
" .Xdefaults 256 (rxvt urxvt setting, vim colorscheme "def256" cterm & gui settings)
" (vim colorscheme "def" cterm matches "def256" if .Xdefaults set thus)
" --------
" ! black
" Rxvt.color0  : #000000
" Rxvt.color8  : #808080
" ! red
" Rxvt.color1  : #DF0000
" Rxvt.color9  : #FF0000
" ! green
" Rxvt.color2  : #87DF00
" Rxvt.color10 : #AFFF00
" ! yellow
" Rxvt.color3  : #DFAF00
" Rxvt.color11 : #FFFF00
" ! blue
" Rxvt.color4  : #5F87DF
" Rxvt.color12 : #87DFFF
" ! magenta
" Rxvt.color5  : #8700DF
" Rxvt.color13 : #87DFFF
" ! cyan
" Rxvt.color6  : #00DFDF
" Rxvt.color14 : #5F5FDF
" ! white
" Rxvt.color7  : #C0C0C0
" Rxvt.color15 : #FFFFFF
#+END_SRC

*** slate.vim

#+HEADER: :tangle "../sundry/misc/editor-syntax-etc/vim/colors/slate.vim"
#+BEGIN_SRC text
"%% SiSU Vim color file
" Name:            Slate
" Maintainer:      Ralph Amissah <ralph@amissah.com>
" Last Change:     2013-02-09
" URL:             <https://git.sisudoc.org/projects/?p=software/spine.git;a=blob;f=data/sisu/conf/editor-syntax-etc/vim/colors/slate.vim;hb=HEAD>
" Notes:          cterm now uses frugal-sisu 8 colors for term
"                 (for gui originally looked at desert Hans Fugal <hans@fugal.net>
"                  <https://hans.fugal.net/vim/colors/desert.vim> (April/May 2003))
:set background=dark
:hi clear
if exists("syntax_on")
  syntax reset
endif
:let colors_name = "slate"
" 0 = black, 1 = red, 2 = green, 3 = yellow/orange, 4 = blue, 5 = magenta, 6 = cyan, 7 = white
:hi Normal                                                           ctermbg=0           ctermfg=7                     guibg=grey15        guifg=white
:hi Cursor         term=reverse             cterm=reverse                                                              guibg=khaki         guifg=slategrey
:hi lCursor        term=reverse             cterm=reverse
:hi StatusLine     term=reverse             cterm=bold,reverse                                               gui=none  guibg=#c2bfa5       guifg=black
:hi StatusLineNC   term=reverse             cterm=reverse                                                    gui=none  guibg=#c2bfa5       guifg=grey40
:hi Search         term=reverse             cterm=none               ctermbg=2           ctermfg=0                     guibg=peru          guifg=wheat
:hi IncSearch      term=reverse             cterm=bold               ctermbg=2           ctermfg=7                     guibg=black         guifg=green
:hi SpecialKey     term=bold                                                             ctermfg=4                                         guifg=yellowgreen
:hi Visual         term=reverse             cterm=reverse                                                    gui=none  guibg=olivedrab     guifg=khaki
:hi VisualNOS      term=bold,underline      cterm=bold,underline
:hi MoreMsg        term=bold                                                             ctermfg=2                                         guifg=SeaGreen
:hi ModeMsg        term=bold                cterm=bold                                                                                     guifg=goldenrod
:hi Question       term=standout                                                         ctermfg=2                                         guifg=springgreen
:hi Title          term=bold                cterm=bold                                   ctermfg=3           gui=bold                      guifg=gold
:hi NonText        term=bold                cterm=bold                                   ctermfg=4                     guibg=grey15        guifg=RoyalBlue
:hi LineNr         term=underline           cterm=bold               ctermbg=0           ctermfg=0*                                        guifg=grey50
:hi Directory      term=bold                                                             ctermfg=4
:hi WildMenu       term=standout                                     ctermbg=3           ctermfg=0                     guibg=darkyellow    guifg=black
:hi VertSplit      term=reverse             cterm=reverse                                                    gui=none  guibg=#c2bfa5       guifg=grey40
:hi Folded         term=standout            cterm=none               ctermbg=0           ctermfg=7                     guibg=black         guifg=grey40
:hi FoldColumn     term=standout                                     ctermbg=7           ctermfg=4                     guibg=black         guifg=grey20
:hi DiffChange                              cterm=none               ctermbg=7           ctermfg=0                     guibg=darkgrey      guifg=white
:hi DiffText                                cterm=none               ctermbg=6           ctermfg=0                     guibg=darkcyan      guifg=white
:hi DiffAdd                                 cterm=none               ctermbg=2           ctermfg=0                     guibg=darkgreen     guifg=white
:hi DiffDelete                              cterm=none               ctermbg=7           ctermfg=0                     guibg=darkgrey      guifg=black
:hi String                                  cterm=none                                   ctermfg=3                                         guifg=SkyBlue
:hi Comment        term=bold                cterm=none               ctermbg=0           ctermfg=7                                         guifg=grey40
:hi Constant       term=underline                                                        ctermfg=1                                         guifg=#ffa0a0
:hi Special        term=bold                                                             ctermfg=6                                         guifg=darkkhaki
:hi Identifier     term=underline                                                        ctermfg=6                                         guifg=salmon
:hi Statement      term=bold                                                             ctermfg=6                                         guifg=CornflowerBlue
:hi Operator       term=bold                                                             ctermfg=1                                         guifg=red
:hi PreProc        term=underline                                    ctermbg=7           ctermfg=1                     guibg=white         guifg=red
:hi Type           term=underline                                                        ctermfg=2                                         guifg=CornflowerBlue
:hi Delimiter      term=none                cterm=none                                   ctermfg=1
:hi Ignore                                  cterm=bold                                   ctermfg=7                                         guifg=grey40
:hi Todo           term=standout                                     ctermbg=3           ctermfg=0                     guibg=yellow2       guifg=orangered
:hi Underlined     term=underline           cterm=underline
:hi Include                                                                              ctermfg=1                                         guifg=red
:hi Define                                                                               ctermfg=3           gui=bold                      guifg=gold
:hi Function                                                                             ctermfg=6                                         guifg=navajowhite
:hi Structure                                                                            ctermfg=2                                         guifg=green
:hi MatchParen                              cterm=bold               ctermbg=4           ctermfg=7
:hi CursorLine                              cterm=bold,underline                                                            guibg=black
:hi CursorColumn                            cterm=bold                                                                 guibg=black
:hi SpellBad       term=underline,standout  cterm=none               ctermbg=7           ctermfg=0                     guibg=darkmagenta   guifg=white
:hi SpellCap       term=underline,standout  cterm=none               ctermbg=7           ctermfg=0
:hi SpellLocal     term=underline,standout  cterm=none               ctermbg=7           ctermfg=0                     guibg=darkmagenta   guifg=white
:hi SpellRare      term=underline,standout  cterm=none               ctermbg=7           ctermfg=0
:hi WarningMsg     term=standout                                                         ctermfg=1                     guibg=darkmagenta   guifg=salmon
:hi ErrorMsg       term=standout            cterm=bold               ctermbg=1           ctermfg=7                     guibg=darkmagenta   guifg=white
:hi Error          term=reverse             cterm=bold               ctermbg=1           ctermfg=7                     guibg=darkmagenta   guifg=white
:hi Black                                                            ctermbg=grey        ctermfg=black                 guibg=grey          guifg=black
:hi Red                                                              ctermbg=black       ctermfg=red                   guibg=black         guifg=red
:hi Magenta                                                          ctermbg=black       ctermfg=magenta               guibg=black         guifg=magenta
:hi Blue                                                             ctermbg=black       ctermfg=blue                  guibg=black         guifg=blue
:hi Cyan                                                             ctermbg=black       ctermfg=cyan                  guibg=black         guifg=cyan
:hi Green                                                            ctermbg=black       ctermfg=green                 guibg=black         guifg=green
:hi Yellow                                                           ctermbg=black       ctermfg=yellow                guibg=black         guifg=yellow
:hi White                                                            ctermbg=black       ctermfg=white                 guibg=black         guifg=white
#+END_SRC

*** def-sisu.vim

#+HEADER: :tangle "../sundry/misc/editor-syntax-etc/vim/colors/def-sisu.vim"
#+BEGIN_SRC text
" Vim color file
" Name:            def-sisu
" Maintainer:      Ralph Amissah <ralph@amissah.com>
" Last Change:     2013-02-14
" URL:             <https://git.sisudoc.org/projects/?p=software/spine.git;a=blob;f=data/sisu/conf/editor-syntax-etc/vim/colors/def-sisu.vim;hb=HEAD>
" Note:            primarily 16 color cterm improved by tweaking of .Xdefaults
"                  (with occasional other colors selected from 256 color palate)
"                  .Xdefaults tweaking to make identical to def (256) provided,
"                  along with an alternative possibility using colors beyond
"                  256 color palate
:hi clear
if exists("syntax_on")
  syntax reset
endif
:set t_Co=256
:set background=dark
:let colors_name = "def-sisu"
" -------
" terminal def
" -------
:hi Normal                             ctermbg=0           ctermfg=7
":hi Cursor                             ctermbg=5           ctermfg=0
:hi lCursor        cterm=reverse
:hi StatusLine     cterm=bold,reverse
:hi StatusLineNC   cterm=reverse
:hi Search         cterm=none          ctermbg=57          ctermfg=0
:hi IncSearch      cterm=none          ctermbg=154         ctermfg=0
:hi SpecialKey                                             ctermfg=4
:hi Visual         cterm=reverse
:hi VisualNOS      cterm=bold,underline
:hi MoreMsg                                                ctermfg=2
:hi ModeMsg        cterm=bold
:hi Question                                               ctermfg=2
:hi Title          cterm=bold                              ctermfg=3
:hi NonText        cterm=bold                              ctermfg=4
:hi LineNr         cterm=bold          ctermbg=0           ctermfg=0*
:hi CursorLineNr   cterm=bold          ctermbg=166         ctermfg=0
:hi Directory                                              ctermfg=4
:hi WildMenu                           ctermbg=3           ctermfg=0
:hi VertSplit      cterm=reverse
:hi Folded         cterm=none          ctermbg=0           ctermfg=8
:hi FoldColumn                         ctermbg=7           ctermfg=4
:hi DiffAdd        cterm=none          ctermbg=2           ctermfg=0
:hi DiffChange     cterm=none          ctermbg=7           ctermfg=0
:hi DiffDelete     cterm=none          ctermbg=7           ctermfg=0
:hi DiffText       cterm=none          ctermbg=6           ctermfg=0
:hi String         cterm=none                              ctermfg=3
:hi Comment        cterm=none          ctermbg=0           ctermfg=4
:hi Constant                                               ctermfg=1
:hi Special                                                ctermfg=6
:hi Identifier                                             ctermfg=6
:hi Statement                                              ctermfg=6
:hi Operator                                               ctermfg=1
:hi PreProc                            ctermbg=7           ctermfg=1
:hi Type                                                   ctermfg=2
:hi Delimiter      cterm=none                              ctermfg=1
:hi Ignore         cterm=bold                              ctermfg=7
:hi Todo                               ctermbg=3           ctermfg=0
:hi Underlined     cterm=underline
:hi Include                                                ctermfg=1
:hi Define                                                 ctermfg=3
:hi Function                                               ctermfg=6
:hi Structure                                              ctermfg=2
:hi MatchParen     cterm=bold          ctermbg=4           ctermfg=7
:hi CursorLine     cterm=bold
:hi CursorColumn                       ctermbg=17
:hi ColorColumn                        ctermbg=17
:hi SpellBad       cterm=underline     ctermbg=0           ctermfg=5
:hi SpellCap       cterm=underline     ctermbg=0           ctermfg=5
:hi SpellLocal     cterm=underline     ctermbg=0           ctermfg=5
:hi SpellRare      cterm=underline     ctermbg=0           ctermfg=5
:hi TrailingWhitespace                 ctermbg=1
:hi ExtraWhitespace                    ctermbg=1
:hi WarningMsg                                             ctermfg=1
:hi ErrorMsg       cterm=bold          ctermbg=1           ctermfg=7
:hi Error          cterm=bold          ctermbg=1           ctermfg=7
" -------
" gui def
" -------
:hi Normal                             guibg=#000000       guifg=#D3D3D3
:hi Cursor                             guibg=#CC9966       guifg=#000000
:hi lCursor        gui=reverse
:hi StatusLine     gui=bold,reverse
:hi StatusLineNC   gui=reverse
:hi Search         gui=none            guibg=#5F00FF       guifg=#000000
:hi IncSearch      gui=none            guibg=#AFFF00       guifg=#000000
:hi SpecialKey                                             guifg=#5971AD
:hi Visual         gui=reverse
:hi VisualNOS      gui=bold,underline
:hi MoreMsg                                                guifg=#4E9A06
:hi ModeMsg        gui=bold
:hi Question                                               guifg=#4E9A06
:hi Title          gui=bold                                guifg=#C4A000
:hi NonText        gui=bold                                guifg=#5971AD
:hi LineNr         gui=bold            guibg=#000000       guifg=#808080
:hi CursorLineNr   gui=bold            guibg=#D75F00       guifg=#000000
:hi Directory                                              guifg=#5971AD
:hi WildMenu                           guibg=#C4A000       guifg=#000000
:hi VertSplit      gui=reverse
:hi Folded         gui=none            guibg=#000000       guifg=#808080
:hi FoldColumn                         guibg=#D3D3D3       guifg=#5971AD
:hi DiffAdd        gui=none            guibg=#4E9A06       guifg=#000000
:hi DiffChange     gui=none            guibg=#D3D3D3       guifg=#000000
:hi DiffDelete     gui=none            guibg=#D3D3D3       guifg=#000000
:hi DiffText       gui=none            guibg=#06989A       guifg=#000000
:hi String         gui=none                                guifg=#C4A000
:hi Comment        gui=none            guibg=#000000       guifg=#5971AD
:hi Constant                                               guifg=#CC0000
:hi Special                                                guifg=#06989A
:hi Identifier                                             guifg=#06989A
:hi Statement                                              guifg=#06989A
:hi Operator                                               guifg=#CC0000
:hi PreProc                            guibg=#D3D3D3       guifg=#CC0000
:hi Type                                                   guifg=#4E9A06
:hi Delimiter      gui=none                                guifg=#CC0000
:hi Ignore         gui=bold                                guifg=#D3D3D3
:hi Todo                               guibg=#C4A000       guifg=#000000
:hi Underlined     gui=underline
:hi Include                                                guifg=#CC0000
:hi Define                                                 guifg=#C4A000
:hi Function                                               guifg=#06989A
:hi Structure                                              guifg=#4E9A06
:hi MatchParen     gui=bold            guibg=#5971AD       guifg=#D3D3D3
:hi CursorLine     gui=bold
:hi CursorColumn                       guibg=#00005F
:hi ColorColumn                        guibg=#00005F
:hi SpellBad       gui=underline       guibg=#000000       guifg=#75507B
:hi SpellCap       gui=underline       guibg=#000000       guifg=#75507B
:hi SpellLocal     gui=underline       guibg=#000000       guifg=#75507B
:hi SpellRare      gui=underline       guibg=#000000       guifg=#75507B
:hi TrailingWhitespace                 guibg=#080000
:hi ExtraWhitespace                    guibg=#CC0000
:hi WarningMsg                                             guifg=#CC0000
:hi ErrorMsg       gui=bold            guibg=#CC0000       guifg=#D3D3D3
:hi Error          gui=bold            guibg=#CC0000       guifg=#D3D3D3
" -------
"256 color .Xdefaults vim: cterm giu
"<https://vim.wikia.com/wiki/Xterm256_color_names_for_console_Vim>
"<https://guns.github.com/xterm-color-table.vim/images/xterm-color-table-with-visible-rgb.png>
" -------
" 256 color .Xdefaults vim: cterm giu def
" -------
"      16 color     standard     altered 256     altered beyond 256
" black/dark grey
"        0        [ 0:#000000]                   #000000
"        8        [ 8:#808080]   [59:#5F5F5F]    #555555
" red
"        1        [ 1:#800000]   160:#DF0000     #CC0000
"        9        [ 9:#FF0000]                   #EF2929
" green
"        2        [ 2:#008000]   112:#87DF00     #4E9A06
"       10        [10:#00FF00]   154:#AFFF00     #8AE234
" yellow/orange
"        3        [ 3:#808000]   178:#DFAF00     #C4A000
"       11        [11:#FFFF00]   184:#DFDF00     #FC9E4F
" blue
"        4        [ 4:#000080]    24:#005F87     #5971AD
"       12        [12:#0000FF]    73:#5FAFAF     #729FCF
" magenta
"        5        [ 5:#800080]    90:#870087     #75507B
"       13        [13:#FF00FF]   126:#AF0087     #AD7FA8
" cyan
"        6        [ 6:#008080]    37:#00AFAF     #06989A
"       14        [14:#00FFFF]    87:#5FFFFF     #34E2E2
" white
"        7        [ 7:#C0C0C0]                   #D3D3D3
"       15        [15:#FFFFFF]                   #EEEEEE
" --------
" .Xdefaults (rxvt urxvt setting beyond 256 colors, vim colorscheme "def" gui settings)
" (vim colorscheme "def" cterm matches "def" gui if .Xdefaults set thus)
" --------
" ! black
" Rxvt.color0  : #000000
" Rxvt.color8  : #555555
" ! red
" Rxvt.color1  : #CC0000
" Rxvt.color9  : #EF2929
" ! green
" Rxvt.color2  : #4E9A06
" Rxvt.color10 : #8AE234
" ! yellow
" Rxvt.color3  : #C4A000
" Rxvt.color11 : #FCE94F
" ! blue
" Rxvt.color4  : #5971AD
" Rxvt.color12 : #729FCF
" ! magenta
" Rxvt.color5  : #75507B
" Rxvt.color13 : #AD7FA8
" ! cyan
" Rxvt.color6  : #06989A
" Rxvt.color14 : #34E2E2
" ! white
" Rxvt.color7  : #D3D7CF
" Rxvt.color15 : #EEEEEE
" --------
" .Xdefaults 256 (rxvt urxvt setting, vim colorscheme "def256" cterm & gui settings)
" (vim colorscheme "def" cterm matches "def256" if .Xdefaults set thus)
" --------
" ! black
" Rxvt.color0  : #000000
" Rxvt.color8  : #808080
" ! red
" Rxvt.color1  : #DF0000
" Rxvt.color9  : #FF0000
" ! green
" Rxvt.color2  : #87DF00
" Rxvt.color10 : #AFFF00
" ! yellow
" Rxvt.color3  : #DFAF00
" Rxvt.color11 : #FFFF00
" ! blue
" Rxvt.color4  : #5F87DF
" Rxvt.color12 : #87DFFF
" ! magenta
" Rxvt.color5  : #8700DF
" Rxvt.color13 : #87DFFF
" ! cyan
" Rxvt.color6  : #00DFDF
" Rxvt.color14 : #5F5FDF
" ! white
" Rxvt.color7  : #C0C0C0
" Rxvt.color15 : #FFFFFF
#+END_SRC

*** frugal-cterm.vim

#+HEADER: :tangle "../sundry/misc/editor-syntax-etc/vim/colors/frugal-cterm-sisu.vim"
#+BEGIN_SRC text
" Vim color file
" Name:            frugal-cterm-sisu
" Maintainer:      Ralph Amissah <ralph@amissah.com>
" Last Change:     2013-02-09
" URL:             <https://git.sisudoc.org/projects/?p=software/spine.git;a=blob;f=data/sisu/conf/editor-syntax-etc/vim/colors/frugal-cterm-sisu.vim;hb=HEAD>
" Note:            8 color cterm, related colorschemes 8 & sparse
:set background=dark
:hi clear
if exists("syntax_on")
  syntax reset
endif
:let colors_name = "frugal-cterm-sisu"
" 0 = black, 1 = red, 2 = green, 3 = yellow/orange, 4 = blue, 5 = magenta, 6 = cyan, 7 = white
:hi Normal                             ctermbg=0           ctermfg=7
:hi Cursor         cterm=reverse
:hi lCursor        cterm=reverse
:hi StatusLine     cterm=bold,reverse
:hi StatusLineNC   cterm=reverse
:hi Search         cterm=none          ctermbg=2           ctermfg=0
:hi IncSearch      cterm=bold          ctermbg=2           ctermfg=7
:hi SpecialKey                                             ctermfg=4
:hi Visual         cterm=reverse
:hi VisualNOS      cterm=bold,underline
:hi MoreMsg                                                ctermfg=2
:hi ModeMsg        cterm=bold
:hi Question                                               ctermfg=2
:hi Title          cterm=bold                              ctermfg=3
:hi NonText        cterm=bold                              ctermfg=4
:hi LineNr         cterm=bold          ctermbg=0           ctermfg=0*
:hi Directory                                              ctermfg=4
:hi WildMenu                           ctermbg=3           ctermfg=0
:hi VertSplit      cterm=reverse
:hi Folded         cterm=none          ctermbg=0           ctermfg=7
:hi FoldColumn                         ctermbg=7           ctermfg=4
:hi DiffChange     cterm=none          ctermbg=7           ctermfg=0
:hi DiffText       cterm=none          ctermbg=6           ctermfg=0
:hi DiffAdd        cterm=none          ctermbg=2           ctermfg=0
:hi DiffDelete     cterm=none          ctermbg=7           ctermfg=0
:hi String         cterm=none                              ctermfg=3
:hi Comment        cterm=none          ctermbg=0           ctermfg=7
:hi Constant                                               ctermfg=1
:hi Special                                                ctermfg=6
:hi Identifier                                             ctermfg=6
:hi Statement                                              ctermfg=6
:hi Operator                                               ctermfg=1
:hi PreProc                            ctermbg=7           ctermfg=1
:hi Type                                                   ctermfg=2
:hi Delimiter      cterm=none                              ctermfg=1
:hi Ignore         cterm=bold                              ctermfg=7
:hi Todo                               ctermbg=3           ctermfg=0
:hi Underlined     cterm=underline
:hi Include                                                ctermfg=1
:hi Define                                                 ctermfg=3
:hi Function                                               ctermfg=6
:hi Structure                                              ctermfg=2
:hi MatchParen     cterm=bold          ctermbg=4           ctermfg=7
:hi CursorLine     cterm=bold,underline
:hi CursorColumn   cterm=bold
:hi ColorColumn                        ctermbg=8
:hi SpellBad       cterm=none          ctermbg=7           ctermfg=0
:hi SpellCap       cterm=none          ctermbg=7           ctermfg=0
:hi SpellLocal     cterm=none          ctermbg=7           ctermfg=0
:hi SpellRare      cterm=none          ctermbg=7           ctermfg=0
:hi WarningMsg                                             ctermfg=1
:hi ErrorMsg       cterm=bold          ctermbg=1           ctermfg=7
:hi Error          cterm=bold          ctermbg=1           ctermfg=7
#+END_SRC

** ftplugin sisu.vim

#+HEADER: :tangle "../sundry/misc/editor-syntax-etc/vim/ftplugin/sisu.vim"
#+BEGIN_SRC text
"%% SiSU Vim ftplugin
" SiSU Maintainer: Ralph Amissah <ralph@amissah.com>
" SiSU Markup:     SiSU (sisu-3.3) 2012-08-18
" an ftplugin setting defaults for editing sisu markup files
:syntax on
:filetype off
":filetype on
:filetype indent on
:autocmd FileType sisu :set nonumber
:set encoding=utf-8 fileencodings=
:set ff=unix
:set autowrite          " Automatically save before commands like :next and :make
:set nocompatible
:set tabstop=2
:set expandtab
:set shiftwidth=2
:set autoindent
:set showcmd            " Show (partial) command in status line.
:set showmatch          " Show matching brackets.
:set ignorecase         " Do case insensitive matching
:set smartcase
:set incsearch
:set hlsearch
:set gdefault
:set guioptions=agr     " add 'm' for menu
:map <silent> <C-m> :if &guioptions =~# 'm' <Bar>
    \set guioptions-=m <Bar>
    \set guioptions-=T <Bar>
  \else <Bar>
    \set guioptions+=m <Bar>
    \set guioptions-=T <Bar>
  \endif<CR>
:set paste
""% statusline
"set statusline=                                  "
"set fillchars=stl:―,stlnc:—,vert:│,fold:۰,diff:·
"" [ buffer number ]
"set statusline +=%#Normal#[                      "
"set statusline +=%#Identifier#%n                 " buffer number
"set statusline +=%#PreProc#%M                    " modified flag
"set statusline +=%#Normal#]                      "
"" [ file name (& modified?) ]
"set statusline +=%#Normal#\ [                    "
"set statusline +=%#Statement#%<%F%*              " full path
""set statusline +=%#Statement#%<%t               " full path
"set statusline +=%#PreProc#%M                    " modified flag
"set statusline +=%#Normal#]                      "
"" [ column : line number / number of lines in file, percentage of file ] [%v:%l/%L\ %p%%]
"set statusline +=%#Normal#\ [                    "
"set statusline +=%#Identifier#%v                 " column & line
"set statusline +=%#Normal#:                      "
"set statusline +=%#Identifier#%l                 " column & line
"set statusline +=%#SpecialKey#/%L\               " total lines
"set statusline +=%#Identifier#%p                 " percentage of file
"set statusline +=%#SpecialKey#%%                 "
"set statusline +=%#Normal#]     "                "
"" [ file format : file type ]
"set statusline +=%#Normal#\ [                    "
"set statusline +=%#SpecialKey#%{&fenc}           " file format
"set statusline +=%#Normal#:                      "
"set statusline +=%#SpecialKey#%{&ff}             " file format
"set statusline +=%#Normal#:                      "
"set statusline +=%#SpecialKey#%y                 " file type
"set statusline +=%#Normal#]                      "
"" [ character under cursor ]
"set statusline +=%#Normal#\ [                    "
"set statusline +=%#String#0x%04B                 " character under cursor
"set statusline +=%#Normal#]\                     "
"" [ syntastic ]
"set statusline +=%#warningmsg#
"set statusline +=%{SyntasticStatuslineFlag()}\   "
""set statusline+=%*
""  Status line background
"set statusline +=%#Folded#\                  "
"" misc
"set laststatus=2                                 " status line always on
"% textwrap
:set whichwrap=<,>,h,l,[,]
:set nolinebreak        " only affects display not buffer
:set wrap
:set wrapmargin=0
"% map
":let mapleader = ","    " consider
:map <leader>paste :set invpaste<cr>
"% wrap/formatting paragraph according to the current 'textwidth' with ^\ (control-\):
:imap <C-\> <C-O>gqap
:nmap <C-\>      gqap
:vmap <C-\>      gq
"% save file, go to next file in buffer
:map <leader>nf :w <enter> :n <enter>
"% vimdiff q exits
:if &diff
:  cmap q qa
:endif
"% directory files, placed in vertical split window
:map <leader>ls :vs<cr> :Explore<cr>
:map <leader>dir :vs<cr> :Explore<cr>
"% remapping lines make cursor jump a line at a time within wrapped text
:nnoremap j gj
:nnoremap k gk
:vnoremap j gj
:vnoremap k gk
:nnoremap <Down> gj
:nnoremap <Up> gk
:vnoremap <Down> gj
:vnoremap <Up> gk
:inoremap <Down> <C-o>gj
:inoremap  <Up> <C-o>gk
"% search and replace
:map <leader>rd :.,$s///c "search and replace down
:map <leader>rg :%s///c "search and replace whole file
:map <leader>rr :rubyd gsub!(//,"")
"% pwd t64 working directory set to that of the file you're editing
"changes pwd to directory of file in current buffer
:function! CHANGE_CURR_DIR()
:  let _dir = expand("%:p:h")
:    exec "cd " . _dir
:    unlet _dir
:endfunction
"% Change to the directory the file in your current buffer is in
:if has("autocmd")
   autocmd BufEnter * :lcd %:p:h
:endif
"% autocompletefilenames To search for files in the current directory
:set path=,,
"auto-completion for file to edit in current dir, used in normal mode
:map <leader>e :e <c-r>=expand("%:p:h") . "/" <cr>
:map <leader>pwd :exe 'cd ' . expand ("%:p:h")<cr>
"% searchhighlight t93: Toggle search highlight <C-n>
:function! ToggleHLSearched()
:  if &hls
:    set nohls
:  else
:    set hls
:  endif
:endfun
:nmap <silent> <C-n> :silent call ToggleHLSearched()<cr>
"%% SiSU vim folds
"% foldsearchx FoldSearch (opens result of search all else closed) t77
:map <leader>fs :set foldmethod=expr foldcolumn=2 foldlevel=0 <cr>
:map <leader>ff :F<cr>
:map <leader>fe :F<cr> zE
"% foldtoggle Fold Toggle mapped to <space>
:fun! ToggleFold()
:  if foldlevel('.') == 0
:    normal! l
:  else
:    if foldclosed('.') < 0
:      foldclose
:    else
:      foldopen
:    endif
:  endif
"  Clear status line
:  echo
:endfun
" Map this function to Space key.
:noremap <space> :call ToggleFold()<cr>
"% foldtype Fold? set foldtext
:set foldtext=v:folddashes.substitute(getline(v:foldstart),'\\=','','g',)
:set foldexpr=getline(v:lnum-1)!~@/&&getline(v:lnum)!~@/&&getline(v:lnum+1)!~@/
"% foldsearch t77: Fold on search result
:function! FoldMake(search)
:  set fdm=manual
:  normal zE
:  normal G$
:  let folded = 0     "flag to set when a fold is found
:  let flags = "w"    "allow wrapping in the search
:  let line1 =  0     "set marker for beginning of fold
:  while search(a:search, flags) > 0
:    let  line2 = line(".")
:      if (line2 -1 > line1)
:        "echo line1 . ":" . (line2-1)
:        "echo "a fold goes here."
:        execute ":" . line1 . "," . (line2-1) . "fold"
:        let folded = 1       "at least one fold has been found
:     endif
:     let line1 = line2     "update marker
:     let flags = "W"       "turn off wrapping
:  endwhile
"  create the last fold which goes to the end of the file.
:  normal $G
:  let  line2 = line(".")
:  if (line2  > line1 && folded == 1)
:    execute ":". line1 . "," . line2 . "fold"
:  endif
:  normal 1G
:endfunction
"% folds Fold Patterns
:command! -nargs=+ -complete=command FMake call FoldMake(<q-args>)
:  if ( &filetype == "ruby" )
:    command! F FMake ^# ==\?\|^\s*\(\(def\|class\|module\)\s\|\(public\|protected\|private\|__END__\)\s*$\)\|\(^\s*\|\s\+\)#%\s
:    command! Fa FMake \(^# ==\?\|^\s*\(\(\(def\|class\|module\)\s\)\|\(\(public\|protected\|private\|__END__\)\(\s*$\)\)\)\)\|^[0-9]\~\|\([#%]\|^["]\)\{1,4\}\s*%\|{\({\|!!\)
:    command! FD FMake \(^# ==\?\|^\s*\(\(def\|class\|module\)\s\)\)\|^\s*\([#%"0-9]\{0,4\}\~\(%\+\s\|!!\)\|#\s\+=\+\s\+\)
:  else
"% folds :F Fold Patterns SiSU Markup :F
:    command! F FMake  ^\([1-8]\|:\?[A-C]\)\~\|\(^%\|\(^\|\s\+\)[#"]\)%\{1,2\}\(\s\|$\)\|^<<\s*|
:    command! Fa FMake ^\([1-8]\|:\?[A-C]\)\~\|\(^%\|\(^\|\s\+\)[#"]\)%\{1,2\}\(\s\|$\)\|^<<\s*|\|^\(Book\|Part\|Chapter\|Section\|Article\|BOOK\|PART\|CHAPTER\|SECTION\|ARTICLE\)\s
:    command! F0 FMake ^\(\s*0\~\|@\S\+:[+-]\?\s\+\)
:    command! FA FMake ^:\?A\~
:    command! FB FMake ^:\?[AB]\~
:    command! FC FMake ^:\?[A-C]\~
:    command! F1 FMake ^\(:\?[A-C]\|1\)\~
:    command! F2 FMake ^\(:\?[A-C]\|[12]\)\~
:    command! F3 FMake ^\(:\?[A-C]\|[1-3]\)\~
:    command! F4 FMake ^[1-4]\~
:    command! F5 FMake ^[4-5]\~
:    command! F6 FMake ^[4-6]\~
:    command! Fc FMake ^[%]\+\s\+
:  endif
"% folds Fold Patterns misc
":command! Fp FMake ^\s*[A-Za-z0-9#]
:command! Fp FMake ^\s*\S
:command! Fo FMake ^[%\"]\s*[{>]
"% linenumbering, on, relative, off
:map <Leader>nn :set <c-r>={'00':'','01':'r','10':'nor'}[&rnu.&nu]<CR>nu<CR>
"% cursorline
:map <leader>cu :if &cursorcolumn <Bar>
    \set nocursorline nocursorcolumn <Bar>
  \else <Bar>
    \set cursorline cursorcolumn <Bar>
  \endif<cr>
:map <leader>cu- :set nocursorline nocursorcolumn<cr>
:map <leader>cu+ :set cursorline cursorcolumn<cr>
#+END_SRC

** templates
*** sst.tpl

#+HEADER: :tangle "../sundry/misc/editor-syntax-etc/vim/templates/sst.tpl"
#+BEGIN_SRC text
# SiSU 8.0

title:
  main:             "#___#"
  sub:              "#___#"
  language:         "#___#"

creator:
  author:           "#___#"

date:
 :published:        "YYYY-MM-DD"

rights:
  copyright:        "#___#"
  license:          "#___#"

classify:
  topic_register:   "#___#"

make:
  breaks:           "new=:B; break=1"
#  home_button_text: "#___#"
#  footer:           "#___#"

#% -- body ---

:A~ @title @author

1~  #___#
#+END_SRC

*** ssm.tpl

#+HEADER: :tangle "../sundry/misc/editor-syntax-etc/vim/templates/ssm.tpl"
#+BEGIN_SRC text
# SiSU 8.0 master

title:
  main:             "#___#"
  sub:              "#___#"
  language:         "#___#"

creator:
  author:           "#___#"

date:
 :published:        "YYYY-MM-DD"

rights:
  copyright:        "#___#"
  license:          "#___#"

classify:
  topic_register:   "#___#"

make:
  breaks:           "new=:B; break=1"
#  home_button_text: "#___#"
#  footer:           "#___#"

#% -- body ---

:A~ @title @author

1~  #___#
#+END_SRC

*** ssm.tpl

#+HEADER: :tangle "../sundry/misc/editor-syntax-etc/vim/templates/ssi.tpl"
#+BEGIN_SRC text
# SiSU 8.0 insert

title:
  main:             "#___#"
  sub:              "#___#"
  language:         "#___#"

creator:
  author:           "#___#"

date:
 :published:        "YYYY-MM-DD"

rights:
  copyright:        "#___#"
  license:          "#___#"

classify:
  topic_register:   "#___#"

make:
  breaks:           "new=:B; break=1"
#  home_button_text: "#___#"
#  footer:           "#___#"

#% -- body ---

:A~ @title @author

1~  #___#
#+END_SRC