Mercurial > hgrepos > Python > libs > pygments-lexer-pseudocode2

annotate README.rst @ 138:69283c05ba48

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Make the table of lexers in the docs identical again. Minor wording changes.
author Franz Glasner <fzglas.hg@dom66.de>
date Thu, 07 May 2026 09:28:54 +0200
parents f713190c6c0b
children acd9073cbbe3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
1 .. -*- coding: utf-8 -*-
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
2
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
3 *****************************************
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
4 README -- Pseudocode Lexer for Pygments
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
5 *****************************************
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
6
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
7 This package contains Pygments lexers for some basic pseudocode.
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
8
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
9 Initially a fork of `pygments-lexer-pseudocode` it has been considerably
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
10 changed and expanded.
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
11
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
12 It now contains the following lexers:
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
13
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
14 .. list-table::
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
15 :align: left
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
16 :header-rows: 1
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
17
138
69283c05ba48 Make the table of lexers in the docs identical again.
Franz Glasner <fzglas.hg@dom66.de>
parents: 136
diff changeset
18 * - Language Name
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
19 - Description
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
20 - Extension(s)
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
21 - Aliases / Short Name(s)
138
69283c05ba48 Make the table of lexers in the docs identical again.
Franz Glasner <fzglas.hg@dom66.de>
parents: 136
diff changeset
22 - Lexer Class
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
23
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
24 * - AlgPseudocode
138
69283c05ba48 Make the table of lexers in the docs identical again.
Franz Glasner <fzglas.hg@dom66.de>
parents: 136
diff changeset
25 - Pseudocode lexer heavily inspired by CTAN's "Algpseudocodex"
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
26 - \*.algpseudocode, \*.algpseudo
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
27 - algpseudocode, algpseudo
138
69283c05ba48 Make the table of lexers in the docs identical again.
Franz Glasner <fzglas.hg@dom66.de>
parents: 136
diff changeset
28 - AlgPseudocodeLexer
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
29
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
30 * - AlgPseudocodeFR
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
31 - AlgPseudocode with french keyword expansion
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
32 - \*.algpseudo-fr, \*.algpseudocode-fr
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
33 - algpseudocode-fr, algpseudo-fr
138
69283c05ba48 Make the table of lexers in the docs identical again.
Franz Glasner <fzglas.hg@dom66.de>
parents: 136
diff changeset
34 - AlgPseudocodeLexer_FR
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
35
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
36 * - AlgPseudocodeDE
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
37 - AlgPseudocode with german keyword expansion
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
38 - \*.algpseudo-de, \*.algpseudocode-de
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
39 - algpseudocode-de, algpseudo-de
138
69283c05ba48 Make the table of lexers in the docs identical again.
Franz Glasner <fzglas.hg@dom66.de>
parents: 136
diff changeset
40 - AlgPseudocodeLexer_DE
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
41
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
42 * - FrPseudocode
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
43 - The original lexer (slightly changed) from `pygments-lexer-pseudocode`
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
44 - \*.fr-algo, \*.fr-pseudocode
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
45 - fr-pseudocode, fr-pseudo, fr-algorithm, fr-algo
138
69283c05ba48 Make the table of lexers in the docs identical again.
Franz Glasner <fzglas.hg@dom66.de>
parents: 136
diff changeset
46 - FrPseudocodeLexer
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
47
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
48
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
49 Installation
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
50 ============
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
51
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
52 The lexers are available as a Python wheel package::
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
53
8
5812e7f3bc13 Rename the project the implementing class to "pygments-lexer-pseudocode2".
Franz Glasner <fzglas.hg@dom66.de>
parents: 1
diff changeset
54 pip install pygments-lexer-pseudocode2
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
55
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
56 Alternatively, to build from the source code repository::
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
57
8
5812e7f3bc13 Rename the project the implementing class to "pygments-lexer-pseudocode2".
Franz Glasner <fzglas.hg@dom66.de>
parents: 1
diff changeset
58 python -m build
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
59
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
60
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
61 Usage
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
62 =====
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
63
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
64 After installation the Pseudocode lexers automatically register itself
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
65 within the plugin system of Pygments. All aliases and filename extensions
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
66 from above are made known to Pygments.
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
67
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
68 Usage is easy.
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
69
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
70 Pygmentizing a file with a known file extension::
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
71
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
72 pygmentize document.algpseudocode
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
73
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
74 Or you can manally select the Pseudocode lexer you want to use by
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
75 using a command line flag::
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
76
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
77 pygmentize -l algpseudocode somefile
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
78
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
79 Within Sphinx use a lexer like this::
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
80
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
81 .. code-block:: algpseudocode
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
82
120
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
83
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
84 License
ef68b3769be5 Convert/rename README.md to README.rst and enhance it considerably
Franz Glasner <fzglas.hg@dom66.de>
parents: 8
diff changeset
85 =======
1
4615d6df8293 ADD: The original pygments-lexer-pseudocode project from GitHub.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
86
136
f713190c6c0b Also mention that some code snippets are licensed under the terms of BSD-2-Clause
Franz Glasner <fzglas.hg@dom66.de>
parents: 133
diff changeset
87 The package is licensed under the terms of the MIT Licence.
f713190c6c0b Also mention that some code snippets are licensed under the terms of BSD-2-Clause
Franz Glasner <fzglas.hg@dom66.de>
parents: 133
diff changeset
88
f713190c6c0b Also mention that some code snippets are licensed under the terms of BSD-2-Clause
Franz Glasner <fzglas.hg@dom66.de>
parents: 133
diff changeset
89 Some code snippets are licensed under the terms of the
f713190c6c0b Also mention that some code snippets are licensed under the terms of BSD-2-Clause
Franz Glasner <fzglas.hg@dom66.de>
parents: 133
diff changeset
90 BSD 2-Clause "Simplified" License as they are taken from the Python
f713190c6c0b Also mention that some code snippets are licensed under the terms of BSD-2-Clause
Franz Glasner <fzglas.hg@dom66.de>
parents: 133
diff changeset
91 lexer that is included in Pygments.