Jingo 使用与技术文档
2024-12-17 18:38:14作者:平淮齐Percy
1. 安装指南
Jingo 是一个适配器,用于在 Django 中使用 Jinja2 模板。在安装 Jingo 前,确保您的环境中已安装 Jinja2。
安装 Jingo 的步骤如下:
pip install jingo
由于 Jingo 已经被弃用,并建议使用 django-jinja 项目,所以在安装前请确认您的项目适合使用 Jingo。
2. 项目的使用说明
Jingo 允许您在 Django 视图中以与 Django 模板相同的方式渲染 Jinja2 模板。
以下是一个简单的使用示例:
from django.shortcuts import render
def my_view(request):
context = dict(user_ids=(1, 2, 3, 4))
return render(request, 'users/search.html', context)
请注意,django.shortcuts.render
方法同样适用于 Jingo。
3. 项目API使用文档
Jingo 主要通过自定义的模板加载器和一些辅助功能来集成 Jinja2 模板。以下是 Jingo 提供的主要组件和功能:
- Loader: Jingo 的模板加载器需要添加到 Django 的
TEMPLATE_LOADERS
设置中。 - Settings: 可以通过
JINGO_INCLUDE_PATTERN
和JINGO_EXCLUDE_APPS
设置来细粒度地控制哪些应用使用 Jinja2。 - Helpers: Jingo 提供了
register.filter
和register.function
装饰器,用于添加自定义的 Jinja2 过滤器和函数。
Template Helpers
Jingo 自动从每个应用的 helpers.py
文件中加载帮助函数和过滤器。
Template Environment
可以通过 jingo.get_env()
获取 Jinja 的 Environment
对象。
4. 项目安装方式
在 Django 项目中安装 Jingo,您需要修改 settings.py
文件来配置模板加载器和可选设置:
# 添加 Jingo 模板加载器
TEMPLATE_LOADERS = (
'jingo.Loader',
'django.template.loaders.filesystem.Loader',
'django.template.loaders.app_directories.Loader',
)
# 可选:指定 Jinja2 模板文件扩展名
JINGO_INCLUDE_PATTERN = r'\.jinja2'
# 可选:排除不使用 Jinja2 的应用
JINGO_EXCLUDE_APPS = ('debug_toolbar',)
在完成这些设置后,Jingo 将可以在您的 Django 项目中正常工作。请确保在项目部署前测试模板渲染的正确性。
以上文档为 Jingo 的基础使用说明,详细配置和使用可能需要根据具体项目需求进行调整。由于 Jingo 将不再维护,对于新项目建议使用 django-jinja。
热门项目推荐
相关项目推荐
鸿蒙开发工具大赶集
本仓将收集和展示鸿蒙开发工具,欢迎大家踊跃投稿。通过pr附上您的工具介绍和使用指南,并加上工具对应的链接,通过的工具将会成功上架到我们社区。014FlashMLA
FlashMLA是DeepSeek在2025年2月24日启动的“开源周”中发布的首个核心技术项目。 主要针对 Hopper GPU 的高效 MLA 解码内核,优化了可变长度序列服务。支持 BF16 和特定块大小分页 kvcache。源项目地址:https://github.com/deepseek-ai/FlashMLAC++00每日精选项目
🔥🔥 每日精选已经升级为:【行业动态】,快去首页看看吧,后续都在【首页 - 行业动态】内更新,多条更新哦~🔥🔥 每日推荐行业内最新、增长最快的项目,快速了解行业最新热门项目动态~~030BootstrapAdmin
基于 RBAC 的 Net8 后台管理框架,权限管理,前后台分离,支持多站点单点登录,兼容所有主流浏览器,内置微信、支付宝、QQ等多种登录方式,内置多种样式,可切换至 Blazor 多 Tabs 模式,权限控制细化到网页内任意元素(按钮、表格、文本框等等)C#00Cangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。Cangjie061毕方Talon工具
本工具是一个端到端的工具,用于项目的生成IR并自动进行缺陷检测。Python040PDFMathTranslate
PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/DockerPython06mybatis-plus
mybatis 增强工具包,简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.comJava03国产编程语言蓝皮书
《国产编程语言蓝皮书》-编委会工作区018- DDeepSeek-R1探索新一代推理模型,DeepSeek-R1系列以大规模强化学习为基础,实现自主推理,表现卓越,推理行为强大且独特。开源共享,助力研究社区深入探索LLM推理能力,推动行业发展。【此简介由AI生成】。Python00
热门内容推荐
最新内容推荐
项目优选
收起

Python - 100天从新手到大师
Python
637
118

React Native鸿蒙化仓库
C++
9
16

本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
287
82

方舟分析器:面向ArkTS语言的静态程序分析框架
TypeScript
6
10

旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
60
49

本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
205
61

🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统
Vue
45
31

前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。
官网地址:https://matechat.gitcode.com
420
37

🔥Vue3 + Vite6+ TypeScript + Element-Plus 构建的后台管理前端模板,配套接口文档和后端源码,vue-element-admin 的 Vue3 版本。
Vue
79
11

open-eBackup是一款开源备份软件,采用集群高扩展架构,通过应用备份通用框架、并行备份等技术,为主流数据库、虚拟化、文件系统、大数据等应用提供E2E的数据备份、恢复等能力,帮助用户实现关键数据高效保护。
HTML
90
65