Программа RQ Search and Replace v.1.20 предназначена для поиска и замены нескольких фрагментов текста в нескольких файлах за один запуск.  В качестве фрагментов могут выбраны непрерывные блоки текста, строки или (с ограничениями для нерегистрированной версии) HTML теги.

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

Для использования расширенного набора функций  требуется регистрация программы .
В данной версии в расширенный список входят следующие функции:
1.  Обработка файлов в поддиректориях
2. Операции с HTML тегами.

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

• составить оглавление -  создать файл-список ссылок на HTML файлы в данной директории.
• в HTML файлах преобразовать Unicod в ASCII  ( последовательности &#xxxx в символы)
• преобразовать Text->HTML (с подсветкой синтаксиса для исходников)

Порядок работы с программой

1. Выбрать при помощи кнопки  нужный каталог , выбрать маску файлов.

---- Выбор каталога ---- Выбор маски файла ---- Включить поддиректории ---- Список обрабатываемых файлов Обрабатываются все файлы из данного списка.

Маску файла можно выбрать по щелчку правой кнопкой мыши из выпадающего списка.
Для выбора какой-нибудь файл должен быть подсвечен!

Выбрать расширение - выбрать все файлы с расширением, как у  подсвеченного Только этот файл - выбрать только подсвеченный файл Обновить список - обновить список файлов в директории.

В зарегистрированной версии могут обрабатываться файлы из выбранного каталога и всех подкаталогов.
Для этого необходимо установить галочку "Включая поддиректории".
В открывшемся окне будет сформирован список файлов, которые подлежат обработке.
Можно исключить из обработки отдельные файлы (сняв соответствующую галку) или целиком поддиректории, используя кнопки "+" и "-".
В незарегистрированной версии обрабатывается  только первые 30 файлов из данного списка.


2. В таблицу поиска и замены внести нужные фрагменты поиска и замены, выбрать требуемые операции - Заменить, Удалить и т.д.

Фрагменты поиска и замены могут быть многострочными.
Поскольку в ячейке таблицы видна только одна строка (хотя хранится целиком многострочный текст), для отображения и редактирования всего фрагмента используется редактор таблицы.
Примечание.
В таблице Поиска и замены (см. ниже) всегда используется шрифт Windows, поэтому Dos и КОИ текст в ячейках  таблицы нечитабелен.
 

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

Для строки:

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

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

Вставить после...  - вставка фрагмента или строки замены после строки поиска.
В тексте ищутся строки, содержащие фрагмент из ячейки "Поиск", и в конец строки дописывается фрагмент из ячейки "Замена". Чтобы фрагмент из ячейки "Замена" добавился в новую строку необходимо добавить пустую строку в ячейку  "Замены" перед фрагментом, нажав клавишу Enter.

Вставить до... - вставка фрагмента или строки замены до строки поиска.
В тексте ищутся строки, содержащие фрагмент из ячейки "Поиск", и в начало строки дописывается фрагмент из ячейки "Замена". Чтобы фрагмент из ячейки "Замена" добавился в новую строку необходимо добавить пустую строку в ячейку  "Замены" после фрагмента, нажав клавишу Enter.

            Для HTML тегов:

Примечание 1.
В незарегистрированной версии  операции с тегами выполняются только над первым  файлом из списка!

Примечание 2.
Под HTML тегом здесь понимается последовательность вида
<[ ]имя_тега[ ]имя_атрибута[ ]=[ ]значение_атрибута[ ][...] >
[ ] - один или более пробелов
знак = и значение_атрибута могут отсутствовать
[...] - следующие последовательности  (имя_атрибута [ ]=[ ] значение_атрибута [ ])

ищутся теги, удовлетворяющие условию поиска и  выполняются операции

Удалить тег - удаляется тег и соответствующий закрывающий тег.
Подробнее.
1. Ищется тег, удовлетворяющий условию поиска
2 . Могут быть установлены следующие условия удаления:
1.  В ячейке замены пишется ключ ALL
Удаляются начальный и конечный теги и весь текст (включая другие теги ) , содержащийся между ними.
2.  В ячейке замены пишется ключ ALL-
Удаляется весь текст (включая другие теги ) , содержащийся между начальным и конечным тегами. Сами теги не удаляются.
3. Если ключ отсутствует, то удаляются только начальный и конечный теги.
Текст, находящийся между ними, сохраняется.

Заменить атрибут  - значение атрибута заменяется на заданное.
Подробнее.
1. Ищется тег, удовлетворяющий условию поиска
2. В найденном теге ищется атрибут, имя  которого совпадает с заданным в ячейке замены.
3. Данному атрибуту присваивается значение, заданное в ячейке замены.
Пример 1.
ячейка поиска <meta http-equiv="Content-Type">
ячейка  замены charset=windows-1251
Будут искаться теги meta, содержащие атрибут http-equiv="Content-Type"  и если в найденном теге присутствует атрибут charset, то ему будет присвоено значение windows-1251
Пример 2.
ячейка поиска <meta  charset=windows-1251><>AND
ячейка  замены charset=koi8-r
Будут искаться теги meta, содержащие атрибут  charset=windows-1251 и
атрибуту charset  будет присвоено значение koi8-r

Удалить атрибут - удаляется атрибут с заданным именем/значением

Добавить атрибут - добавляется атрибут с заданным  именем/значением
Если атрибут с таким именем уже имеется, то его значение изменяется на заданное, без добавления нового атрибута.

В верхний регистр - значение атрибута переводится в верхний регистр
Подробнее.
1. Ищется тег, удовлетворяющий условию поиска
2. Если  в найденном  теге присутствуют атрибуты, перечисленные в ячейке замены, то значения этих атрибутов переводятся в верхний регистр. Имена атрибутов не изменяются.  Значения других атрибутов не изменяются.
Если в ячейке замены вместо имен атрибутов указан символ * , то изменяется регистр значений всех атрибутов. Другие маски пока не поддерживаются.

Пример 1.
ячейка поиска  <a target=_blank ><>OR
ячейка  замены href target
В найденном теге значение атрибутов href , target переводятся в верхний регистр.

В нижний регистр - значение атрибута переводится в нижний регистр

Примечание.
При обработке найденных тегов двойные (и более) пробелы внутри тегов заменяются на одинарные.
Примечание.
При сравнении значений атрибутов кавычки и апострофы отбрасываются.
Т.е значения атрибутов
onClick="this.setHomePage('http://www.ru'); return false;"
onClick='this.setHomePage("http://www.ru"); return false;'
onClick=this.setHomePage('http://www.ru'); return false;
считаются равными.

Могут быть установлены следующие условия поиска:

1. Эквивалентность (равенство) тегов
Ищется тег такого же типа, содержащий такой же набор атрибутов
Порядок атрибутов, количество пробелов - не имеет значения.
В ячейке поиска указывается  тег и условие поиска EQU, например
<IMG SRC="bluprev.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Previous Page"><>EQU
(здесь последовательность <> - просто разделитель )
Если тег поиска указан без атрибутов, то  тег с таким же именем и без атрибутов будет считаться подходящим.

2.Условие И
Искомый тег должен содержать в себе все признаки поиска
В ячейке поиска указывается тег + <>And, например
<IMG SRC="bluprev.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Previous Page"> <>And
Ищется тег с таким же именем, набор атрибутов которого должен содержать все указанные атрибуты.
Если тег поиска указан без атрибутов, то любой тег с таким же именем будет считаться подходящим.

3. Условие ИЛИ
Искомый тег должен содержать в себе хотя бы один из признаков поиска В ячейке поиска указывается тег + <>OR
Если тег поиска указан без атрибутов, то любой тег с таким же именем будет считаться подходящим.

4. Условие И-НЕ
 Искомый тег НЕ должен содержать в себе ни одного из признаков поиска В ячейке поиска указывается тег + <>NOT
Если тег поиска указан без атрибутов, то любой тег с таким же именем будет считаться подходящим.

5. Условие ИЛИ-НЕ
Искомый тег НЕ должен содержать в себе хотя бы один из признаков поиска
В ячейке поиска указывается тег + <>NOR
Если тег поиска указан без атрибутов, то любой тег с таким же именем будет считаться подходящим.
Если в найденном теге нет атрибутов, то такой тег  будет считаться подходящим.

6. Если условие поиска (<>XXX) не задано , то по умолчанию присваивается  <>OR

Заполнять таблицу можно несколькими способами.

1. Сохранять копии - сохраняет копии преобразуемых файлов в соответствующих подкаталогах :
"Original" -  каталог с копией оригинальных файлов.
Перед началом обработки (поиска и замены) оригинальные файлы сохраняются в этом каталоге.
Если такой каталог уже существует, то запрашивается разрешение на сохранение.
"LastCopy" - переход в каталог с последней сохраненной копией.
Если обработка происходит несколько раз, то в этом каталоге хранится последняя копия  текущего каталога.
2. Запрашивать подтверждение
Возможность выполнять операции без дополнительного подтверждения.
 

Начать  Поиск  и Замену

Для начала проведения поиска и замены необходимо нажать кнопку Пуск. Если данные в таблице поиска и замены неверны, то будет выдаваться  предупреждающее сообщение.  Ход процесса  поиска отображается в редакторе  лога и на панели лога. Процесс поиска можно остановить, нажав кнопку Стоп. .

Сохранение  проекта
Содержание таблицы, текущая директория, маска файлов могут быть сохранены для последующей работы. Это можно сделать через пункт меню Проект-Сохранить (Сохранить как..)

Отмена изменений
Сохранение копий и восстановление исходных файлов осуществляется через пункт меню "Копии".   Возможен быстрый доступ к папкам с копиями исходных и обработанных файлов, их удаление, копирование.

  Некоторые советы

• Загруженный в редактор файл можно редактировать вручную и сохранять изменения через меню.

• Подсветка синтаксиса HTML файлов очень медленна. Чтобы прервать процесс подсветки надо кликнуть по полю окна редактора.

• Выделенные фрагменты можно перетаскивать из редактора в редактор с помощью мыши.

• Редактор лога можно использовать для хранение фрагментов текста. 

• При нажатии кнопки    появляется панель выбора каталога. "Горячие" директории можно выбирать и   сохранять в соответствующем комбобоксе.
  
  

• Выбранный файл можно запустить (если с его расширением ассоциирована какая-нибудь программа ) дважды кликнув на строку с именем файла под меню.
  
  
   

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

Описание Меню

• Файл - обычные операции  с файлами. Открыть файл можно двойным кликом в списке файлов справа
• Проект - Открытие, удаление, сохранение файлов с содержанием таблицы поиска\замены и другими настройками
• Выбор кодировки - ручной или автоматический.
   

  Email Bug пока не поддерживается.

• Просмотр в виде.. - просмотр файлов в окне редактора файла как текстовый, RTF, как HTML документ.
   

  Plain Text - в текстовом формате RTF - просмотр файлов *.rtf HTML Filtered - убирает теги из *.html файлов По формату - просмотр в окне редактора *.html файлов . Включить\.выключить перенос слов (в данной версии не работает)

• Операции - дополнительные операции, которые могут быть выполнены.
   
• Настройки -
      Сохранять копии - исходных и обработанных файлов.
      Запрашивать подтверждение - о проведении обработки.
      (В противном случае обработка будет происходить по нажатии  кнопки ПУСК  без дополнительных запросов)
       Очистить таблицу поиска и замены
       Сохранять лог-файл - сохраняется под именем вида
       ProjectjName+Date$+"_"+Timeg$+".log" в директории запуска
       программы
       Шрифт и цвета - настройка  шрифта и цвета  фона окон редактора и таблицы.
   
• Копии - быстрый доступ к папкам с копиями исходных и обработанных файлов, их удаление, копирование
  Копии сохраняются в папке BackUp в  директории запуска программы в виде
  
  Путь резервных копий сформирован из пути папки с исходными файлами.
  В папке Original хранятся исходные файлы, в папке LastCopy - последние измененные файлы.
  Исходные файлы сохраняются только один раз в начале работы.
  Если данный каталог с иходными файлами  уже существует с прошлой сессии, то запрашивается разрешение на перезапись.
  Примечание.
  Если в процессе работы маска файлов была изменена, то необходимо вручную сохранить файлы как исходные.
  
  
  "Текущие" - переход в каталог с обработанными файлами
  
  "Исходные" - переход в каталог с копией оригинальных файлов.
  Перед началом обработки (поиска и замены) оригинальные файлы сохраняются в этом каталоге.
  
  "Последние" - переход в каталог с последней сохраненной копией.
  Если обработка происходит несколько раз, то в этом каталоге хранится последняя копия.
  
  "Сохранить как исходные" - переписать файлы из текущего каталога  (только перечисленные в списке файлов с учетом маски!) в каталог исходных файлов.
  Если результаты обработки удовлетворительные, то файлы можно сохранить как исходные.
  
  "Сохранить как последние" - переписать файлы из текущего каталога в каталог с последней копией.
  Открытый в редакторе файл необходимо предварительно сохранить!
  
  "Восстановить из исходных" - переписать оригинальные файлы в текущий каталог.
  Чтобы отменить все изменения,  можно восстановить исходные файлы.
  Переписываются только файлы присутствующие в списке, т.е. с учетом маски.
  Чтобы восстановить все файлы, маска должна быть "*.*".
  
  "Восстановить из последних"
  Если результаты последней обработки неудовлетворительные, то можно восстановить последнюю копию.
  Переписываются только файлы присутствующие в списке, т.е. с учетом маски.
  Чтобы восстановить все файлы, маска должна быть "*.*".
  Восстановленный файл автоматически в окно редактора НЕ загружается!
  
  "Удалить исходные"
  Удаление всей папки с копией оригинальных файлов.
  
  "Удалить последние"
  Удаление всей папки с последней копией.
  
   
• История - Быстрый доступ к последним 9 обработанным директориям.
• Помощь

Другие функции

Операция создания страницы-оглавления (contens.htm) для html файлов из заданной директории.
На  данной странице формируются ссылки на html-файлы в данной директории. В тексте ссылок указываются данные из тега <title> html-страниц или другого, ограниченного произвольными последовательностями символов, указанного в таблице.
В ячейке поиска задается начальная последовательность, в ячейке замены - конечная.
Для формирования оглавления необходимо выбрать в списке только файлы HTML-формата. В противном случае файл оглавления может быть не сформирован.

Возможные проблемы

1. Подсветка синтаксиса HTML файлов очень медленна. Чтобы прервать процесс подсветки надо кликнуть по полю окна редактора.
2.  После остановки подсветки иногда не появляется вертикальный скролл бар.  Чтобы он появился необходимо изменить размер редактора лога, потянув за красный горизонтальный разделитель.
3. Сообщения в редактор лога (нижнее окно) выводятся шрифтами разных цветов, в том числе и белого. На светлом фоне надписи могут быть не видны.
4. При сбоях в процессе обработки кнопки Пуск, Стоп могут остаться подсвеченными.
5. Файлы размером более 2048 к  не редактируются, только показываются.
6. Могут быть проблемы с размером шрифта DOS при вводе, но  после сохранения файла размер шрифта будет нормальный.
7. Для нормальной работы с DOS кодировкой под Windows XP необходимо установить файл riched32.dll из дистрибутива Windows 98 в рабочий каталог программы и файл шрифта 8514OEM.FON в каталог codePage в рабочем каталоге программы.
8. Иногда самопроизвольно переключает раскладку с русского на английский при вводе текста в DOS кодировке. Можно попробовать в свойствах клавиатуры назначить  русский язык по умолчанию.
9. Чтобы загружать и просматривать текст в бинарных файлах, надо установить галку в меню Операции-Заменять 0-31 символы
С файлами более 5-8Мб работать практически невозможно из-за низкой скорости загрузки.