Code Highlighter 2

Description

Code Highlighter 2 allows syntax highlighting over 580 languages in LibreOffice.

Code Highlighter 2 is a fork of Code Highlighter, originally created by slgobinath but no more maintained.

Usage

• Open a LibreOffice document.
• Copy and paste the code snippet where you want it:
  • Writer: either in a text frame (preferred option), in a text box, in a table cell or as plain text;
  • Calc: either in a cell or in a text box;
  • Impress and Draw: in a text box.

• Select the text or the object containing the code snippet.
• Format -> Code Highlighter 2 -> Highlight Code:
  • in the dialog, select the language and style.
• Format -> Code Highlighter 2 -> Highlight Code (previous settings):
  • does not open a dialog, but applies previous settings (persistent also between restarts of LO).
• Format -> Code Highlighter 2 -> Update selection:
  • update an already highlighted snippet using the formatting informations stored with it.

Alternatively (from v2.7.2, Writer only)

• Format all your snippets with a dedicated paragraph style.
• Choose Format → Code Highlighter 2 → Highlight Code.
• Select the paragraph style and press Highlight all.

Features

• Supports all languages (more than 500) and styles (more than 40) provided by Pygments.
• Supports multiselection.
• Supports line numbering.
• Supports all modules excepted Base.
• Supports direct formatting or character styles.
• Allow to disable background color.
• Allow in-document preview [2.4.11].
• Allow highlighting at once all code formatted with a dedicated paragraph style [2.7.2]

Tips

• CodeHighlighter2 contains two styles that are not part of Pygments: libreoffice-classic and libreoffice-dark, that make use of LibreOffice IDE color schemes (classic mode and dark mode). Code Highlighter also adds a “LibreOffice Basic” language, which is not a Pygments lexer but a convenient shortcut to VB.net lexer, which is perfect for parsing LOBasic.
• Not all language aliases that are valid names for Code Highlighter 2 appear in the option dialog: if you are unable to find a language, try anyway to type its name in the combobox (try for example with “R” or with “Pascal”).
• Choose “automatic” to highlight from different languages at the same time.
• Click the “More…” button to access line numbers options or character styles options.
• Uncheck line numbering option to remove unwanted line numbers, due for example to copy-pasted code.
• For long snippet, CodeHighlighter2 works faster with text and text frame in Writer.

General behaviour

• Highlighting is applied to the selected object, that can be plain text, text frame, text shape, text table cell or calc cell.
• Highlight properties are hard-formatted for each token, parsed according to the choosen Pygments lexer (aka coding language). If someone prefers instead to make use of character styles, select the corresponding option in the dialog box (from v2.3.0, Writer only).
• When cursor is inside a text shape or a Calc cell, highlighting is applied to the whole shape or cell even if only a part of the text is selected.
• When cursor is inside a text frame, a text table cell or an already highlighted plain text*, highlighting is only applied to the selected text if any, otherwise to the whole frame, cell or plain text snippet.
• When highlighting applies to the selected text, it formats the entire paragraphs, even if selection starts after the paragraph start or ends before paragraph end, unless the selection is an inline snippet.
• Choosing "Update selection", the program will update highlighted code keeping the already applied options. If nothing is selected and the cursor is inside an already highlighted block, the whole block will be updated*.

_{* To allow code update, Code Highlighter 2 stores the formatting options in the document as User Defined Attributes. If you're not comfortable with that, you can disable it by setting the 'StoreOptionsWithSnippet' option to 0 in advanced options (Options-> Advanced-> Open Expert Configuration-> ooo.ext.code-highlighter.Registry).}

Dependencies

Linux users may need to first install the LibreOffice script provider for python.

For Ubuntu and derivatives, close all the LibreOffice products and do

sudo apt-get install libreoffice-script-provider-python

Other Linux systems may not need this package. If you encounter any problems after installing the extension, please check whether you have any similar package.

Localization

• en (English, US)
• fr (French - Français)
• hu (Hungarian - magyar) [thanks to ovari]
• it (Italian - Italiana)
• ru (Russian - Русский) [thanks to kompilainenn]

Any problems?

If you find any bugs, please report them at GitHub Issues.

Screenshots

Dialog:

Result:

Homepage: https://github.com/jmzambon/libreoffice-code-highlighter

Repository: https://github.com/jmzambon/libreoffice-code-highlighter