Скрипты для FAR Manager / Scripts for FAR Manager

Оглавление

• LuaFAR
• Плагины

• Скрипты

• Пакеты
  • Пакет LuaFAR context
  • Пакет UM Adapter
  • Пакет Rh_Scripts
  • Пакет Rh_Macros
  • Пакет LuaSpell
  • Пакет Rh_Presets
  • Пакет LFA config
  • Набор fl_scripts

• Ссылки

Содержание раздела

Все иллюстрации выполнены в FAR Manager с выбранным шрифтом "DejaVu Sans Mono".

LuaFAR

Библиотека LuaFAR расширяет возможности FAR Manager, позволяя писать плагины, скрипты и утилиты на языке Lua.

Скрипты обычно реализуют простые действия, утилиты — более сложные, комплексные. Скрипты и утилиты обычно объединяются в наборы и пакеты в соответствии с предпочтениями их разработчиков.

Начиная с FAR v.3.0 build 2851 библиотека вошла в состав FAR Manager, а язык Lua заменил использовавшийся до этого встроенный язык макросов.

Библиотека LuaFAR, плагины LuaFAR for Editor, LuaFAR Search, LuaFAR History, набор скриптов far2, а также ряд других плагинов и макросов разработаны Сэмуэлом Зейгерманом (Shmuel Zeigerman).

Плагины

LuaFAR for Editor (LuaFAR для Редактора) — плагин для выполнения различных действий в редакторе FAR Manager (и не только в редакторе), влючает в себя набор полезных скриптов.

LuaFAR History (LuaFAR История) — плагин для отображения историй команд, папок и редактирования/просмотра файлов.

LuaFAR Search (LuaFAR Поиск и Замена) — плагин для поиска и замены текста в редакторе и на панелях FAR Manager с использованием различных регулярных выражений (Lua regex, FAR regex, PCRE, Oniguruma).

К оглавлению

Скрипты

Отдельных скриптов и утилит для FAR пока нет.

К оглавлению

Пакеты

Пакет LuaFAR context

LuaFAR context — пакет для определения типов файлов и работы с файлами конфигураций параметров, связанных с типами файлов.

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

Пакет разработан на основе конфигураций, используемых в fl_scripts, доработан и расширен совместными усилиями с maxfl . LuaFAR context требуется для работы пакета Rh_Scripts, пакета LuaFAR area config, и набора fl_scripts.

Для работы сборки пакета требуется:

• FAR Manager v.3.0 build 4575.

Ссылка: сборка пакета v.3.3.2.0 [Build от 2017-01-14] (0,079 MiB).

Внимание: Перед установкой обязательно прочтите context\doc\install.rus. Для "LuaFAR для Редактора" пакет достаточно установить в каталог плагина. Для "UM Adapter" пакет достаточно установить в каталог work каталога профиля FAR. Пакет можно установить в каталог, доступный для всех скриптов LuaFAR. Порядок задания такого каталога описан в файле справки context\faq\faq_rus.hlf (тема «Где размещать общие скрипты и библиотеки?»).

К оглавлению

Пакет UM Adapter

UM Adapter — пакет для использования в плагине LuaMacro пакетов скриптов, написанных для "LuaFAR for Editor".

Состав:

• Скрипт‑макрос um_adapter.lua, написанный на основе lf4ed.lua из плагина "LuaFAR for Editor".
• Набор скриптов far2, необходимых для работы пакетов.

Ссылка: сборка пакета v.3.0.2.1 [Build от 2017-02-27] (0,019 MiB).

Ссылка: полная сборка пакета v.3.0.2.1 full [Build от 2017-02-27] (0,347 MiB).

Внимание: Полная сборка предназначена только для первоначальной установки пакета. Сборка включает в себя также пакеты LuaFAR context и Rh_Scripts. Распакуйте архив в каталог %FarProfile%, а затем скопируйте um_adapter.lua в каталог %FarProfile%\Macros\scripts.

К оглавлению

Пакет Rh_Scripts

Rh_Scripts — пакет скриптов и утилит для "LuaFAR для Редактора".

Состав:

• Утилита «Пользовательское меню Lua» (LUM).
• Утилита «Прямоугольное меню» (RectMenu).
• Общие скрипты:
  • Скрипт «Настраиваемое меню» (CustomMenu).
  • Скрипт «Фильтрационное меню» (FilterMenu).
  • Скрипт «Вызыватель меню выбранного вида» (MenuCaller).
  • Скрипт «Формирователь текста для пунктов меню» (MenuTexter).
  • Скрипт «Календарь» (Calendar, см. календари).
  • Скрипт «Таблица символов» (CharsMap, см. таблицу символов).
  • Скрипт «Меню из пунктов вывода символов» (CharsMenu, см. наборы символов).
  • Скрипт «Конфигуратор пакета Rh_Scripts» (rhsConfig).
• Скрипты для редактора:
  • Скрипт «Текстовые шаблоны» (TextTemplate).
  • Скрипт «Завершение слов» (WordComplete).
  • Скрипт для использования действий (AutoActions и HandActions).
  • Скрипт «Усекатель пустоты» (VoidTruncate).
  • Скрипт для «Усекателя пустоты» в авторежиме (TruncAction).
