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

Programming Far Manager plugins

previous page next page

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

В начале языковых файлов и в файлах подсказки могут содержаться следующие управляющие элементы, начинающиеся с точки.

Управляющий элемент Описание

Управляющий элемент	Описание
.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=<Language name>,<Language description>

Этим элементом должен начинаться любой файл помощи или поддержки языка.

описывает файловый язык и должен быть стандартным языковым именем (на английском). Все файлы с тем же языком должны иметь то же значение <Language name>.

может содержать языковое описание в любой форме. Эта строка отобразится в меню Languages (Языки).

.PluginContents

.PluginContents=<Contents topic name>

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

.Options

.Options <KeyName>=<Value>

Это дополнительное утверждение может использоваться для указания дополнительных опций в файлах помощи. Таких утверждений может быть несколько.

Одно из следующих значений:

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

Смотрите также:

Языковая поддержка, Файлы помощи

previous page start next page