Skip to content

Commit 111fcbf

Browse files
committed
docs: Make more things referenceable
1 parent 67962ee commit 111fcbf

1 file changed

Lines changed: 34 additions & 28 deletions

File tree

docs/tmpl.rst

Lines changed: 34 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -153,15 +153,19 @@ extension defines the schema through the :rst:dir:`data.schema` directive or
153153
Extra Context
154154
-------------
155155

156-
Extra context provides access to pre-prepared structured data from external
157-
sources (such as Sphinx application, JSON file, and etc.). Unlike main context
158-
which comes from the directive/role itself, extra context lets you fetch data
159-
that was prepared beforehand.
156+
.. glossary::
157+
158+
Extra Context
159+
Extra context provides access to pre-prepared structured data from external
160+
sources (such as Sphinx application, JSON file, and etc.). Unlike main context
161+
which comes from the directive/role itself, extra context lets you fetch data
162+
that was prepared beforehand.
160163

161-
Extra contexts are generated on demand. Load them in the template using the
162-
``load_extra()`` function. You can also pass positional and keyword arguments
163-
to ``load_extra()``, which are forwarded to the extra context's
164-
``generate()`` method.
164+
``load_extra``
165+
Extra contexts are generated on demand. Load them in the template using the
166+
``load_extra()`` function. You can also pass positional and keyword arguments
167+
to ``load_extra()``, which are forwarded to the extra context's
168+
``generate()`` method.
165169

166170
.. example::
167171
:style: grid
@@ -275,35 +279,37 @@ following filters:
275279

276280
__ https://jinja.palletsprojects.com/en/stable/templates/#builtin-filters
277281

278-
``roles``
279-
Produces role markup from a sequence of strings.
282+
.. glossary::
280283

281-
.. example::
282-
:style: grid
284+
``roles``
285+
Produces role markup from a sequence of strings.
283286

284-
.. data.render::
287+
.. example::
288+
:style: grid
285289

286-
{%
287-
set text = ['index', 'usage']
288-
| roles('doc')
289-
| join(', ')
290-
%}
290+
.. data.render::
291291
292-
:Text: ``{{ text }}``
293-
:Rendered: {{ text }}
292+
{%
293+
set text = ['index', 'usage']
294+
| roles('doc')
295+
| join(', ')
296+
%}
294297
295-
``jsonify``
296-
Convert value to JSON.
298+
:Text: ``{{ text }}``
299+
:Rendered: {{ text }}
297300
298-
.. example::
299-
:style: grid
301+
``jsonify``
302+
Convert value to JSON.
300303

301-
.. data.render::
304+
.. example::
305+
:style: grid
306+
307+
.. data.render::
302308
303-
{% set text = {'name': 'mimi'} %}
309+
{% set text = {'name': 'mimi'} %}
304310
305-
:Strify: ``{{ text }}``
306-
:JSONify: ``{{ text | jsonify | replace('\n', '')}}``
311+
:Strify: ``{{ text }}``
312+
:JSONify: ``{{ text | jsonify | replace('\n', '')}}``
307313
308314
.. seealso:: :ref:`ext-filters`
309315

0 commit comments

Comments
 (0)