sphinxnotes-recentupdate 1.1__tar.gz → 2.0a1__tar.gz

{sphinxnotes_recentupdate-1.1 → sphinxnotes_recentupdate-2.0a1}/.cruft.json

@@ -1,6 +1,6 @@
 {
   "template": "https://github.com/sphinx-notes/cookiecutter",
-  "commit": "4736b672023e3bf4bc80d0d51850d7bc45ca1e12",
+  "commit": "233a8daa4e276a9559975a51178f29e7079dcafd",
   "checkout": null,
   "context": {
     "cookiecutter": {
@@ -12,6 +12,8 @@
       "version": "1.1",
       "github_owner": "sphinx-notes",
       "github_repo": "recentupdate",
+      "generated_file_header": "This file is generated from sphinx-notes/cookiecutter.",
+      "dont_edit_header": "DO NOT EDIT.",
       "pypi_name": "sphinxnotes-recentupdate",
       "pypi_owner": "SilverRainZ",
       "is_python_project": true,
@@ -20,7 +22,7 @@
       "sphinx_version": "7.0",
       "development_status": "3 - Alpha",
       "_template": "https://github.com/sphinx-notes/cookiecutter",
-      "_commit": "4736b672023e3bf4bc80d0d51850d7bc45ca1e12"
+      "_commit": "233a8daa4e276a9559975a51178f29e7079dcafd"
     }
   },
   "directory": null

{sphinxnotes_recentupdate-1.1 → sphinxnotes_recentupdate-2.0a1}/.gitignore

@@ -1,3 +1,5 @@
+# This file is generated from sphinx-notes/cookiecutter.
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
@@ -135,3 +137,5 @@ poetry.lock
 docs/_build/
 # sphinxnotes-any >= 2.5
 docs/.any*
+
+.worktrees/

{sphinxnotes_recentupdate-1.1 → sphinxnotes_recentupdate-2.0a1}/.pre-commit-config.yaml

@@ -1,6 +1,8 @@
+# This file is generated from sphinx-notes/cookiecutter.
+
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.1
+    rev: v0.14.11
     hooks:
       - id: ruff-check
         args: [ --fix ]

sphinxnotes_recentupdate-2.0a1/AGENTS.md

@@ -0,0 +1,40 @@
+<!-- This file is generated from sphinx-notes/cookiecutter. --> 
+
+## 基本说明
+
+这是一个由 SphinxNotes 开发的 Sphinx Extension，由 `sphinxnotes/cookiecutter` 生成，很多基础文件来自模板。
+
+## 首先阅读
+
+- 开始了解项目时，优先阅读 `docs/index.rst`。
+- 如果任务和文档、Sphinx 配置或示例有关，继续阅读 `docs/` 下的其他文件
+
+## 通用知识
+
+- 使用 `make` 会构建 `docs/` 下的文档，文档自依赖当前项目，因此文档构建成功也意味着项目基本能正常构建
+  - `docs/_build` 存放构建好的文档，`make clean` 清除所有构建结果
+  - `make test` 运行测试，测试位于 `tests/`，可能的 e2e 测试位于 `tests/test_e2e.py`
+  - `make doctest` 运行 Sphinx 文档测试
+  - `make install` 使用 `pip install --user` 将项目安装到本地，跨项目测试时常用
+- `make tmpl-*` 用于模板同步，参看 "模板同步" 小节
+
+## 关于 SphinxNotes 项目
+
+- 同为 `sphinxnotes` 项目的其他仓库通常位于当前项目的上一级目录
+- 如果你在阅读代码时遇到本地依赖、模板来源或跨仓库复用关系，可以直接读取这些本地仓库文件，不必先猜测实现，也不必优先去远程搜索。
+- 当我提到 "所有项目" 的时候，请从当前项目的上一级目录的 `cookiecutter/project-list.txt` 获取项目列表
+- `docs/conf.py` 往往会直接从源码树导入当前项目，因此排查文档构建问题时，要同时检查运行时依赖和文档依赖。
+
+## 模板同步
+
+- 先确认任务是当前项目问题，还是模板问题；如果是模板问题，优先在 `sphinxnotes/cookiecutter` 中修复。
+- 模板变更完成后，优先使用 `make tmpl-update` 把改动同步回项目，而不是手工重复修改生成文件。
+- 如果 `make tmpl-update` 产生 `.rej`、冲突或三方合并失败，优先尝试 `make tmpl-apply-rej`，再手工解决冲突。
+- 手工解决冲突时，重点检查 `README.rst`、`pyproject.toml`、`.github/workflows/`、`docs/conf.py`、`docs/requirements.txt` 这些常见受影响文件。
+- 当模板同步结果确认无误后，优先使用 `make tmpl-update-done` 完成后续收尾步骤。
+
+### 修改约定
+
+- 修改模板生成文件时，保留原有注释，除非模板本身已经统一移除了这些注释。
+- 遇到 `CUSTOM ... START` / `END` 这类用户自定义区块时，必须保留这些锚点，并尽量保留区块中的用户内容。
+- 如果模板更新和项目内手工修改发生冲突，优先保护用户自定义内容，再整理模板变更。

{sphinxnotes_recentupdate-1.1 → sphinxnotes_recentupdate-2.0a1}/MANIFEST.in

@@ -1,5 +1,4 @@
 # This file is generated from sphinx-notes/cookiecutter.
-# You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 include LICENSE
 include README.rst

{sphinxnotes_recentupdate-1.1 → sphinxnotes_recentupdate-2.0a1}/Makefile

@@ -1,5 +1,4 @@
 # This file is generated from sphinx-notes/cookiecutter.
-# You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 LANG = en_US.UTF-8
 
@@ -23,11 +22,15 @@ clean:
 
 .PHONY: fmt
 fmt:
-	ruff format src/ && ruff check --fix src/
+	ruff format src/ tests/ && ruff check --fix src/ tests/
 
 .PHONY: test
 test:
-	$(PY) -m unittest discover -s tests -v
+	$(PY) -m pytest tests/ -v
+
+.PHONY: doctest
+doctest:
+	$(MAKE) doctest -C docs/
 
 ################################################################################
 # Distribution Package
@@ -36,7 +39,8 @@ test:
 # Build distribution package, for "install" or "upload".
 .PHONY: dist
 dist: pyproject.toml clean
-	$(PY) -m build
+	# Use ``--no-isolation`` to prevent network accessing when in local env.
+	$(PY) -m build $(if $(CI),,--no-isolation)
 
 # Install distribution package to user directory.
 #

{sphinxnotes_recentupdate-1.1/src/sphinxnotes_recentupdate.egg-info → sphinxnotes_recentupdate-2.0a1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sphinxnotes-recentupdate
-Version: 1.1
+Version: 2.0a1
 Summary: Get the document update information from git and display it in Sphinx documentation
 Author: Shengyu Zhang
 Maintainer: Shengyu Zhang
@@ -25,7 +25,7 @@ Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: Sphinx>=7.0
 Requires-Dist: GitPython
-Requires-Dist: Jinja2
+Requires-Dist: sphinxnotes-render
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
@@ -34,20 +34,9 @@ Requires-Dist: ruff>=0.11.10; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
 Provides-Extra: test
 Requires-Dist: pytest; extra == "test"
-Provides-Extra: docs
-Requires-Dist: furo; extra == "docs"
-Requires-Dist: sphinx_design; extra == "docs"
-Requires-Dist: sphinx_copybutton; extra == "docs"
-Requires-Dist: sphinxcontrib-gtagjs; extra == "docs"
-Requires-Dist: sphinx-sitemap; extra == "docs"
-Requires-Dist: sphinxext-opengraph; extra == "docs"
-Requires-Dist: sphinx-last-updated-by-git; extra == "docs"
-Requires-Dist: sphinxnotes-project; extra == "docs"
-Requires-Dist: sphinxnotes-comboroles; extra == "docs"
 Dynamic: license-file
 
 .. This file is generated from sphinx-notes/cookiecutter.
-   You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 ========================
 sphinxnotes-recentupdate

{sphinxnotes_recentupdate-1.1 → sphinxnotes_recentupdate-2.0a1}/README.rst

@@ -1,5 +1,4 @@
 .. This file is generated from sphinx-notes/cookiecutter.
-   You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 ========================
 sphinxnotes-recentupdate

{sphinxnotes_recentupdate-1.1 → sphinxnotes_recentupdate-2.0a1}/docs/Makefile

@@ -1,5 +1,4 @@
 # This file is generated from sphinx-notes/cookiecutter.
-# You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 # Minimal makefile for Sphinx documentation
 

sphinxnotes_recentupdate-2.0a1/docs/_images/.gitkeep

@@ -0,0 +1 @@
+# This file is generated from sphinx-notes/cookiecutter.

sphinxnotes_recentupdate-2.0a1/docs/_static/.gitkeep

@@ -0,0 +1 @@
+# This file is generated from sphinx-notes/cookiecutter.

sphinxnotes_recentupdate-2.0a1/docs/_static/custom.css

@@ -0,0 +1,10 @@
+/* This file is generated from sphinx-notes/cookiecutter.
+ * DO NOT EDIT.
+ */
+
+/* Missing style for nodes.system_message from Alabaster. */
+.system-message {
+    background-color: #fda;
+    padding: 5px;
+    border: 3px solid red;
+}

sphinxnotes_recentupdate-2.0a1/docs/changelog.rst

@@ -0,0 +1,57 @@
+.. This file is generated from sphinx-notes/cookiecutter.
+
+==========
+Change Log
+==========
+
+.. hint:: You may want to learn about our `Release Strategy`__
+
+   __ https://sphinx.silverrainz.me/release.html
+
+.. Example:
+
+   1.0
+   ===
+
+   .. version:: _
+      :date: yyyy-mm-dd
+
+   Change log here.
+
+Version 2.x
+===========
+
+.. version:: 2.0
+   :break:
+
+   - The template feature is now provided by
+     :external+render:doc:`sphinxnotes-render <index>`. It offers richer features;
+     Please see :external+render:doc:`tmpl`
+   - The extension now provides a ``recentupdate`` extra context for replacing 
+     the ``.. recentupdate::`` directive. See :doc:`usage` for more details
+
+   BREAKING CHANGES:
+
+   - Drop the ``.. recentupdate::`` directive
+   - Drop the ``strftime`` and ``roles`` filters
+   - Drop the ``recentupdate_date_format``, ``recentupdate_template``, and
+     ``recentupdate_exclude_path`` confvals
+   - The members of :py:class:`~sphinxnotes.recentupdate.Revision` are renamed
+
+Version 1.x
+===========
+
+.. version:: 1.1
+   :date: 2025-10-30
+
+   - fix: Deal with case when sphinx srcdir != git workdir
+
+.. version:: 1.0
+   :date: 2025-10-17
+
+   First stable version after five years :-)
+
+.. version:: 1.0a0
+   :date: 2021-12-06 
+
+   Release alpha version.

{sphinxnotes_recentupdate-1.1 → sphinxnotes_recentupdate-2.0a1}/docs/conf.py

@@ -1,5 +1,4 @@
 # This file is generated from sphinx-notes/cookiecutter.
-# You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 # Configuration file for the Sphinx documentation builder.
 #
@@ -23,6 +22,8 @@ version = release = '1.1'
 # ones.
 extensions = [
     'sphinx.ext.githubpages',
+    'sphinx.ext.doctest',
+    'sphinx.ext.viewcode',
     'sphinx_design',
     'sphinx_copybutton',
     'sphinx_last_updated_by_git',
@@ -45,6 +46,9 @@ exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
 # produce any output in the built files.
 show_authors = True
 
+# Keep warnings as “system message” paragraphs in the rendered documents.
+keep_warnings = True
+
 # -- Options for HTML output -------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
@@ -52,12 +56,6 @@ show_authors = True
 #
 html_theme = 'furo'
 
-html_theme_options = {}
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
 html_theme_options = {
     "source_repository": "https://github.com/sphinx-notes/recentupdate/",
     "source_branch": "master",
@@ -70,6 +68,13 @@ html_baseurl = 'https://sphinx.silverrainz.me/recentupdate'
 
 html_logo = html_favicon = '_static/sphinx-notes.png'
 
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+html_css_files = ['custom.css']
+
 # -- Extensions -------------------------------------------------------------
 
 extensions.append('sphinx.ext.extlinks')
@@ -85,13 +90,12 @@ gtagjs_ids = ['G-E4SNX0WZYV']
 extensions.append('sphinx.ext.autodoc')
 autoclass_content = 'init'
 autodoc_typehints = 'description'
+autodoc_default_options = {
+    'member-order': 'bysource',
+}
 
 extensions.append('sphinx.ext.intersphinx')
-intersphinx_mapping = {
-    'python': ('https://docs.python.org/3', None),
-    'sphinx': ('https://www.sphinx-doc.org/en/master', None),
-    'jinja': ('https://jinja.palletsprojects.com/en/latest/', None),
-}
+intersphinx_mapping = {}
 
 extensions.append('sphinx_sitemap')
 sitemap_filename = "sitemap.xml"
@@ -107,6 +111,7 @@ comboroles_roles = {
     'parsed_literal': (['literal'], True),
 }
 
+
 extensions.append('sphinxnotes.project')
 primary_domain = 'any'
 
@@ -117,7 +122,17 @@ primary_domain = 'any'
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 import os
 import sys
-sys.path.insert(0, os.path.abspath('../src/sphinxnotes'))
-extensions.append('recentupdate')
+sys.path.insert(0, os.path.abspath('../src/'))
+extensions.append('sphinxnotes.recentupdate')
 
 # CUSTOM CONFIGURATION
+
+intersphinx_mapping['render'] = ('https://sphinx.silverrainz.me/render', None)
+
+extensions.append('sphinxnotes.render.ext')
+
+manpages_url = 'https://manpages.debian.org/{path}'
+
+autodoc_typehints = 'signature'
+
+project_example_style = 'stack'

sphinxnotes_recentupdate-2.0a1/docs/conf.rst

@@ -0,0 +1,14 @@
+=============
+Configuration
+=============
+
+The extension provides the following configuration:
+
+.. autoconfval:: recentupdate_exclude_commit
+
+   A list of commit message pattern that should be excluded when looking for file changes.
+
+.. autoconfval:: recentupdate_count
+
+   Number of recent revisions to return by default when calling
+   ``load_extra('recentupdate')`` without an explicit ``count`` parameter.

{sphinxnotes_recentupdate-1.1 → sphinxnotes_recentupdate-2.0a1}/docs/index.rst

@@ -1,5 +1,4 @@
 .. This file is generated from sphinx-notes/cookiecutter.
-   You need to consider modifying the TEMPLATE or modifying THIS FILE.
 
 ========================
 sphinxnotes-recentupdate
@@ -28,12 +27,14 @@ Introduction
 
 .. INTRODUCTION START
 
-Get the document update information from git and display it in Sphinx documentation.
+Get the Sphinx document update information from Git repository.
 
-This extensions provides a :doc:`recentupdate <usage>` directive, which can show recent document update of current Sphinx documentation. The update information is read from Git_ repository (So you must use Git to manage your documentation). You can customize the update information through generating reStructuredText from Jinja_ template.
+This extension integrates with :external+render:doc:`sphinxnotes-render <index>`
+by providing an extra context ``recentupdate``. The recent document update
+information is read from a Git_ repository. You can customize the presentation
+via ``data.render`` template.
 
 .. _Git: https://git-scm.com/
-.. _Jinja: https://jinja.palletsprojects.com/en/3.0.x/templates/
 
 .. INTRODUCTION END
 
@@ -59,22 +60,33 @@ Then, add the extension name to ``extensions`` configuration item in your
 .. code-block:: python
 
    extensions = [
-             # …
-             'sphinxnotes.recentupdate',
-             # …
-             ]
+              # …
+              'sphinxnotes.render.ext',
+              'sphinxnotes.recentupdate',
+              # …
+              ]
 
 .. _Getting Started with Sphinx: https://www.sphinx-doc.org/en/master/usage/quickstart.html
 .. _conf.py: https://www.sphinx-doc.org/en/master/usage/configuration.html
 
 .. ADDITIONAL CONTENT START
 
-Add ``recentupdate`` directive to your document, build your document, the directive will be rendered to:
+Now you can use the :rst:dir:`data.render` directive (provided by
+``sphinxnotes.render.ext``) with ``recentupdate`` extra context to render
+a revision list:
 
 .. example::
-   :style: grid
 
-   .. recentupdate::
+   .. data.render::
+
+      The most recent 3 commits:
+
+      {% for r in load_extra('recentupdate', 3) %}
+      ``{{ r.date }}``
+         {{ r.message[0] }}
+      {% endfor %}
+
+Please refer to :doc:`usage` for more details.
 
 .. ADDITIONAL CONTENT END
 
@@ -98,6 +110,7 @@ as part of **The Sphinx Notes Project**.
    :caption: The Sphinx Notes Project
 
    Home <https://sphinx.silverrainz.me/>
+   GitHub <https://github.com/sphinx-notes>
    Blog <https://silverrainz.me/blog/category/sphinx.html>
    PyPI <https://pypi.org/search/?q=sphinxnotes>
 

{sphinxnotes_recentupdate-1.1 → sphinxnotes_recentupdate-2.0a1}/docs/make.bat

@@ -1,37 +1,38 @@
-REM This file is generated from sphinx-notes/cookiecutter. DO NOT EDIT.
-
-@ECHO OFF
-
-pushd %~dp0
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=python -msphinx
-)
-set SOURCEDIR=.
-set BUILDDIR=_build
-
-if "%1" == "" goto help
-
-%SPHINXBUILD% >NUL 2>NUL
-if errorlevel 9009 (
-	echo.
-	echo.The Sphinx module was not found. Make sure you have Sphinx installed,
-	echo.then set the SPHINXBUILD environment variable to point to the full
-	echo.path of the 'sphinx-build' executable. Alternatively you may add the
-	echo.Sphinx directory to PATH.
-	echo.
-	echo.If you don't have Sphinx installed, grab it from
-	echo.http://sphinx-doc.org/
-	exit /b 1
-)
-
-%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
-goto end
-
-:help
-%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
-
-:end
-popd
+REM This file is generated from sphinx-notes/cookiecutter.
+REM DO NOT EDIT.
+
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=python -msphinx
+)
+set SOURCEDIR=.
+set BUILDDIR=_build
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The Sphinx module was not found. Make sure you have Sphinx installed,
+	echo.then set the SPHINXBUILD environment variable to point to the full
+	echo.path of the 'sphinx-build' executable. Alternatively you may add the
+	echo.Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.http://sphinx-doc.org/
+	exit /b 1
+)
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+
+:end
+popd

