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

Emiliano
Gulmini

    emi_barbarossa@yahoo.it

Юрій
Чорноіван

    yurchor@ukr.net

Переклад українською
2004
Emiliano Gulmini
&FDLNotice;
2004-08-09
1.0.0

&kfilereplace; — це утиліта для пошуку і заміни рядків.

KDE
KFileReplace
заміна
пошук
рядок

## Вступ

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

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

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

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

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

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

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

Новий сеанс

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

Лише пошук

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

Замінити

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

Симулювати заміну

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

Зупинити

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

Додати рядки

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

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

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

Змінити рядки

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

Вилучити список

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

Інвертувати рядки

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

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

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

Шукати у підтеках

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

Зробити резервні копії

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

Пошук з врахуванням регістру

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

Команди

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

Формальні вирази

  За допомогою цієї кнопки можна увімкнути формальні вирази у стилі &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`. Вставте цей вираз до поля редактора пошуку, натисніть кнопку Гаразд і увімкніть формальні вирази за допомогою кнопки-перемикача Формальні вирази. Будь ласка, зауважте, що використання формальних виразів надає вам змогу виконувати дуже складні пошуки, але значно сповільнює сам процес пошуку. Оволодіти мовою формальних виразів досить складно, і часто якщо ви бажаєте вирішити одну проблему за допомогою формального виразу, ви створите дві проблеми.

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

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

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

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

### Команди

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

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

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

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

François Dupoux dupoux@dupoux.com

  Перший автор

Andras Mantia amantia@kde.org

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

Emiliano Gulmini emi_barbarossa@yahoo.it

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

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

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

&underFDL; &underGPL;

## Встановлення

### Як встановити &kfilereplace;

Поточна версія &kfilereplace; є частиною пакунка &kdewebdev;, отже, щоб встановити її, вам потрібна копія пакунка &kdewebdev;. Зауважте, що якщо ви користуєтеся версією &kde;, яка постачається виробником вашої операційної системи, ймовірно, що ви вже встановили &kdewebdev;. У такому разі ви можете скористатися &kfilereplace;, якщо запустите веб-редактор &quantaplus;, або безпосередньо (якщо у вас не занадто стара версія &kde;). У іншому випадку, ви можете звантажити пакунок &kdewebdev; з мережі Інтернет: будь ласка, зверніться до домашнього сайта &kdewebdev;, щоб отримати докладнішу інформацію.

### Вимоги

Щоб мати змогу користуватися командою [$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;