# HG changeset patch # User Franz Glasner # Date 1778149313 -7200 # Node ID b616f9645e37473abb34a3c4405e209cc2d2ad38 # Parent 6da3b9dd42945c578416f4ef3ae6591930502ac0 More referencing with internal and external links diff -r 6da3b9dd4294 -r b616f9645e37 README.rst --- 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 diff -r 6da3b9dd4294 -r b616f9645e37 docs/conf.py --- 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 diff -r 6da3b9dd4294 -r b616f9645e37 docs/details-algpseudocode.rst --- 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 diff -r 6da3b9dd4294 -r b616f9645e37 docs/intro.rst --- 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