.Language=Russian,Russian (Русский)
.PluginContents=FarColorer

@contents
$# FarColorer

    ~Меню настроек.~@settingsmenu@
    ~Настройка плагина.~@config@
    ~Настройка логирования.~@configlog@
    ~Командная строка.~@cmdline@
    ~Меню плагина в редакторе.~@menu@

    ~Настройка базы схем и стилей~@customize@
    ~Настройка схем.~@confighrc@

    ~Использование плагина в макросах:~@MacroCallPlugin@
      ~Макрофункции.~@MacroCall@
      ~Идентификаторы плагина.~@PluginGuids

    ~Об авторах.~@author@

@settingsmenu
$# Settings

  #Основные настройки#
    Вызывает диалог с главными настройками плагина

  #Настройки схем#
    Вызывает диалог настройки параметров схем. Диалог не работает если плагин отключен.

  #Настройки логирования#
    Вызывает диалог настройки логирования.

  #Тест библиотеки схем#
    Тестирует возможность загрузки всех языковых схем беря путь до catalog.xml из окна настроек.

@config
$# Настройки плагина.

  Диалог настройки (#Параметры# - #Параметры внешних модулей# - #FarColorer#) позволяет настроить некоторые параметры плагина:

  #Включить#
     Включает/Отключает плагин в редакторе.

  Следующие четыре параметра используются для настройки базовой библиотеки схем и стилей,
  применяемых в работе плагина. Подробнее в разделе ~Настройка базы схем и стилей~@customize@

  #Файл catalog.xml#
     Полный путь к пользовательскому файлу catalog.xml библиотеки схем. При обычной установке плагина FarColorer ищет этот файл в подпапке base папки плагина.

  #Папка пользовательских схем (hrc)#
     Полный путь к папке с пользовательскими файлами схемы.

  #Папка пользовательских цветовых стилей (hrd)#
     Полный путь к папке с файлами пользовательского стиля.

  #Файл пользовательских настроек схем (hrcsettings)#
     Полный путь к файлу с пользовательскими настройками схемы.

  #Цветовой стиль#
     Выбор цветового стиля который будет использоваться при раскраске текста. Выбор не работает если плагин отключен.

  #TrueMod Включить#
     Включает/Отключает TrueMod режим работы плагина.

  #TrueMod Цветовой стиль#
     Выбор цветового стиля который будет использоваться при раскраске текста в режиме TrueMod. Выбор не работает если плагин отключен или недоступен режим TrueMod.

  #Выделять парные элементы#
     Выделять или нет парные элементы языка (скобки, кавычки).

  #Показывать синтаксис#
     Включает/Отключает показ синтаксиса.

  #Классический стиль списка функций#
     В классическом стиле отображается только имя функции. Иначе показывается c начала номер строки, потом первая буква в функции и само имя функции.

  #Изменять цвет фона редактора#
     Во включенном состоянии FarColorer устанавливает в системных настройках цвет элемента "Обычный текст" цветовой группы "Редактор" таким же как и цвет по умолчанию для цветовой схемы FarColorer. Эффект виден на файлах количество строк в которых меньше высоты окна редактора.

  #Показать крест#
     [ ] Не показывать никогда.
     [?] Показывать если включено в схеме.
     [x] Показывать всегда.

  #Вид креста#
     Вид креста показываемый при "[x] Показать крест".

  #Период построения#
     Периодичность в миллисекундах с которой Far вызывает "фоновый" разбор файла в Colorer. Чем меньше это значение тем быстрее раскрашивается большой файл, но отзывчивость экрана падает.

  #{ Ok }#
     Закрытие диалога и сохранение параметров.

@customize
$^#Настройка базы схем и стилей#
    FarColorer поставляется с базовой библиотекой HRC-схем и HRD-стилей, корневым файлом которой является catalog.xml.
    Для изменения набора и поведения HRC-схем и HRD-стилей, используются параметры путей до файлов в диалоге настройки плагина,
    а так же диалог ~Настройки схем~@confighrc .

    Необходимые действия для изменения базовой библиотеки приведены на странице ~https://colorer.github.io/advanced/custom/~ .

    При работе с настройками библиотекой схем и стилей применяется следующий порядок загрузки:
    1. Читаем значение параметра "Файл catalog.xml"
    	- если заполнен то используем указанный файл как catalog.xml
    	- иначе используем catalog.xml поставляемый с плагином
    2. Читаем hrcsettings.xml, идущий в поставке плагина
    3. Читаем значение параметра "Папка пользовательских схем (hrc)"
    	- если заполнен и это файл, то обрабатываем файл как набор hrd-sets (устаревший способ, для обратной совместимости)
    	- если заполнен и это папка, то загружаем из нее все *.hrd файлы
    4. Читаем значение параметра "Папка пользовательских схем (hrc)"
    	- если заполнен и это файл, то обрабатываем как так же как и proto.hrc (устаревший способ, для обратной совместимости)
    	- если заполнен и это папка, то загружаем из нее все *.hrc файлы
    5. Читаем значение параметра "Файл пользовательских настроек схем (hrcsettings)" (пользовательский hrcsettings.xml)
    	- если заполнен, то загружаем его
    	- если не заполнен, проверяем переменную окружения COLORER_HRC_SETTINGS с путем до файла
    6. Читаем настройки схем из настроек плагина в FarManager


@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.
    #Сайт плагина#
           https://github.com/colorer/FarColorer
    #Сайт Colorer library#
           https://colorer.sf.net
           https://colorer.github.io

    #Cail Lomecb# (Игорь Русских). Copyright (c) 1999-2009
           email  : irusskih at gmail dot com

    #Eugene Efremov#
           email  : 4mirror at mail dot ru

    #ctapmex#  (Алексей Добрунов).  Copyright (c) 2009-2025
           email  : ctapmex at ctapmex dot com
