Metadata-Version: 1.0
Name: django-htmlmin
Version: 0.7.0
Summary: html minify for django
Home-page: UNKNOWN
Author: CobraTeam
Author-email: andrewsmedina@gmail.com
License: UNKNOWN
Description: ++++++++++++++
        django-htmlmin
        ++++++++++++++
        
        .. image:: https://secure.travis-ci.org/cobrateam/django-htmlmin.png
           :target: http://travis-ci.org/cobrateam/django-htmlmin
        
        django-html in an HTML minifier for Python with full support for HTML 5. It
        supports Django, Flask and any other Python web framework. It also provides a
        command line tool that can be used for static websites or deployment scripts.
        
        Why minify HTML code?
        =====================
        
        One of important points on client side optimization is minify HTML, with
        minified HTML code, you reduce the size of data transferred from your server to
        your client, and your pages load faster.
        
        Installing
        ==========
        
        For install django-htmlmin, run on terminal: ::
        
            $ [sudo] pip install django-htmlmin
        
        Using the midleware
        ===================
        
        All you need to do is add two middlewares to your ``MIDDLEWARE_CLASSES`` and
        enable the ``HTML_MINIFY`` setting: ::
        
            MIDDLEWARE_CLASSES = (
                # other middleware classes
                'htmlmin.middleware.HtmlMinifyMiddleware',
                'htmlmin.middleware.MarkRequestMiddleware',
            )
        
        Note that if you're using Django's caching middleware, ``MarkRequestMiddleware``
        should go after ``FetchFromCacheMiddleware``, and ``HtmlMinifyMiddleware``
        should go after ``UpdateCacheMiddleware``: ::
        
            MIDDLEWARE_CLASSES = (
              'django.middleware.cache.UpdateCacheMiddleware',
              'htmlmin.middleware.HtmlMinifyMiddleware',
              # other middleware classes
              'django.middleware.cache.FetchFromCacheMiddleware',
              'htmlmin.middleware.MarkRequestMiddleware',
            )
        
        You can optionally specify the ``HTML_MINIFY`` setting::
        
            HTML_MINIFY = True
        
        The default value for the ``HTML_MINIFY`` setting is ``not DEBUG``. You only
        need to set it to ``True`` if you want to minify your HTML code when ``DEBUG``
        is enabled.
        
        Excluding some URLs
        -------------------
        
        If you don't want to minify all views in your app and it's under a ``/my_app``
        URL, you can tell the middleware to not minify the response of your views by
        adding a ``EXCLUDE_FROM_MINIFYING`` setting on your settings.py: ::
        
            EXCLUDE_FROM_MINIFYING = ('^my_app/', '^admin/')
        
        As you can see, you use a regex pattern for URL exclusion. If you want to
        exclude all URLs of your app, except a specific view, you can use the decorator
        ``minified_response`` (check the next section above).
        
        Keeping comments
        ----------------
        
        The default behaviour of the middleware is remove all comments from HTML. If
        you want to keep your comments, set the setting ``KEEP_COMMENTS_ON_MINIFYING``
        to ``True``: ::
        
            KEEP_COMMENTS_ON_MINIFYING = True
        
        Using the decorator
        ===================
        
        django-htmlmin also provides a decorator, that you can use only on views you
        want to minify the response: ::
        
            from htmlmin.decorators import minified_response
        
            @minified_response
            def home(request):
                return render_to_response('home.html')
        
        Decorator to avoid response to be minified
        ------------------------------------------
        
        You can use ``not_minified_response`` decorator on views if you want avoid
        response to be minified instead to use ``EXCLUDE_FROM_MINIFYING`` setting: ::
        
            from htmlmin.decorators import not_minified_response
        
            @not_minified_response
            def home(request):
                return render_to_response('home.html')
        
        Using the html_minify function
        ==============================
        
        If you are not working with Django, you can invoke the ``html_minify`` function
        manually: ::
        
            from htmlmin.minify import html_minify
            html = '<html>    <body>Hello world</body>    </html>'
            minified_html = html_minify(html)
        
        Here is an example with a `Flask <http://flask.pocoo.org>`_ view: ::
        
            from flask import Flask
            from htmlmin.minify import html_minify
        
            app = Flask(__name__)
        
            @app.route('/')
            def home():
                rendered_html = render_template('home.html')
                return html_minify(rendered_html)
        
        Keeping comments
        ----------------
        
        By default, ``html_minify`` function removes all comments. If you want to keep
        them, you can pass ``False`` as value to ``ignore_comments`` parameter on that
        function: ::
        
            from htmlmin.minify import html_minify
            html = '<html>    <body>Hello world<!-- comment to keep --></body>    </html>'
            minified_html = html_minify(html, ignore_comments=False)
        
        
        Using command line tool
        =======================
        
        If you are not even using Python, you can use the ``pyminify`` command line
        tool to minify HTML files: ::
        
            $ pyminify index.html > index_minified.html
        
        You can also keep comments, if you want: ::
        
            $ pyminify --keep-comments index.html > index_minified_with_comments.html
        
        development
        ===========
        
        * Source hosted at `GitHub <http://github.com/cobrateam/django-htmlmin>`_
        * Report issues on `GitHub Issues
          <http://github.com/cobrateam/django-htmlmin/issues>`_
        
        Pull requests are very welcomed! Make sure your patches are well tested.
        
        Running tests
        -------------
        
        If you are using a virtualenv, all you need is:
        
        ::
        
            $ make test
        
        community
        =========
        
        irc channel
        -----------
        
        #cobrateam channel on irc.freenode.net
        
        Changelog
        =========
        
        0.6.2
        -----
        
        * [bugfix] #39 Breaks CSS and JS containing < and > signs.
        
        0.6.1
        -----
        
        * [bugfix] Non ascii characters in exclude field fix
        
        0.6
        ---
        
        * using BeautifulSoup4 as parser
        * full support for HTML 5
        * [bugfix] don't remove conditional comments
        * [partial bugfix] don't remove all spaces around some tags
        
        0.5.1
        -----
        
        * [bugfix] line breaks inside tags are now replaced by a single white space.
        
        0.5
        ---
        
        * added support for more HTML 5 tags
        * fixed encoding bug on admin interface
        * added the ``KEEP_COMMENTS_ON_MINIFYING`` setting to keep comments when
          minifying using the middleware
        
        0.4.3
        -----
        
        * skipping ``<textarea></textarea>`` content from minifying
        
        0.4.2
        -----
        
        * [bugfix] fixed behavior for nesting html 5 tags (`issue #14 <https://github.com/cobrateam/django-htmlmin/issues/14>`_)
        
        0.4.1
        -----
        
        * [bugfix] stopped minifying ``<pre>`` tags (thanks `Cícero Verneck Corrêa <https://github.com/cicerocomp>`_)
        
        LICENSE
        =======
        
        Unless otherwise noted, the django-htmlmin source files are distributed under the BSD-style license found in the LICENSE file.
        
Platform: UNKNOWN
