Настройка подсветки
Измените цвет нужной категории, сохранив свою тему оформления. Здесь собраны справочник токенов и настройки, которые можно скопировать в VS Code.
Настройте первый цвет
Заголовок раздела «Настройте первый цвет»- Откройте локальный файл
.gpp. Убедитесь, что индикатор языка в правом нижнем углу показывает GPPL. - Нажмите Ctrl+Shift+P и выполните Preferences: Open User Settings (JSON) — «Параметры: Открыть параметры пользователя (JSON)». Нужны редактируемые пользовательские настройки, а не параметры по умолчанию, доступные только для чтения.
- Добавьте настройки ниже внутрь внешних
{ }. Если такие ключи уже есть, объедините их содержимое вместо создания второй копии. Сохраните остальные параметры, в том числе кодировку файлов. - Сохраните
settings.jsonи вернитесь к файлу.gpp. Строки в одинарных кавычках должны стать оранжевыми, в двойных — светло-голубыми. Перезагрузка расширения обычно не нужна.
{ "[gppl]": { "editor.semanticHighlighting.enabled": true }, "editor.semanticTokenColorCustomizations": { "rules": { "string:gppl": "#9CDCFE", "string.format:gppl": "#FF8000" } }}Замените #FF8000 на нужный шестнадцатеричный цвет. Цвета примеров рассчитаны на тёмный фон; подберите читаемые сочетания для своей темы. Чтобы вернуть цвет темы, удалите только добавленное правило.
Селектор string.format:gppl означает: тип string, модификатор format, язык gppl. Базовое правило string:gppl действует и на строки с модификаторами; более точное string.format:gppl позволяет отдельно оформить одинарные кавычки. Это правила для категорий, а не способ назначить цвет одной переменной по имени. Сохраняйте написание селектора из примера, даже если имена в GPPL-коде записаны заглавными буквами.
Полный пример цветов
Заголовок раздела «Полный пример цветов»С версии 1.7.0: пример охватывает все базовые типы и дополнительные категории. Он работает с выбранной вами темой; включать GPPL Classic Dark необязательно. Объедините его с существующими настройками, как описано выше.
{ "[gppl]": { "editor.semanticHighlighting.enabled": true, "editor.bracketPairColorization.enabled": false }, "editor.semanticTokenColorCustomizations": { "rules": { "variable:gppl": "#D4D4D4", "variable.readonly.defaultLibrary:gppl": { "foreground": "#9CDCFE", "italic": true }, "variable.readonly.defaultLibrary.boolean:gppl": { "foreground": "#FFC042", "italic": false, "underline": false }, "parameter:gppl": "#B5CEA8", "function:gppl": "#DCDCAA", "function.defaultLibrary:gppl": "#00CACA", "function.systemProcedure:gppl": "#4EC9B0", "function.userProcedure:gppl": "#F5CB49", "keyword:gppl": "#C586C0", "keyword.interrupt:gppl": { "foreground": "#FF6666", "bold": true, "italic": true }, "keyword.line:gppl": "#D7BA7D", "namespace:gppl": "#C586C0", "class:gppl": "#FF8000", "string:gppl": "#CE9178", "string.format:gppl": "#FF8000", "number:gppl": "#B5CEA8", "comment:gppl": "#8A9980", "operator:gppl": "#D4D4D4", "operator.comparison:gppl": "#F78C6C", "operator.logical:gppl": "#C586C0", "operator.generation:gppl": "#FFD700", "operator.separator:gppl": "#89DDFF" } }}Здесь отключено раскрашивание пар скобок, чтобы был виден цвет из operator.generation. Поиск парных скобок и команда Go to Bracket продолжают работать. Если предпочитаете цвета пар скобок VS Code, оставьте раскрашивание включённым и не добавляйте этот параметр.
Проверьте на GPPL-коде
Заголовок раздела «Проверьте на GPPL-коде»Сохраните пример в отдельный локальный файл .gpp и изучите категории. Это упражнение для редактора, а не полноценный постпроцессор станка. Блок кода на сайте использует статическую синтаксическую подсветку; цвета в VS Code определяются вашими настройками.
@init_post global numeric demo_value demo_value = abs(-2)endp
@start_of_file ; Compare the word and symbolic forms. if demo_value eq 2 and not(active(demo_value)) then {nb "X" demo_value:'5.3'} endif if demo_value != 0 then change(demo_value) = true call @usr_demo(demo_value) endifendp
@usr_demo(numeric demo_argument) print demo_argument:'5.3'endp@init_post и @start_of_file — системные процедуры, хотя их тела пишете вы. @usr_demo — пользовательская процедура, demo_argument — параметр, а abs, active и change — встроенные функции. У eq и != намеренно разные селекторы; см. таблицу операторов ниже.
Справочник токенов
Заголовок раздела «Справочник токенов»Для удобства чтения в таблицах опущен суффикс :gppl. Добавляйте его в настройках, чтобы изменить только GPPL. Категории описывают подсветку IDE, а не поведение кода при выполнении или корректность имени.
Базовые категории
Заголовок раздела «Базовые категории»Все десять базовых типов есть в 1.6.3 и сохраняются в версии 1.7.0. Их правила действуют и на варианты с модификаторами.
| Селектор | Элементы GPPL |
|---|---|
variable |
Локальные/глобальные переменные и неразрешённые обычные идентификаторы; у системных имён есть дополнительные модификаторы. |
parameter |
Параметры процедур в объявлениях и разрешённых ссылках. |
function |
Имена процедур, токены функций и завершение процедуры endp. |
keyword |
Управление выполнением (if, then, elseif, else, endif, while, endw), call, inc, print, input, trace, col, colrel. |
namespace |
Слова области видимости global и local; название токена не означает наличие пространств имён в GPPL. |
class |
Слова типов integer, numeric, logical, string; это имя категории подсветки, а не объектно-ориентированный класс. |
string |
Строковые литералы; одинарные кавычки дополнительно получают format. |
number |
Целые числа, десятичные числа и научная запись. |
comment |
Комментарии с точки с запятой, включая документационные ;;;. |
operator |
Арифметика, присваивание и символьные сравнения; версия 1.7.0 добавляет подгруппы ниже. |
Уже доступные различия
Заголовок раздела «Уже доступные различия»| Селектор | Что выбирает |
|---|---|
string.format |
Все литералы в одинарных кавычках, например '5.3'; категорию определяют кавычки, а не содержимое. |
keyword.interrupt |
abort, exit, break, return. |
variable.readonly.defaultLibrary |
Системные переменные из каталога, например xpos и pi. |
variable.readonly.defaultLibrary.boolean |
Литералы true и false. |
variable.declaration |
Объявления переменных. |
parameter.declaration |
Объявления параметров. |
function.declaration |
Объявления процедур; в версии 1.7.0 можно дополнительно указать модификатор категории процедуры. |
Модификатор readonly также используется для оформления системных имён. Он не доказывает, что присваивание переменной запрещено. Ограничения записи проверяются диагностикой отдельно, например для pi. Отдельных семантических селекторов для имён локальных и глобальных переменных или переменных VMID нет; namespace окрашивает сами слова local и global.
Группы операторов
Заголовок раздела «Группы операторов»С версии 1.7.0: группы настраиваются независимо. Они не выделяют отдельные токены внутри строк, комментариев или длинных идентификаторов вроде eq_value.
| Селектор | Токены |
|---|---|
operator |
+ - * / ^ = == != < > <= >= без модификатора подгруппы. Общее правило также действует на подгруппы, если стиль не задан более точным правилом. |
operator.comparison |
Только словесные сравнения: eq ne lt gt le ge. |
operator.logical |
and or not !, включая not(...) и !(...). |
operator.generation |
Пара { }, ограничивающая вывод при генерации. Другие скобки в эту группу не входят. |
operator.separator |
: перед форматом вывода в блоке генерации, print или tostr, а также перед уровнем в trace "all":5. |
== и != входят в общую operator; отдельной категории для каждого из них нет. != — сравнение, а не логическое отрицание; его ! не является отдельным токеном. В 1.6.3 словесные сравнения и and/or/not относятся к ключевым словам, а ! — к обычным операторам; новые селекторы подгрупп требуют версии 1.7.0.
Функции, процедуры и управление выводом
Заголовок раздела «Функции, процедуры и управление выводом»С версии 1.7.0: для трёх независимых цветов используйте три селектора функций.
| Селектор | Примеры и границы |
|---|---|
function.defaultLibrary |
Встроенные функции из каталога: abs, tostr, get_axis_vector, change, active, even, odd, date, time. Логические функции сохраняют категорию по обе стороны присваивания. |
function.systemProcedure |
Системные @-процедуры из каталога: объявления с пользовательским телом и вызовы. Например, @init_post. |
function.userProcedure |
Остальные @-имена, включая пользовательские процедуры и неразрешённые имена. Этот цвет не означает, что процедура найдена. |
keyword.line |
nb и nl, управляющие блоком или строкой вывода. |
endp остаётся обычной function. В 1.6.3 change, active, even, odd и nb/nl относятся к ключевым словам; три группы функций ещё не разделены последовательно описанным выше способом. Объявленная переменная с именем, похожим на builtin, не становится автоматически вызовом функции.
Модификаторы и более точные правила
Заголовок раздела «Модификаторы и более точные правила»Используются модификаторы declaration, readonly, defaultLibrary, boolean, interrupt, format, а в версии 1.7.0 — также comparison, logical, generation, line, systemProcedure, userProcedure, separator. definition зарезервирован в легенде, но сейчас не выдаётся; правило с ним не выделит объявления.
При необходимости объединяйте модификаторы: function.userProcedure.declaration:gppl выбирает объявления пользовательских процедур, а function.userProcedure:gppl — и объявления, и вызовы. Например, добавьте "function.userProcedure.declaration:gppl": { "bold": true } в объект rules. Можно задавать foreground, bold, italic, underline и strikethrough; указание одного цвета не отменяет существующие стили шрифта.
Подсветка TextMate без семантики
Заголовок раздела «Подсветка TextMate без семантики»Для обычной работы IDE используйте семантические правила выше. Если вы намеренно отключили семантическую подсветку, цвета определяются лексическими TextMate scopes через editor.tokenColorCustomizations.
В 1.6.3 наша TextMate-грамматика покрывает только строки и комментарии. Расширенная таблица ниже относится к версии 1.7.0 и режиму языка GPPL.
| TextMate scope | Элементы |
|---|---|
comment.line.semicolon.gppl |
Комментарии. |
string.quoted.single.gppl |
Литералы в одинарных кавычках. |
string.quoted.double.gppl |
Литералы в двойных кавычках. |
constant.character.escape.gppl |
Распознанные escape-последовательности внутри строк. |
entity.name.function.procedure.gppl |
Все имена @-процедур вместе. |
support.function.builtin.gppl |
Имена builtin-функций, определяемые лексически. |
keyword.control.gppl |
Ключевые слова управления выполнением, операторов языка и endp. |
keyword.control.interrupt.gppl |
abort/exit/break/return. |
keyword.control.line.gppl |
nb/nl. |
entity.name.namespace.gppl |
global/local. |
entity.name.type.class.gppl |
Слова типов данных. |
constant.language.boolean.gppl |
true/false. |
constant.numeric.gppl |
Числа. |
keyword.operator.gppl |
Арифметика, присваивание и символьные сравнения. |
keyword.operator.comparison.word.gppl |
Словесные сравнения. |
keyword.operator.logical.gppl |
Логические операторы. |
punctuation.section.generation.gppl |
{ }. |
keyword.operator.separator.gppl |
:. |
Лексическая подсветка не различает обычные переменные, параметры, системные переменные и места объявления. Все @-процедуры имеют общий scope, а для builtin-имён не учитывается затенение переменной. При включённой семантической подсветке токен всей строки может также перекрыть TextMate-цвет escape-последовательности. Это ограничения резервной подсветки, а не дополнительные семантические селекторы.
{ "[gppl]": { "editor.semanticHighlighting.enabled": false, "editor.bracketPairColorization.enabled": false }, "editor.tokenColorCustomizations": { "textMateRules": [ { "scope": "keyword.operator.comparison.word.gppl", "settings": { "foreground": "#F78C6C" } }, { "scope": "punctuation.section.generation.gppl", "settings": { "foreground": "#FFD700" } }, { "scope": "entity.name.function.procedure.gppl", "settings": { "foreground": "#F5CB49", "fontStyle": "bold" } } ] }}Чтобы добавить категорию, скопируйте один объект в массив textMateRules и замените его scope значением из таблицы. Семантические настройки находятся в rules, настройки TextMate — в textMateRules. Это разные форматы.
GPPL, GPP и темы
Заголовок раздела «GPPL, GPP и темы»Для режима GPP расширения SolidCAM замените :gppl на :gpp в семантических селекторах, а [gppl] на [gpp] в языковых настройках. Если используете оба режима, сохраните оба набора. Сервер GPPL IDE поддерживает оба идентификатора. При отключённой семантической подсветке GPP использует грамматику установленного расширения SolidCAM: приведённые выше GPPL scopes в этом режиме не гарантируются.
Примеры находятся вне блока с именем темы, поэтому действуют при смене тем. Выбор встроенной темы описан в разделе Цветовая тема и подсветка. Отображаемое имя — GPPL Classic Dark, но идентификатор настройки остаётся GPPL UltraEdit, в том числе в блоках [GPPL UltraEdit]. Существующие правила для конкретной темы могут влиять на результат; проверьте их при переключении.
Если цвет не изменился
Заголовок раздела «Если цвет не изменился»- Убедитесь, что установленная версия поддерживает селектор. Новые категории не начнут работать в 1.6.3.
- Проверьте режим языка и суффикс: GPPL использует
gppl, режим GPP от SolidCAM —gpp. - В настройках проверьте действующее значение Editor: Semantic Highlighting Enabled для этого языка, включая переопределения рабочей области. Для семантических правил нужно
true, для примера TextMate —false. - Установите курсор на токен и выполните Developer: Inspect Editor Tokens and Scopes из палитры команд. Проверьте семантический тип, модификаторы, TextMate scopes и правило, задающее цвет текста. Закройте инспектор клавишей Esc.
- Найдите более точное правило, блок для конкретной темы или повторяющиеся ключи настроек. Для
{ }отключите Editor: Bracket Pair Colorization Enabled, чтобы увидеть цвет категории. Общее правилоfunctionилиoperatorдействует и на токены с модификаторами. - Если семантический токен не показан, убедитесь, что расширение активно для открытого файла. Если другие языковые функции тоже недоступны, откройте Решение проблем. Удалите добавленное правило, чтобы сравнить с цветом темы по умолчанию.
Синтаксис селекторов и параметры оформления VS Code описаны в официальных руководствах по семантической подсветке и настройке тем.