django-css for Linux 2.2.1

django-css is a fork of the django_compressor app that makes it easy to use CSS compilers with your Django projects. CSS compilers extend CSS syntax to include more powerful features such as variables and nested blocks, and pretty much rock all around. Django-css can currently be used with any CSS compiler that can be called from the command line, such as HSS, Sass, CleverCSS, or LESS.<br /><br />Thanks to django_compressor, django-css will also version and compress linked and inline javascript or CSS into a single cached file. These cached files will get served through whatever frontend server you use for serving static files, because serving static files through Django is just silly.<br /><br />Note: The pypi version of CleverCSS is buggy and will not work with django-css. Use the updated version on github: http://github.com/dziegler/clevercss/tree/master<br /><br />Installation<br /><br />Add compressor to INSTALLED_APPS. You should also enable some type of caching backend such as memcached, e.g. CACHE_BACKEND = 'memcached://127.0.0.1:11211/'. Don't worry, your static files are not being served through Django. The only thing stored in cache is the path to the static file.<br /><br />Usage<br /><br />Syntax:<br /><br />{% load compress %}<br />{% compress < js/css > %}<br />< html of inline or linked JS/CSS ><br />{% endcompress %}<br /><br />Examples:<br /><br />{% load compress %}<br />{% compress css %}<br />< link rel="stylesheet" href="/media/css/one.css" type="text/css" charset="utf-8" ><br />< link rel="stylesheet" href="/media/css/two.sass" type="text/css" charset="utf-8" ><br />{% endcompress %}<br /><br />Which would be rendered like:<br /><br />< link rel="stylesheet" href="/media/CACHE/css/f7c661b7a124.css" type="text/css" media="all" charset="utf-8" ><br /><br />or:<br /><br />{% load compress %}<br />{% compress js %}<br />< script src="/media/js/one.js" type="text/javascript" charset="utf-8" >< /script ><br />< script type="text/javascript" charset="utf-8" >obj.value = "value";< /script ><br />{% endcompress %}<br /><br />Which would be rendered like:<br /><br />< script type="text/javascript" src="/media/CACHE/js/3f33b9146e12.js" charset="utf-8" >< /script ><br /><br />If you're using xhtml, you should use:<br /><br />{% load compress %}<br />{% compress css xhtml %}<br />< link rel="stylesheet" href="/media/css/one.css" type="text/css" charset="utf-8" / ><br />< link rel="stylesheet" href="/media/css/two.sass" type="text/css" charset="utf-8" / ><br />{% compress css %}<br /><br />Which would be rendered like:<br /><br />< link rel="stylesheet" href="/media/CACHE/css/f7c661b7a124.css" type="text/css" media="all" charset="utf-8" / ><br /><br />Settings<br /><br />COMPILER_FORMATS default: {}<br /> A dictionary specifying the compiler and arguments to associate with each extension.<br /><br />django-css will select which CSS compiler to use based off a file's extension. For example:<br /><br />COMPILER_FORMATS = {<br /> '.sass': {<br /> 'binary_path':'sass',<br /> 'arguments': '*.sass *.css'<br /> },<br /> '.hss': {<br /> 'binary_path':'/home/dziegler/hss',<br /> 'arguments':'*.hss'<br /> },<br /> '.ccss': {<br /> 'binary_path':'clevercss',<br /> 'arguments': '*.ccss'<br /> },<br />}<br /><br />will use Sass to compile *.sass files, HSS to compile *.hss files, and clevercss to compile *.ccss files. *.css files will be treated like normal css files.<br /><br />binary_path is the path to the CSS compiler. In the above example, sass and clevercss are installed in my path, and hss is located at /home/dziegler/hss.<br /><br />arguments are arguments you would call in the command line to the compiler. The order and format of these will depend on the CSS compiler you use. Prior to compilation, * will be replaced with the name of your file to be compiled.<br /><br />If this seems a little hacky, it's because I wanted to make it easy to use whatever CSS compiler you want with as little setup as possible.<br /><br />COMPRESS default: the opposite of DEBUG<br /> Boolean that decides if compression will happen.<br />COMPRESS_CSS_FILTERS default: []<br /> A list of filters that will be applied to CSS.<br />COMPRESS_JS_FILTERS default: ['compressor.filters.jsmin.JSMinFilter'])<br /> A list of filters that will be applied to javascript.<br />COMPRESS_URL default: MEDIA_URL<br /> Controls the URL that linked media will be read from and compressed media will be written to.<br />COMPRESS_ROOT default: MEDIA_ROOT<br /> Controls the absolute file path that linked media will be read from and compressed media will be written to.<br />COMPRESS_OUTPUT_DIR default: "CACHE"<br /> Controls the directory inside COMPRESS_ROOT that compressed files will be written to.<br /><br />Notes<br /><br />All relative url() bits specified in linked CSS files are automatically converted to absolute URLs while being processed. Any local absolute urls (those starting with a '/') are left alone.<br /><br />Stylesheets that are @import'd are not compressed into the main file. They are left alone.<br /><br />Set the media attribute as normal on your and elements and the combined CSS will be wrapped in @media blocks as necessary.<br /><br />Linked files must be on your COMPRESS_URL (which defaults to MEDIA_URL). If DEBUG is true off-site files will throw exceptions. If DEBUG is false they will be silently stripped.<br /><br />CSS files are compiled only when needed, because it would be silly to re-compile on every page request. The way this works is that django-css looks at the time your css was last modified, and the time your CleverCSS, HSS, etc file was modified. If the modification time for the CleverCSS, HSS, etc file is after the css file's, then the css file gets re-compiled.<br /><br />If COMPRESS is False (defaults to the opposite of DEBUG) CSS files will still be compiled if needed, but files will not be compressed and versioned.<br /><br />The pypi version of CleverCSS is buggy and will not work with django-css. Use the updated version on github: http://github.com/dziegler/clevercss/tree/master<br /><br />#md5=b4ab5e9a8d0079abafdbf0d5e67c579d

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Charset Dquotutf Quot,  Clevercss,  Compiler,  Compress,  Compressed,  Controls,  Css,  Css Linux,  Debug,  Default,  Django,  Django Css,  Djangocss,  Files,  Likelt,  Linked,  Linux,  Media,  Rel Dquotstylesheetquot,  Script,  Static,  Type Dquottextcssquot,  Version
Users rating:	0/10