Plugins.Install.txt

                     Установка/удаление плагинов
                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~

Данный текст содержит инструкции по следующим вопросам:

1. Установка плагинов

2. Удаление плагинов

3. Обновление плагинов


УСТАНОВКА ПЛАГИНА
~~~~~~~~~~~~~~~~~

1. Прочитайте документацию к плагину (file_id.diz, readme.txt, whatsnew.txt
   doc\*.* и т.д.) на предмет выяснения подробностей по установке, версии
   FAR Manager, с которой будет работать плагин и т.д.

   Установите плагин тем способом, как там написано.

2. Если в документации отсутствуют инструкции по установке, или если
   приведенные в документации инструкции не удалось выполнить, то
   установите плагин следующим способом:

   a) создайте подкаталог с произвольным именем в папке FAR\Plugins;

   b) скопируйте туда все, что находится в дистрибутиве плагина
      (по крайней мере, файлы *.dll, *.hlf, *.lng нужны всегда)

   c) перезапустите FAR

   При удаче плагин добавит соответствующий ему пункт в меню плагинов
   или сделает то, что написано в документации к нему.

   d) нажмите F1, Shift-F2, выберите из списка пункт помощи
      по установленному плагину и внимательно эту помощь прочитайте

   e) вызовите меню конфигурации плагина (F9, Параметры->Параметры внешних
      модулей), если оно есть, и настройте установленный плагин.

3. Подсказка: чтобы горячие клавиши в меню плагинов (F11) не съезжали
   после изменения набора плагинов, укажите их явно при помощи клавиши F4
   в этом меню.


УДАЛЕНИЕ ПЛАГИНА
~~~~~~~~~~~~~~~~

1. Прочитайте документацию к плагину (помощь, readme.txt, doc\*.* и т.д.)
   на предмет выяснения подробностей по удалению плагина. Удалите плагин
   тем способом, как там написано.

2. Если в документации отсутствуют инструкции по удалению, или если
   приведенные в документации инструкции не удалось выполнить, то
   удалите плагин следующим способом:

   a) если у вас запущено параллельно несколько копий FAR, выйдите
      из всех, кроме одной

   b) перенесите (F6) подкаталог плагина из папки плагинов (по умолчанию это
      FAR\Plugins\) куда-нибудь в другой каталог
      в пределах того же диска (например, на уровень выше, в каталог FAR\)

   c) если каталог был успешно перенесен, перезапустите FAR
       и переходите к пункту e)

   d) если плагин заблокировал свой рабочий каталог, и перенести его
      не удаётся:

      - выйдите из текущей копии FAR

      - запустите новую копию FAR с параметром /p в командной строке
        (FAR запустится без плагинов)

   e) удалите каталог с ненужным плагином

   f) если после удаления плагина FAR начал вести себя странно (неправильно
      показывать список в меню плагинов по F11 и меню дисков, падать
      и т.д.), очистите кэш плагинов - запустите прилагаемый файл
      ClearPluginsCache.bat или удалите вручную ветку реестра
      [HKEY_CURRENT_USER\Software\Far\PluginsCache]

   g) при желании можно также попытаться найти и удалить все записи
      реестра, относящиеся к удаленному плагину.
      Чаще всего это подраздел с именем плагина в ветке
      [HKEY_CURRENT_USER\Software\Far\Plugins],
      некоторое количество подразделов в ветке
      [HKEY_CURRENT_USER\Software\Far\SavedDialogHistory]
      и некоторое количество подразделов в ветке
      [HKEY_CURRENT_USER\Software\Far\PluginHotkeys].
      Если не знаете как, попросите об этом специалиста. Однако данный шаг
      является совершенно необязательным: никакого вреда эти записи реестра
      не принесут.


ОБНОВЛЕНИЕ ПЛАГИНА
~~~~~~~~~~~~~~~~~~

Периодически вы будете устанавливать новые версии плагинов. Простейший
способ это сделать - сначала удалить старую версию, а затем установить
новую (см. предыдущие разделы). Однако это не всегда удобно, поскольку
может привести к потере настроек плагина. Поэтому обновление лучше
выполнять следующим образом:

1. Прочитайте документацию к новой версии плагина (file_id.diz, readme.txt,
   whatsnew.txt, doc\*.* и т.д.) на предмет выяснения подробностей по
   установке новой версии плагина. Обновите версию плагина тем способом,
   как там написано.

2. Если в документации отсутствуют инструкции по обновлению, или если
   приведенные в документации инструкции не удалось выполнить, то
   обновите плагин следующим способом:

   a) выполните пункты (a-d) раздела по удалению плагина (см. выше)

   b) если старый каталог плагина не содержит каких-либо дополнительных
      файлов конфигурации, данных и т.д., можете сразу его удалить;
      но лучше всё же сохраните его на какое-то время для облегчения
      отката на старую версию, если новая по каким-то причинам окажется
      неудовлетворительной

   c) создайте в каталоге FAR\Plugins подкаталог с тем же именем, что
      и у старой версии плагина

   d) скопируйте туда все, что находится в дистрибутиве нового плагина
      (по крайней мере, файлы *.dll, *.hlf, *.lng нужны всегда)

   e) если нужно, скопируйте туда же дополнительные файлы настроек,
      данных и т.д. из каталога старой версии, которые вы создали
      в процессе работы с плагином

   f) выполните пункты (c-e) раздела по установке плагина (см. выше)