PyMuPDF 1.23.0rc1 - en to ja translation catalogue (83 entries)

en: PyMuPDF is a high-performance Python library for data extraction, analysis, conversion & manipulation of PDF (and other) documents.
ja: PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。

en: PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, PDF Splitting, PDF Creation, Pyodide, PyScript
ja: PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript

en: Module *fitz*
ja: モジュール *fitz*

en: New in version 1.16.8
ja: バージョン 1.16.8 で新たに追加されました

en: PyMuPDF can also be used in the command line as a **module** to perform utility functions. This feature should obsolete writing some of the most basic scripts.
ja: PyMuPDFは、ユーティリティ機能を実行するために**モジュール** としてコマンドラインで使用することもできます。この機能により、最も基本的なスクリプトの記述が廃止される可能性があります。

en: Admittedly, there is some functional overlap with the MuPDF CLI `mutool`. On the other hand, PDF embedded files are no longer supported by MuPDF, so PyMuPDF is offering something unique here.
ja: 確かに、MuPDF CLI  `mutool`  といくつかの機能的な重複があります。一方で、PDFの埋め込みファイルはもはやMuPDFではサポートされていないため、PyMuPDFはここで独自の機能を提供しています。

en: Invocation
ja: 呼び出し

en: Invoke the module like this::
ja: 次のようにしてモジュールを呼び出します::

en: General remarks:
ja: 一般的な注意事項：

en: Request help via `"-h"`, resp. command-specific help via `"command -h"`.
ja: ヘルプを要求するには、`"-h"` 、またはコマンド固有のヘルプを要求するには `"command -h"` を使用します。

en: Parameters may be abbreviated where this does not introduce ambiguities.
ja: 曖昧さが生じない場所では、パラメータは省略形で指定できます。

en: Several commands support parameters `-pages` and `-xrefs`. They are intended for down-selection. Please note that:
ja: いくつかのコマンドは、 `-pages` と  `-xrefs`  のパラメータをサポートしています。これらは選択範囲を絞るためのものです。以下に注意してください：

en: **page numbers** for this utility must be given **1-based**.
ja: このユーティリティでは、**ページ番号** は1から始まる必要があります。

en: valid :data:`xref` numbers start at 1.
ja: 有効な  :data:`xref`  番号は1から始まります。

en: Specify a comma-separated list of either *single* integers or integer *ranges*. A **range** is a pair of integers separated by one hyphen "-". Integers must not exceed the maximum page, resp. xref number. To specify that maximum, the symbolic variable "N" may be used. Integers or ranges may occur several times, in any sequence and may overlap. If in a range the first number is greater than the second one, the respective items will be processed in reversed order.
ja: シングル整数または整数の範囲のコンマ区切りのリストを指定します。範囲は、ハイフン " - " で区切られた整数のペアです。整数は、最大ページまたは xref 番号を超えてはいけません。最大値を指定するには、記号変数 "N" を使用できます。整数または範囲は複数回、任意の順序で重複して出現する可能性があります。範囲内の最初の数値が2番目の数値よりも大きい場合、それらのアイテムは逆順で処理されます。

en: How to use the module inside your script::
ja: スクリプト内でモジュールを使用する方法::

en: Use the following 2-liner and compile it with `Nuitka <https://pypi.org/project/Nuitka/>`_ in standalone mode. This will give you a CLI executable with all the module's features, that can be used on all compatible platforms without Python, PyMuPDF or MuPDF being installed.
ja: 以下の2行のコードを使用し、 `Nuitka <https://pypi.org/project/Nuitka/>`_ をスタンドアロンモードでコンパイルします。これにより、Python、PyMuPDF、またはMuPDFがインストールされていないすべての互換プラットフォームで使用できる、モジュールのすべての機能を備えたCLI実行可能ファイルが得られます。

en: Cleaning and Copying
ja: クリーニングとコピー

en: This command will optimize the PDF and store the result in a new file. You can use it also for encryption, decryption and creating sub documents. It is mostly similar to the MuPDF command line utility *"mutool clean"*::
ja: このコマンドは、PDFを最適化し、その結果を新しいファイルに保存します。また、暗号化、復号化、およびサブドキュメントの作成にも使用できます。これは、ほとんど MuPDF のコマンドラインユーティリティ "mutool clean" と似ています::

