changeset 263:2e78e255b54e

Make a link to the reST source where appropriate to learn about the lexer syntax
author Franz Glasner <fzglas.hg@dom66.de>
date Tue, 19 May 2026 18:03:48 +0200
parents 27fd802338c6
children 3dce08f06ecc
files docs/_latex/intro-latex.rst docs/conf.py docs/lexer-algpseudocode.rst docs/lexer-frpseudocode.rst
diffstat 4 files changed, 29 insertions(+), 9 deletions(-) [+]
line wrap: on
line diff
--- a/docs/_latex/intro-latex.rst	Mon May 18 12:25:48 2026 +0200
+++ b/docs/_latex/intro-latex.rst	Tue May 19 18:03:48 2026 +0200
@@ -4,17 +4,13 @@
  Introduction
 **************
 
-Metadata
-========
+.. topic:: Metadata
 
-.. include:: ../../README.rst
-   :start-line: 5
-   :end-before: This package
+   .. include:: ../../README.rst
+      :start-line: 5
+      :end-before: This package
 
 
-Content
-=======
-
 This package contains `Pygments`_ lexers for some basic pseudocode.
 
 Initially a fork of `pygments-lexer-pseudocode` it has been considerably
--- a/docs/conf.py	Mon May 18 12:25:48 2026 +0200
+++ b/docs/conf.py	Tue May 19 18:03:48 2026 +0200
@@ -125,8 +125,20 @@
 
 html_static_path = ['_static']
 html_extra_path = ['../LICENSES']
-html_copy_source = False
+html_copy_source = True
 html_show_sourcelink = False
+#html_sidebars = {
+#    '**': [
+#        'localtoc.html',     # a fine-grained table of contents of the
+#                             # current document
+#        'globaltoc.html',    # a coarse-grained table of contents for the
+#                             # whole documentation set -- collapsed
+#        'sourcelink.html',   # a link to the source of the current document,
+#                             # if enabled in html_show_sourcelink
+#        'relations.html',    # two links to the previous and next documents
+#        'searchbox.html',    # the “quick search” box
+#    ],
+#}
 
 #html_theme = 'alabaster'
 html_theme = 'haiku'
--- a/docs/lexer-algpseudocode.rst	Mon May 18 12:25:48 2026 +0200
+++ b/docs/lexer-algpseudocode.rst	Tue May 19 18:03:48 2026 +0200
@@ -5,6 +5,12 @@
  AlgPseudocode and Language Variants
 *************************************
 
+.. only:: html
+
+   .. hint::
+      The reST source of this documentation page can be found
+      `here <_sources/lexer-algpseudocode.rst.txt>`_.
+
 These lexers are heavily inspired by CTAN’s `Algpseudocodex`_.
 They recognize all sorts of single- and multi-line comments in addition to
 expressions and commands that are inspired by `Algpseudocodex`_.
--- a/docs/lexer-frpseudocode.rst	Mon May 18 12:25:48 2026 +0200
+++ b/docs/lexer-frpseudocode.rst	Tue May 19 18:03:48 2026 +0200
@@ -4,6 +4,12 @@
  FrPseudocode
 **************
 
+.. only:: html
+          
+   .. hint::
+      The reST source of this documentation page can be found
+      `here <_sources/lexer-frpseudocode.rst.txt>`_.
+
 This is the pseudocode lexer from the original `pygments-lexer-pseudocode`
 package.