view README.rst @ 160:b4028838e0c8

Implement lexer option "prohibit_raiseonerror_filter". Sphinx raises by default when an Error token is seen (by means of the "raiseonerror" filter that is applied by default to lexers in Sphinx). This option skips this and allows error locations to be seen and highlighted properly. While there convert most Generic.Error tokens to Error tokens because now they can be handled by a lexer with "prohibit_raiseonerror_filter=True".
author Franz Glasner <fzglas.hg@dom66.de>
date Fri, 08 May 2026 17:46:28 +0200
parents c4f6f5e771b0
children 6a7dace0141e
line wrap: on
line source

.. -*- coding: utf-8 -*-

*****************************************
 README -- Pseudocode Lexer for Pygments
*****************************************

This package contains `Pygments`_ lexers for some basic pseudocode.

Initially a fork of `pygments-lexer-pseudocode` it has been considerably
changed and expanded.

It now contains the following lexers:

.. include:: lexerlist.rst


Installation
============

The lexers are available as a `Python`_ wheel package::

    pip install pygments-lexer-pseudocode2

Alternatively, to build from the source code repository::

    python -m build


Usage
=====

After installation the Pseudocode lexers automatically register itself
within the plugin system of Pygments. All aliases and filename extensions
from above are made known to Pygments.

Usage is easy.

  Pygmentizing a file with a known file extension::

    pygmentize document.algpseudocode

  Or you can manally select the Pseudocode lexer you want to use by
  using a command line flag::

    pygmentize -l algpseudocode somefile

  Within `Sphinx`_ use a lexer like this::

    .. code-block:: algpseudocode


License
=======

The package is licensed under the terms of the MIT Licence.

Some code snippets are licensed under the terms of the
BSD 2-Clause "Simplified" License as they are taken from the Python
lexer that is included in `Pygments`_.