|
| 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