summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMike Bayer <mike_mp@zzzcomputing.com>2019-07-04 09:35:16 -0400
committerMike Bayer <mike_mp@zzzcomputing.com>2019-07-04 09:35:16 -0400
commit8648759895b8778f06528ecebf5170f67a0dc65e (patch)
tree03113c4734555d3bdf6bdc75fb1b794f2ae30b01
parent4861e0d58fdfe2bd15d4d26beb0b8163ce3a6637 (diff)
downloadmako-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.rst2
-rw-r--r--doc/build/syntax.rst13
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>``
--------------