# KFind ハンドブック

Miroslav
Flidr

    flidr@kky.zcu.cz

Martin
Hartig

    hartig@mathematik.uni-kl.de

Mark
Roberts

    mar2@scigen.co.uk

バージョン 0.4, 1998年6月21日

このハンドブックでは、KFind のバージョン0.4について説明します。

The KFind Handbook

KDE
KFind
File searching

## はじめに

Kfindは、ディレクトリ階層内のファイルを見つける目的で設計されたツールです。

ファイルがどこかそのあたりにあるのはわかっているけれど、正確にどこにあるかがわからないとき、kfindを使うと便利です。 必要なファイルを見つけた後、

- 保存する、

- 削除する、

- ファイル・プロパティを変更する、

- アーカイブへ保存する、

- ファイル・マネージャ(Kfm)からそのファイルが入ったディレクトリを開く

ことができます。

このプログラムがユーザの皆様の役に立つことを願っています。また、提案やコメントなどをいただけたら幸いです。

`Miroslav Flidr` flidr@kky.zcu.cz.

## インストール

### KFind の入手方法

KFindは、KDEプロジェクト(http://www.kde.org)の中心となるアプリケーションです。KFindは、プロジェクトのメインFTP ftp://ftp.kde.org/pub/kde/から入手できます。 そこには多くのFTPミラーサイトへのリンクもあります。

### 必要なソフトウェア

KFindを正しくコンパイルするには、`libkdecore`および`libkfm`の最新バージョンが必要です。必要なライブラリおよびKFind本体もftp://ftp.kde.org/pub/kde/にあります。

### コンパイルとインストール

Kfindは、KDEリリースの一部として統合されているのが普通であり、KDEの通常のインストール時にその他のKDEアプリケーションと一緒に自動的にインストールされます。

ユーザのシステム上でKFindをコンパイルしインストールするには、KFindディストリビューションのベース・ディレクトリから次のように入力します。

    % ./configure
    % make
    % make install

KFindは`autoconf`を使用しているため、コンパイルには何も問題はないはずです。問題が起きた場合は、KDEメーリング・リストまでご連絡ください。

### 設定

設定は通常、設定 ダイアログを使って行われます。詳細については、このマニュアルのユーザ・セクションを参照してください。興味のある方のため、kfind設定の技術的な説明を記載しておきます。

Kfindは、コンフィギュレーション・ファイル(通常は `~/.kfindrc`)から設定パラメータを読み取ります。

このファイルには、検索結果の保存、使用可能なアーカイバ、およびその他の設定パラメータについての情報が入っています。これらのパラメータは、設定ダイアログから編集できます。

全般情報 : リソース・ファイルはセクションから構成されます。各セクションは、角かっこで囲まれたヘッダー・タイトル（たとえば`[Saving]`）で始まります。

ヘッダーに続く情報は`Kfind`操作の特定のアスペクトに関連するものです。

保存の設定 : コンフィギュレーション・ファイルには、検索結果の保存に使用されるファイルのファイル名とフォーマットが入ります。このパラメータは、次のように保存されます。

    [Saving]
    Format=HTML
    Filename=/root/result.html

`Format`エントリの値は、`HTML` または`Plain Text`です。

Archiver configuration（アーカイバの設定）: `kfind` で使用可能なアーカイバは、次のように.kfindrcファイル内の`[Archiver Types]`エントリに指定されます。

    [Archiver Types]
    Archivers=tar;zip;zoo;

各アーカイバについては、個々のエントリで詳しく記述されます。

    [tar]
    ExecOnCreate=tar cf %a -C %d %n
    ExecOnUpdate=tar uf %a -C %d %n
    Comment=Tar

最初の行には、新規アーカイブの作成時に実行されるコマンドが入っています。2番目の行は、既存アーカイブの更新用です。3番目の行は、設定ダイアログに表示されるアーカイバの説明に使用されるコメントです。これらのコマンドには変数が使用できるため、変数の前には%記号が付けてあります。

正しいコマンドライン変数は、次のとおりです。

`&percnt;a` アーカイブの完全名

`&percnt;f` 通常のファイル名

`&percnt;d` 親ディレクトリ。与えられた引数がディレクトリではなくファイルである場合、これはそのファイルが入っているディレクトリになります。

`&percnt;n` ファイルの名前。与えられた引数がディレクトリである場合、これはそのディレクトリの名前になります。

## 画面上での基本操作

ここでは、Kfindのユーザ・インタフェースについて簡単に説明します。

Kfindのウィンドウは、4つの領域に分かれています。ツールバー、検索パラメータ・ダイアログ、表示領域、およびステータスバーです。表示領域とステータスバーが表示されるのは、検索結果を受け取った後だけです。

### ツールバー

検索開始

  パラメータ ダイアログで指定されたパラメータを使って、新規に検索を開始します。

新しく検索

  結果を消去し、表示領域を隠します。

検索を停止

  検索処理の実行を停止します。

開く

  選択されたファイルに対してデフォルトの関連付けを開始するよう、Kfmに指示を出します

アーカイブに追加

  選択されたファイルを指定されたアーカイブに追加します。

削除

  選択されたファイルを削除し、ディレクトリをリフレッシュするよう、Kfmに指示を出します。

設定

  選択されたファイルのプロパティを表示します。

内包するフォルダを開く

  選択されたファイルが入ったフォルダを開くよう、Kfmに指示を出します。

検索結果を保存

  オプション->設定 ダイアログで指定されたファイルに結果を保存します。

ヘルプ

  KFindのドキュメンテーションを表示します。

終了

  KFindを終了します。

### 検索パラメータ ダイアログ

このダイアログは、`KFind`の主要部分です。検索ユーティリティに対してパラメータを指定するために使用します。3つの検索パラメータ・グループがあります。

名前と場所

  このダイアログは、検索対象のファイル名を指定するときに使用します。ファイル名は、コンボボックスに入力され、次のようなワイルドカードが使用されます。

  - ? 任意の1文字に相当します。

  - * 任意の一連の文字列に相当します。

  - &lsqb; ] 文字の定義セットに相当します。たとえば、&lsqb;a-zA-Z0-9] はASCII文字の大文字／小文字、数字、およびドットに相当します。

  - \ sign is alphanumerical or a point

  コンボ ボックスには、名前の履歴が保存されています。参照ボタンを使って、検索対象のディレクトリを指定できます。サブディレクトリを検索させるかどうかは、サブフォルダも探すチェック・ボタンで指定します。
