1.2.1 - en to ja translation catalogue (26 entries)

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

en: Summary
ja: 概要

en: This function extracts snippets of target text around search keywords (``KWIC``. ``KeyWord In Context``).
ja: この関数は対象テキスト中から検索キーワード周辺のテキスト（ ``KWIC`` 。 ``KeyWord In Context`` ）を抽出します。抽出されたテキストのことをスニペットと呼びます。

en: The snippets 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 snippet of ``I am a groonga user. <3`` for keyword ``groonga`` is ``I am a <span class="keyword">groonga</span> user. &lt;3``.
ja: スニペットは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: This function is a HTML specific version of :doc:`snippet`. Generally, this function is enough for normal Web application use.
ja: この関数は :doc:`snippet` のHTML特化バージョンです。通常、普通のWebアプリケーションでの使用ではこの関数で十分です。

en: Syntax
ja: 構文

en: ``snippet_html`` has only one parameter::
ja: ``snippet_html`` の引数は1つだけです::

en: Usage
ja: 使い方

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

en: ``snippet_html`` can be used in only ``--output_columns`` in :doc:`/reference/commands/select`.
ja: ``snippet_html`` は :doc:`/reference/commands/select` コマンドの ``--output_columns`` 内でのみ指定できます。

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 "fast performance"``. In this case, ``fast`` and ``performance`` are used as keywords.
ja: 以下の例は ``--query "fast performance"`` を使っています。この場合は、キーワードとして ``fast`` と ``performance`` を使います。

en: ``--query "fast performance"`` matches to only the first record's content. ``snippet_html(content)`` extracts two text parts that include the keywords ``fast`` or ``performance`` and surrounds the keywords with ``<span class="keyword">`` and ``</span>``.
ja: ``--query "fast performance"`` は最初のレコードの内容にだけマッチします。 ``snippet_html(content)`` は、テキスト中からキーワード ``fast`` と ``performance`` の少なくともどちらか一方を含んでいるテキストのスニペットを抽出します。今回は2箇所抽出しています。そして、抽出したテキストのスニペット内にあるキーワードを ``<span class="keyword">`` と ``</span>`` で囲みます。

en: The max number of text parts is 3. If there are 4 or more text parts that include the keywords, only the leading 3 parts are only used.
ja: テキストのスニペット数は多くても3です。4つ以上のテキストのスニペットが抽出できるときは、最初の3つだけを使います。

en: The max size of a text part is 200byte. The unit is bytes not characters. The size doesn't include inserted ``<span class="keyword">`` and ``</span>``.
ja: テキストのスニペットの最大サイズは200バイトです。単位は文字数ではなくバイトです。挿入される ``<span class="keyword">`` と ``</span>`` のバイト数はこのサイズの中には含まれません。

en: Both the max number of text parts and the max size of a text part aren't customizable.
ja: テキストのスニペットの最大数とテキストのスニペットの最大サイズはカスタマイズできません。

en: If you want to customize them, you need to use :doc:`snippet` instead of this function.
ja: これらをカスタマイズしたい場合はこの関数ではなく :doc:`snippet` を使ってください。

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

en: Return value
ja: 戻り値

en: This function returns an array of string or ``null``. If This function can't find any snippets, it returns ``null``.
ja: この関数は文字列の配列もしくは ``null`` を返します。この関数はは該当するスニペットがない場合に ``null`` を返します。

en: An element of array is a snippet::
ja: 配列の要素がスニペットになります::

en: A snippet includes one or more keywords. The max byte size of a snippet except open tag and close tag is 200byte. The unit isn't the number of characters.
ja: スニペットには1つ以上のキーワードが含まれています。開始タグと終了タグを除いたスニペットの最大サイズは200byteです。単位は文字数ではなくてバイトです。

en: Open tag is ``<span class="keyword">`` and close tag is ``</span>``.
ja: 開始タグは ``<span class="keyword">`` で終了タグは ``</span>`` です。

en: The array size is larger than or equal to 1 and less than or equal to 3.
ja: 配列のサイズは1以上3以下です。

en: If you want to customize the max byte size of snippet and/or the max number of snippets, use :doc:`snippet` instead.
ja: スニペットの最大サイズまたは最大スニペット数を変更したい場合は :doc:`snippet` を使ってください。

en: See also
ja: 参考