• Служебные скрипты:
  • Скрипт «Обработка клавиш» (Keys).
  • Скрипт «Выполнение действий» (Actions).
  • Скрипт «Lua‑ и LuaFAR‑функции» (Utils).
  • Скрипт «Управление диалогами» (Dialog).
  • Скрипт «Обработка текста в редакторе» (Editor).
  • Скрипт «Работа с макросами‑шаблонами» (Macro).
  • Скрипт «Работа с меню и пунктами меню» (Menu).
  • Скрипт «Обработка даты и времени» (DateTime).
  • Скрипт «Работа с пользовательскими типами данных» (Types).
  • Скрипт «Обработка символов» (Character).
  • Скрипт «Разбор данных по Unicode‑символам» (CharsData).
  • Скрипт «Список Unicode‑символов» (CharsList).
  • Скрипт «Некоторые Unicode‑символы и наборы символов» (CharsSets).
• Остальные файлы:
  • Пользовательские настройки пакета сохраняются в каталог
    %FarProfile%\data\scripts\Rh_Scripts\.
  • Дополнительные файлы для пакета необходимо располагать в каталоге
    %FarProfile%\data\scripts\Rh_Scripts\data\.
  • Дополнительные файлы для некоторых скриптов пакета:
    
    • NamesList.txt — названия Unicode‑символов.
    • Blocks.txt — названия блоков (тематических групп) символов.

Утилита «Пользовательское меню Lua» позволяет выводить меню в зависимости от типа файла.

Возможности:

• Привязка файла к типу с помощью пакета LuaFAR context.
• Привязка типа к выводимому меню в lua‑файле.
• Поддерживаемые меню: прямоугольное, фильтрационное и поисковое.
• Виды пунктов: подменю, макросы, шаблоны, скрипты и команды.
• Назначение нескольких комбинаций клавиш на пункты меню.
• Поддержка настроек собственных меню LUM и локализации текста.

Примеры меню LUM:

• LuaEUM — для редактора.
• LuaVUM — для просмотра.
• LuaPUM — для панелей.
• LuaDUM — для диалога.
• LumFLS — для работы с fl_scripts.

Примеры общих подменю:

• Дополнения (Addon scripts):
  
  • Таблица символов (выбор блока).
  • Календарь.
  • Календари (Calendars):
    
    • Григорианский календарь.
    • Календарь тысячелетий.
    • 16‑ричный календарь.
    • Проект‑минимум календаря
      (вненедельные дни: 29 февраля, 31 декабря).
    • Пернский календарь.
• Наборы символов (Character kits, скриншоты сняты в окне ConEmu со шрифтом DejaVu Sans Mono):
  • Буквы (греческие, иврит).
  • Клавиатуры (кириллица).
  • Математика (символы и знаки, различные индексы).
  • Пунктуация (символы‑знаки, пробел и черта).
• Кавычки/скобки (Quotes/brackets):
  • Закавычивание (Quote text).
  • Раскавычивание (Dequote text).
• Разные скрипты (Other scripts):
  Общая информация, Применение LuaFAR context, Пример Hello, world!.
• Примеры команд (Command samples):
  Показ File_id.diz различными способами.

Примеры подменю для редактора (LuaEUM):

• Вставка шаблона (Template Insert).
  Готовые подменю для Lua, C/C++, Pascal, Html.
• Lua‑скрипты (Lua scripts):
  
  • Чистка текста (Clear text).
  • Усечение пустоты (Truncate void).
  • Изменение символов (Change characters).
  • Транскрибирование (Transcript text).
• Субтитры для файлов ass/ssa, srt (текущая фраза).

Только общие подменю для просмотра (LuaVUM).

Примеры подменю для панелей (LuaPUM).

• Меню Git (Git menu, Extended log, Reset/revert, Tag).
• Меню команд TortoiseSVN. (TortoiseSVN menu).

Только общие подменю для диалога (LuaDUM).

Подменю LumSVN «TortoiseSVN» позволяет выполнять почти все команды TortoiseSVN.

Особенности:

• Аналог контекстного меню TortoiseSVN Проводника.
• Работает только с текущим элементом активной неплагиновой панели.
• Различаются: файл/папка, рабочая копия или нет, версионированный или нет.
• Для работы используются TortoiseProc.exe и SubWCRev.exe из TortoiseSVN.
• Настройки хранятся в файле
  %FarProfile%\data\scripts\Rh_Scripts\LumSVN\config\TortoiseSVN.cfg.

Иллюстрация подменю «TortoiseSVN»:

• версионированные папка и файл,
• папка и файл нерабочей копии,
• неверсионированные папка и файл.

Утилита «Прямоугольное меню» позволяет выводить меню в несколько строк и столбцов.

Возможности:

• Меню в виде таблицы из нескольких строк и столбцов.
• Параметры настройки для меню в целом и для отдельных пунктов.
• Маркирование цветом заданных символов текста пунктов меню.
• Поддерживаемые меню: фильтрационное и поисковое (far2.searchmenu).
• Внешний вид: список, главное меню, всплывающее меню и т.д.
• Пример списка: Список завершения слова.
• Примеры меню: Календари, Таблица символов, Наборы символов, Вставка шаблона, Git, TortoiseSVN.

