zhouzhongping/wiki
1
0
Fork 0
Code
760e1caadc
wiki/Tech/programming-language/Python/模块/WEB开发/Jinja-模板引擎.html

313 lines
467 KiB
HTML
Raw Normal View History

Deploy HTML files - 2024-08-05
2024-08-05 18:05:18 +08:00
<!DOCTYPE html>
<html><head><title>Jinja 模板引擎</title><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta property="og:title" content="Jinja 模板引擎"/><meta property="og:description" content="Jinja 模板引擎教程."/><meta property="og:image" content="https://wiki.7wate.com/static/og-image.png"/><meta property="og:width" content="1200"/><meta property="og:height" content="675"/><link rel="icon" href="../../../../../static/icon.png"/><meta name="description" content="Jinja 模板引擎教程."/><meta name="generator" content="Quartz"/><link rel="preconnect" href="https://fonts.googleapis.com"/><link rel="preconnect" href="https://fonts.gstatic.com"/><script async src="https://umami.7wate.com/script.js" data-website-id="c061efdc-95dd-4d21-9d04-a1ffda0a85b9"></script><script>
var _hmt = _hmt || [];
(function() {
var hm = document.createElement("script");
hm.src = "https://hm.baidu.com/hm.js?94d8ccb156eb7c65abf317e6e01cdba9";
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(hm, s);
})();
</script><script async src="https://www.googletagmanager.com/gtag/js?id=G-MHMEL0F832"></script><script>
(function() {
window.dataLayer = window.dataLayer || [];
function gtag() {
window.dataLayer.push(arguments);
}
gtag('js', new Date());
gtag('config', 'G-MHMEL0F832');
})();
</script><link href="../../../../../index.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://fonts.googleapis.com/css2?family=IBM Plex Mono&amp;family=Schibsted Grotesk:wght@400;700&amp;family=Source Sans Pro:ital,wght@0,400;0,600;1,400;1,600&amp;display=swap" rel="stylesheet" type="text/css" spa-preserve/><script src="../../../../../prescript.js" type="application/javascript" spa-preserve></script><script type="application/javascript" spa-preserve>const fetchData = fetch(`../../../../../static/contentIndex.json`).then(data => data.json())</script></head><body data-slug="Tech/programming-language/Python/模块/WEB开发/Jinja-模板引擎"><div id="quartz-root" class="page"><div id="quartz-body"><div class="left sidebar"><h1 class="page-title "><a href="../../../../..">📚 X·Eden</a></h1><div class="spacer mobile-only"></div><div class="search "><div id="search-icon"><p>Search</p><div></div><svg tabIndex="0" aria-labelledby="title desc" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 19.9 19.7"><title id="title">Search</title><desc id="desc">Search</desc><g class="search-path" fill="none"><path stroke-linecap="square" d="M18.5 18.3l-5.4-5.4"></path><circle cx="8" cy="8" r="7"></circle></g></svg></div><div id="search-container"><div id="search-space"><input autocomplete="off" id="search-bar" name="search" type="text" aria-label="Search for something" placeholder="Search for something"/><div id="results-container"></div></div></div></div><div class="darkmode "><input class="toggle" id="darkmode-toggle" type="checkbox" tabIndex="-1"/><label id="toggle-label-light" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="dayIcon" x="0px" y="0px" viewBox="0 0 35 35" style="enable-background:new 0 0 35 35;" xmlSpace="preserve"><title>Light mode</title><path d="M6,17.5C6,16.672,5.328,16,4.5,16h-3C0.672,16,0,16.672,0,17.5 S0.672,19,1.5,19h3C5.328,19,6,18.328,6,17.5z M7.5,26c-0.414,0-0.789,0.168-1.061,0.439l-2,2C4.168,28.711,4,29.086,4,29.5 C4,30.328,4.671,31,5.5,31c0.414,0,0.789-0.168,1.06-0.44l2-2C8.832,28.289,9,27.914,9,27.5C9,26.672,8.329,26,7.5,26z M17.5,6 C18.329,6,19,5.328,19,4.5v-3C19,0.672,18.329,0,17.5,0S16,0.672,16,1.5v3C16,5.328,16.671,6,17.5,6z M27.5,9 c0.414,0,0.789-0.168,1.06-0.439l2-2C30.832,6.289,31,5.914,31,5.5C31,4.672,30.329,4,29.5,4c-0.414,0-0.789,0.168-1.061,0.44 l-2,2C26.168,6.711,26,7.086,26,7.5C26,8.328,26.671,9,27.5,9z M6.439,8.561C6.711,8.832,7.086,9,7.5,9C8.328,9,9,8.328,9,7.5 c0-0.414-0.168-0.789-0.439-1.061l-2-2C6.289,4.168,5.914,4,5.5,4C4.672,4,4,4.672,4,5.5c0,0.414,0.168,0.789,0.439,1.06 L6.439,8.561z M33.5,16h-3c-0.828,0-1.5,0.672-1.5,1.5s0.672,1.5,1.5,1.5h3c0.828,0,1.5-0.672,1.5-1.5S34.328,16,33.5,16z M28.561,26.439C28.289,26.168,27.914,26,27.5,26c-0.828,0-1.5,0.672-1.5,1.5c0,0.414,0.168,0.789,0.439,1.06l2,2 C28.711,30.832,29.086,31,29.5,31c0.828,0,1.5-0.672,1.5-1.5c0-0.414-0.168-0.789-0.439-1.061L28.561,26.439z M17.5,29 c-0.829,0-1.5,0.672-1.5,1.5v3c0,0.828,0.671,1.5,1.5,1.5s1.5-0.672,1.5-1.5v-3C19,29.672,18.329,29,17.5,29z M17.5,7 C11.71,7,7,11.71,7,17.5S11.71,28,17.5,28S28,23.29,28,17.5S23.29,7,17.5,7z M17.5,25c-4.136,0-7.5-3.364-7.5-7.5 c0-4.136,3.364-7.5,7.5-7.5c4.136,0,7.5,3.364,7.5,7.5C25,21.636,21.636,25,17.5,25z"></path></svg></label><label id="toggle-label-dark" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="nightIcon" x="0px" y="0px" viewBox="0 0 100 100" style="enable-background='new 0 0 100 100'" xmlSpace="preserve"><title>Dark mode</title><path d="M96.76,66.458c-0.853-0.852-2.15-1.064-3.23-0.534c-6.063,2.991-12.858,4.571-19.655,4.571 C62.022,70.495,50.88,65.88,42.5,57.5C29.043,44.043,25.658,23.536,34.076,6.47c0.532-1.08,0.318-2.379-0.534-3.23 c-0.851-0.852-2.15-1.064-3.23-0.534c-4.918,2.427-9.375,5.619-13.246,9.491c-9.
<p>Jinja2 的设计理念源自 Django 模板引擎，但在易用性、扩展性和性能上做出了大幅提升。</p>
<h2 id="安装">安装<a aria-hidden="true" tabindex="-1" href="#安装" class="internal"> §</a></h2>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="shell" data-theme="default"><code data-language="shell" data-theme="default"><span data-line><span style="color:var(--shiki-token-function);">pip</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string);">install</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string);">jinja2</span></span></code></pre></div>
<p>Jinja2 没有复杂的依赖 ，安装后可以直接导入和使用。</p>
<h2 id="核心功能">核心功能<a aria-hidden="true" tabindex="-1" href="#核心功能" class="internal"> §</a></h2>
<h3 id="创建模板环境">创建模板环境<a aria-hidden="true" tabindex="-1" href="#创建模板环境" class="internal"> §</a></h3>
<p><strong>使用 Jinja2 时 ，第一步是创建一个模板环境。<strong>模板环境包含了模板的各种配置选项 ，如全局函数、过滤器、测试等。通常</strong>一个应用只需要创建一个环境。</strong></p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="python" data-theme="default"><code data-language="python" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">from</span><span style="color:var(--shiki-color-text);"> jinja2 </span><span style="color:var(--shiki-token-keyword);">import</span><span style="color:var(--shiki-color-text);"> Environment ， PackageLoader ， select_autoescape</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-color-text);">env </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Environment</span><span style="color:var(--shiki-token-punctuation);">(</span></span>
<span data-line><span style="color:var(--shiki-token-punctuation);"> loader</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-function);">PackageLoader</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">'yourapplication'</span><span style="color:var(--shiki-token-punctuation);"> ， </span><span style="color:var(--shiki-token-string-expression);">'templates'</span><span style="color:var(--shiki-token-punctuation);">) ，</span></span>
<span data-line><span style="color:var(--shiki-token-punctuation);"> autoescape</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-function);">select_autoescape</span><span style="color:var(--shiki-token-punctuation);">([</span><span style="color:var(--shiki-token-string-expression);">'html'</span><span style="color:var(--shiki-token-punctuation);"> ， </span><span style="color:var(--shiki-token-string-expression);">'xml'</span><span style="color:var(--shiki-token-punctuation);">])</span></span>
<span data-line><span style="color:var(--shiki-token-punctuation);">)</span></span></code></pre></div>
<p>这里我们使用 <code>PackageLoader</code> 加载 <code>app/templates</code> 目录下的模板 ，并开启了自动转义 HTML 和 XML 的功能 ，以防范 XSS 攻击。<code>trim_blocks</code> 选项可以去除模板代码前后的空行。</p>
<h3 id="定义模板">定义模板<a aria-hidden="true" tabindex="-1" href="#定义模板" class="internal"> §</a></h3>
<p>Jinja2 使用类 HTML 语法的模板文件 ，其中嵌入了一些特殊的语法来完成变量替换、逻辑控制等功能。例如:</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="jinja2" data-theme="default"><code data-language="jinja2" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">&lt;!DOCTYPE html></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;html></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;head></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;title>{{ title }}&lt;/title></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;/head></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;body></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;ul></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> {% for item in items %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;li>{{ loop.index }}: {{ item }}&lt;/li></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> {% endfor %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;/ul></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;/body></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;/html></span></span></code></pre></div>
<p>这个模板实现了一个简单的动态列表渲染 ，使用了变量、for 循环等模板语法。</p>
<h3 id="渲染模板">渲染模板<a aria-hidden="true" tabindex="-1" href="#渲染模板" class="internal"> §</a></h3>
<p>加载一个模板并渲染只需要简单的两步：</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="python" data-theme="default"><code data-language="python" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">template </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> env</span><span style="color:var(--shiki-token-punctuation);">.</span><span style="color:var(--shiki-token-function);">get_template</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">'index.html'</span><span style="color:var(--shiki-token-punctuation);">)</span></span>
<span data-line><span style="color:var(--shiki-color-text);">content </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> template</span><span style="color:var(--shiki-token-punctuation);">.</span><span style="color:var(--shiki-token-function);">render</span><span style="color:var(--shiki-token-punctuation);">(title</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-string-expression);">'Home'</span><span style="color:var(--shiki-token-punctuation);"> ， items</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-punctuation);">[</span><span style="color:var(--shiki-token-string-expression);">'A'</span><span style="color:var(--shiki-token-punctuation);"> ， </span><span style="color:var(--shiki-token-string-expression);">'B'</span><span style="color:var(--shiki-token-punctuation);"> ， </span><span style="color:var(--shiki-token-string-expression);">'C'</span><span style="color:var(--shiki-token-punctuation);">])</span></span></code></pre></div>
<p>这样就可以通过一个字典对象传入变量 ，生成最后的文本结果。</p>
<p>Jinja2 也支持模板继承 ，一个基础模板可以被多个页面模板扩展：</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="jinja2" data-theme="default"><code data-language="jinja2" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">{# base.html #}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;!DOCTYPE html></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;html></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;body></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> {% block content %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> {% endblock %} </span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;/body></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;/html></span></span>
<span data-line><span style="color:var(--shiki-color-text);"></span></span>
<span data-line><span style="color:var(--shiki-color-text);"></span></span>
<span data-line><span style="color:var(--shiki-color-text);">{# index.html #}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"></span></span>
<span data-line><span style="color:var(--shiki-color-text);">{% extends &quot;base.html&quot; %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"></span></span>
<span data-line><span style="color:var(--shiki-color-text);">{% block content %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;p>This is Index Page.&lt;/p> </span></span>
<span data-line><span style="color:var(--shiki-color-text);">{% endblock %}</span></span></code></pre></div>
<h2 id="实践使用">实践使用<a aria-hidden="true" tabindex="-1" href="#实践使用" class="internal"> §</a></h2>
<h3 id="帖子应用">帖子应用<a aria-hidden="true" tabindex="-1" href="#帖子应用" class="internal"> §</a></h3>
<p>以下是一个使用 Flask（Python Web 框架）和 Jinja 的简单帖子列表应用，这个应用将允许用户查看帖子列表，并点击一个帖子以查看其详细内容。</p>
<p>前端部分将使用 Jinja 来生成 HTML，后端部分将使用 Flask 来处理 HTTP 请求。</p>
<p>首先，让我们从后端开始。我们将定义一个 Flask 应用和两个路由：一个用于显示帖子列表，另一个用于显示单个帖子的详细信息。</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="python" data-theme="default"><code data-language="python" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">from</span><span style="color:var(--shiki-color-text);"> flask </span><span style="color:var(--shiki-token-keyword);">import</span><span style="color:var(--shiki-color-text);"> Flask ， render_template</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-color-text);">app </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Flask</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-constant);">__name__</span><span style="color:var(--shiki-token-punctuation);">)</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-color-text);">posts </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> [</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-punctuation);">{</span><span style="color:var(--shiki-token-string-expression);">'id'</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">1</span><span style="color:var(--shiki-color-text);"> ， </span><span style="color:var(--shiki-token-string-expression);">'title'</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">'First Post'</span><span style="color:var(--shiki-color-text);"> ， </span><span style="color:var(--shiki-token-string-expression);">'content'</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">'This is the first post.'</span><span style="color:var(--shiki-token-punctuation);">}</span><span style="color:var(--shiki-color-text);"> ，</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-punctuation);">{</span><span style="color:var(--shiki-token-string-expression);">'id'</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">2</span><span style="color:var(--shiki-color-text);"> ， </span><span style="color:var(--shiki-token-string-expression);">'title'</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">'Second Post'</span><span style="color:var(--shiki-color-text);"> ， </span><span style="color:var(--shiki-token-string-expression);">'content'</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">'This is the second post.'</span><span style="color:var(--shiki-token-punctuation);">}</span><span style="color:var(--shiki-color-text);"> ，</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-comment);"># Add more posts as needed</span></span>
<span data-line><span style="color:var(--shiki-color-text);">]</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-token-function);">@app</span><span style="color:var(--shiki-token-punctuation);">.</span><span style="color:var(--shiki-token-function);">route</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">'/'</span><span style="color:var(--shiki-token-punctuation);">)</span></span>
<span data-line><span style="color:var(--shiki-token-keyword);">def</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">post_list</span><span style="color:var(--shiki-color-text);">():</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">return</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">render_template</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">'post_list.html'</span><span style="color:var(--shiki-token-punctuation);"> ， posts</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-punctuation);">posts)</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-token-function);">@app</span><span style="color:var(--shiki-token-punctuation);">.</span><span style="color:var(--shiki-token-function);">route</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">'/post/&lt;int:post_id>'</span><span style="color:var(--shiki-token-punctuation);">)</span></span>
<span data-line><span style="color:var(--shiki-token-keyword);">def</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">post_detail</span><span style="color:var(--shiki-color-text);">(</span><span style="color:var(--shiki-token-parameter);">post_id</span><span style="color:var(--shiki-color-text);">):</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> post </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">next</span><span style="color:var(--shiki-token-punctuation);">((post </span><span style="color:var(--shiki-token-keyword);">for</span><span style="color:var(--shiki-token-punctuation);"> post </span><span style="color:var(--shiki-token-keyword);">in</span><span style="color:var(--shiki-token-punctuation);"> posts </span><span style="color:var(--shiki-token-keyword);">if</span><span style="color:var(--shiki-token-punctuation);"> post[</span><span style="color:var(--shiki-token-string-expression);">'id'</span><span style="color:var(--shiki-token-punctuation);">] </span><span style="color:var(--shiki-token-keyword);">==</span><span style="color:var(--shiki-token-punctuation);"> post_id) ， </span><span style="color:var(--shiki-token-constant);">None</span><span style="color:var(--shiki-token-punctuation);">)</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">if</span><span style="color:var(--shiki-color-text);"> post </span><span style="color:var(--shiki-token-keyword);">is</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">None</span><span style="color:var(--shiki-token-punctuation);">:</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">return</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">'Post not found'</span><span style="color:var(--shiki-color-text);"> ， </span><span style="color:var(--shiki-token-constant);">404</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">return</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">render_template</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">'post_detail.html'</span><span style="color:var(--shiki-token-punctuation);"> ， post</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-punctuation);">post)</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-token-keyword);">if</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">__name__</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">==</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">'__main__'</span><span style="color:var(--shiki-token-punctuation);">:</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> app</span><span style="color:var(--shiki-token-punctuation);">.</span><span style="color:var(--shiki-token-function);">run</span><span style="color:var(--shiki-token-punctuation);">(debug</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-constant);">True</span><span style="color:var(--shiki-token-punctuation);">)</span></span></code></pre></div>
<p>在这个后端代码中，<code>posts</code> 是一个包含多个帖子的列表，每个帖子都是一个字典，包含一个 ID、一个标题和内容。<code>post_list</code> 和 <code>post_detail</code> 函数是两个路由处理器，分别用于显示帖子列表和单个帖子的详细信息。</p>
<p>接下来，让我们看看前端部分。我们将需要两个 Jinja 模板：一个用于显示帖子列表，另一个用于显示单个帖子的详细信息。</p>
<p>post_list.html：</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="html" data-theme="default"><code data-language="html" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">&lt;!</span><span style="color:var(--shiki-token-string-expression);">doctype</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">html</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;</span><span style="color:var(--shiki-token-string-expression);">html</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">head</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">title</span><span style="color:var(--shiki-color-text);">>Post List&lt;/</span><span style="color:var(--shiki-token-string-expression);">title</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;/</span><span style="color:var(--shiki-token-string-expression);">head</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">body</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">h1</span><span style="color:var(--shiki-color-text);">>Post List&lt;/</span><span style="color:var(--shiki-token-string-expression);">h1</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">ul</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> {% for post in posts %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">li</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">a</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">href</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-string-expression);">&quot;{{ url_for('post_detail' ， post_id=post.id) }}&quot;</span><span style="color:var(--shiki-color-text);">>{{ post.title }}&lt;/</span><span style="color:var(--shiki-token-string-expression);">a</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;/</span><span style="color:var(--shiki-token-string-expression);">li</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> {% endfor %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;/</span><span style="color:var(--shiki-token-string-expression);">ul</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;/</span><span style="color:var(--shiki-token-string-expression);">body</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;/</span><span style="color:var(--shiki-token-string-expression);">html</span><span style="color:var(--shiki-color-text);">></span></span></code></pre></div>
<p>post_detail.html：</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="html" data-theme="default"><code data-language="html" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">&lt;!</span><span style="color:var(--shiki-token-string-expression);">doctype</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">html</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;</span><span style="color:var(--shiki-token-string-expression);">html</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">head</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">title</span><span style="color:var(--shiki-color-text);">>{{ post.title }}&lt;/</span><span style="color:var(--shiki-token-string-expression);">title</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;/</span><span style="color:var(--shiki-token-string-expression);">head</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">body</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">h1</span><span style="color:var(--shiki-color-text);">>{{ post.title }}&lt;/</span><span style="color:var(--shiki-token-string-expression);">h1</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">p</span><span style="color:var(--shiki-color-text);">>{{ post.content }}&lt;/</span><span style="color:var(--shiki-token-string-expression);">p</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">a</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">href</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-string-expression);">&quot;{{ url_for('post_list') }}&quot;</span><span style="color:var(--shiki-color-text);">>Back to Post List&lt;/</span><span style="color:var(--shiki-token-string-expression);">a</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;/</span><span style="color:var(--shiki-token-string-expression);">body</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;/</span><span style="color:var(--shiki-token-string-expression);">html</span><span style="color:var(--shiki-color-text);">></span></span></code></pre></div>
<p>在这些模板中，我们使用了 Jinja 的变量、循环和函数。例如，<code>{% for post in posts %}</code> 循环遍历所有的帖子，<code>{{ post.title }}</code> 显示帖子的标题，<code>{{ url_for('post_detail' ， post_id=post.id) }}</code> 生成帖子详细信息页面的 URL。</p>
<p>这就是一个简单的使用 Flask 和 Jinja 的帖子列表应用示例。你可以根据需要添加更多的功能，例如添加新的帖子、编辑现有的帖子等。</p>
<p>注意，**在 Flask 中，Jinja 是默认的模板引擎，**所以你不需要显式创建 Jinja 的环境。如果你的模板不在默认的 <code>templates</code> 文件夹中，你需要在创建 Flask 应用时指定模板文件夹的路径，如下：</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="python" data-theme="default"><code data-language="python" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">app </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Flask</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-constant);">__name__</span><span style="color:var(--shiki-token-punctuation);"> ， template_folder</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-string-expression);">'/path/to/your/templates'</span><span style="color:var(--shiki-token-punctuation);">)</span></span></code></pre></div>
<h3 id="博客应用">博客应用<a aria-hidden="true" tabindex="-1" href="#博客应用" class="internal"> §</a></h3>
<p>以下是一个简单的博客应用示例。首先，我们定义 Flask 应用和路由（<code>app.py</code>）：</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="python" data-theme="default"><code data-language="python" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">from</span><span style="color:var(--shiki-color-text);"> flask </span><span style="color:var(--shiki-token-keyword);">import</span><span style="color:var(--shiki-color-text);"> Flask ， render_template</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-color-text);">app </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Flask</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-constant);">__name__</span><span style="color:var(--shiki-token-punctuation);">)</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-token-comment);"># 假设我们有以下博客文章</span></span>
<span data-line><span style="color:var(--shiki-color-text);">posts </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> [</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-punctuation);">{</span><span style="color:var(--shiki-token-string-expression);">&quot;id&quot;</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">1</span><span style="color:var(--shiki-color-text);"> ， </span><span style="color:var(--shiki-token-string-expression);">&quot;title&quot;</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">&quot;First Post&quot;</span><span style="color:var(--shiki-color-text);"> ， </span><span style="color:var(--shiki-token-string-expression);">&quot;content&quot;</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">&quot;This is the first post.&quot;</span><span style="color:var(--shiki-token-punctuation);">}</span><span style="color:var(--shiki-color-text);"> ，</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-punctuation);">{</span><span style="color:var(--shiki-token-string-expression);">&quot;id&quot;</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">2</span><span style="color:var(--shiki-color-text);"> ， </span><span style="color:var(--shiki-token-string-expression);">&quot;title&quot;</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">&quot;Second Post&quot;</span><span style="color:var(--shiki-color-text);"> ， </span><span style="color:var(--shiki-token-string-expression);">&quot;content&quot;</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">&quot;This is the second post.&quot;</span><span style="color:var(--shiki-token-punctuation);">}</span><span style="color:var(--shiki-color-text);"> ，</span></span>
<span data-line><span style="color:var(--shiki-color-text);">]</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-token-function);">@app</span><span style="color:var(--shiki-token-punctuation);">.</span><span style="color:var(--shiki-token-function);">route</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">&quot;/&quot;</span><span style="color:var(--shiki-token-punctuation);">)</span></span>
<span data-line><span style="color:var(--shiki-token-keyword);">def</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">home</span><span style="color:var(--shiki-color-text);">():</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">return</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">render_template</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">&quot;home.html&quot;</span><span style="color:var(--shiki-token-punctuation);"> ， posts</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-punctuation);">posts)</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-token-function);">@app</span><span style="color:var(--shiki-token-punctuation);">.</span><span style="color:var(--shiki-token-function);">route</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">&quot;/post/&lt;int:post_id>&quot;</span><span style="color:var(--shiki-token-punctuation);">)</span></span>
<span data-line><span style="color:var(--shiki-token-keyword);">def</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">post_detail</span><span style="color:var(--shiki-color-text);">(</span><span style="color:var(--shiki-token-parameter);">post_id</span><span style="color:var(--shiki-color-text);">):</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> post </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">next</span><span style="color:var(--shiki-token-punctuation);">((post </span><span style="color:var(--shiki-token-keyword);">for</span><span style="color:var(--shiki-token-punctuation);"> post </span><span style="color:var(--shiki-token-keyword);">in</span><span style="color:var(--shiki-token-punctuation);"> posts </span><span style="color:var(--shiki-token-keyword);">if</span><span style="color:var(--shiki-token-punctuation);"> post[</span><span style="color:var(--shiki-token-string-expression);">&quot;id&quot;</span><span style="color:var(--shiki-token-punctuation);">] </span><span style="color:var(--shiki-token-keyword);">==</span><span style="color:var(--shiki-token-punctuation);"> post_id) ， </span><span style="color:var(--shiki-token-constant);">None</span><span style="color:var(--shiki-token-punctuation);">)</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">if</span><span style="color:var(--shiki-color-text);"> post </span><span style="color:var(--shiki-token-keyword);">is</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">None</span><span style="color:var(--shiki-token-punctuation);">:</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">return</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">&quot;Post not found&quot;</span><span style="color:var(--shiki-color-text);"> ， </span><span style="color:var(--shiki-token-constant);">404</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">return</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">render_template</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">&quot;post_detail.html&quot;</span><span style="color:var(--shiki-token-punctuation);"> ， post</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-punctuation);">post)</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-token-keyword);">if</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">__name__</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">==</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">&quot;__main__&quot;</span><span style="color:var(--shiki-token-punctuation);">:</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> app</span><span style="color:var(--shiki-token-punctuation);">.</span><span style="color:var(--shiki-token-function);">run</span><span style="color:var(--shiki-token-punctuation);">(debug</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-constant);">True</span><span style="color:var(--shiki-token-punctuation);">)</span></span></code></pre></div>
<p>接着，我们创建一个基础模板（<code>base.html</code>）：</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="html" data-theme="default"><code data-language="html" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">&lt;!</span><span style="color:var(--shiki-token-string-expression);">DOCTYPE</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">html</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;</span><span style="color:var(--shiki-token-string-expression);">html</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;</span><span style="color:var(--shiki-token-string-expression);">head</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">title</span><span style="color:var(--shiki-color-text);">>{% block title %}{% endblock %}&lt;/</span><span style="color:var(--shiki-token-string-expression);">title</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;/</span><span style="color:var(--shiki-token-string-expression);">head</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;</span><span style="color:var(--shiki-token-string-expression);">body</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> {% block content %}{% endblock %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;/</span><span style="color:var(--shiki-token-string-expression);">body</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);">&lt;/</span><span style="color:var(--shiki-token-string-expression);">html</span><span style="color:var(--shiki-color-text);">></span></span></code></pre></div>
<p>然后，定义主页模板（<code>home.html</code>）：</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="html" data-theme="default"><code data-language="html" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">{% extends &quot;base.html&quot; %}</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-color-text);">{% block title %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> Home</span></span>
<span data-line><span style="color:var(--shiki-color-text);">{% endblock %}</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-color-text);">{% block content %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">h1</span><span style="color:var(--shiki-color-text);">>My Blog&lt;/</span><span style="color:var(--shiki-token-string-expression);">h1</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">ul</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> {% for post in posts %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">li</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">a</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">href</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-string-expression);">&quot;{{ url_for('post_detail' ， post_id=post.id) }}&quot;</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> {{ post.title }}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;/</span><span style="color:var(--shiki-token-string-expression);">a</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;/</span><span style="color:var(--shiki-token-string-expression);">li</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> {% endfor %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;/</span><span style="color:var(--shiki-token-string-expression);">ul</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);">{% endblock %}</span></span></code></pre></div>
<p>最后，定义文章详情页模板（<code>post_detail.html</code>）：</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="html" data-theme="default"><code data-language="html" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">{% extends &quot;base.html&quot; %}</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-color-text);">{% block title %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> {{ post.title }}</span></span>
<span data-line><span style="color:var(--shiki-color-text);">{% endblock %}</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-color-text);">{% block content %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">h1</span><span style="color:var(--shiki-color-text);">>{{ post.title }}&lt;/</span><span style="color:var(--shiki-token-string-expression);">h1</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">p</span><span style="color:var(--shiki-color-text);">>{{ post.content }}&lt;/</span><span style="color:var(--shiki-token-string-expression);">p</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;</span><span style="color:var(--shiki-token-string-expression);">a</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">href</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-string-expression);">&quot;{{ url_for('home') }}&quot;</span><span style="color:var(--shiki-color-text);">>Back to Home&lt;/</span><span style="color:var(--shiki-token-string-expression);">a</span><span style="color:var(--shiki-color-text);">></span></span>
<span data-line><span style="color:var(--shiki-color-text);">{% endblock %}</span></span></code></pre></div>
<p>在这个 Flask 应用示例中，它显示了一个博客文章列表，你可以点击每个文章的标题来查看文章的详细内容。所有的模板都继承自 <code>base.html</code>，并覆盖了 <code>title</code> 和 <code>content</code> 区块。<code>home.html</code> 使用了一个 for 循环来显示所有的文章，<code>post_detail.html</code> 显示了单个文章的标题和内容。</p>
<h3 id="最佳规范">最佳规范<a aria-hidden="true" tabindex="-1" href="#最佳规范" class="internal"> §</a></h3>
<p>编写模板时 ，有一些最佳实践可以提高可维护性:</p>
<ul>
<li>命名规范：如 index.html ， base.html ，macros.html</li>
<li>模板结构：HTML、逻辑、配置等区块划分清楚</li>
<li>功能模块化：使用宏、包含等复用代码</li>
<li>注释标识：如命名空间、宏参数等</li>
</ul>
<h2 id="高级功能">高级功能<a aria-hidden="true" tabindex="-1" href="#高级功能" class="internal"> §</a></h2>
<h3 id="代码优化">代码优化<a aria-hidden="true" tabindex="-1" href="#代码优化" class="internal"> §</a></h3>
<p>在 Jinja 中，一些优化技术可以帮助你提高模板的性能和可读性。例如：</p>
<ul>
<li>使用宏（Macros）：宏类似于 Python 中的函数，可以帮助你避免重复的代码。</li>
</ul>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="jinja" data-theme="default"><code data-language="jinja" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">{% macro input(name ， value='' ， type='text') %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;input type= {{ type }} name= {{ name }} value= {{ value }} ></span></span>
<span data-line><span style="color:var(--shiki-color-text);">{% endmacro %}</span></span></code></pre></div>
<ul>
<li>使用 include 和 extends ：<code>include</code> 和 <code>extends</code> 可以帮助你复用和组织模板。</li>
</ul>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="jinja" data-theme="default"><code data-language="jinja" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">{% extends base.html %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"></span></span>
<span data-line><span style="color:var(--shiki-color-text);">{% block content %}</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;h1>{{ title }}&lt;/h1></span></span>
<span data-line><span style="color:var(--shiki-color-text);"> &lt;p>{{ content }}&lt;/p></span></span>
<span data-line><span style="color:var(--shiki-color-text);">{% endblock %}</span></span></code></pre></div>
<h3 id="错误处理">错误处理<a aria-hidden="true" tabindex="-1" href="#错误处理" class="internal"> §</a></h3>
<p>在 Jinja 中，错误处理是通过抛出异常实现的。Jinja 定义了一些自己的异常，如 <code>TemplateNotFound</code>、<code>TemplateSyntaxError</code> 等。主要异常类型有：</p>
<ul>
<li>TemplateNotFound：模板文件不存在</li>
<li>TemplateSyntaxError：模板语法错误</li>
<li>UndefinedError：变量未定义</li>
<li>SecurityError：安全错误 (如禁用标签)</li>
</ul>
<p>你可以通过捕捉这些异常来处理错误。</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="python" data-theme="default"><code data-language="python" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">from</span><span style="color:var(--shiki-color-text);"> jinja2 </span><span style="color:var(--shiki-token-keyword);">import</span><span style="color:var(--shiki-color-text);"> TemplateNotFound</span></span>
<span data-line> </span>
<span data-line><span style="color:var(--shiki-token-keyword);">try</span><span style="color:var(--shiki-token-punctuation);">:</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> template </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> env</span><span style="color:var(--shiki-token-punctuation);">.</span><span style="color:var(--shiki-token-function);">get_template</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">'mytemplate.html'</span><span style="color:var(--shiki-token-punctuation);">)</span></span>
<span data-line><span style="color:var(--shiki-token-keyword);">except</span><span style="color:var(--shiki-color-text);"> TemplateNotFound</span><span style="color:var(--shiki-token-punctuation);">:</span></span>
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">print</span><span style="color:var(--shiki-token-punctuation);">(</span><span style="color:var(--shiki-token-string-expression);">'Template not found'</span><span style="color:var(--shiki-token-punctuation);">)</span></span></code></pre></div>
<h3 id="测试和调试">测试和调试<a aria-hidden="true" tabindex="-1" href="#测试和调试" class="internal"> §</a></h3>
<p>Jinja 提供了一个强大的模板调试器，可以帮助你查找和修复模板中的错误。你可以通过设置 <code>Environment</code> 的 <code>debug</code> 选项来启用调试器。</p>
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="python" data-theme="default"><code data-language="python" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">env </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Environment</span><span style="color:var(--shiki-token-punctuation);">(loader</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-punctuation);">... ， debug</span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-token-constant);">True</span><span style="color:var(--shiki-token-punctuation);">)</span></span></code></pre></div>
<p>当 <code>debug</code> 选项设置为 <code>True</code> 时，Jinja 会在渲染模板时检查错误，并在发现错误时抛出异常。</p>
<h3 id="集成其他库">集成其他库<a aria-hidden="true" tabindex="-1" href="#集成其他库" class="internal"> §</a></h3>
<p>Jinja 可以与许多其他 Python 库和框架一起使用。例如，Jinja 是 Flask 和 Django 这两个流行的 Web 框架的默认模板引擎。此外，Jinja 也可以与诸如 Bootstrap 之类的前端框架一起使用，以创建更丰富和动态的网页。</p>
<h2 id="社区动态">社区动态<a aria-hidden="true" tabindex="-1" href="#社区动态" class="internal"> §</a></h2>
<p>Jinja 是一个活跃的开源项目，有一个活跃的开发者和用户社区。你可以在 <a href="https://github.com/pallets/jinja" class="external">Github</a> 上关注 Jinja 的最新更新和发布。此外，你还可以参与 <a href="https://gitter.im/pallets/jinja" class="external">Gitter上的Jinja社区</a>，在那里你可以找到其他 Jinja 用户的帮助，分享你的经验，或者只是去看看其他人都在做什么。</p>
<p>总的来说，Jinja 是一个强大而灵活的模板引擎，适合用于多种应用。通过深入学习和实践，你可以充分利用 Jinja 的功能，提高你的 Web 开发效率和质量。</p></article></div><div class="right sidebar"><div class="graph "><h3>Graph View</h3><div class="graph-outer"><div id="graph-container" data-cfg="{&quot;drag&quot;:true,&quot;zoom&quot;:true,&quot;depth&quot;:1,&quot;scale&quot;:1.1,&quot;repelForce&quot;:0.5,&quot;centerForce&quot;:0.3,&quot;linkDistance&quot;:30,&quot;fontSize&quot;:0.6,&quot;opacityScale&quot;:1,&quot;showTags&quot;:true,&quot;removeTags&quot;:[]}"></div><svg version="1.1" id="global-graph-icon" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 55 55" fill="currentColor" xmlSpace="preserve"><path d="M49,0c-3.309,0-6,2.691-6,6c0,1.035,0.263,2.009,0.726,2.86l-9.829,9.829C32.542,17.634,30.846,17,29,17
s-3.542,0.634-4.898,1.688l-7.669-7.669C16.785,10.424,17,9.74,17,9c0-2.206-1.794-4-4-4S9,6.794,9,9s1.794,4,4,4
c0.74,0,1.424-0.215,2.019-0.567l7.669,7.669C21.634,21.458,21,23.154,21,25s0.634,3.542,1.688,4.897L10.024,42.562
C8.958,41.595,7.549,41,6,41c-3.309,0-6,2.691-6,6s2.691,6,6,6s6-2.691,6-6c0-1.035-0.263-2.009-0.726-2.86l12.829-12.829
c1.106,0.86,2.44,1.436,3.898,1.619v10.16c-2.833,0.478-5,2.942-5,5.91c0,3.309,2.691,6,6,6s6-2.691,6-6c0-2.967-2.167-5.431-5-5.91
v-10.16c1.458-0.183,2.792-0.759,3.898-1.619l7.669,7.669C41.215,39.576,41,40.26,41,41c0,2.206,1.794,4,4,4s4-1.794,4-4
s-1.794-4-4-4c-0.74,0-1.424,0.215-2.019,0.567l-7.669-7.669C36.366,28.542,37,26.846,37,25s-0.634-3.542-1.688-4.897l9.665-9.665
C46.042,11.405,47.451,12,49,12c3.309,0,6-2.691,6-6S52.309,0,49,0z M11,9c0-1.103,0.897-2,2-2s2,0.897,2,2s-0.897,2-2,2
S11,10.103,11,9z M6,51c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S8.206,51,6,51z M33,49c0,2.206-1.794,4-4,4s-4-1.794-4-4
s1.794-4,4-4S33,46.794,33,49z M29,31c-3.309,0-6-2.691-6-6s2.691-6,6-6s6,2.691,6,6S32.309,31,29,31z M47,41c0,1.103-0.897,2-2,2
s-2-0.897-2-2s0.897-2,2-2S47,39.897,47,41z M49,10c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S51.206,10,49,10z"></path></svg></div><div id="global-graph-outer"><div id="global-graph-container" data-cfg="{&quot;drag&quot;:true,&quot;zoom&quot;:true,&quot;depth&quot;:-1,&quot;scale&quot;:0.9,&quot;repelForce&quot;:0.5,&quot;centerForce&quot;:0.3,&quot;linkDistance&quot;:30,&quot;fontSize&quot;:0.6,&quot;opacityScale&quot;:1,&quot;showTags&quot;:true,&quot;removeTags&quot;:[]}"></div></div></div><div class="toc desktop-only"><button type="button" id="toc" class><h3>Table of Contents</h3><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="fold"><polyline points="6 9 12 15 18 9"></polyline></svg></button><div id="toc-content"><ul class="overflow"><li class="depth-0"><a href="#安装" data-for="安装">安装</a></li><li class="depth-0"><a href="#核心功能" data-for="核心功能">核心功能</a></li><li class="depth-1"><a href="#创建模板环境" data-for="创建模板环境">创建模板环境</a></li><li class="depth-1"><a href="#定义模板" data-for="定义模板">定义模板</a></li><li class="depth-1"><a href="#渲染模板" data-for="渲染模板">渲染模板</a></li><li class="depth-0"><a href="#实践使用" data-for="实践使用">实践使用</a></li><li class="depth-1"><a href="#帖子应用" data-for="帖子应用">帖子应用</a></li><li class="depth-1"><a href="#博客应用" data-for="博客应用">博客应用</a></li><li class="depth-1"><a href="#最佳规范" data-for="最佳规范">最佳规范</a></li><li class="depth-0"><a href="#高级功能" data-for="高级功能">高级功能</a></li><li class="depth-1"><a href="#代码优化" data-for="代码优化">代码优化</a></li><li class="depth-1"><a href="#错误处理" data-for="错误处理">错误处理</a></li><li class="depth-1"><a href="#测试和调试" data-for="测试和调试">测试和调试</a></li><li class="depth-1"><a href="#集成其他库" data-for="集成其他库">集成其他库</a></li><li class="depth-0"><a href="#社区动态" data-for="社区动态">社区动态</a></li></ul></div></div><div class="backlinks "><h3>Backlinks</h3><ul class="overflow"><li>No backlinks found</li></ul></div><div class="explorer mobile-only"><button type="button" id="explorer" data-behavior="collapse" data-collapsed="collapsed" data-savestate="true" data-tree="[{&quot;path&quot;:&quot;Basics&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Basics/english&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Blog&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/个人成长&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/医学健康&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/历史&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/哲学宗教&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/心理&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/政治军事&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/教育学习&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/文学&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/生活百科&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/社会文化&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/科学技术&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/经济理财&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/艺术&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/计算机&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Company&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Company/信息化&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Company/信息化/规范&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Culture&quot;,&quot;collapse
function toggleCallout() {
const outerBlock = this.parentElement;
outerBlock.classList.toggle(`is-collapsed`);
const collapsed = outerBlock.classList.contains(`is-collapsed`);
const height = collapsed ? this.scrollHeight : outerBlock.scrollHeight;
outerBlock.style.maxHeight = height + `px`;
let current = outerBlock;
let parent = outerBlock.parentElement;
while (parent) {
if (!parent.classList.contains(`callout`)) {
return;
}
const collapsed2 = parent.classList.contains(`is-collapsed`);
const height2 = collapsed2 ? parent.scrollHeight : parent.scrollHeight + current.scrollHeight;
parent.style.maxHeight = height2 + `px`;
current = parent;
parent = parent.parentElement;
}
}
function setupCallout() {
const collapsible = document.getElementsByClassName(
`callout is-collapsible`
);
for (const div of collapsible) {
const title = div.firstElementChild;
if (title) {
title.removeEventListener(`click`, toggleCallout);
title.addEventListener(`click`, toggleCallout);
const collapsed = div.classList.contains(`is-collapsed`);
const height = collapsed ? title.scrollHeight : div.scrollHeight;
div.style.maxHeight = height + `px`;
}
}
}
document.addEventListener(`nav`, setupCallout);
window.addEventListener(`resize`, setupCallout);
</script><script type="module">
import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.esm.min.mjs';
const darkMode = document.documentElement.getAttribute('saved-theme') === 'dark'
mermaid.initialize({
startOnLoad: false,
securityLevel: 'loose',
theme: darkMode ? 'dark' : 'default'
});
document.addEventListener('nav', async () => {
await mermaid.run({
querySelector: '.mermaid'
})
});
</script><script src="https://cdn.jsdelivr.net/npm/katex@0.16.7/dist/contrib/copy-tex.min.js" type="application/javascript"></script><script src="../../../../../postscript.js" type="module"></script></html>
Copy Permalink