変更された日付

  このダイアログを使用すれば、特定の期間に作成されたファイルを検索できます。

詳細

  このページを使用すれば、特定の種類のファイルを検索できます。たとえば、Postscript文書、JPEG イメージ・ファイル、またはWAV サウンド・ファイルなどを検索できます。

### 表示領域

表示領域には、検索処理の結果が入ります。ファイルが選択された後、開く、アーカイブに追加、削除、設定、および 内包するフォルダを開く の各機能が有効になります。ダブルクリックすると、デフォルトの関連付けが実行されます。

## メニューの項目

### ファイル

ファイル メニューからは、次の機能が実行できるようになっています。

開く

  このオプションは、kfm を呼び出し、デフォルトの関連付け（たとえば、プログラム・ファイルは実行される、テキスト・ファイルはテキスト・エディタで開かれるなど）に基づいて、現在選択されているファイルを開くように指示します。リストのファイル名をダブルクリックすることでも同じ操作ができます。

アーカイブに追加

  選択されたファイルをアーカイブに追加します。

削除

  選択されたファイルを削除します。

プロパティ

  選択されたファイルのプロパティが変更できるようにします。

内包するフォルダを開く

  ファイル・マネージャ(KFM)ウィンドウで、指定されたファイルが入っているディレクトリを開きます。

検索条件を保存

  選択されたファイルの一覧表を保存します。

終了

  `Kfind`を終了します。

### 編集

このメニューの項目は無効になっています。

### オプション

このメニューからは、設定 ダイアログを開始できます。ユーザはこのダイアログの最初のタブを使用して、検索結果を保存するファイルとファイル・フォーマットを決定できます。 2番目のタブで、使用可能なファイルの種類およびアーカイバの詳細を見ることができます。

保存

  ユーザはこのダイアログを使用して、検索結果の保存先ファイルを指定できます。デフォルトはユーザのホームディレクトリの `.kfind-results.html` です。 他の名前が選ばれると、検索結果のフォーマットを指定できます。現在サポートされているのは、HTMLフォーマットとテキスト(.txt)フォーマットです。

アーカイバ

  このダイアログを使用すれば、アーカイブに追加 機能が使用するアーカイバ定義を表示（将来的には編集も）できます。

### ヘルプ

>KFind およびKFindのドキュメンテーションについての情報を表示できます。

## エピローグ

### 開発者

Miroslav Flídr

  E-Mail: flidr@kky.zcu.cz

Mario Weilguni;

  E-Mail: mweilguni@kde.org

### 著者

Miroslav Flídr

  E-Mail: flidr@kky.zcu.cz

Martin Hartig

  E-Mail: hartig@mathematik.uni-kl.de

Mark Roberts

  E-Mail: mar2@scigen.co.uk

Eric Bischoff

  - 編集者 E-mail: ebisch@cybercable.tm.fr