# Підручник &kfilereplace;

## Вступ

&kfilereplace; — це програма, яку призначено для пошуку і заміни списку рядків у ієрархії файлів. Під рядками тут маємо на увазі, звичайні рядки або формальні вирази у стилі &Qt;. Крім того, можна вказувати і інші параметри для уточнення пошуку.

## Користування &kfilereplace;

&kfilereplace; у своїй автономній інкарнації &kfilereplace; у своїй автономній інкарнації

### Панель інструментів

Панель інструментів &kfilereplace; має виглядати так: Панель інструментів &kfilereplace; Панель інструментів &kfilereplace;

На панелі інструментів показано кнопки, пов’язані з основними функціями програми.

### Піктограми панелі інструментів

Налагодити сеанс пошуку/заміни

- За допомогою цієї кнопки можна відкрити діалогове вікно сеансу, у якому ви можете встановити декілька базових параметрів, якщо &kfilereplace; запущено як окрему програму, вашим першим кроком під час роботи має бути натискання цієї кнопки.

Пошук

- За допомогою цієї кнопки можна розпочати сеанс пошуку.

Імітувати

- За допомогою цієї кнопки можна почати імітацію пошуку з заміною. Після натискання цієї кнопки ніяких змін до файлів внесено не буде.

Замінити

- За допомогою цієї кнопки можна розпочати сеанс пошуку з заміною. Коли буде знайдено відповідний рядок, &kfilereplace; замінить його на інший рядок.

Зупинити

- За допомогою цієї кнопки можна зупинити виконання операції.

Додати рядок

- За допомогою цієї кнопки можна відкрити діалогове вікно Додати рядки, у якому ви можете змінити ваш список рядків.

Вилучити рядок

- За допомогою цієї кнопки можна вилучити вибраний (або поточний, якщо нічого не вибрано) рядок зі списку.

Редагувати вибраний рядок

- За допомогою цієї кнопки можна змінити вибраний рядок.

Випорожнити список рядків

- За допомогою цієї кнопки можна вилучити всі рядки зі списку.

Змінити місцями поточний рядок

- За допомогою цієї кнопки можна поміняти місцями рядок пошуку з рядком заміни, так можна скасувати результати операції з пошуку/заміни.

Завантажити список рядків з файла

- За допомогою цієї кнопки можна завантажити список рядків, збережений у файлі xml з суфіксом `kfr`.

Включати підтеки

- За допомогою цієї кнопки ви можете виконати рекурсивний пошук з заміною у підтеках вашого основного каталогу.

Створити резервні файли

- За допомогою цієї кнопки можна увімкнути створення резервних файлів.

З урахуванням регістру

- За допомогою цієї кнопки можна увімкнути пошук з врахуванням регістру.

Уможливити команди у рядку пошуку

- За допомогою цієї кнопки можна увімкнути команди. Команди — це особливі рядки, докладніше про них можна дізнатися з розділу kfilereplace-commands.

Уможливити формальні вирази

- За допомогою цієї кнопки можна увімкнути формальні вирази у стилі &Qt;.

### Список результатів

Перегляд результатів у &kfilereplace; Перегляд результатів у &kfilereplace;

У області перегляду результатів буде показано назви файлів, які містять рядки, які ви хотіли знайти (або замінити), шлях до цих файлів, їх розмір, кількість знайдених рядків та ідентифікатор користувача-власника цих файлів. У цій області також буде показано точне місце кожного знайденого рядка. Крім того, з цієї області ви зможете відкрити файл, якщо клацнете правою кнопкою миші на запису у списку, де показано позицію у вигляді рядка і стовпчика.

### Список рядків

Це область перегляду рядків: Перегляд рядків у &kfilereplace; Перегляд рядків у &kfilereplace;

У області перегляду рядків буде показано список рядків, які ви бажаєте знайти або замінити. Будь ласка, зауважте, що у режимі пошуку області перегляду «Результати» і «Рядки» мають різне компонування.

### Діалогове вікно «Пошук і заміна у файлах»

Діалогове вікно Пошук і заміна у файлах використовується для налаштування основних параметрів, потрібних для роботи &kfilereplace;. У цьому вікні є дві вкладки: Загальні і Додаткові.

#### Вкладка «Загальні»

Вкладка «Загальні» &kfilereplace; Вкладка «Загальні» &kfilereplace;

Якщо ви бажаєте почати новий сеанс, першим кроком буде натискання кнопки Налагодити сеанс пошуку/заміни. Потім вам слід буде ввести адресу основного каталогу і послідовність шаблонів у стилі командної оболонки, які буде використано для фільтрування назв файлів.

