Metadata-Version: 1.0
Name: django-scss
Version: 0.2
Summary: Django template tags to compile SCSS into CSS
Home-page: https://github.com/andreyfedoseev/django-scss
Author: Andrey Fedoseev
Author-email: andrey.fedoseev@gmail.com
License: UNKNOWN
Description: Django SCSS
        ===================
        
        Django SCSS provides template tags to compile SCSS into CSS from templates.
        It works with both inline code and extenal files.
        
        Installation
        ************
        
        1. Add "django_scss" to INSTALLED_APPS setting.
        2. Make sure that you have sass executable installed. See SASS official site for details.
        3. Optionally, you can specify the full path to sass executable with SCSS_EXECUTABLE setting. By default it's set to sass.
        
        Example Usage
        *************
        
        Inline
        ------
        
        ::
        
            {% load scss %}
        
            <style>
              {% inlinescss %}
                #header {
                  h1 {
                    font-size: 26px;
                    font-weight: bold;
                  }
                  p { font-size: 12px;
                    a { text-decoration: none;
                      &:hover { border-width: 1px }
                    }
                  }
                }
              {% endinlinescss %}
            </style>
        
        renders to
        
        ::
        
              <style>
                #header h1 {
                  font-size: 26px;
                  font-weight: bold; }
                #header p {
                  font-size: 12px; }
                  #header p a {
                    text-decoration: none; }
                    #header p a:hover {
                      border-width: 1px; }
              </style>
        
        
        External file
        -------------
        
        ::
        
            {% load scss %}
        
            <link rel="stylesheet" href="{{ STATIC_URL}}{% scss "path/to/styles.scss" %}" />
        
        renders to
        
        ::
        
            <link rel="stylesheet" href="/media/SCSS_CACHE/path/to/styles-91ce1f66f583.css" />
        
        Note that by default compiled files are saved into ``SCSS_CACHE`` folder under your ``STATIC_ROOT`` (or ``MEDIA_ROOT`` if you have no ``STATIC_ROOT`` in your settings).
        You can change this folder name with ``SCSS_OUTPUT_DIR`` setting.
        
        Note that all relative URLs in your stylesheet are converted to absolute URLs using your ``STATIC_URL`` setting.
        
        
        Settings
        ********
        
        ``LESS_EXECUTABLE``
            Path to SASS compiler executable. Default: "sass".
        
        ``SCSS_OUTPUT_DIR``
            Output directory for compiled external stylesheets. It's relative to ``STATIC_ROOT``. Default: ``"SCSS_CACHE"``.
        
        ``SCSS_USE_CACHE``
            Whether to use cache for inline styles. Default: ``True``.
        
        ``SCSS_CACHE_TIMEOUT``
            Cache timeout for inline styles (in seconds). Default: 30 days.
        
        ``SCSS_MTIME_DELAY``
            Cache timeout for reading the modification time of external stylesheets (in seconds). Default: 10 seconds.
        
        
        Changes
        *******
        
        0.2
        ---
        
        - Log coffeescript compilation errors
        - Fixed bug with paths on Windows
        
        
        0.1
        ---
        
        - Initial release
        
Keywords: scss,css
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
