html minify for django
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.
For install django-htmlmin, run on terminal:
$ [sudo] pip install django-htmlmin
All you need to do is add htmlmin.middleware.HtmlMinifyMiddleware
to your MIDDLEWARE_CLASSES
and enable the HTML_MINIFY
setting:
MIDDLEWARE_CLASSES = ( # other middleware classes 'htmlmin.middleware.HtmlMinifyMiddleware', ) 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.
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).
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
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')
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.decorator import no_minified_response @no_minified_response def home(request): return render_to_response('home.html')
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 of Flask 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)
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)
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
- Source hosted at GitHub
- Report issues on GitHub Issues
Pull requests are very welcomed! Make sure your patches are well tested.
if you are using a virtualenv, all you need is:
$ make test
#cobrateam channel on irc.freenode.net
- [bugfix] line breaks inside tags are now replaced by a single white space.
- 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
- skipping
<textarea></textarea>
content from minifying
- [bugfix] fixed behavior for nesting html 5 tags (issue #14)
- [bugfix] stopped minifying
<pre>
tags (thanks Cícero Verneck Corrêa)