en: If you specify "-pages", be aware that only page-related objects are copied, **no document-level items** like e.g. embedded files.
ja: 「-pages」を指定する場合、ページ関連のオブジェクトのみがコピーされることに注意してください。埋め込みファイルのようなドキュメントレベルのアイテムはコピーされません。

en: Please consult :meth:`Document.save` for the parameter meanings.
ja: パラメータの意味については、 :meth:`Document.save` をご参照ください。

en: Extracting Fonts and Images
ja: フォントと画像の抽出

en: Extract fonts or images from selected PDF pages to a desired directory::
ja: 選択したPDFページからフォントや画像を指定したディレクトリに抽出します::

en: **Image filenames** are built according to the naming scheme: **"img-xref.ext"**, where "ext" is the extension associated with the image and "xref" the :data:`xref` of the image PDF object.
ja: **画像のファイル名** は、命名規則に従って構築されます： **"img-xref.ext"** で、"ext" は画像に関連する拡張子であり、"xref" は画像PDFオブジェクトの :data:`xref` です。

en: **Font filenames** consist of the fontname and the associated extension. Any spaces in the fontname are replaced with hyphens "-".
ja: **フォントのファイル名** は、フォント名と関連する拡張子から構成されます。フォント名にスペースがある場合、ハイフン "-" で置き換えられます。

en: The output directory must already exist.
ja: 出力ディレクトリはすでに存在している必要があります。

en: Except for output directory creation, this feature is **functionally equivalent** to and obsoletes `this script <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/extract-images/extract-from-pages.py>`_.
ja: 出力ディレクトリの作成を除いて、この機能は `このスクリプト <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/extract-images/extract-from-pages.py>`_ と機能的に同等であり、これを使うことで廃止できます。

en: Joining PDF Documents
ja: PDF文書の結合

en: To join several PDF files specify::
ja: 複数のPDFファイルを結合するには、次のように指定します::

en: Each input must be entered as **"filename,password,pages"**. Password and pages are optional.
ja: 各入力は「ファイル名、パスワード、ページ」の形式で入力してください。パスワードとページはオプションです。

en: The password entry **is required** if the "pages" entry is used. If the PDF needs no password, specify two commas.
ja: パスワードエントリは「ページ」エントリが使用される場合に必要です。PDFにパスワードが必要ない場合は、2つのコンマを指定してください。

en: The **"pages"** format is the same as explained at the top of this section.
ja: 「ページ」のフォーマットは、このセクションの先頭で説明したものと同じです。

en: Each input file is immediately closed after use. Therefore you can use one of them as output filename, and thus overwrite it.
ja: 各入力ファイルは使用後すぐに閉じられます。したがって、出力ファイル名の1つとして使用し、上書きすることができます。

en: Example: To join the following files
ja: 例: 以下のファイルを結合する

en: **file1.pdf:** all pages, back to front, no password
ja: **file1.pdf:** すべてのページ、最前面から最後尾、パスワードなし

en: **file2.pdf:** last page, first page, password: "secret"
ja: **file2.pdf:** 最後のページ、最前面、パスワード: "secret"

en: **file3.pdf:** pages 5 to last, no password
ja: **file3.pdf:** 5ページから最後尾、パスワードなし

en: and store the result as **output.pdf** enter this command:
ja: そして結果を  **output.pdf**  として保存するには、次のコマンドを入力してください:

en: Low Level Information
ja: 低レベル情報

en: Display PDF internal information. Again, there are similarities to *"mutool show"*::
ja: PDFの内部情報を表示します。再度、 *「mutool show」* との類似点があります。

en: Examples::
ja: 例::

en: Embedded Files Commands
ja: 埋め込みファイルコマンド

en: The following commands deal with embedded files -- which is a feature completely removed from MuPDF after v1.14, and hence from all its command line tools.
ja: 以下のコマンドは埋め込みファイルに関するもので、MuPDF v1.14以降から完全に削除され、そのためすべてのコマンドラインツールからも削除されています。

en: Information
ja: 情報

en: Show the embedded file names (long or short format)::
ja: 埋め込みファイルの名前を表示します（長いフォーマットまたは短いフォーマット）::

en: Example::
ja: 例::

en: Detailed output would look like this per entry::
ja: 詳細な出力は、各エントリごとに以下のようになります::

en: Extraction
ja: 抽出

