Deployed f5c5a04 with MkDocs version: 1.6.1

Author: maximebf

guides/pages/index.html

@@ -740,27 +740,27 @@
 </li>
 
         <li class="md-nav__item">
-  <a href="#content-pages" class="md-nav__link">
+  <a href="#the-page-template" class="md-nav__link">
     <span class="md-ellipsis">
-      Content pages
+      The page template
     </span>
   </a>
 
 </li>
 
         <li class="md-nav__item">
-  <a href="#how-routing-works" class="md-nav__link">
+  <a href="#content-pages" class="md-nav__link">
     <span class="md-ellipsis">
-      How routing works
+      Content pages
     </span>
   </a>
 
 </li>
 
         <li class="md-nav__item">
-  <a href="#the-page-template" class="md-nav__link">
+  <a href="#how-routing-works" class="md-nav__link">
     <span class="md-ellipsis">
-      The page template
+      How routing works
     </span>
   </a>
 
@@ -1924,27 +1924,27 @@
 </li>
 
         <li class="md-nav__item">
-  <a href="#content-pages" class="md-nav__link">
+  <a href="#the-page-template" class="md-nav__link">
     <span class="md-ellipsis">
-      Content pages
+      The page template
     </span>
   </a>
 
 </li>
 
         <li class="md-nav__item">
-  <a href="#how-routing-works" class="md-nav__link">
+  <a href="#content-pages" class="md-nav__link">
     <span class="md-ellipsis">
-      How routing works
+      Content pages
     </span>
   </a>
 
 </li>
 
         <li class="md-nav__item">
-  <a href="#the-page-template" class="md-nav__link">
+  <a href="#how-routing-works" class="md-nav__link">
     <span class="md-ellipsis">
-      The page template
+      How routing works
     </span>
   </a>
 
@@ -2026,22 +2026,28 @@ <h1 id="pages">Pages</h1>
 <p>This feature is provided by <a href="https://github.com/hyperflask/flask-file-routes">Flask-File-Routes</a></p>
 </div>
 <h2 id="dynamic-pages">Dynamic pages</h2>
-<p>Dynamic pages can use the following formats:</p>
-<ul>
-<li><strong>jpy</strong>: jinjapy hybrid format that let you execute code before rendering the template</li>
-<li><strong>py</strong>: python code only</li>
-</ul>
-<p>A jinjapy file contains 2 sections:</p>
-<ul>
-<li>Some Python code enclosed by lines containg 3 dashes "---"</li>
-<li>A body containing some Jinja template code</li>
-</ul>
-<p>Both are optional:</p>
+<p>Pages use the <a href="https://github.com/hyperflask/jinjapy">jinjapy</a> file format. It combines python code and a <a href="#the-page-template">jinja template</a>. The python code will be executed first on every request, then the template will be rendered.</p>
+<p>The python code is enclosed inside 2 lines containing 3 dashes "---"</p>
+<p>A special <a href="#the-page-object">page object</a> is available in the python code. Assign values to this object so that they become available in the template.</p>
+<div class="highlight"><pre><span></span><code><span class="c">---</span>
+<span class="n">page</span><span class="o">.</span><span class="n">message</span> <span class="o">=</span> <span class="s2">&quot;Hello world&quot;</span>
+<span class="c">---</span>
+<span class="cp">{{</span> <span class="nv">message</span> <span class="cp">}}</span>
+</code></pre></div>
+<p>Both the python code or the templates are optional:</p>
 <ul>
 <li>If the python code is missing, the file only contains a Jinja template</li>
 <li>If the python code is left unclosed (the file starts with "---" on a single line followed by some python code), the file has no template</li>
 </ul>
 <p>The python code has a few global variables injected when executed: <code>page</code>, <code>request</code>, <code>abort</code>, <code>redirect</code>, <code>url_for</code>, <code>current_app</code>, <code>render_template</code>.</p>
+<div class="admonition tip">
+<p class="admonition-title">Tip</p>
+<p>Pages can also be declared using .py files. In this case they will be pure python modules. Use <code>page.respond()</code> to send a response.</p>
+</div>
+<h2 id="the-page-template">The page template</h2>
+<p>Templates are powered by <a href="https://jinja.palletsprojects.com/en/stable/">Jinja</a>.</p>
+<p>We recommend reading the <a href="https://flask.palletsprojects.com/en/stable/templating/">Flask templating guide</a>.</p>
+<p>Hyperflask includes built-ins UI components powered by <a href="https://daisyui.com/">DaisyUI</a>. Check out the <a href="/guides/components/#built-in-ui-components">Components</a> guide.</p>
 <h2 id="content-pages">Content pages</h2>
 <p>No python code will be executed on content pages.</p>
 <p>Content pages can use the following formats:</p>
@@ -2066,10 +2072,6 @@ <h2 id="how-routing-works">How routing works</h2>
 </li>
 </ul>
 <p>The placeholder value is available through the <a href="#the-page-object"><code>page</code> object</a> (eg: <code>page.slug</code>).</p>
-<h2 id="the-page-template">The page template</h2>
-<p>Templates are powered by <a href="https://jinja.palletsprojects.com/en/stable/">Jinja</a>.</p>
-<p>We recommend reading the <a href="https://flask.palletsprojects.com/en/stable/templating/">Flask templating guide</a>.</p>
-<p>Hyperflask includes built-ins UI components powered by <a href="https://daisyui.com/">DaisyUI</a>. Check out the <a href="/guides/components/#built-in-ui-components">Components</a> guide.</p>
 <h2 id="layouts">Layouts</h2>
 <p>Hyperflask makes managing layouts for your pages easier. Layouts are saved in the <em>app/layouts</em> folder. The default layout can be overriden at <em>app/layouts/default.html</em>.
 (Hyperflask provides a default layout when none is created)</p>