Поиск и Замена: Плагин для FAR
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
(Файл, который обычно читают первым ;-))
Если бы вы все еще голосовали за данный плагин на плагринге:
http://plugring.farmanager.com/cgi-bin/voter.cgi?ID=229 также усердно, как
заваливаете меня просьбами, то хуже бы этому свету от этого не стало :-)
Для поддержки разработки программы можно пожертвовать некоторую сумму. Вот
мои кошельки в системе WebMoney.ru (www.wmtransfer.com): Z787475721790
(для USD), E876273527569 (для Euro), R538290555814 (для рублей).
Есть у меня просьба к вам (не оглядывайтесь, именно к вам): не могли бы вы
(ваши знакомые и т.д.) перевести lng, hlf (если будет желание, то еще и readme,
faq, history) на английский, немецкий, французский или любой другой, какой
знаете, язык, а затем прислать это дело мне, чтобы я включил это в поставку
программы? Я никого не заставляю и лишь надеюсь на то, что есть люди, готовые
подкрепить свои "пасибы" делом...
1. Что это за программа
2. Системные требования
3. Лицензия
4. Установка и удаление
5. Поддержка внешних модулей (плагинов) в S&R
5.1. Системные плагины
5.2. Пользовательские плагины
5.3. История изменений
6. История изменений
7. Где брать новые версии
8. Дополнительная настройка
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. Что это за программа
Это плагин для FAR'а, позволяющий производить поиск и замену неких данных
как в одном файле, так и во многих, а также работающий в редакторе и программе
просмотра. Предназначено для web-мастеров, программистов и продвинутых
пользователей.
Основные характеристики:
* Вы можете обрабатывать файлы в любой кодировке, установленной в FAR,
а также в кодировке Unicode
* Вы можете производить поиск и замену hex-кодов
* Вы можете использовать регулярные выражения в строках поиска и замены, для
указания маски файлов
* Вы можете сохранять и использовать схемы
* Вы можете указывать ограничения по дате, размеру, атрибутам для
обрабатываемых файлов
* Вы можете указать список обрабатываемых каталогов.
* Вы можете перекодировать данные из любой кодировки в любую (кроме Unicode)
* Можно произвести подсчет вхождений искомой строки в редакторе, программе
просмотра или во многих файлах
* Работа в выделенной области в редакторе
* Удобная навигация по найденному в редакторе
* Поддержка расширения возможностей при помощи внешних модулей.
В том числе уже есть и работают:
* NewName: переименование файлов с использованием регулярных выражений
* Dir2File: создание списка файлов - многофункциональный плагин,
способный сгенерировать все, что угодно, по вашим же правилам.
Например, вы можете:
* создать html-страницу с картинками из текущего каталога
* создать bat-файлы со сложными командами обработки нужных файлов
* скопировать ярлыки Internet (*.url) в один html-файл
* и многое другое - все зависит от вашей фантазии
* VerInfo: показ содержимого versioninfo для нужного файла
* И многое другое...
Рекомендую обязательно прочесть помощь (ее не так много, но многие вопросы
исчезнут сами собой) и FAQ.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2. Системные требования
Для того, чтобы плагин выполнял основные свои функции, достаточно FAR
Manager версий 1.6x. Если вам нужна обработка файлов с учетом атрибутов, работа
в программе просмотра, "умные" диалоги, автоматический запуск поиска в
редакторе для файла, находящегося в режиме запрета модификации и умение плагина
отличать панель с реальными файлами от всех прочих, то потребуется FAR 1.70
beta 5 (build 1634) и выше.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3. Лицензия
Прочтите, пожалуйста, лицензию (License.txt) - там все написано.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
4. Установка и удаление
Установить можно так же, как и большинство прочих плагинов для Фара:
- создайте подкаталог с произвольным именем в Far\Plugins и скопируйте туда
файлы s_and_r.dll, *.hlf, *.lng, *.msg, оба целиком (с подкаталогами) каталога
SRPlugins (там находятся внешние модули для S&R) и System (системные модули).
- Импортируйте, если нужно, в реестр файл Reg\FATypes.reg - он содержит
настройки для нескольких типов файлов, которые используются для поиска разделов
в редактируемом файле. Если у вас есть подобные настройки для файлов разных
типов, то присылайте их мне и они будут включены в дистрибутив программы.
- Если вы используете плагин второго уровня newname.srp, то импортируйте в
реестр файл newnamescheme.reg - он содержит пример схем, предназначенных для
замены возможностей стандартного плагина "Преобразование регистра".
- Если вы используете плагин второго уровня dir2file.srp, то можете
импортировать в реестр файл dir2file_scheme.reg - он содержит пример схем для
этого плагина.
- Перезапустите FAR
- В меню плагинов (F11) появится пункт от S&R - пользуйтесь
(плагин можно запускать и из командной строки - подробности в справке)
Для удобства применения плагина в редакторе и в программе просмотра можно
"перекрыть" макросами стандартные функции Фара. Готовые примеры макросов
смотрите в файлах *.reg из данного дистрибутива.
Удаление плагина:
- сотрите каталог с плагином, который вы создали при установке (возможно
потребуется перезапустить Фар, чтобы тот "освободил" s_and_r.dll)
- удалите все макросы, которые используют S&R - они теперь бесполезны
- удалите записи плагина в реестр (например, при помощи uninstall.reg)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
5. Поддержка внешних модулей (плагинов) в S&R
Программа S&R реализует некоторые функции при помощи внешних модулей
(плагинов), которые можно разделить на два вида: системные и пользовательские.
Все поставляемые вместе с S&R плагины предназначены только для той версии
S&R, в дистрибутив которой они входят. Корректная работа этих плагинов с
другими версиями S&R не гарантируется.
5.1. Системные плагины
~~~~~~~~~~~~~~~~~~~~~~
Эти плагины реализуют некоторые внутренние функции (их можно назвать
"системными") программы S&R, просто для удобства разработки и использования они
физически расположены не в s_and_r.dll, а в динамически подключаемых
библиотеках. Они имеют расширение SRS и вместе со своими сообщениями
(msg-файлы) находятся в подкаталогах каталога System, который должен находится
в тот же каталоге, где находится s_and_r.dll. Переименовывать или переносить их
в другие каталоги, нежели так, как они расположены в дистрибутиве, нельзя, в
противном случае основной модуль просто не сможет их найти - обращение к ним
осуществляется по конкретным именам.
5.2. Пользовательские плагины
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Реализуют дополнительные функции по желанию пользователя. Имеют расширение
SRP. S&R ищет их во всех каталогах, начиная с SRPlugins (это каталог должен
быть там же, где находится s_and_r.dll, или указывается в "настройки/прочие").
Можно писать плагины для панелей, редактора и программы просмотра.
Документацию по написанию пользовательских плагинов (на русском языке) в
формате chm или html всегда можно скачать с моего сайта, там же ее можно
просмотреть в режиме on-line.
Необходимый для сборки плагинов заголовочный файл и пример плагина на C++ (в
качестве примера выступают исходные тексты любого по выбору из стандартных
плагинов) высылаются по запросу. Все это не входит в дистрибутив S&R по простой
причине - я не уверен, нужно ли это кому-нибудь вообще...
5.3. История изменений
~~~~~~~~~~~~~~~~~~~~~~
Смотрите файл srp_history.txt
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6. История изменений
Смотрите файл history.txt
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7. Где брать новые версии
В первую очередь мои творения появляются здесь: http://www.moris.ru/~spinoza
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8. Дополнительная настройка
В данном разделе описано несколько параметров, которые влияют на работу
плагина, но недоступны через обычное меню конфигурации. Эти параметры хранятся
там же, где и все прочие настройки плагина - обычно это следующая ветвь
реестра: HKCU\Software\Far\Plugins\S_And_R. При изменении этих параметров
потребуется перезапустить FAR.
"UFH"=dword:00000001
Если значение равно 00000001, то используется первая строчка из "истории"
Фара для получения строк поиска, замены, маски файлов, если 00000000, то
указанные строки берутся из внутренних переменных плагина. По умолчанию -
00000001.
"Prefix"="S&R"
Префикс для запуска плагина из командной строки. Допустимый размер - до 63
байтов. По умолчанию - "S&R". При изменении этого параметра, возможно,
потребуется очистить кэш плагинов (см. FAR\ClearPluginsCache.bat)
"LogDir"=""
Каталог для создаваемого лога. При отсутствии этой переменной или если она
пуста, лог создается в текущем каталоге. Можно использовать переменные
окружения. Кодировка должна быть OEM. Максимальный размер - 256 байтов.
"CPN"=dword:0000000A
Количество временных панелей. По умолчанию - 10. Допустимые значения: от 2
до 64.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Благодарю за использование S&R.
Иван Синтюрин
Sat 04 Feb 17:12:30 2006