en: Extract an embedded file like this::
ja: 埋め込みファイルを以下のように抽出します::

en: For details consult :meth:`Document.embfile_get`. Example (refer to previous section)::
ja: 詳細については、Document.embfile_get() を参照してください。例（前のセクションを参照）::

en: Deletion
ja: 削除

en: Delete an embedded file like this::
ja: 以下のようにして埋め込みファイルを削除します::

en: For details consult :meth:`Document.embfile_del`.
ja: 詳細については、 :meth:`Document.embfile_del`  を参照してください。

en: Insertion
ja: 挿入

en: Add a new embedded file using this command::
ja: このコマンドを使用して新しい埋め込みファイルを追加します::

en: *"NAME"* **must not** already exist in the PDF. For details consult :meth:`Document.embfile_add`.
ja: *"NAME"* は既にPDF内に存在していてはいけません。詳細については、 :meth:`Document.embfile_add`  を参照してください。

en: Updates
ja: 更新

en: Update an existing embedded file using this command::
ja: このコマンドを使用して既存の埋め込みファイルを更新します::

en: Use this method to change meta-information of the file -- just omit the *"PATH"*. For details consult :meth:`Document.embfile_upd`.
ja: ファイルのメタ情報を変更するために、この方法を使用します - 単に「PATH」を省略してください。詳細については、 :meth:`Document.embfile_upd`  を参照してください。

en: Copying
ja: コピー

en: Copy embedded files between PDFs::
ja: PDF間で埋め込みファイルをコピーします::

en: Text Extraction
ja: テキスト抽出

en: New in v1.18.16
ja: v1.18.16で新登場

en: Extract text from arbitrary :ref:`supported documents<Supported_File_Types>` to a textfile. Currently, there are three output formatting modes available: simple, block sorting and reproduction of physical layout.
ja: 任意の :ref:`サポートされたドキュメント <Supported_File_Types>` からテキストをテキストファイルに抽出します。現在、3つの出力フォーマットモードが利用可能です：シンプル、ブロックソート、物理的なレイアウトの再現。

en: **Simple** text extraction reproduces all text as it appears in the document pages -- no effort is made to rearrange in any particular reading order.
ja: **シンプル** なテキスト抽出は、ドキュメントページに表示される通りのすべてのテキストを再現します - 特定の読み取り順序に再配置する努力は行われません。

en: **Block sorting** sorts text blocks (as identified by MuPDF) by ascending vertical, then horizontal coordinates. This should be sufficient to establish a "natural" reading order for basic pages of text.
ja: **ブロックソート** は、テキストブロック（MuPDFによって識別される）を垂直座標、水平座標の昇順に並べ替えます。これは、基本的なテキストページの「自然な」読み取り順序を確立するために十分です。

en: **Layout** strives to reproduce the original appearance of the input pages. You can expect results like this (produced by the command `python -m fitz gettext -pages 1 demo1.pdf`):
ja: **レイアウト** は、入力ページの元の外観を再現しようとします。次のような結果が期待できます（コマンド  `python -m fitz gettext -pages 1 demo1.pdf`  によって生成されたもの）：

en: The "gettext" command offers a functionality similar to the CLI tool `pdftotext` by XPDF software, http://www.foolabs.com/xpdf/ -- this is especially true for "layout" mode, which combines that tool's `-layout` and `-table` options.
ja: 「gettext」コマンドは、XPDFソフトウェアのCLIツール `pdftotext` と似た機能を提供します。http://www.foolabs.com/xpdf/ - これは特に「レイアウト」モードに当てはまり、このモードはそのツールの `-layout` と `-table` オプションを組み合わせています。

en: After each page of the output file, a formfeed character, `hex(12)` is written -- even if the input page has no text at all. This behavior can be controlled via options.
ja: 出力ファイルの各ページの後に、フォームフィード文字 `hex(12)` が書き込まれます - 入力ページにテキストがない場合でもです。この動作はオプションを介して制御できます。

en: For "layout" mode, **only horizontal, left-to-right, top-to bottom** text is supported, other text is ignored. In this mode, text is also ignored, if its :data:`fontsize` is too small.
ja: 「レイアウト」モードでは、水平方向、左から右、上から下のテキストのみがサポートされ、他のテキストは無視されます。また、このモードでは、:data:`fontsize` が小さすぎる場合もテキストが無視されます。

