1.2.1 - en to ja translation catalogue (34 entries)

en: Summary
ja: 概要

en: ``QueryExpanderTSV`` is a query expander plugin that reads synonyms from TSV (Tab Separated Values) file. This plugin provides poor feature than the embedded query expansion feature. For example, it doesn't support word normalization. But it may be easy to use because you can manage your synonyms by TSV file. You can edit your synonyms by spreadsheet application such as Excel. With the embedded query expansion feature, you manage your synonyms by Groonga's table.
ja: ``QueryExpanderTSV`` はクエリー展開プラグインです。同義語はTSV（データをタブで区切るファイルフォーマット）ファイルから読み込みます。このプラグインは組み込みのクエリー展開機能よりも機能が少ないです。例えば、単語の正規化をサポートしていません。しかし、TSVファイルで同義語を管理できるためこちらの方が使いやすいかもしれません。TSVファイルなのでExcelなどの表計算ソフトで同義語を編集できます。組み込みのクエリー展開機能では、Groongaのテーブルとして同義語を管理します。

en: Install
ja: インストール

en: You need to register ``query_expanders/tsv`` as a plugin before you use ``QueryExpanderTSV``::
ja: ``QueryExpanderTSV`` を使う前に ``query_expanders/tsv`` をプラグインとして登録します::

en: Usage
ja: 使い方

en: You just add ``--query_expander QueryExpanderTSV`` parameter to ``select`` command::
ja: ``select`` コマンドに ``--query_expander QueryExpanderTSV`` パラメーターを追加します::

en: If ``QUERY`` has registered synonyms, they are expanded. For example, there are the following synonyms.
ja: ``QUERY`` 内に登録済みの同義語がある場合はそれらが展開されます。例えば、以下の同義語があるとします。

en: synonym 1
ja: 同義語1

en: synonym 2
ja: 同義語2

en: word
ja: 単語

en: The table means that ``synonym 1`` and ``synonym 2`` are synonyms of ``word``. For example, ``groonga`` and ``Senna`` are synonyms of ``groonga``. And ``mroonga`` and ``groonga MySQL`` are synonyms of ``mroonga``.
ja: この表は、 ``単語`` の同義語は ``同義語1`` と ``同義語2`` という意味です。例えば、 ``groonga`` の同義語は ``groonga`` と ``Senna`` です。また、 ``mroonga`` の同義語は ``mroonga`` と ``groonga MySQL`` です。

en: Here is an example of query expnasion that uses ``groonga`` as query::
ja: クエリーが ``groonga`` のときのクエリー展開の例です::

en: The above command equals to the following command::
ja: 上記のコマンドは以下のコマンドと同じ意味です::

en: Here is another example of query expnasion that uses ``mroonga search`` as query::
ja: クエリーが ``mroonga search`` のときのクエリー展開の例です::

en: It is important that registered words (``groonga`` and ``mroonga``) are only expanded to synonyms and not registered words (``search``) are not expanded. Query expansion isn't occurred recursively. ``groonga`` is appeared in ``(mroonga OR (groonga MySQL))`` as query expansion result but it isn't expanded.
ja: 登録されている単語だけ（ここでは ``groonga`` と ``mroonga`` ）クエリー展開されて、登録されていない単語（ここでは ``search`` ）はクエリー展開されていないことが大事なポイントです。また、再帰的にクエリー展開しません。クエリー展開した結果の ``(mroonga OR (groonga MySQL))`` の中に ``groonga`` がありますが、これは展開されません。

en: Normally, you need to include ``word`` itself into synonyms. For example, ``groonga`` and ``mroonga`` are included in synonyms of themselves. If you want to ignore ``word`` itself, you don't include ``word`` itself into synonyms. For example, if you want to use query expansion as spelling correction, you should use the following synonyms.
ja: 通常、同義語の中に ``単語`` 自身も含める必要があります。例えば、 ``groonga`` と ``mroonga`` が同義語の中に含まれています。もし、 ``単語`` 自身を無視したい場合は同義語の中に ``単語`` を含めないでください。例えば、クエリー展開機能をスペル訂正機能として使う場合は、以下のような同義語を使ってください。

