Pygments tokens usage

This document explains how BSL/SDBL lexers map code to Pygments tokens and how those tokens become CSS classes in the Zensical classic theme. It is meant to help you build custom themes with predictable syntax colors.

How to read this file

Each token becomes a CSS class in the rendered HTML. Zensical's classic theme then maps those classes to CSS variables like --md-code-hl-keyword-color. If a token has an empty flag, it means the lexer does not emit it.

Theming quick start

If you only want a solid base theme, focus on these CSS variables first:

• --md-code-hl-keyword-color (keywords, control flow)
• --md-code-hl-function-color (functions, types, namespaces)
• --md-code-hl-variable-color (variables, properties)
• --md-code-hl-string-color (strings, string escapes)
• --md-code-hl-number-color (numbers)
• --md-code-hl-comment-color (comments, doc sections)
• --md-code-hl-operator-color (operators)
• --md-code-hl-punctuation-color (punctuation)

Then refine:

• --md-code-hl-special-color (escapes, preprocessor, special strings)
• --md-code-hl-constant-color (builtins, constants)
• --md-code-hl-generic-color (errors, generic output)

For a concrete example of palette overrides, see docs/stylesheets/monokai.css.

BSL-focused examples

These snippets show how the lexer typically classifies elements. Use them as a visual target when adjusting your palette.

1
2

// Параметры:
//   Период - Дата - период расчета

Expected tokens:

• // and doc text: Comment.Single
• Параметры: Keyword
• Период: Name.Variable
• Дата: Name.Class
• - and :: Punctuation

1
2
3

Если ЗначениеЗаполнено(Период) Тогда
    Сообщить("ОК");
КонецЕсли;

Expected tokens:

• Если, Тогда, КонецЕсли: Keyword
• ЗначениеЗаполнено: Name.Builtin
• Период: Name.Variable
• "ОК": Literal.String
• (, ), ;: Punctuation

1

// РеквизитыКомпонент - Массив из см. ВнешниеКомпоненты.РеквизитыКомпоненты

Expected tokens:

• РеквизитыКомпонент: Name.Variable
• Массив: Name.Class
• из, см.: Keyword
• ВнешниеКомпоненты.РеквизитыКомпоненты: Name.Class

SDBL-focused examples

1
2
3

ВЫБРАТЬ
    ПОЛЕ
ИЗ Таблица

Expected tokens:

• ВЫБРАТЬ, ИЗ: Keyword.Declaration
• ПОЛЕ: Name.Variable
• Таблица: Name.Class

Full token list

Below is the list of standard Pygments tokens and whether they are used by the BSL or SDBL lexers in this project. Columns show usage flags, the rendered CSS class, and the palette variable most closely matching the token category.