1.2.1 - en to ja translation catalogue (25 entries)

en: Execution example::
ja: 実行例::

en: Summary
ja: 概要

en: ``highlight_full`` tags target text. It can use to highlight the search keyword. It can specify use/not use HTML escape, the normalizer name and change the tag for each keyword.
ja: ``highlight_full`` は対象テキストをタグ付けします。検索文字列をハイライトさせるために利用することができます。HTMLエスケープの有無、ノーマライザー名を指定することができ、キーワードごとにタグを変更することができます。

en: Syntax
ja: 構文

en: ``highlight_full`` has required parameter and optional parameter::
ja: ``highlight_full`` には必須引数と省略可能引数とがあります::

en: Usage
ja: 使い方

en: Here are a schema definition and sample data to show usage.
ja: 使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。

en: ``highlight_full`` can be used in only ``--output_columns`` in :doc:`/reference/commands/select` before version 10.0.6 (exclusive). However, it can be also used in ``--output_columns`` in :doc:`/reference/commands/logical_select` since version 10.0.6.
ja: 10.0.6より前のバージョンでは、``highlight_full`` は :doc:`/reference/commands/select` コマンドの ``--output_columns`` 内でのみ指定できますが、 10.0.6以降は :doc:`/reference/commands/logical_select` コマンドの ``--output_columns`` 内でも使用できます。

en: ``highlight_full`` requires :doc:`/reference/command/command_version` 2 or later.
ja: ``highlight_full`` を使うには :doc:`/reference/command/command_version` 2以降を使う必要があります。

en: The following example uses HTML escape and normalzier is ``NormalizeAuto``. It specifies the tags ``<span class="keyword1">`` and ``</span>`` of the keyword ``groonga``, and the tags ``<span class="keyword2">`` and ``</span>`` of the keyword ``mysql``.
ja: 以下の例はHTMLエスケープを使用し、ノーマライザーに ``NormalizerAuto`` を指定しています。この例では キーワード ``groonga`` に ``<span class="keyword1">``  と ``</span>`` のタグを指定し、キーワード ``mysql`` に ``<span class="keyword2">`` と ``</span>`` のタグを指定しています。

en: The text are scanned by the keywords for tagging after they are normalized by ``NormalizerAuto`` normalizer.
ja: キーワードとテキストは ``NormalizerAuto`` ノーマライザーで正規化されてタグ付けのためにスキャンされます。

en: ``--query "groonga mysql"`` matches to the first record's body. ``highight_full`` surrounds the keywords ``groonga`` contained in the text with ``<span class="keyword1">`` and ``</span>``, and the keywords ``mysql`` contained in the text with with ``<span class="keyword2">`` and ``</span>``.
ja: ``--query "groonga mysql"`` は最初のレコードにマッチします。 ``highlight_full`` は、テキスト中に含まれるキーワード ``groonga`` を ``<span class="keyword1">`` と ``</span>`` で囲み、 キーワード ``mysql`` を ``<span class="keyword2">`` と ``</span>`` で囲みます。

en: Special characters such as ``<`` and ``>`` are escapsed as ``&lt;`` and ``&gt;``.
ja: ``<`` や ``>`` などの特殊文字は &lt; や &gt; にエスケープされています。

en: You can specify string literal instead of column.
ja: カラムの代わりに文字列リテラルを指定することもできます。

en: Parameters
ja: 引数

en: There are three required parameters, ``column``, ``normalizer_name`` and ``use_html_escape``. There are three or over optional parameters, ``keywordN``, ``open_tagN`` and ``end_tagN``.
ja: 必須引数は3つあります。 ``column`` と ``normalizer_name`` と ``use_html_escape`` です。省略可能引数は3つ以上あります。 ``keywordN`` と ``open_tagN`` と ``end_tagN`` です。

en: Specifies a column of the table.
ja: テーブルのカラムを指定します。

en: Specifies a normalizer name.
ja: ノーマライザー名を指定します。

en: Specifies use or not use HTML escape. If it is ``true`` , use HTML escape. If it is ``false`` , not use HTML escape.
ja: HTMLエスケープの有無を指定します。 ``true`` を指定すればHTMLエスケープされます。 ``false`` を指定すればHTMLエスケープされません。

en: Specifies a keyword for tagging. You can specify multiple keywords for each three arguments.
ja: タグ付けするキーワードを指定します。3つの引数ごとに複数のキーワードを指定することができます。

en: Specifies a open tag. You can specify multiple open tags for each three arguments.
ja: 開始タグを指定します。3つの引数ごとに複数の開始タグを指定することができます。

en: Specifies a close tag. You can specify multiple close tags for each three arguments.
ja: 終了タグを指定します。3つの引数ごとに複数の終了タグを指定することができます。

en: Return value
ja: 戻り値

en: ``highlight_full`` returns a tagged string or ``null``. If ``highlight_full`` can't find any keywords, it returns ``null``.
ja: ``highlight_full`` はタグ付の文字列もしくは null を返します。``highlight_full`` は該当するキーワードがない場合に null を返します。

en: See also
ja: 参考