Для работы сборки пакета требуется:

• FAR Manager v.3.0 build 4575.
• UM Adapter v.3.0.2.0 .
• LuaFAR context v.3.3.2.0 .
• для flsLUM — fl_scripts v.3.1.0.0+ .

Ссылка: сборка пакета v.3.3.6.5 [Build от 2018-08-19] (0,254 MiB).

К оглавлению

Пакет Rh_Macros

Rh_Macros — пакет скриптов и макросов для FAR Manager.

Для работы сборки пакета требуется:

• FAR Manager v.3.0 build 4575.
• LuaFAR context v.3.3.2.0 .
• Rh_Scripts v.3.3.6.5 .

Ссылка: сборка пакета v.3.3.4.0 [Build от 2018-08-19] (0,019 MiB).

К оглавлению

Пакет LuaSpell

LuaSpell — пакет для проверки орфографии в редакторе FAR Manager.

Пакет поддерживает словари, используемые Hunspell, а также словари OOoUserDict1 (пользовательский словарь OpenOffice) и WordList (список слов). Для Hunspell‑словарей используется библиотека hunspell из проекта luapower.

Для работы сборки пакета требуется:

• FAR Manager v.3.0 build 4575.
• Hunspell v.1.3.2.

Ссылка: сборка пакета v.3.2.4.4 [Build от 2016-07-04] (0,017 MiB),
библиотека hunspell v.1.3.2 (0,233 MiB),
русский (с "ё") и английский словари в кодировке UTF‑8 (0,606 MiB),
старый пример конфигурации для tex‑тегов с заготовкой словаря (0,001 MiB).

Внимание:

• Перед установкой пакета прочтите LuaSpell\doc\Install.rus.
• В пути к словарям должны быть только символы из кодировки ANSI.
• Все файлы словарей должны быть в кодировке UTF‑8 без BOM, а в первой строке aff‑файлов нужно прописать SET UTF-8.

К оглавлению

Пакет Rh_Presets

Rh_Presets — пакет пресетов поиска/замены для FAR Manager.

Пункты пресетов: часть 1, часть 2, часть 3.

Для работы сборки пакета требуется:

• FAR Manager v.3.0 build 4575.
• LuaFAR Search v.3.26.3 .

Ссылка: сборка пакета v.3.1.4.0 [Build от 2016-07-03] (0,007 MiB).

К оглавлению

Набор fl_scripts и пакет LuaFAR area config разработаны Максимом Гончаром (maxfl) и в настоящее время поддерживаются С. Зейгерманом и мной.

Пакет LFA config

LuaFAR area config — пакет для плагина "LuaFAR для Редактора", предназначенный для автонастройки редактора FAR в зависимости от типа файла.

Возможности:

• Задание настроек редактора в зависимости от типа файла.
• Показ номеров строк (слева от поля редактирования).
• Подсветка позиции конца строки и конца файла.
• Подсветка правой границы и последней строки файла.

Иллюстрация работы пакета: пример 1, пример 2.

Для работы тестовой сборки пакета требуется:

• FAR Manager v.3.0 build 4575.
• UM Adapter v.3.0.2.0 .
• LuaFAR for Editor v.3.7.1 .
• LuaFAR context v.3.3.2.0 .

Ссылка: сборка пакета v.3.1.1.1 [Build от 2018-08-22] (0,017 MiB).

К оглавлению

Набор fl_scripts

FAR Lua scripts — набор скриптов для "LuaFAR для Редактора".

Для работы пакета требуется:

• FAR Manager v.3.0 build 3707.
• LuaFAR for Editor v.3.4.0 .
• LuaFAR context v.3.1.0.0 .

Ссылка: сборка пакета v.3.1.0.0 [Build от 2013-11-16] (0,033 MiB).

К оглавлению

Ссылки

Основные ссылки:

• Язык Lua.
• FAR Manager: форум, PlugRing.
• Пакет luapower: hunspell.

Страницы:

• Shmuel Zeigerman: GitHub, PlugRing.
• Aidar Rakhmatullin: GitHub, PlugRing.

Плагины LuaFAR:

• LuaFAR for Editor: обсуждение, GitHub, PlugRing.
• LuaFAR History: обсуждение, PlugRing.
• LuaFAR Search: обсуждение, PlugRing.

Скрипты и пакеты:

• Пакет LuaFAR context: обсуждение, GitHub, PlugRing.
• Пакет UM Adapter: обсуждение, GitHub, PlugRing.
• Пакет Rh_Scripts: обсуждение, GitHub, PlugRing.
• Пакет Rh_Macros: GitHub, PlugRing.
• Пакет LuaSpell: обсуждение, GitHub, PlugRing.
• Пакет Rh_Presets: GitHub.
• Пакет LFA config: обсуждение.
• Набор fl_scripts: обсуждение, GitHub.

К оглавлению

Основное содержание \ Программы