sponsor Vim development Vim logo Vim Book Ad

Colortemplate : The Toolkit for Colorscheme Designers!

 script karma  Rating 5/2, Downloaded by 244  Comments, bugs, improvements  Vim wiki

created by
Lifepillar
 
script type
ftplugin
 
description
GitHub repo: https://github.com/lifepillar/vim-colortemplate

Colortemplate is a plugin for Vim 8 that allows you to easily develop colorschemes. Its ambitious goal is to become *the* way to create new colorschemes for Vim!

Colortemplate is based on a very simple but very flexible template format. This is a minimal template:

Full name:  My Gorgeous Theme
Short name: gorgeous
Author:     Me <me@somewhere.org>
Maintainer: Me <me@somewhere.org>

Background: dark

# Color palette
Color:      black #000000 ~
Color:      white #ffffff ~

# Highlight group definitions
Normal white black
# Etc…

Use :Colortemplate to turn a template into a full-fledged colorscheme. For example:

:Colortemplate ~/.vim

will translate your template and write your new shining colorscheme into ~/.vim/colors/gorgeous.vim, ready to be used!

If you want to get a flavor of how Colortemplate can be used in the real world, take a look at:

https://github.com/lifepillar/vim-gruvbox8
https://github.com/lifepillar/vim-solarized8

Main Features:

- Generates colorschemes that support true colors and 256 colors by default.
- Generates colorschemes that load efficiently and have a consistent structure following best practices.
- Detects a few common mistakes, e.g., missing highlight group definitions.
- Supports generating any number of auxiliary files (say, autoload/gorgeous.vim).
- Much more! To get started, see :help ft-colortemplate.

Besides, Colortemplate has a few functions to help you develop your colorscheme, in particular functions to find the best 256-color approximations for GUI colors and to display information about the highlight group under the cursor.

The discussion that prompted the creation of this script: https://github.com/vim/vim/issues/1665
 
install details
 

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
vim-colortemplate-1.3.0.tar.gz 1.3.0 2018-08-05 8.0 Lifepillar Output a statistics tab when compiling a template, with useful information about your colorscheme (contrast ratio, color difference, brightness difference, GUI/terminal differences). Create colorschemes that transparently fallback to using 16 colors when t_Co < 256. Many other minor changes.
vim-colortemplate-1.2.2.tar.gz 1.2.2 2018-03-04 8.0 Lifepillar Enable completion of Colortemplate keywords. Add syntax highlighting for debugPC and debugBreakpoint. Minor updates to the documentation.
vim-colortemplate-1.2.1.tar.gz 1.2.1 2018-01-23 8.0 Lifepillar A few bug fixes, especially a couple related to the Include: directive. Clean up the templates folder.
vim-colortemplate-1.2.0.tar.gz 1.2.0 2018-01-21 7.0 Lifepillar Lots of small (and not so small) fixes! Improved documentation. Add Palette directive to include generated palettes. New functions to generate Vimspectr color palettes. Making top notch colorschemes has never been easier!
vim-colortemplate-1.1.1.tar.gz 1.1.1 2017-11-11 8.0 Lifepillar Lots of new goodies! "Include" directive to import files; "auxfile" blocks to generate additional files (e.g., in autoload); warnings for undefined basic highlight groups; more and stricter checks; improved documentation (with new Best practices section!). There are some backward incompatible changes wrt v1.0.0: please see the help file.
vim-colortemplate-1.0.0.tar.gz 1.0.0 2017-10-28 8.0 Lifepillar The toolkit for colorschemes developers!
Lots of new features and bug fixes: new parser; better error handling; generate colorschemes supporting 16 colors, 256 colors and true colors, with dark and/or light background; infer the best approximate colors automatically using DeltaE*; embed the documentation directly in the template; new information fields and interpolation possibilities; utility function to explore approximated colors; toggle the display of details about the highlight group under the cursor; tests added.
vim-colortemplate-0.0.2.tar.gz v0.0.2 2017-10-01 8.0 Lifepillar Bug fixes in error handling.
vim-colortemplate-0.0.1.tar.gz 0.0.1 2017-10-01 8.0 Lifepillar Initial upload
ip used for rating: 54.82.10.219

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.
   
OSDN.net Logo