sphinxnotes_recentupdate-2.0a1/docs/requirements.txt

@@ -0,0 +1,16 @@
+# This file is generated from sphinx-notes/cookiecutter.
+
+# Documentation build dependencies.
+# Keep these out of pyproject optional-dependencies to avoid resolver issues.
+furo
+sphinx_copybutton
+sphinxcontrib-gtagjs
+sphinx-sitemap
+sphinxext-opengraph
+sphinx-last-updated-by-git
+sphinxnotes-project
+sphinxnotes-comboroles
+
+# CUSTOM DOCS DEPENDENCIES START
+sphinxnotes-render
+# CUSTOM DOCS DEPENDENCIES END

sphinxnotes_recentupdate-2.0a1/docs/usage.rst

@@ -0,0 +1,104 @@
+=====
+Usage
+=====
+
+The extension provides an extra context ``recentupdate`` for `sphinxnotes-render`_.
+Extra context can be load by the :external+render:term:`load_extra` function in
+a Jinja template. User can easily render a Jinja template via :rst:dir:`data.render`
+directive.
+
+``recentupdate``
+================
+
+When calling ``load_extra('recentupdate', **kwargs)`` in the template, the
+following parameters are available:
+
+``count``
+  Number of recent revisions to return (default from :confval:`recentupdate_count`).
+
+``path``
+  A git pathspec (:manpage:`gitglossary(7)`) to filter file changes
+  (default ``'.'``).
+  See also :example:`Recent Updates of Custom Path`.
+
+``current_doc``
+  If ``True``, only return revisions that modified the current document
+  (default ``False``).
+  See also :example:`Recent Updates to Current Document`.
+
+Each item returned is a :py:class:`~sphinxnotes.recentupdate.Revision` object:
+
+.. autoclass:: sphinxnotes.recentupdate.Revision
+
+   .. autoattribute:: message
+   .. autoattribute:: author
+   .. autoattribute:: date
+   .. autoattribute:: added_docs
+   .. autoattribute:: changed_docs
+   .. autoattribute:: removed_docs
+
+This is a basic example:
+
+.. example::
+
+   .. data.render::
+
+      {% for r in load_extra('recentupdate', count=5) %}
+      ``👤{{ r.author }}`` @ ``📅 {{ r.date }}``
+         {{ r.message[0] }}
+      {% endfor %}
+
+Examples
+========
+
+.. example:: Show Which Files Updated
+
+   .. data.render::
+
+      {% for r in load_extra('recentupdate', count=5) %}
+      ``📅 {{ r.date }}``
+         {% if r.changed_docs -%}
+         :Modified: {{ r.changed_docs | roles("doc") | join(", ") }}
+         {% endif %}
+         {% if r.added_docs -%}
+         :Added: {{ r.added_docs | roles("doc") | join(", ") }}
+         {% endif %}
+         {% if r.removed_docs -%}
+         :Deleted: {{ r.removed_docs | join(", ") }}
+         {% endif %}
+      {% endfor %}
+
+      The aboved :external+render:term:`roles` filter is also provided by
+      `sphinxnotes-render`_.
+
+.. example:: Recent Updates of Custom Path
+
+   .. data.render::
+
+      Recent changes of the ``docs/index.rst`` file:
+
+      {% for r in load_extra('recentupdate', count=5, path='docs/index.rst') %}
+      ``{{ r.date }}`` — {{ r.message[0] }}
+      {% endfor %}
+
+.. example:: Recent Updates to Current Document
+
+   .. data.render::
+
+      Recent changes to this document:
+
+      {% for r in load_extra('recentupdate', count=5, current_doc=True) %}
+      ``{{ r.date }}`` — {{ r.message[0] }}
+      {% endfor %}
+
+``sphinxnotes-render``
+======================
+
+For more details about ``sphinxnotes-render``:
+
+.. seealso::
+
+   :external+render:doc:`sphinxnotes-render: Templating <tmpl>`
+     How to write ``data.render`` templates.
+   :external+render:doc:`sphinxnotes-render: Extending <ext>`
+     How extra context and filters work.