en: synonym
ja: 同義語

en: ``gronga`` in ``word`` has a typo. A ``o`` is missing. ``groonga`` in ``synonym`` is the correct word.
ja: ``単語`` の ``gronga`` には誤字があります。 ``o`` がひとつ足りません。 ``同義語`` の ``groonga`` が正しい単語です。

en: Here is an example of using query expnasion as spelling correction::
ja: スペル訂正機能としてクエリー展開機能を使う例です::

en: The former command has a typo in ``--query`` value but the latter command doesn't have any typos.
ja: 前者のコマンドは ``--query`` の値に誤字がありますが、後者のコマンドは誤字がありません。

en: TSV File
ja: TSVファイル

en: Synonyms are defined in TSV format file. This section describes about it.
ja: 同義語はTSVフォーマットのファイルで定義します。このセクションでは定義方法について説明します。

en: Location
ja: 場所

en: The file name should be ``synonyms.tsv`` and it is located at configuration directory. For example, ``/etc/groonga/synonyms.tsv`` is a TSV file location. The location is decided at build time.
ja: TSVファイルのファイル名は ``synonyms.tsv`` で、設定ディレクトリに置かなければいけません。例えば、 ``/etc/groonga/synonyms.tsv`` がTSVファイルの場所になります。場所はビルド時に決まります。

en: You can change the location by environment variable ``GRN_QUERY_EXPANDER_TSV_SYNONYMS_FILE`` at run time::
ja: 環境変数 ``GRN_QUERY_EXPANDER_TSV_SYNONYMS_FILE`` を指定することで実行時に場所を変更することもできます::

en: With the above command, ``/tmp/synonyms.tsv`` file is used.
ja: 上述のコマンドでは ``/tmp/synonyms.tsv`` ファイルが使われます。

en: Format
ja: フォーマット

en: You can define zero or more synonyms in a TSV file. You define a ``word`` and ``synonyms`` pair by a line. ``word`` is expanded to ``synonyms`` in ``--query`` value. ``Synonyms`` are combined by ``OR``. For example, ``groonga`` and ``Senna`` synonyms are expanded as ``groonga OR Senna``.
ja: TSVファイル内に0個以上の同義語を定義することができます。1行につき ``単語`` と ``同義語リスト`` のペアを定義します。 ``--query`` の値の中にでてきた ``単語`` は ``同義語リスト`` に展開されます。 ``同義語リスト`` は ``OR`` でまとめます。例えば、同義語リスト ``groonga`` と ``Senna`` は ``groonga OR Senna`` と展開されます。

en: The first column is ``word`` and the rest columns are ``synonyms`` of the ``word``. Here is a sample line for ``word`` is ``groonga`` and ``synonyms`` are ``groonga`` and ``Senna``. ``(TAB)`` means a tab character (``U+0009``)::
ja: 最初のカラムが ``単語`` で、残りのカラムが ``単語`` の ``同義語リスト`` になります。以下は、 ``単語`` が ``groonga`` で、 ``同義語リスト`` が ``groonga`` と ``synonyms`` の例です。 ``(TAB)`` はタブ文字（ ``U+0009`` ）という意味です::

en: Comment line is supported. Lines that start with ``#`` are ignored. Here is an example for comment line. ``groonga`` line is ignored as comment line::
ja: コメント行をサポートしています。 ``#`` から始まる行は無視します。以下はコメント行の例です。 ``groonga`` とある行はコメント行として無視されます::

en: Limitation
ja: 制限

en: You need to restart groonga to reload your synonyms. TSV file is loaded only at the plugin load time.
ja: 同義語を再読み込みするにはgroongaを再起動する必要があります。TSVファイルはプラグイン読み込み時に一度だけ読み込みます。

en: See also
ja: 参考

en: :ref:`select-query-expansion`
ja: 詳細については :ref:`select-query-expander` を参照してください。
