vim-css3-syntax/README.md

vim-css3-syntax

Add CSS3 syntax support to Vim's built-in syntax/css.vim.

INSTALLATION

I strongly recommend to install this plugin on Vim 7.4 or higher with default runtime files.

Manual Installation

Download from GitHub, extract vim-css3-syntax.tar.gz, and copy the contents to your ~/.vim directory.

Installing with Git and pathogen

$ cd ~/.vim/bundle
$ git clone https://github.com/hail2u/vim-css3-syntax.git

NOTES

Highlighting problems on: vertical-align, box-shadow, and others

Some properties do not highlight correctly by default. This is a limitation of Vim's highlight priority mechanism. To fix this problems, put following lines in your ~/.vim/after/css.vim:

setlocal iskeyword+=-

Or in your ~/.vimrc:

augroup VimCSS3Syntax
  autocmd!

  autocmd FileType css setlocal iskeyword+=-
augroup END

This setting have side effects, so use it at your own risk.

Vendor Prefixes

I do not plan to support CSS3 properties (or functions) with vendor prefixes, such as -webkit- or -moz-, etc. These are hard to maintain because they are:

• Added frequently
• Changed unexpectedly
• Removed silently

These must be supported by separate syntax plugins (Vim 7.4's default CSS syntax file supports this). If you want to highlight prefixed properties or functions manually, :highlight and :match would help:

:highlight VendorPrefix guifg=#00ffff gui=bold
:match VendorPrefix /-\(moz\|webkit\|o\|ms\)-[a-zA-Z-]\+/

These commands highlight vendor prefixed properties and functions instantly with cyan and bold (on gVim).

CSS Preprocessors: Sass, LESS, and Stylus

vim-css3-syntax supports Sass's SCSS syntax only. If you want use this plugin with LESS, install VIM-LESS. Sass's indent synatx and Stylus are not supported.

HISTORY

v0.10

• Add CSS Display Module Level 3 features
• Move Selectors Level 4 features correctly
• Move page break values from css3-multicol.vim to css3-page.vim
• Follow spec updates
• Fix test
• Remove version checking

v0.9

• Add Compositing and Blending Level 1 features
• Add CSS Fonts Module Level 3 features
• Add CSS Speech Module features
• Add Selectors Level 4 features
• Split CSS Counter Styles Level 3 features from css3-lists.vim
• Follow spec updates
• Add missing values
• Add notes about CSS preprocessors
• Fix test
• Add version checking

v0.8

• Add CSS Masking Level 1 features
• Add CSS Shapes Module Level 1 features
• Follow spec updates
• Add missing properties
• Some minor bug fixes

v0.7

• Add CSS Conditional Rules Module Level 3 features
• Add CSS Intrinsic & Extrinsic Sizing Module Level 3 features
• Add CSS Cascading and Inheritance Level 3 features
• Add CSS Paged Media Module Level 3 features
• Add CSS Custom Properties for Cascading Variables Module Level 1 features
• Add CSS Overflow Module Level 3 features
• Seperate CSS Text Decoration Module Level 3 features
• Follow spec updates
• Bundle after/syntax/html.vim and after/syntax/scss.vim
• Some minor bug fixes

v0.6

• Add Test
• Remove deprecated CSS Grid Positioning Module
• Follow spec updates
• Some minor bug fixes

v0.5

• Add CSS Regions Module Level 3 features
• Add CSS Exclusions and Shapes Module Level 3 features
• Add CSS Grid Layout features
• Add CSS Box Alignment features
• Add gr unit
• Follow spec updates
• Some minor bug fixes

v0.4

• Add CSS Fragmentation Module Level 3 features
• Fix a problem on pseudo-class and pseudo-element names inside @media block
• Fix a problem on media type and expression
• Add CSS Values and Units Module Level 3 features
• Follow spec updates
• Some minor bug fixes

v0.3

• Add CSS3 Presentation Levels Module features
• Add CSS3 Lists Module features
• Add CSS3 Generated and Replaced Content Module features
• Add CSS Template Layout Module features
• Add CSS Image Values and Replaced Content Module Level 3 features
• Fix a problem on class names inside @media block
• Some minor bug fixes

v0.2

• Almost all CSS3 features added

v0.1

• Initial release

AUTHOR

Kyo Namegashima kyo@hail2u.net

LICENSE

MIT: http://hail2u.mit-license.org/2011