Далі, ви можете встановити деякі корисні параметри, наприклад вказати програмі, що слід шукати у підтеках, виконати пошук з врахуванням регістру, увімкнути команди і/або формальні вирази

Будь ласка, зауважте, що формальні вирази і команди можуть негативно вплинути на швидкодію програми.

, створення резервних копій кожного файла перед заміною.

Якщо ви бажаєте почати пошук негайно, введіть рядок у поле пошуку і натисніть кнопку Шукати тепер, у іншому випадку, залиште поле пошуку порожнім і натисніть кнопку Шукати пізніше.

#### Вкладка «Додаткові»

Вкладка «Додаткові» &kfilereplace; Вкладка «Додаткові» &kfilereplace;

На вкладці Додаткові ви можете встановити деякі корисні параметри, які обмежать пошук лише певними файлами у каталозі. Якщо ви бажаєте запустити &kfilereplace; для пошуку лише у файлах, чий розмір знаходиться у діапазоні 10кБ - 100кБ, ви можете скористатися параметрами розміру. Крім того, можна обмежити пошук за датою, або провести пошук у файлах, які належать (або не належать) певному користувачеві (це може бути корисним для системних адміністраторів).

### Діалогове вікно «Параметри»

У цьому діалоговому вікні містяться пункти, які є на панелі інструментів, і додаткові пункти, які можуть бути корисними у певних ситуаціях. Ви можете відкрити це вікно за допомогою пункту Параметри Налаштувати KFileReplace... у головному меню.

#### Загальні параметри

Ці параметри вже обговорювалися у розділі Панель інструментів. Вкладка «Загальні» у вікні «Параметри» Вкладка «Загальні» у вікні «Параметри»

#### Додаткові параметри

Вкладка «Додатково» у вікні «Параметри» Вкладка «Додатково» у вікні «Параметри»

Не показувати файли, якщо у них не знайдено або не замінено рядків Під час пошуку зупинитися на першому знайденому рядку Переходити за символічними посиланнями Ігнорувати приховані файли і каталоги
- показує лише файли, у яких знайдено деякі з ваших рядків. Це пришвидшує пошук. &kfilereplace; припинить пошук після відшукання відповідного рядка і почне шукати інші рядки, якщо ви шукали лише один рядок, пошук буде продовжено у наступному файлі. якщо файл є посиланням на інший файл, шукати у справжньому файлі. якщо буде виявлено приховані файли або теки, ігнорувати їх.

### Діалогове вікно «Вставити рядки пошуку/заміни»

Діалогове вікно «Вставити рядки пошуку/заміни» &kfilereplace; Діалогове вікно «Вставити рядки пошуку/заміни» &kfilereplace;

Це діалогове вікно використовується для додавання рядків до списку і редагування списку рядків. Вам просто слід вставити список пошуку або пошуку з заміною, а потім за допомогою двох мініредакторів додати ваш текст. Кнопки зі стрілками нададуть вам змогу додавати або вилучати пари рядків. Коли процес буде завершено, натисніть кнопку Гаразд.

## Можливості &kfilereplace;

У цій главі наведено відомості про деякі корисні функції &kfilereplace;.

### Як зберегти ваш список рядків

Якщо ви бажаєте повторно використати список рядків, який ви зберегли у файлі `xml`, скористайтеся пунктом меню Пошук/Заміна Рядки Зберегти список рядків до файла. Після цієї команди буде створено простий файл `xml` з суфіксом `kfr`. Щоб завантажити файл `kfr`, скористайтеся пунктом меню Пошук/Заміна Рядки Завантажити список рядків з файла. Сам файл виглядає десь так:

    <?xml version="1.0" ?>
    <kfr>
            <mode search="false"/>
            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_1]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_1]]
    ></newstring>
            </replacement>
            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_2]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_2]]
    ></newstring>
            </replacement>

            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_N]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_N]]
    ></newstring>
            </replacement>

    </kfr
    >

Якщо ви користувалися форматом файлів попередніх версій програми, ви можете оновити файл вручну, змінивши його за наведеною вище схемою. Іншим способом буде завантаження файла, записаного у старому форматі і повторне його збереження за допомогою &kfilereplace; у спосіб, описаний вище.

### Як створити простий звіт

Створити звіт можна за допомогою пункту Пошук/Заміна Результати Створити файл звіту головного меню. Звіт виглядатиме як тека з файлами `xml` і одним файлом `css`. Звіти корисні для створення журналів ваших дій. Функція створення звітів у &kfilereplace; Функція створення звітів у &kfilereplace;

