changeset 144:b616f9645e37

More referencing with internal and external links
author Franz Glasner <fzglas.hg@dom66.de>
date Thu, 07 May 2026 12:21:53 +0200
parents 6da3b9dd4294
children c4f6f5e771b0
files README.rst docs/conf.py docs/details-algpseudocode.rst docs/intro.rst
diffstat 4 files changed, 12 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/README.rst	Thu May 07 11:27:03 2026 +0200
+++ b/README.rst	Thu May 07 12:21:53 2026 +0200
@@ -44,7 +44,7 @@
 
     pygmentize -l algpseudocode somefile
 
-  Within Sphinx use a lexer like this::
+  Within `Sphinx`_ use a lexer like this::
 
     .. code-block:: algpseudocode
 
--- a/docs/conf.py	Thu May 07 11:27:03 2026 +0200
+++ b/docs/conf.py	Thu May 07 12:21:53 2026 +0200
@@ -50,6 +50,10 @@
 
 highlight_language = "none"
 
+rst_epilog = """
+.. _Sphinx: https://www.sphinx-doc.org
+"""
+
 
 # --- Options for todo extension ---------------------------------------------
 todo_include_todos = True
--- a/docs/details-algpseudocode.rst	Thu May 07 11:27:03 2026 +0200
+++ b/docs/details-algpseudocode.rst	Thu May 07 12:21:53 2026 +0200
@@ -40,6 +40,9 @@
      The symbol to be printed as when starting comments with
      ``\REMARK`` or ``\REM``.
 
+  To use a lexer with non-default options in `Sphinx`_ see section
+  :ref:`customized-sphinx-lexers`.
+
 
 Comments
 ========
@@ -272,10 +275,12 @@
 .. note:: Explicit token types are **case-sensitive**.
 
 
+.. _customized-sphinx-lexers:
+
 Customized Lexers in Sphinx
 ===========================
 
-Defining lexers with non-default options in Sphinx can be done in its
+Defining lexers with non-default options in `Sphinx`_ can be done in its
 configuration file :file:`conf.py`:
 
 .. code-block:: python
--- a/docs/intro.rst	Thu May 07 11:27:03 2026 +0200
+++ b/docs/intro.rst	Thu May 07 12:21:53 2026 +0200
@@ -8,7 +8,7 @@
 
 .. include:: lexerlist.rst
 
-They may be used in Sphinx by their aliases:
+They may be used in `Sphinx`_ by their aliases:
 
 .. code-block:: none