MediaWiki Custom Pygments: Difference between revisions

From Leo's Notes
This page was last edited on 1 June 2018, at 23:40.
No edit summary
No edit summary
Line 41: Line 41:
         'root': [
         'root': [
             (r'^##.*\n', Comment),
             (r'^##.*\n', Comment),
             (r'^(\[*[a-zA-Z0-9\@:~\/\-\]*]*[\$#]{1})', Name, 'command'),
             (r'^(\[*[a-zA-Z0-9\@:~\/\-\]*]*[\$#%]{1})', Name, 'command'),
            (r'^(\[+[a-zA-Z0-9\@:~\/\-\]+]*[\$#%]?)', Name, 'command'),
             (r'.*\n', Text)
             (r'.*\n', Text)
         ],
         ],
Line 50: Line 51:
                 (r'\n', String, '#pop')
                 (r'\n', String, '#pop')
         ]
         ]


     }
     }

Revision as of 23:40, 1 June 2018

To create a custom Pygments lexer for MediaWiki, do the following:

  1. Clone the Pygments project in the extensions/SyntaxHighlight_GeSHi/pygments directory. This should replace the pygmentize binary with the python script.
  2. Create your lexer in the extensions/SyntaxHighlight_GeSHi/pygments/pygments/lexers directory.
  3. Update the map by running make mapfiles in extensions/SyntaxHighlight_GeSHi/pygments
  4. Update the SyntaxHighlight_GeSHi.lexers.php file to contain the new lexer alias.

A simple lexer used on this wiki is for the Terminal output. It has the following lexer code which is just a couple regexes.

# -*- coding: utf-8 -*-
"""
    pygments.lexers.terminal
    ------------------------

    Lexers for terminal output

    :copyright:  Leo's stuff
    :license:  Leo's stuff
"""

import re

from pygments.lexer import RegexLexer, bygroups
from pygments.token import Text, Comment, Operator, Keyword, Name, String, \
    Number, Punctuation, Error

__all__ = ['TerminalLexer']

class TerminalLexer(RegexLexer):
    """
    For terminal output

    .. versionadded:: 0.1
    """

    name = 'terminal'
    aliases = ['terminal']

    tokens = {
        'root': [
            (r'^##.*\n', Comment),
            (r'^(\[*[a-zA-Z0-9\@:~\/\-\]*]*[\$#%]{1})', Name, 'command'),
            (r'^(\[+[a-zA-Z0-9\@:~\/\-\]+]*[\$#%]?)', Name, 'command'),
            (r'.*\n', Text)
        ],

        'command': [
                (r'[^\\\n]+', String),
                (r'\\\n', String),
                (r'\n', String, '#pop')
        ]



    }