| CSSTIDY(1) | CSSTIDY(1) |
NAME¶
csstidy - CSS parser and optimiserSYNOPSIS¶
csstidy input-file [options] [output-file]DESCRIPTION¶
The csstidy(1) command parses and optimises a css file given as input-file. If no output-file is specified, the results are displayed to standard output. Various options allow for fine-grained control over the level of readability, file size and other items.EXAMPLES¶
To optimise a CSS file and send the output to screen use:csstidy mycssfile.css
If you want to save the output to a file, use:
csstidy mycssfile.css myoutputfile.css
If you want to use an option[s] and output to a file, use:
csstidy mycssfile.css --lowercase_s=true
myoutputfile.css
OPTIONS¶
--allow_html_in_templates=[false|true]default = false
--case_properties=[false|true]
Case for properties. Default = false.
--compress_colors=[true|false]
If set to true, csstidy will optimize color
value by trying to save bytes (i.e. black becomes #000). Default = true.
--compress_font-weight=[true|false]
If set to true, csstidy will optimize font
value by trying to save bytes (i.e. normal becomes 400). Default = true.
--discard_invalid_properties=[false|true]
If set to true, csstidy will remove invalid
properties. In a sense this is like validation, except you get no warnings
unless you study the output. As an example, if you misspelled the property
"width" as "with", that property will simply be removed.
Default = false.
--lowercase_s=[false|true]
If set to true, all uppercase selectors (i.e.
A, P, SPAN) will be rewritten in lowercase. Default = false.
--preserve_css=[false|true]
All comments and most browser specific hacks
will be removed if this is set to false. Setting this to true will preserve
browser specific hacks. Default = false.
--remove_bslash=[true|false]
Remove unnecessary backslashes. This may or
may not be desirable depending upon whether you have used backslashes to
accomodate browsers that do not comply with w3c standards. Default =
true.
--remove_last_;=[false|true]
Default = false.
--silent=[false|true]
When set to true, csstidy will not output
information about the optimizations preformed. Default = false.
--sort_properties=[false|true]
Sorts properties (i.e. background, color,
width) of selectors. Default = false.
--sort_selectors=[false|true]
Sorts selectors. Use this with caution, as it
will totally rearrange any sense of layout in your file that you may have
written into it, and css is sensitive to order. Sorts in order of ID's,
classes and then selectors. Default = false.
--timestamp=[false|true]
If set to true, adds a comment enclosed
timestamp to the top of the output. Default = false.
--merge_selectors=[2|1|0]
If selectors (including ID's and classes) have
identical properties, then csstidy will merge them. A setting of 2 represents
a high degree of merging. 0 represents no merging. Default = 2.
--optimise_shorthands=[1|2|0]
If set to 2, csstidy will invoke all
optimisations. 0 represents no optimisations, and 1 a safe level of
optimatisations. Default = 1.
--template=[default|filename|low|high|highest]
Affects how much whitespace is removed and
ultimately the readability of the output.
CSS HACKS¶
The following is a list of all CSS hacks that will not be modified by default by csstidy. If you enable "preserve CSS", more hacks will be saved. In general you should do without CSS hacks anyway, but if you need them and want to use csstidy you should use one of the following hacks:p\roperty:value; (only if you disable the removal of unnecessary backslashes)
div#test
head:first-child+body div
body>div
html[xmlns] div
@import "null?\"\\{"; @import "styles.css"; (and all other @import rules)
@media all{/\* rules \*/}
* html div
i\{content:"\"/*"\} div\{property:value\}
html*#test
_property:value
AUTHOR¶
Written by Florian Schmitz <floele@gmail.com>RESOURCES¶
Main web site: http://csstidy.sourceforge.net/| 03/18/2007 |