diff options
author | Mike Bayer <mike_mp@zzzcomputing.com> | 2019-07-04 09:35:16 -0400 |
---|---|---|
committer | Mike Bayer <mike_mp@zzzcomputing.com> | 2019-07-04 09:35:16 -0400 |
commit | 8648759895b8778f06528ecebf5170f67a0dc65e (patch) | |
tree | 03113c4734555d3bdf6bdc75fb1b794f2ae30b01 | |
parent | 4861e0d58fdfe2bd15d4d26beb0b8163ce3a6637 (diff) | |
download | mako-8648759895b8778f06528ecebf5170f67a0dc65e.tar.gz |
Add top-level doc links for <%page> tag
I found it difficult to locate what the <%page> tag is capable
of, iterate everything it is known to be useful for including
links in the intro paragraph for <%page>.
Change-Id: Ice4c92a10943829f33c423f015eb49baaacc5fdc
References: #299
-rw-r--r-- | doc/build/filtering.rst | 2 | ||||
-rw-r--r-- | doc/build/syntax.rst | 13 |
2 files changed, 13 insertions, 2 deletions
diff --git a/doc/build/filtering.rst b/doc/build/filtering.rst index 3bcb25a..c8765d3 100644 --- a/doc/build/filtering.rst +++ b/doc/build/filtering.rst @@ -4,6 +4,8 @@ Filtering and Buffering ======================= +.. _expression_filtering: + Expression Filtering ==================== diff --git a/doc/build/syntax.rst b/doc/build/syntax.rst index 4d2814d..2873584 100644 --- a/doc/build/syntax.rst +++ b/doc/build/syntax.rst @@ -271,8 +271,17 @@ Currently, only one ``<%page>`` tag gets used per template, the rest get ignored. While this will be improved in a future release, for now make sure you have only one ``<%page>`` tag defined in your template, else you may not get the results you -want. The details of what ``<%page>`` is used for are described -further in :ref:`namespaces_body` as well as :ref:`caching_toplevel`. +want. Further details on what ``<%page>`` is used for are described +in the following sections: + +* :ref:`namespaces_body` - ``<%page>`` is used to define template-level + arguments and defaults + +* :ref:`expression_filtering` - expression filters can be applied to all + expressions throughout a template using the ``<%page>`` tag + +* :ref:`caching_toplevel` - options to control template-level caching + may be applied in the ``<%page>`` tag. ``<%include>`` -------------- |