Управляющие элементы

Programming Far Manager plugins

Управляющие элементы

В начале языковых файлов и в файлах подсказки могут содержаться следующие управляющие элементы, начинающиеся с точки.
Управляющий элементОписание
.Language
.Language=<Language name>,<Language description>
Этим элементом должен начинаться любой файл помощи или поддержки языка.
<Language name>
описывает файловый язык и должен быть стандартным языковым именем (на английском). Все файлы с тем же языком должны иметь то же значение <Language name>.
<Language description>
может содержать языковое описание в любой форме. Эта строка отобразится в меню Languages (Языки).
.PluginContents
.PluginContents=<Contents topic name>

Это дополнительное утверждение может использоваться для добавления <Contents topic name> в список помощи плагинов (отображается в помощи Far Manager нажатием Shift+F2). После выбора этого пункта будет показана тема Contents (см. раздел "Файлы помощи" относительно темы Contents).

.Options
.Options <KeyName>=<Value>
Это дополнительное утверждение может использоваться для указания дополнительных опций в файлах помощи. Таких утверждений может быть несколько.
<KeyName>
Одно из следующих значений:
  • CtrlColorChar Значение <Value> содержит символ, с помощью которого будет указан цветовой атрибут (см. раздел "Файлы помощи" относительно темы CtrlColorChar). Например, утверждение:
    .Options CtrlColorChar=\
    говорит о том, что для спецсимвола, указывающего на цветовые атрибуты будет использоваться символ \.

  • TabSize
    <Value> указывает на размер табуляции в HLF-файле. Может быть от 1 до 16. По умолчанию равно 8.

  • CtrlStartPosChar
    Значение <Value> содержит символ, с помощью которого будет указано с какой позиции начинать последующие строки. Например, утверждение:
    .Options CtrlStartPosChar=&
    говорит о том, что спецсимволом позиции переноса будет символ '&', тогда
    пункт 1 - &папа у Васи силён в математике, учится папа за Васю весь год.
    выравнивается так:
    _пункт 1 - папа у Васи силён в математике, учится папа
               за Васю весь год.


Пример:

.Language=Russian,Russian (Русский)
.PluginContents=FTP клиент
@Contents
$ #FTP клиент#
   ~Подключение к FTP серверу~@FTPConnect@

   ~Работа с именами серверов~@FTPNames@

   ~Команды FTP клиента~@FTPCmd@

   ~Конфигурация FTP клиента~@FTPCfg@

   ~Режимы панели FTP клиента~@FTPPanel
Смотрите также: