1.2.1 - en to ja translation catalogue (35 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: If you want to use this function for normal Web application, :doc:`snippet_html` may be suitable. It's a HTML specific version of this function.
ja: 普通のWebアプリケーションにこの関数を使いたい場合、 :doc:`snippet_html` の方が適切かもしれません。 ``snippet_html`` はこの関数のHTML特化バージョンです。

en: Syntax
ja: 構文

en: ``snippet`` requires at least one parameter that is the snippet target text::
ja: ``snippet`` は少なくとも1つの引数が必須です。その引数はスニペット対象のテキストです。 ::

en: You can specify one ore more tuples of keyword, open tag and close tag::
ja: キーワード・開始タグ・終了タグのセットを1つ以上指定できます。 ::

en: If you specify default open tag and default close tag, you can specify only keywords::
ja: デフォルトの開始タグと終了タグを指定した場合は、キーワードだけを指定できます。 ::

en: If you specify default open tag and default close tag and omit keywords, keywords are extracted from the current condition automatically like :doc:`snippet_html`::
ja: デフォルトの開始タグ・終了タグを指定し、キーワードを省略した場合は、 :doc:`snippet_html` のように現在の条件から自動でキーワードを抽出します。 ::

en: You can specify options as the last argument with all syntaxes::
ja: どの構文でも最後の引数にオプションを指定できます。 ::

en: Usage
ja: 使い方

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

en: ``snippet`` extracts keywords from conditions specified in ``--query`` and/or ``--filter`` automatically when you specify ``default_open_tag`` option and ``default_close_tag`` and don't specify keywords. It's similar to :doc:`snippet_html`.
ja: ``default_open_tag`` オプションと ``default_close_tag`` オプションを指定してキーワードを指定しなかった場合、 ``snippet`` は ``--query`` と ``--filter`` で指定した条件から自動的にキーワードを抽出します。これは :doc:`snippet_html` と同じ挙動です。

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. This ``snippet`` extracts two text parts that include the keywords ``fast`` or ``performance`` and surrounds the keywords with ``[`` and ``]``.
ja: ``--query "fast performance"`` は最初のレコードの内容にだけマッチします。この ``snippet`` は、テキスト中からキーワード ``fast`` と ``performance`` の少なくともどちらか一方を含んでいるテキストのスニペットを抽出します。今回は2箇所抽出しています。そして、抽出したテキストのスニペット内にあるキーワードを ``[`` と ``]`` で囲みます。

en: The max number of text parts is 3 by default. You can change it by ``max_n_results`` option:
ja: テキスト部分の最大数はデフォルトで3です。これは ``max_n_results`` オプションでカスタマイズできます。

en: It returns only one snippet because ``"max_n_results": 1`` is specified.
ja: ``"max_n_results": 1`` を指定したのでスニペットを1つだけ返しています。

en: The max size of a text part is 200byte by default. The unit is bytes not characters. The size doesn't include inserted ``[`` and ``[``. You can change it by ``width`` option:
ja: テキストの断片の最大サイズは200バイトです。単位は文字数ではなくバイトです。挿入される ``[`` と ``]`` のバイト数はこのサイズの中には含まれません。この値は ``width`` オプションで変更できます。

en: You can detect snippet delimiter with regular expression by ``delimiter_regexp`` option. You can use ``\.\s*`` to use only text in the target sentence. Note that you need to escape ``\`` in string:
ja: ``delimiter_regexp`` オプションを使うと正規表現でスニペットの区切りを検出できます。英語の文の場合、対象の文の中のテキストだけを使いたい場合は ``\.\s*`` を指定します。文字列の中では ``\`` をエスケープしないといけないことに注意してください。

en: You can see the detected delimiters (``.`` and following white spaces) aren't included in the result snippets. This is intentional behavior.
ja: 検出された区切り文字（ ``.`` と後続の空白）が結果のスニペットに含まれていないことに気づいたでしょうか。これは意図した挙動です。

en: You can specify keywords explicitly instead of extracting keywords from the current condition:
ja: 現在の条件からキーワードを抽出するのではなく、キーワードを明示的に指定することもできます。

en: This ``snippet`` returns two snippets for the first record and ``null`` for the second record. Because the second record doesn't have any specified keywords.
ja: この ``snippet`` は最初のレコードでは2つのスニペットを返し、2番目のレコードでは ``null`` を返しています。なぜなら2番目のレコードには指定したキーワードが含まれていないからです。

en: You can specify open tag and close tag for each keyword:
ja: キーワードごとに開始タグと終了タグを指定することができます。

en: This ``snippet`` surrounds ``fast`` with ``[`` and ``]]`` and ``performance`` with ``(`` and ``)``.
ja: この ``snippet`` は ``fast`` を ``[`` と ``]]`` で囲み、 ``performance`` を ``(`` と ``)`` で囲みます。

en: Parameters
ja: 引数

en: Required parameters
ja: 必須引数

en: Optional parameters
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: You can change this by :ref:`snippet-width` option.
ja: これは :ref:`snippet-width` オプションで変更できます。

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

en: You can change this by :ref:`snippet-max-n-results` option.
ja: この値は :ref:`snippet-max-n-results` オプションで変更できます。

en: See also
ja: 参考
