1.2.1 - en to ja translation catalogue (26 entries)

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

en: Summary
ja: 概要

en: ``highlight_html`` tags target text. It can use to highlight the search keywords. The tagged text are prepared for embedding HTML. Special characters such as ``<`` and ``>`` are escapsed as ``&lt;`` and ``&gt;``. Keyword is surrounded with ``<span class="keyword">`` and ``</span>``. For example, a tagged text of ``I am a groonga user. <3`` for keyword ``groonga`` is ``I am a <span class="keyword">groonga</span> user. &lt;3``.
ja: ``highlight_html`` は対象テキストをタグ付けします。検索文字列をハイライトさせるために利用することができます。タグ付けされたテキストはHTML中に埋め込みやすいように処理されています。``<`` や ``>`` などの特殊文字は &lt; や &gt; にエスケープされています。キーワードは ``<span class="keyword">`` と ``</span>`` で囲まれています。たとえば、 ``I am a groonga user. <3`` という対象テキストのキーワード ``groonga`` でタグ付けされたテキストは ``I am a <span class="keyword">groonga</span> user. &lt;3`` となります。

en: Syntax
ja: 構文

en: This function has from one to two parameters::
ja: この関数の引数は1つから2つの引数を受け取ります。::

en: Usage
ja: 使い方

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

en: ``highlight_html`` 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_html`` は :doc:`/reference/commands/select` コマンドの ``--output_columns`` 内でのみ指定できますが、10.0.6以降は、 :doc:`/reference/commands/logical_select` コマンドの ``--output_columns`` 内でも使用できます。

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

en: You also need to specify ``--query`` and/or ``--filter``. Keywords are extracted from ``--query`` and ``--filter`` arguments.
ja: また、 ``--query`` と ``--filter`` オプションも指定する必要があります。（どちらか一方でも構いません。）これは、 ``--query`` と ``--filter`` オプションからキーワードを抽出しているためです。

en: The following example uses ``--query "groonga mysql"``. In this case, ``groonga`` and ``mysql`` are used as keywords.
ja: 以下の例は ``--query "groonga mysql"`` を使っています。この場合は、キーワードとして ``groonga`` と ``mysql`` を使います。

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 only the first record's body. ``highlight_html(body)`` surrounds the keywords ``groonga`` or ``mysql`` contained in the text with ``<span class="keyword">`` and ``</span>``.
ja: ``--query "groonga mysql"`` は最初のレコードにマッチします。``highlight_html(body)`` は、テキスト中に含まれるキーワード ``groonga`` と ``mysql`` を ``<span class="keyword">`` と ``</span>`` で囲みます。

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

en: You can use different style(e.g. background color) for each keywords by ``sequential_class_tag_mode``.
ja: ``sequential_class_tag_mode`` を使うことで、それぞれのキーワードで異なるスタイル(例えば、背景色)を使えます。

en: Parameters
ja: 引数

en: This section describes all parameters.
ja: このセクションではすべての引数について説明します。

en: Required parameters
ja: 必須引数

en: There is only one required parameter.
ja: 必須の引数は1つです。

en: The text to be highlighted in HTML.
ja: HTMLでハイライトする対象のテキストです。

en: Optional parameters
ja: 省略可能引数

en: The default value of ``sequential_class_tag_mode`` is ``false``. If ``sequential_class_tag_mode`` is ``true``, you can use different style(e.g. background color) for each keywords.
ja: ``sequential_class_tag_mode`` のデフォルト値は ``false`` です。``sequential_class_tag_mode`` が ``true`` の場合、それぞれのキーワードで異なるスタイル(例えば、背景色)を使えます。

en: If ``sequential_class_tag_mode`` is ``true``, class tags are ``<mark class="keyword-%d">/<mark>`` for now.
ja: ``sequential_class_tag_mode`` が ``true`` の場合、classタグは今の所 ``<mark class="keyword-%d">/<mark>`` となります。

en: Return value
ja: 戻り値

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

en: See also
ja: 参考
