Skip to content

Commit 52318f1

Browse files
committed
+doc
1 parent 25b6923 commit 52318f1

File tree

1 file changed

+62
-0
lines changed

1 file changed

+62
-0
lines changed

doc/csscomb.txt

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
*csscomb.txt* CSScomb for Vim
2+
3+
Vim plugin author: Aleksandr Batsuev <batsuev@gmail.com>
4+
CSScomb author: Vyacheslav Oliyancuk <miripiruni@gmail.com>
5+
WebSite: http://csscomb.com
6+
Repository: http://github.com/miripiruni/CSScomb-for-Vim
7+
8+
==============================================================================
9+
CONTENTS *csscomb-contents*
10+
11+
About |csscomb-about|
12+
Custom sort order |csscomb-custom-sort-order|
13+
Install |csscomb-install|
14+
15+
==============================================================================
16+
ABOUT *csscomb-about*
17+
18+
The algorithm of CSScomb simulates web-technologist's actions upon working
19+
with CSS-code to the limit. Usually to re-order code you move lines over each
20+
other considering comments in the code, multilines records of property values,
21+
khaki and everything that could be found in the real file. CSScomb reproduces
22+
these actions for you. This means that the parser "thinks" as a person editing
23+
the text, not as a blind robot parsing CSS.
24+
25+
What can CSScomb do?
26+
27+
* Sorts CSS-properties within the selectors according to the settings.
28+
29+
* Treats the initial formatting of style sheets carefully.
30+
31+
* Sorts commented properties as if they are not commented.
32+
33+
* Moves down unknown properties in the order they are met within the selector.
34+
E.g.: he\ight: 100% and similar will be taken as the unknown ones.
35+
36+
* Successfully parses @media ... {...} and any other constructions with @.
37+
38+
* Successfully parses expressions and then moves them to the end of the
39+
properties in the order they are met within the framework of properties of
40+
one selector.
41+
42+
==============================================================================
43+
CUSTOM SORT ORDER *csscomb-custom-sort-order*
44+
45+
For adjusting plugins use one-dimensional and two-dimensional JSON arrays.
46+
In case of two-dimensional arrays the properties will be divided into groups
47+
with an empty line. In plugins you should pick open file csscomb.php
48+
49+
==============================================================================
50+
INSTALL *csscomb-install*
51+
52+
With Pathogen
53+
cd ~/.vim/bundle
54+
git clone https://github.com/miripiruni/csscomb-for-vim.git
55+
56+
With Vundle
57+
Add to .vimrc: Bundle 'git://github.com/miripiruni/csscomb-for-vim.git'
58+
59+
Manual without plugins manager
60+
git clone https://github.com/miripiruni/csscomb-for-vim.git
61+
cp csscomb-vim/plugin/* ~/.vim/plugin/
62+

0 commit comments

Comments
 (0)