### Як використовувати формальні вирази

Якщо ви бажаєте виконати пошук всіх рядків, що починаються на x, ht або u і закінчуються на ml, вам слід скористатися формальним виразом: `(x|ht|u)ml`. Вставте цей вираз до поля редактора пошуку, натисніть кнопку Гаразд і увімкніть формальні вирази за допомогою кнопки-перемикача Формальні вирази. Будь ласка, зауважте, що використання формальних виразів надає вам змогу виконувати дуже складні пошуки, але значно сповільнює сам процес пошуку. Оволодіти мовою формальних виразів досить складно, і часто якщо ви бажаєте вирішити одну проблему за допомогою формального виразу, ви створите дві проблеми.

### Як захистити початкові файли

Якщо ви не бажаєте втрачати початкові файли, ви можете зробити копію цих файлів перед заміною рядків. Після того, як вставите ваші рядки, і перед тим, як почнете процес заміни, просто відповідно перемкніть кнопку-перемикач Резервування. Якщо ви бажаєте змінити суфікс резервних файлів, скористайтеся діалоговим вікно Параметри.

### Як відкрити файл

Якщо ви бажаєте відкрити файли, у якому було знайдено деякі з рядків, які ви шукали, вам слід вибрати рядок у області перегляду результатів, навести на нього вказівник миші і клацнути правою кнопкою миші. Програма відкриє контекстне меню, за допомогою якого ви зможете відкрити потрібний файл.

### Команди

Припустімо, що ви бажаєте замінити фразу Пригоди Аліси у країні чудес на увесь файл з романом Керола. Звичайно ж, ви не бажаєте робити цього вручну, — вам потрібна команда, яка зробить це за вас. Натисніть кнопку Додати, виберіть Режим пошуку та заміни і вставте такі рядки: `Пригоди Аліси у країні чудес` у міні-редактор пошуку і рядок `[$loadfile:`/шлях-до-моєї-теки/моя-тека/мій-файл`$]` у міні-редактор заміни. Натисніть кнопку Гаразд. Коли повернетеся до головного вікна &kfilereplace;, увімкніть команди за допомогою кнопки Команди на панелі інструментів і запустіть процес заміни. Існують також і інші команди, з їх списком можна ознайомитися у розділі available-commands.

## Подяки і ліцензія

Авторські права на програму &kfilereplace; належать François Dupoux dupoux@dupoux.com, ©1999, Andras Mantia amantia@kde.org, ©2003, Emiliano Gulmini emi_barbarossa@yahoo.it, ©2004

## Автори і супровідники &kfilereplace;:

François Dupoux dupoux@dupoux.com

- Перший автор

Andras Mantia amantia@kde.org

- Автор оболонки, створив KPart, співсупровідник

Emiliano Gulmini emi_barbarossa@yahoo.it

- Поточний супровідник, спрощення і переписування коду

Авторські права на документацію належать Emiliano Gulmini emi_barbarossa@yahoo.it, ©2004

Переклад українською: Юрій Чорноіван yurchor@ukr.net

&underFDL; &underGPL;

## Збирання і встановлення

&install.intro.documentation; &install.compile.documentation;

### Вимоги

Щоб мати змогу користуватися командою [$mathexp:`деякий_математичний_вираз`$], вам слід встановити математичний калькулятор &bc; (версії 1.06 або пізнішої), написаний Philip A. Nelson (philnelson@acm.org).

## Команди &kfilereplace;

[$datetime:iso$] [$datetime:local$] [$user:uid$] [$user:gid$] [$user:loginname$] [$user:fullname$] [$user:homedir$] [$user:shell$] [$loadfile:`/мій-шлях/мій-каталог/мій-файл`$] [$empty:$] [$random:`ЦІЛЕ_ЧИСЛО`$] [$random:$] [$mathexp:`вираз bc`$]
- ця команда повертає поточну дату і час у форматі ISO &Qt;. те саме, що і попереднє, але у локальному форматі. поверне ідентифікатор користувача поточного користувача. поверне ідентифікатор групи поточного користувача. поверне системне ім’я поточного користувача. поверне повне ім’я поточного користувача. поверне назву домашньої теки поточного користувача. поверне назву оболонки поточного користувача. поверне вміст файла мій-файл. поверне порожній рядок. поверне випадковий рядок чисел, отриманий з використанням параметра ЦІЛЕ_ЧИСЛО як початкового числа. те саме, що і попереднє, але без початкового числа. поверне результат обчислення математичного виразу &bc; v1.06.

&documentation.index;