Files
vim-css3-syntax/README.md
2023-01-09 12:12:54 +09:00

89 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
vim-css3-syntax
===============
CSS3 syntax (and syntax defined in some foreign specifications) support for
[Vim][1]s built-in `syntax/css.vim`
COMPATIBILITY
-------------
This syntax files are compatible with the default runtime files that come with
**Vim 9.0 or higher**. If you still use Vim 8.x or lower, you must:
- Copy [latest CSS syntax file][2] to your `~/.vim/` directory (recommended)
- Update runtime files
- Use [older version][3]
- Switch to [`vim80` branch][4]
INSTALLATION
------------
### Vim package
$ mkdir -p ~/.vim/pack/css3-syntax/start
$ cd ~/.vim/pack/css3-syntax/start
$ git clone https://github.com/hail2u/vim-css3-syntax.git
### pathogen.vim
$ cd ~/.vim/bundle
$ git clone https://github.com/hail2u/vim-css3-syntax.git
### Manual
Download `vim-css3-syntax.tar.gz` from GitHub, extract it, and copy the contents
to your `~/.vim` directory.
NOTES
-----
### 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.4s 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).
### Media Queries
I drop Media Queries Level 3 support in v0.12.0. There is no easy way to support
Media Queries properly with `after` syntax plugin like this one, sorry. If you
want to highlight Media Queries correctly, you must update Vim to 8.0+.
AUTHOR
------
Kyo Nagashima <hail2u@gmail.com> (https://hail2u.net/)
LICENSE
-------
MIT
[1]: http://www.vim.org/
[2]: https://github.com/vim/vim/blob/master/runtime/syntax/css.vim
[3]: https://github.com/hail2u/vim-css3-syntax/releases/tag/v1.10.2
[4]: https://github.com/hail2u/vim-css3-syntax/tree/vim80