en: "Simple" and "blocks" mode in contrast output **all text** for any text size or orientation.
ja: 対照的に、「シンプル」モードと「ブロック」モードでは、テキストのサイズや向きに関係なくすべてのテキストが出力されます。

en: Command::
ja: コマンド::

en: Command options may be abbreviated as long as no ambiguities are introduced. So the following do the same:
ja: コマンドのオプションは、曖昧さが生じない限り、省略形を使用することができます。したがって、以下のように同じ結果を得ることができます：

en: The output filename defaults to the input with its extension replaced by `.txt`. As with other commands, you can select page ranges **(caution: 1-based!)** in `mutool` format, as indicated above.
ja: 出力ファイル名は、入力ファイル名の拡張子が  `.txt` に置換されたものがデフォルトです。他のコマンドと同様に、上記に示されているように、 `mutool` 形式でページ範囲（注意：1から始まる）を選択できます。

en: **mode:** (str) select a formatting mode -- default is "layout".
ja: **mode:** (str) フォーマットモードを選択します - デフォルトは「レイアウト」です。

en: **noligatures:** (bool) corresponds to **not** :data:`TEXT_PRESERVE_LIGATURES`. If specified, ligatures (present in advanced fonts: glyphs combining multiple characters like "fi") are split up into their components (i.e. "f", "i"). Default is passing them through.
ja: **noligatures:** (bool) :data:`TEXT_PRESERVE_LIGATURES` に相当します。指定された場合、リガチャ（複数の文字を結合するグリフ、例:「fi」のようなもの）はその構成要素（つまり「f」、「i」）に分割されます。デフォルトはそのまま通過させることです。

en: **convert-white:** corresponds to **not** :data:`TEXT_PRESERVE_WHITESPACE`. If specified, all white space characters (like tabs) are replaced with one or more spaces. Default is passing them through.
ja: **convert-white:**  :data:`TEXT_PRESERVE_WHITESPACE`  に相当します。指定された場合、すべての空白文字（タブなど）は1つ以上のスペースに置き換えられます。デフォルトはそのまま通過させることです。

en: **extra-spaces:**  (bool) corresponds to **not** :data:`TEXT_INHIBIT_SPACES`. If specified, large gaps between adjacent characters will be filled with one or more spaces. Default is off.
ja: **extra-spaces:**  (bool) :data:`TEXT_INHIBIT_SPACES`  に相当します。指定された場合、隣接する文字間の大きな間隔は1つ以上のスペースで埋められます。デフォルトはオフです。

en: **noformfeed:**  (bool) instead of `hex(12)` (formfeed), write linebreaks `\n` at end of output pages.
ja: **noformfeed:** (bool)  `hex(12)` （フォームフィード）の代わりに、出力ページの末尾に  ``\n`` 個の改行を書き込みます。

en: **skip-empty:**  (bool) skip pages with no text.
ja: **skip-empty:**  ((bool) テキストがないページをスキップします。

en: **grid:** lines with a vertical coordinate difference of no more than this value (in points) will be merged into the same output line. Only relevant for "layout" mode. **Use with care:** 3 or the default 2 should be adequate in most cases. If **too large**, lines that are *intended* to be different in the original may be merged and will result in garbled and / or incomplete output. If **too low**, artifact separate output lines may be generated for some spans in the input line, just because they are coded in a different font with slightly deviating properties.
ja: **grid:** 垂直座標の差がこの値（ポイント単位）を超えない行は、同じ出力行に結合されます。 「レイアウト」モードにのみ関連します。注意して使用してください: ほとんどの場合、3またはデフォルトの2が適切です。大きすぎると、元のフォントで異なる行が結合され、文字化けや不完全な出力が発生する可能性があります。低すぎると、入力行の一部の範囲で個別の出力行が生成されることがありますが、これはわずかに異なる特性を持つ別のフォントでコーディングされているためです。

en: **fontsize:** include text with :data:`fontsize` larger than this value only (default 3). Only relevant for "layout" option.
ja: **fontsize:** この値よりも大きな :data:`fontsize` を持つテキストのみを含めます（デフォルト3）。 「レイアウト」オプションにのみ関連します。

en: This documentation covers all versions up to |version|.
ja: このドキュメントは |version| までのすべてのバージョンを対象としています。
