Syntax Highlighting With Rouge
Rouge (MIT licensed) is a fast syntax highlighter that is compatible with stylesheets designed for Pygments.
To use Rouge, set the option ‘syntax_highlighter’ to
‘rouge’ and make sure that Rouge is available. The Rouge library can be installed, e.g., via
Rubygems by running
gem install rouge.
The Rouge syntax highlighter supports the following keys of the option ‘syntax_highlighter_opts’:
- The default language that should be used when no language is set.
- A custom Rouge formatter class that should be used instead of
Note that setting this key only makes sense using Ruby code because the value needs to be a class object!
- If set to
true, highlighting with Rouge will be disabled.
Should probably not be set globally but inside the ‘span’ or ‘block’ options.
- A key-value map of options that are only used when syntax highlighting code spans.
- A key-value map of options that are only used when syntax highlighting code blocks.
Furthermore all Rouge options (e.g. ‘line_numbers’) can be set directly on the ‘syntax_highlighter_opts’ option (where they apply to code spans and code blocks) and/or on the ‘span’/’block’ keys.