From 3b2a78935fd6550521f719a10e5b0fceb1ddb350 Mon Sep 17 00:00:00 2001 From: Raymaekers Luca Date: Wed, 15 Feb 2023 16:31:56 +0100 Subject: Not really but, First commit! --- config/old/vim/doc/Colorizer.txt | 432 +++++++++++++++++++++++++++++++++++++++ config/old/vim/doc/tags | 43 ++++ 2 files changed, 475 insertions(+) create mode 100644 config/old/vim/doc/Colorizer.txt create mode 100644 config/old/vim/doc/tags (limited to 'config/old/vim/doc') diff --git a/config/old/vim/doc/Colorizer.txt b/config/old/vim/doc/Colorizer.txt new file mode 100644 index 0000000..c235d76 --- /dev/null +++ b/config/old/vim/doc/Colorizer.txt @@ -0,0 +1,432 @@ +*Colorizer.txt* A plugin to color colornames and codes + +Author: Christian Brabandt +Version: 0.10 Thu, 27 Mar 2014 23:12:43 +0100 +Copyright: (c) 2009-2013 by Christian Brabandt + The VIM LICENSE applies to Colorizer.txt + (see |copyright|) except use ColorizerPlugin instead of "Vim". + NO WARRANTY, EXPRESS OR IMPLIED. USE AT-YOUR-OWN-RISK. + +============================================================================== +Contents *Colorizer* +============================================================================== + + 1. Colorizer Manual.............................|Colorizer-manual| + 1.1 :ColorHighlight......................|:ColorHighlight| + 1.2 :ColorClear..........................|:ColorClear| + 1.3 :RGB2Term............................|:RGB2Term| + 1.4 :HSL2RGB.............................|:HSL2RGB| + 1.5 :Term2RGB............................|:Term2RGB| + 1.6 :ColorContrast.......................|:ColorContrast| + 1.7 :ColorSwapFgBg.......................|:ColorSwapFgBg| + 1.8 :ColorToggle.........................|:ColorToggle| + 2. Configuration................................|Colorizer-config| + 2.1 Automatic loading...................|Colorizer-auto| + 2.2 Automatically highlight filetypes...|Colorizer-hl-ft| + 2.3 Skip coloring comments..............|Colorizer-comments| + 2.4 Adjust the contrast.................|Colorizer-contrast| + 2.5 Highlight colornames................|Colorizer-hl-names| + 2.6 Use X11 colornames..................|Colorizer-names| + 2.7 Use syntax highlighting.............|Colorizer-syntax| + 2.8 Specify patterns to highlight.......|Colorizer-pattern| + 2.9 Colorizing Taskwarrior files........|Colorizer-taskwarrior-files| + 2.10 Colorizing vim syntax files.........|Colorizer-vim-files| + 2.11 Use custom colornames...............|Colorizer-custom-colornames| + 2.12 Colorizing :hi statements...........|Colorizer-vim-hi| + 3. Colorizer Mappings...........................|Colorizer-maps| + 4. Colorizer Tips...............................|Colorizer-tips| + 5. Colorizer Feedback...........................|Colorizer-feedback| + 6. Colorizer History............................|Colorizer-history| + +============================================================================== +1. Colorizer Manual *Colorizer-manual* +============================================================================== + +Functionality + +This plugin is based on the css_color plugin by Nikolaus Hofer. The idea is to +highlight color names and codes in the same color that they represent. + +The plugin understands the W3C colors (used for CSS files for example), the +color names from the X11 Window System and also codes in hex notation, like +#FF0000 (which represents Red in the RGB color system). Additionally, it +supports the CSS color specifications, e.g. rgb(RR,GG,BB) color representation +in either absolute or percentage values and also the HVL color +representation like hvl(H,V,L) + +It works best in the gui version of Vim, but the plugin also supports 256 and +88 color terminals and translates the colors to those supported by the +terminal. 16 and 8 color terminals should work theoretically too, but have not +been widely tested. Note that translating the colors to the terminal might +impose a performance penalty, depending on the terminal type and the number of +matches in the file. + +This plugin defines the following commands: + + *:ColorHighlight* +:[range]ColorHighlight[!] [args] + +Scan the lines given by [range] for color code names and highlight those. If +[range] is omitted, the whole file will be scanned. If the ! is used, the +plugin will redefine all highlighting groups. If ! is not used, it will +skip patterns, that would take too long and make Vim unresponsive. + +[args] can by any of "syntax" or "match". "syntax" means to convert the +highlighting to syntax highlighting. This is useful, so a plugin like +|2html.vim| can convert the colors correctly to HTML. The default is +"match", which uses the |matchadd()| function. (Prepending "no" is +supported and will disable that setting and use the opposite). + + *:ColorClear* +:ColorClear Turn off color highlighting. + + *:RGB2Term* +:RGB2Term Translate the color code given as argument to + the closest color that can be displayed in the + terminal. The color must be given in the + format #RRGGBB (the hex format of the colors red, + green and blue (the '#' is optional), or + alternatively like rgb(X,X,X) + + Uses the number of colors your terminal is capable + of (or 256 colors for gVim). + + *:HSL2RGB* +:HSL2RGB hsl(h,v,l) Translate the HVL color defined by the string + 'hsl(h,v%,l%)' into a color that the current + terminal can display. Note that the color must be + given in the format 'hsl(HH, V, L)' where HH + defines the Hue as absolute value between 0 and + 255 and V and L represent a percentage for value + and Lightness. + + *:Term2RGB* +:Term2RGB number Translate terminal color to an RGB color + (using the xterm 256 color cube). + + *:ColorContrast* +:ColorContrast Switch between all different color contrast + settings (foreground colors). + *:ColorSwapFgBg* +:ColorSwapFgBg Switch between foreground and background colors. + This will toggle in 3 ways. From Swapping + foreground and background colors, to only + highlighting the foreground color back to normal + foreground background color. + + *:ColorToggle* +:ColorToggle Switch between highlighting colors and no + highlighting. + +============================================================================== +2 Colorizer Configuration *Colorizer-config* +============================================================================== + +2.1 Automatic loading *Colorizer-auto* +--------------------- + +The Colorizer plugin can be configured to automatically load when opening a +new file. Note that this might slow down the loading process, especially on +the terminal. To enable this, simply set the variable 'g:colorizer_auto_color' +to 1, e.g. by defining it in your |.vimrc| > + + :let g:colorizer_auto_color = 1 +< +(Not recommended, see below at |Colorizer-hl-ft| for the preferred way) + +2.2 Automatically highlight filetypes *Colorizer-hl-ft* +------------------------------------- + +If you want to have certain filetypes automatically highlighted, you can use +the variable g:colorizer_auto_filetype, e.g. to enable highlighting for +HTML and CSS files by default, add the following to your |.vimrc|: > + + :let g:colorizer_auto_filetype='css,html' +< +After restarting Vim, the plugin will become active whenever the filetype is +set to either html or css. + +2.3 Skip coloring comments *Colorizer-comments* +-------------------------- + +You can skip comments from being colored by setting the variable +g:colorizer_skip_comments to 1: > + + :let g:colorizer_skip_comments = 1 +< +The plugin will skip all matches of color codes and names that appear inside +comments (this only works when syntax highlighting is enabled |:syn-on|) + +Note however, that if the same color is used inside comments and outside +comments, it will also be highlighted inside the comments, because +coloring is done matching only the color pattern and once this is done outside +of comments, this will also match inside comments. + +2.4 Adjust the contrast *Colorizer-contrast* +----------------------- + +Colorizer can be adjusted to blur the contrast between foreground and +background color. For this, the variable 'g:colorizer_fgcontrast' can be used. +It can be given any value between -1 and 2 with 2 being the default. Each +smaller value will decrease the contrast a little bit, with -1 being special, +as there is the foreground color equals the background color. Use +|:ColorContrast| to cycle through the different values. + +2.5 Highlight colornames *Colorizer-hl-names* +------------------------ + +If for any reason you don't want the plugin to highlight colornames, you can +prevent this by setting the g:colorizer_colornames variable to 0, e.g. put > + + :let g:colorizer_colornames = 0 +< +into your |.vimrc| + +2.6 Use X11 colornames *Colorizer-names* +---------------------- + +Colorizer can be configured to support all color names defined by the X11 +Window System. By default it only supports the colors defined by the W3C for +the CSS specification. To use the X11 color names, set the variable +'g:colorzer_x11_names' to 1, e,g. put in your |.vimrc| > + + let g:colorizer_x11_names = 1 +< + +2.7 Use syntax highlighting *Colorizer-syntax* +--------------------------- + +The plugin by default uses the |matchadd()| functions for highlighting colors +on the fly. Unfortunately, this is a problem, if you want to have the result +successfully transformed to a HTML file using the |2html.vim| plugin. Therefore, +the Colorizer plugin can also convert the highlighting to correct syntax +highlighting. Use either the > + + :ColorHighlight syntax +< +command (see |:ColorHighlight|) or set the variable 'g:colorizer_syntax' to 1, +e.g. in your |.vimrc| put > + + let g:colorizer_syntax = 1 +< + +2.8 Specify pattern to highlight *Colorizer-pattern* +-------------------------------- + +By default, Colorizer detects the following patterns and highlights them as +hex colors (for better readability it is separated into 3 parts): > + + # %(\x\{3}\|\x\{6}\) \%(\>\|[-_]\)\@=/' +< + +This means it always looks for a '#' followed by either a 3 or 6 hexadecimal +digits denoting the RGB hex color codes, followed by either the word-boundary +(|/\>|), a hyphen or a underscore. But only the first and middle part will be +highlighted (i.e. the RGB color codes). + +You can of course specify a different pattern for your needs by setting the +g:colorizer_hex_pattern variable. e.g. to display '#RRGGBB' and have all of it +highlighted, use > + + let g:colorizer_hex_pattern = ['#', '\%(\x\{3}\|\x\{6}\)', ''] + +2.9 Colorizing Taskwarrior files *Colorizer-taskwarrior-files* +-------------------------------- + +For taskwarrior files, this plugin can also highlight those colors. By +default, this will only work, if the file name ends with '.theme' + +For an example, see this website: +http://taskwarrior.org/news/182 + +2.10 Colorizing vim syntax files *Colorizer-vim-files* +-------------------------------- + +Colorizer also supports highlighting vim syntax files. For this to work, the +'filetype' must be set to vim, then the plugin tries to identify the colors +and highlight them. + +2.11 Use custom colornames *Colorizer-custom-colornames* +-------------------------- + +You can add separate colornames to be colored. For this to work, set the +variable g:colorizer_custom_colors to your liking, e.g. like this: > + + let g:colorizer_custom_colors = { 'blue': '#ff0000'} + +Guess what, this will color the word blue in red. + +2.12 Colorizing :highlight statements *Colorizer-vim-hi* +------------------------------------- + +Colorizer also supports highlighting |:hi| statements, that are used by vim +colorschemes and syntax files as well as a dump of the |:hi| command +To colorizer :hi statements, the 'filetype' must be set to vim, while for :hi +dumps, the 'filetype' must be empty. + +============================================================================== +3. Colorizer Mappings *Colorizer-maps* +============================================================================== + +By default, the Colorizer plugin does not map any key, so that it won't +pollute the global mapping namespace. If you want however to have the +following default maps set up, set the global variable g:colorizer_auto_map +in your |.vimrc| like this: > + + :let g:colorizer_auto_map = 1 + +< +This will set up the following key mappings (if they are not already taken): + +Keys Name Function +---- ---- -------- +cC Colorizer Toggle highlighting of Colors. In visual + mode it only highlights the colors in the + selected region (normal and visual mode). +cT ColorContrast Cycle through contrast setting + |:ColorContrast| (normal and visual mode) +cF ColorFgBg Toggle foreground and background color + |:ColorSwapFgBg| + +It uses the prefix c to set all functionality up. By default, +is defined as '\' (||). Use the name provided in the second column to +map the function to a different key. + +============================================================================== +4. Colorizer Tips *Colorizer-tips* +============================================================================== + +You can enable the plugin to be loaded for certain filetypes automatically. +This makes sense for example for CSS files or HTML files. To do so, create the +following autocommand in your |.vimrc| > + + :au BufNewFile,BufRead *.css,*.html,*.htm :ColorHighlight! +< + +This will automatically highlight all existing color codes and names if you +edit either a HTML file or a CSS file. Note that this does not update the +highlighting, after you have been changing the file. + +The recommended way to do this is to use the g:colorizer_auto_filetype +variable and set this to the desired filetypes. |Colorizer-hl-ft| + +============================================================================== +5. Colorizer Feedback *Colorizer-feedback* +============================================================================== + +Feedback is always welcome. If you like the plugin, please rate it at the +vim-page: http://www.vim.org/scripts/script.php?script_id=3963 + +You can also follow the development of the plugin at github: +http://github.com/chrisbra/color_highlight + +Bugs can also be reported there: +https://github.com/chrisbra/color_highlight/issues + +Alternatively, you can also report any bugs to the maintainer, mentioned in +the third line of this document. Please don't hesitate to contact me, I +won't bite ;) + +If you like the plugin, write me an email (look in the third line for my mail +address). And if you are really happy, vote for the plugin and consider +looking at my Amazon whishlist: http://www.amazon.de/wishlist/2BKAHE8J7Z6UW + +============================================================================== +6. Colorizer History *Colorizer-history* +============================================================================== + +0.10 Mar 27, 2014 {{{1 +- Also highlight Ansi Term sequences +- Match colornames using the "old" RE Engine, if Vim supports it. +- Make |:RGB2Xterm| output the color name in its color +- Rename |:RGB2Xterm| to |:RGB2Term| +- Highlight Taskwarrior file +- Code refactoring +- Make |:ColorSwapFgBg| work as expected (did not always toggle reliably + between all states) +- Correctly parse Ansi Term colors +- |:Term2RGB| +- Highlight Vim color files correctly +- merge colorhighlight plugin https://github.com/blueyed/colorhighlight.vim + +0.9: Aug 14, 2013: {{{1 +- https://github.com/chrisbra/color_highlight/issues/15 (rgba highlighting + didn't work for floating point value of alpha, reported by LiTuX.S, thanks!) +- https://github.com/chrisbra/color_highlight/issues/16 (rgb() pattern did + match too much, reported by taecilla, thanks!) +- https://github.com/chrisbra/color_highlight/issues/19 (error on calling + ColorWinEnter() command, reported by wedgwood, thanks!) +- https://github.com/chrisbra/color_highlight/issues/20 and + https://github.com/chrisbra/color_highlight/issues/21 + (also color on split commands, reported by wedgwood and Andri Möll, Thanks!) +- https://github.com/chrisbra/color_highlight/issues/22 (Make sure, patterns + like white-space won't get colored, reported by Andri Möll, Thanks!) +- https://github.com/chrisbra/color_highlight/issues/23 (ColorToggle got + confused when several windows with highlighting exists, reported by Andri + Möll, Thanks!) +- https://github.com/chrisbra/color_highlight/issues/24 (turning off coloring + should also remove the autocommands, reported by Andri Möll, Thanks!) + +0.8: Dec 14, 2012 {{{1 +- https://github.com/chrisbra/color_highlight/issues/13 (colorizing should not + stop at word-boundaries, reported by teschmitz, thanks!) +- https://github.com/chrisbra/color_highlight/issues/14 (convert highlighting + to syntax groups, so TOhtml works, reported by teschmitz, thanks!) + +0.7: Jul 25, 2012 {{{1 +- Highlight rgb colors with whitespace after comma (reported by sergey-vlasov + in https://github.com/chrisbra/color_highlight/issues/12, thanks!) +- Save and restore the search register, so the plugin doesn't clobber it +- check for 'ed' and 'gd' defaults + +0.6: May 17, 2012 {{{1 +- Fix various issues with hsl coloring (reported by teschmitz in + https://github.com/chrisbra/color_highlight/issues/9, thanks!) +- Make it possible, to skip coloring comments (reported by teschmitz in + https://github.com/chrisbra/color_highlight/issues/10, thanks!) +- search highlighting should overrule color highlighting(reported by teschmitz + in https://github.com/chrisbra/color_highlight/issues/11, thanks!) +- updated documentation (suggested by teschmitz, thanks!) + +0.5: Apr 03, 2012 {{{1 +- Fix issue 7 (reported by teschmitz in + https://github.com/chrisbra/color_highlight/issues/7, thanks!) +0.4: Mar, 23, 2012 {{{1 +- |:ColorSwapFgBg| (suggested by teschmitz, in + https://github.com/chrisbra/color_highlight/issues/3, thanks!) +- make automatic color loading work (reported by wedgwood in + https://github.com/chrisbra/color_highlight/issues/6, thanks!) + |Colorizer-auto| and |Colorizer-hl-ft| +- more documentation updates +- added Mappings (suggested by Ingo Karkat, thanks!) |Colorizer-maps| +- prevent highlighting of color names (suggested by Tarlika Schmitz in + https://github.com/chrisbra/color_highlight/issues/5, thanks!) + |Colorizer-hl-names| +- enable filetype specific autocommands, so that for certain filetypes + colors are highlighted automatically |Colorizer-hl-ft| + (suggested by Tarlika Schmitz, thanks!) + +0.3: Mar 15, 2012 {{{1 +- Use the g:colorizer_fgcontrast variable to have lesser contrast between + foreground and background colors (patch by Ingo Karkat, thanks!) +- gvim did not color rgb(...) codes +- did not correctly highlight 3 letter color codes (issue + https://github.com/chrisbra/color_highlight/issues/1, + reported by Taybin Rutkin, thanks!) +- support autoloading (requested by Ingo Karkat, thanks!) +- add |GLVS| support +- |:ColorContrast| to interactively switch between contrast settings + (suggested by Ingo Karkat, thanks!) +0.2: Mar 02, 2012 {{{1 + +- Initial upload +- development versions are available at the github repository +- put plugin on a public repository + (http://github.com/chrisbra/color_highlight) + +0.1: Mar 02, 2012 {{{1 +- first internal version + }}} +============================================================================== +Modeline: +vim:tw=78:ts=8:ft=help:et:fdm=marker:fdl=0:norl diff --git a/config/old/vim/doc/tags b/config/old/vim/doc/tags new file mode 100644 index 0000000..bf72e29 --- /dev/null +++ b/config/old/vim/doc/tags @@ -0,0 +1,43 @@ +:ColorClear Colorizer.txt /*:ColorClear* +:ColorContrast Colorizer.txt /*:ColorContrast* +:ColorHighlight Colorizer.txt /*:ColorHighlight* +:ColorSwapFgBg Colorizer.txt /*:ColorSwapFgBg* +:ColorToggle Colorizer.txt /*:ColorToggle* +:HSL2RGB Colorizer.txt /*:HSL2RGB* +:RGB2Term Colorizer.txt /*:RGB2Term* +:Term2RGB Colorizer.txt /*:Term2RGB* +Colorizer Colorizer.txt /*Colorizer* +Colorizer-auto Colorizer.txt /*Colorizer-auto* +Colorizer-comments Colorizer.txt /*Colorizer-comments* +Colorizer-config Colorizer.txt /*Colorizer-config* +Colorizer-contrast Colorizer.txt /*Colorizer-contrast* +Colorizer-custom-colornames Colorizer.txt /*Colorizer-custom-colornames* +Colorizer-feedback Colorizer.txt /*Colorizer-feedback* +Colorizer-history Colorizer.txt /*Colorizer-history* +Colorizer-hl-ft Colorizer.txt /*Colorizer-hl-ft* +Colorizer-hl-names Colorizer.txt /*Colorizer-hl-names* +Colorizer-manual Colorizer.txt /*Colorizer-manual* +Colorizer-maps Colorizer.txt /*Colorizer-maps* +Colorizer-names Colorizer.txt /*Colorizer-names* +Colorizer-pattern Colorizer.txt /*Colorizer-pattern* +Colorizer-syntax Colorizer.txt /*Colorizer-syntax* +Colorizer-taskwarrior-files Colorizer.txt /*Colorizer-taskwarrior-files* +Colorizer-tips Colorizer.txt /*Colorizer-tips* +Colorizer-vim-files Colorizer.txt /*Colorizer-vim-files* +Colorizer-vim-hi Colorizer.txt /*Colorizer-vim-hi* +Colorizer.txt Colorizer.txt /*Colorizer.txt* +RelativeNumberCurrentWindow-configuration RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow-configuration* +RelativeNumberCurrentWindow-dependencies RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow-dependencies* +RelativeNumberCurrentWindow-description RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow-description* +RelativeNumberCurrentWindow-history RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow-history* +RelativeNumberCurrentWindow-ideas RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow-ideas* +RelativeNumberCurrentWindow-installation RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow-installation* +RelativeNumberCurrentWindow-known-problems RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow-known-problems* +RelativeNumberCurrentWindow-limitations RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow-limitations* +RelativeNumberCurrentWindow-todo RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow-todo* +RelativeNumberCurrentWindow-usage RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow-usage* +RelativeNumberCurrentWindow.txt RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow.txt* +RelativeNumberCurrentWindow.vim RelativeNumberCurrentWindow.txt /*RelativeNumberCurrentWindow.vim* +g:RelativeNumberCurrentWindow_OnFocus RelativeNumberCurrentWindow.txt /*g:RelativeNumberCurrentWindow_OnFocus* +g:RelativeNumberCurrentWindow_OnInsert RelativeNumberCurrentWindow.txt /*g:RelativeNumberCurrentWindow_OnInsert* +g:RelativeNumberCurrentWindow_SameNumberWidth RelativeNumberCurrentWindow.txt /*g:RelativeNumberCurrentWindow_SameNumberWidth* -- cgit v1.2.3