-
Notifications
You must be signed in to change notification settings - Fork 17
/
Copy pathcolorerr.hlf
411 lines (300 loc) · 25.3 KB
/
colorerr.hlf
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
.Language=Russian,Russian (Русский)
.PluginContents=FarColorer
@contents
$# FarColorer
~Меню настроек.~@settingsmenu@
~Настройка плагина.~@config@
~Настройка схем.~@confighrc@
~Настройка логирования.~@configlog@
~Командная строка.~@cmdline@
~Меню плагина в редакторе.~@menu@
~Использование плагина в макросах:~@MacroCallPlugin@
~Макрофункции.~@MacroCall@
~Идентификаторы плагина.~@PluginGuids
~Об авторах.~@author@
Всю информацию по инсталляции и работе с FarColorer ищите текстовых файлах в архивах плагина и в документации по библиотеке.
@settingsmenu
$# Settings
#Основные настройки#
Вызывает диалог с главными настройками плагина
#Настройки схем#
Вызывает диалог настройки параметров схем. Диалог не работает если плагин отключен.
#Настройки логирования#
Вызывает диалог настройки логирования.
#Тест библиотеки схем#
Тестирует возможность загрузки всех языковых схем беря путь до catalog.xml из окна настроек.
@config
$# Настройки плагина.
Диалог настройки (#Параметры# - #Параметры внешних модулей# - #FarColorer#) позволяет настроить некоторые параметры плагина:
#Включить#
Включает/Отключает плагин в редакторе.
#Файл catalog.xml#
Полный путь в этом поле задает базовый файл настроек catalog.xml. При обычной установке плагина FarColorer ищет этот файл в подпапке base папки плагина.
#Файл списка схем пользователя#
Полный путь в этом поле задает файл аналог proto.hrc, или директорию с файлами, содержащими пользовательскиe схемы. В случае указания директории обрабатываются только *.hrc файлы.
#Файл цветовых стилей пользователя#
Полный путь в этом поле задает файл со списком цветовых стилей.
#Цветовой стиль#
Выбор цветового стиля который будет использоваться при раскраске текста. Выбор не работает если плагин отключен.
#TrueMod Включить#
Включает/Отключает TrueMod режим работы плагина.
#TrueMod Цветовой стиль#
Выбор цветового стиля который будет использоваться при раскраске текста в режиме TrueMod. Выбор не работает если плагин отключен или недоступен режим TrueMod.
#Выделять парные элементы#
Выделять или нет парные элементы языка (скобки, кавычки).
#Показывать синтаксис#
Включает/Отключает показ синтаксиса.
#Классический стиль списка функций#
В классическом стиле отображается только имя функции. Иначе показывается c начала номер строки, потом первая буква в функции и само имя функции.
#Изменять цвет фона редактора#
Во включенном состоянии FarColorer устанавливает в системных настройках цвет элемента "Обычный текст" цветовой группы "Редактор" таким же как и цвет по умолчанию для цветовой схемы FarColorer. Эффект виден на файлах количество строк в которых меньше высоты окна редактора.
#Показать крест#
[ ] Не показывать никогда.
[?] Показывать если включено в схеме.
[x] Показывать всегда.
#Вид креста#
Вид креста показываемый при "[x] Показать крест".
#Период построения#
Периодичность в миллисекундах с которой Far вызывает "фоновый" разбор файла в Colorer. Чем меньше это значение тем быстрее раскрашивается большой файл, но отзывчивость экрана падает.
#{ Ok }#
Закрытие диалога и сохранение параметров.
@confighrc
$# Настройки схем
Для каждой из выбранных схем выводится список параметров влияющих на отображение раскраски.
Значение параметра - значение установленное для этого параметра.
Значения вида <default-значение> показывает, что параметр равен "значение" которое установлено либо в системных (не пользовательских) настройках схемы, либо взято у схемы default. Сохранение всех изменений происходит после нажатия кнопки "ОК".
@configlog
$# Настройки логирования
#Включить#
Включает/Отключает логирование в плагине.
#Уровень логирования#
Один из возможных уровней логирования.
#Папка логов#
Путь до папки в которой будут создаваться логи. Без указания имени файла.
@cmdline
$# Командная строка
Вы можете вызывать внутренний консольный просмотрщик FarColorer`а через префикс плагина в командной строке. Используя префикс "clr:" после которого следует имя нужного файла вы можете открывать файл на просмотр с подсветкой синтаксиса. В пути могут быть использованы переменные окружения. При наличии пробелов в имени путь надо указывать в кавычках.
Эта функциональность аналогична программе #colorer.exe# за тем исключением, что плагину не нужно каждый раз загружать базу HRC которая уже загружена и используется в редакторе.
@add
$# Списки
В этих меню показывается список найденных функций в тексте или же найденные FarColorer`ом синтаксические ошибки.
Можно пользоваться фильтром набирая прямо в меню искомую последовательность текста.
#Ctrl-Left/Right#
Раскрыть/закрыть иерархический уровень в списке.
#Ctrl-Up/Down#
Переместиться к следующему-предыдущему элементу в списке и по тексту.
#Ctrl-Enter#
Закрыть список и вставить текущий элемент в позицию под курсором.
#Enter#
Закрыть список и переместиться к выбранному элементу.
#Tab#
Дополняет фильтр символами, идущими после '?' в поле отображения фильтра.
#Клавиши [0-9a-z;:-_]#
Фильтровать список по вводимому шаблону.
@menu
$# Меню операций
#1 Список типов#
Выводит меню всех поддерживаемых типов файлов. Выбрав любой вы принудительно установите тип раскраски текущего файла.
#2 Найти парную скобку#
Находит парную скобку (или любую парную структуру) к текущей и переходит на нее.
#3 Выделить блок со скобками#
Переходит на начало парного блока и выделяет его весь. Эту функцию не обязательно вызывать установив курсор на парной конструкции. Если он находится внутри блока то FarColorer сам найдет начало и конец ближайшего блока и выделит его.
#4 Выделить блок между скобок#
Выделяется блок как и в предыдущем случае, но сами парные конструкции в выделение не попадают - выделяется только внутренность блока.
#5 Список функций#
Находит все функциональные регионы в текущем файле и выводит их в меню. В этом меню можно использовать любые буквенные клавиши для задания фильтров.
#6 Список ошибок#
Аналогично предыдущему - но показываются все найденные ошибки в файле.
#*# Функционирование этих возможностей плагина зависит от соответствующих языковых схем. Вся выводимая информация берется из анализа регионов соответствующих типов файлов.
#7 Выбрать текущий регион#
Выделяет текущий цветовой регион под курсором.
#A Данные региона#
Выводит имя региона и схемы под курсором.
#8 Найти функцию#
Ищет функцию под курсором в списке функций и переходит на нее.
#9 Обновить раскраску#
Обновляет текущее состояние расцветки и заново перекрашивает файл.
#R Перезагрузить библиотеку схем#
Перечитывает настройки плагина и библиотеку схем.
#C Настройка#
Вызывает ~меню настроек~@config@ FarColorer.
@PluginGuids
$# Идентификаторы плагина
GUID плагина - {D2F36B62-A470-418d-83A3-ED7A3710E5B5}
#Диалоги#
Диалог настроек - {87C92249-430D-4334-AC33-05E7423286E9}
Диалог настроек параметров схем - {0497F43A-A8B9-4af1-A3A4-FA568F455707}
Диалог настроек логирования - {3D1031EA-B67A-451C-9FC6-081320D3A139}
Диалог назначения горячей клавиши - {C6BE56D8-A80A-4f7d-A331-A711435F2665}
#Меню#
Главное меню плагина в редакторе - {45453CAC-499D-4b37-82B8-0A77F7BD087C}
Меню настроек - {63E396BA-8E7F-4E38-A7A8-CBB7E9AC1E6D}
Меню выбора типа файлов - {46921647-DB52-44CA-8D8B-F34EA8B02E5D}
Меню списка цветовых стилей - {18A6F7DF-375D-4d3d-8137-DC50AC52B71E}
Меню списка функций/ошибок - {A8A298BA-AD5A-4094-8E24-F65BF38E6C1F}
#Сообщения#
Ошибка - {0C954AC8-2B69-4c74-94C8-7AB10324A005}
Загрузка баз - {DEE3B49D-4A55-48a8-9DC8-D11DA04CBF37}
Ничего не найдено - {AB214DCE-450B-4389-9E3B-533C7A6D786C}
Название региона - {70656884-B7BD-4440-A8FF-6CE781C7DC6A}
@MacroCallPlugin
$# Использование плагина в макросах
Плагин можно вызывать из макросов используя макрофункцию Plugin.Call(GUID,[param]).
Формат вызова:
#Plugin.Call("D2F36B62-A470-418d-83A3-ED7A3710E5B5",<Параметры>,...)#
здесь:
#D2F36B62-A470-418d-83A3-ED7A3710E5B5#
~идентификатор плагина~@PluginGuids@
#<Параметры>#
различные параметры согласно описанию ниже.
~Макрофункции.~@MacroCall@
@MacroCall
$# Макрофункции
#Работа с макросами#
Формат вызова функций #Plugin.Call("D2F36B62-A470-418d-83A3-ED7A3710E5B5",<FUNCTION>... )#, либо #Plugin.SyncCall#.
Вызов всех функций регистро-независимый.
Возвращаемое значение, если не указано отдельно, "true" - успешно, "false" - ошибка.
#Работа с глобальными настройками#
Ограничений на макрорегионы не установлено.
#...,"Settings",<Name>, <Param>)#
<Name> - принимает следующие значения:
"Menu" - Открывает меню настроек. Значение по умолчанию если <Name> пустой.
"Main" - Открывает окно главных настроек
"Log" - Открывает окно настроек логирования
"Hrc" - Открывает окно настроек параметров схем
"Reload" - Перезагружает все настройки плагина и открытых редакторов. Включая библиотеку схему.
"Status" - статус активности плагина.
<Param> - число:
0 - выключен;
1 - включен;
Либо boolean: "false" -выключен, "true" - включён.
Если задан то применяется новый статус с перезагрузкой всех настроек. Возвращает предыдущее значение. Если не задан возвращает текущее значение.
"SaveSettings" - Сохраняет настройки плагина.
#Работа с меню#
Работает только в MACROAREA_EDITOR.
#...,"Menu")#
Открывает меню плагина в редакторе.
#Работа с типами файлов#
Работает только в MACROAREA_EDITOR.
#...,"Types",<Action>, <Param>)#
<Action> - принимает следующие значения:
"Menu" - Открывает меню выбора типа файлов.
"List" - Возвращает массив названий всех доступных типов файлов.
"Get" - Возвращает текущий тип (первый параметр) и группу файла (второй параметр).
"Set" - Устанавливает для файла открытого в редакторе указанный тип.
<Param> - строка, тип файла
#Работа с параметрами типов файлов#
Ограничений на макрорегионы не установлено. Все изменения применяются только для текущего сеанса плагина. Для сохранения изменений необходимо вызывать "SaveSettings", для сброса "Reload".
#...,"ParamsOfType",<Action>, <Param1>,...)#
"List" - Список параметров типа
<Param1> - название типа. Строка. Регистро-зависимо.
Возвращает
<OutParam1> - массив названий параметров.
<OutParam2> - массив значений этих параметров. В случае отсутствия значения у параметра возвращается "nil".
"Get" - Возвращает значение параметра. Тип - всегда строка.
<Param1> - название типа. Строка. Регистро-зависимо.
<Param2> - название параметра. Строка. Регистро-зависимо. В случае отсутствия значения возвращается "nil".
"Set" - Устанавливает значение для параметра или удаляет его.
<Param1> - название типа. Строка. Регистро-зависимо.
<Param2> - название параметра. Строка. Регистро-зависимо.
<Param3> - значение параметра. Строка. Если не передан то удаляется пользовательское значение параметра. Если передана пустая строка то это значение присваивается параметру.
#Работа с скобками#
Работает только в MACROAREA_EDITOR.
#...,"Brackets",<Action>)#
<Action> - принимает следующие значения:
"Match" - Найти парную скобку.
"SelectAll" - Выделить блок со скобками.
"SelectIn" - Выделить блок между скобок.
#Работа с регионами#
Работает только в MACROAREA_EDITOR.
#...,"Region",<Action>)#
<Action> - принимает следующие значения:
"Select" - Выбрать текущий регион.
"Show" - Показать окно с данными региона.
"List" - Возвращает описание региона. Первый параметр регион, второй схема.
#Работа с функциями#
Работает только в MACROAREA_EDITOR.
#...,"Functions",<Action>)#
<Action> - принимает следующие значения:
"Show" - Показать окно со списком функций.
"Find" - Найти функцию, на которой стоит курсор.
"List" - Возвращает массив всех найденных функций и массив номеров строк в которых они объявлены.
#Работа с ошибками#
Работает только в MACROAREA_EDITOR.
#...,"Errors",<Action>)#
<Action> - принимает следующие значения:
"Show" - Показать окно со списком ошибок
"List" - Возвращает массив всех найденных ошибок и массив номеров строк в которых они найдены.
#Работа с параметрами текущего редактора#
При закрытии редактора данные параметры не сохраняются.
Работает только в MACROAREA_EDITOR.
#...,"Editor",<Action>,<Param1>,...)#
<Action> - принимает следующие значения:
"Refresh" - обновляет раскраску.
"Status" - Статус активности плагина для текущего редактора:
<Param1> - число:
0 - выключен;
1 - включен;
Если задан то изменяется текущее и возвращает предыдущее значение.
Если не задан, возвращает текущее значение для данного редактора
"CrossVisible" - Видимость и тип креста в редакторе:
Возвращает текущий стиль креста и правила отображения для данного редактора.
<OutParam1> - число:
0 - выключен;
1 - включен;
2 - согласно параметрам схемы.
<OutParam2> - число:
0 - не отображается;
1 - вертикальный;
2 - горизонтальный;
3 - полный крест.
Если указаны дополнительные параметры то изменяет стиль и правила отображения.
<Param1> - число:
0 - выключен;
1 - включен;
2 - согласно параметрам схемы
<Param2> - необязательный, число:
1 - вертикальный;
2 - горизонтальный;
3 - полный крест.
"Pair" - Статус отображения парных элементов:
<Param1> - число:
0 - выключен;
1 - включен;
Если задан то изменяется текущее и возвращает предыдущее значение.
Если не задан, возвращает текущее значение для данного редактора.
"Syntax" - статус отображения синтаксиса:
<Param1> - число:
0 - выключен;
1 - включен;
Если задан то изменяется текущее и возвращает предыдущее значение.
Если не задан, то возвращает текущее значение для данного редактора.
"Progress" - возвращает процент парсинга текущего файла в редакторе. Целочисленное значение.
@hrd
$# Выбор цветового стиля
Список всех доступных цветовых стилей. Можно выбрать любой для работы.
@exception
$# Произошло исключение
Во время работы FarColorer произошло исключение. Вся дальнейшая работа плагина будет приостановлена. Вы можете включить FarColorer через его меню настроек как только будете уверены в том, что причина исключения устранена. Вся дополнительная информация об ошибке находится в файле лога ошибок (по умолчанию colorer.log).
@filetypechoose
$# Список типов
Список содержит все поддерживаемые типы файлов. Выбрав любой вы принудительно установите тип раскраски текущего файла.
#Автоматическое определение# - выбор типа файла производит плагин по встроенным правилам.
#Избранные# - список избранных типов. Добавление в "Избранные" производится по нажатию клавиши Ins, удаление - Delete.
#Горячие клавиши# - для назначения горячей клавиши типу файла нужно нажать F4 и в открывшемся окне задать клавишу.
Горячие клавиши и нахождение в группе "Избранные" так же можно настраивать через ~Настройки схем.~@confighrc@ Это параметры "hotkey" и "favorite" для любой из схем.
@keyassign
$# Назначение клавиши
Клавиши 0-9, A-Z
@author
$# FarColorer плагин подсветки синтаксиса для FAR Manager.
#Сайт плагина#
http://colorer.sf.net
#Cail Lomecb# (Игорь Русских). Copyright (c) 1999-2009
email : irusskih at gmail dot com
web : http://cail.nm.ru
#Eugene Efremov#
email : 4mirror at mail dot ru
#ctapmex# (Алексей Добрунов). Copyright (c) 2009-2021
email : ctapmex at gmail dot com
web : http://dobrunov.ru