django-htmlmin 技术文档
1. 安装指南
首先,确保您的环境中已安装pip。然后,通过以下命令安装django-htmlmin:
$ [sudo] pip install django-htmlmin
如果您使用的是虚拟环境,请确保在正确的环境中运行上述命令。
2. 项目使用说明
2.1 中间件使用
要将django-htmlmin集成到您的Django项目中,您需要在settings.py文件中配置中间件。以下是配置步骤:
-
将以下两个中间件添加到
MIDDLEWARE_CLASSES(或MIDDLEWARE,取决于Django版本)设置中:MIDDLEWARE_CLASSES = ( # 其他中间件类 'htmlmin.middleware.HtmlMinifyMiddleware', 'htmlmin.middleware.MarkRequestMiddleware', ) -
启用
HTML_MINIFY设置:HTML_MINIFY = True
默认情况下,HTML_MINIFY的值是not DEBUG。如果您希望在DEBUG模式下启用HTML压缩,则需要将其设置为True。
2.2 排除特定URL
如果您不希望压缩应用中所有视图的HTML,可以通过添加EXCLUDE_FROM_MINIFYING设置在settings.py中指定不压缩的URL模式。
EXCLUDE_FROM_MINIFYING = ('^my_app/', '^admin/')
2.3 保持注释
默认情况下,中间件会删除所有HTML注释。如果您希望保留注释,请设置KEEP_COMMENTS_ON_MINIFYING为True:
KEEP_COMMENTS_ON_MINIFYING = True
2.4 保守空白压缩
默认情况下,压缩器会智能地删除空白字符,仅在需要保持内联文本渲染时留下空格。如果您希望将所有空白字符减少为一个空格而不完全删除,请设置CONSERVATIVE_WHITESPACE_ON_MINIFYING为False:
CONSERVATIVE_WHITESPACE_ON_MINIFYING = True
3. 项目API使用文档
3.1 装饰器使用
django-htmlmin提供了一个装饰器minified_response,您可以将其应用于需要压缩响应的视图:
from htmlmin.decorators import minified_response
@minified_response
def home(request):
return render_to_response('home.html')
如果需要避免特定响应被压缩,可以使用not_minified_response装饰器,而不使用EXCLUDE_FROM_MINIFYING设置:
from htmlmin.decorators import not_minified_response
@not_minified_response
def home(request):
return render_to_response('home.html')
3.2 html_minify函数使用
如果您不是在使用Django,可以手动调用html_minify函数压缩HTML:
from htmlmin.minify import html_minify
html = '<html> <body>Hello world</body> </html>'
minified_html = html_minify(html)
对于Flask视图,可以如下使用:
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)
3.3 保持注释
默认情况下,html_minify()会删除所有注释。如果您希望保留它们,请传递ignore_comments=False参数:
from htmlmin.minify import html_minify
html = '<html> <body>Hello world<!-- comment to keep --></body> </html>'
minified_html = html_minify(html, ignore_comments=False)
4. 项目安装方式
请遵循上述安装指南,使用pip安装django-htmlmin。如果您需要从源代码安装,请确保从GitHub克隆存储库并运行setup.py脚本。
$ git clone https://github.com/cobrateam/django-htmlmin.git
$ cd django-htmlmin
$ python setup.py install
以上就是django-htmlmin的详细技术文档,希望能够帮助您更好地了解和使用该项目。
GLM-5智谱 AI 正式发布 GLM-5,旨在应对复杂系统工程和长时域智能体任务。Jinja00
GLM-5-w4a8GLM-5-w4a8基于混合专家架构,专为复杂系统工程与长周期智能体任务设计。支持单/多节点部署,适配Atlas 800T A3,采用w4a8量化技术,结合vLLM推理优化,高效平衡性能与精度,助力智能应用开发Jinja00- QQwen3.5-397B-A17BQwen3.5 实现了重大飞跃,整合了多模态学习、架构效率、强化学习规模以及全球可访问性等方面的突破性进展,旨在为开发者和企业赋予前所未有的能力与效率。Jinja00
Kimi-K2.5Kimi K2.5 是一款开源的原生多模态智能体模型,它在 Kimi-K2-Base 的基础上,通过对约 15 万亿混合视觉和文本 tokens 进行持续预训练构建而成。该模型将视觉与语言理解、高级智能体能力、即时模式与思考模式,以及对话式与智能体范式无缝融合。Python00
MiniMax-M2.5MiniMax-M2.5开源模型,经数十万复杂环境强化训练,在代码生成、工具调用、办公自动化等经济价值任务中表现卓越。SWE-Bench Verified得分80.2%,Multi-SWE-Bench达51.3%,BrowseComp获76.3%。推理速度比M2.1快37%,与Claude Opus 4.6相当,每小时仅需0.3-1美元,成本仅为同类模型1/10-1/20,为智能应用开发提供高效经济选择。【此简介由AI生成】Python00
ruoyi-plus-soybeanRuoYi-Plus-Soybean 是一个现代化的企业级多租户管理系统,它结合了 RuoYi-Vue-Plus 的强大后端功能和 Soybean Admin 的现代化前端特性,为开发者提供了完整的企业管理解决方案。Vue06- RRing-2.5-1TRing-2.5-1T:全球首个基于混合线性注意力架构的开源万亿参数思考模型。Python00
Qwen3.5Qwen3.5 昇腾 vLLM 部署教程。Qwen3.5 是 Qwen 系列最新的旗舰多模态模型,采用 MoE(混合专家)架构,在保持强大模型能力的同时显著降低了推理成本。00