PyMuPDF 1.23.0rc1 - en to ja translation catalogue (41 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: Archive
ja: Archive (アーカイブ)

en: New in v1.21.0
ja: v1.21.0での新機能

en: This class represents a generalization of file folders and container files like ZIP and TAR archives. Archives allow accessing arbitrary collections of file folders, ZIP / TAR files and single binary data elements as if they all were part of one hierarchical tree of folders.
ja: このクラスは、ファイルフォルダーやZIPやTARアーカイブのようなコンテナファイルの一般化を表します。アーカイブは、ファイルフォルダー、ZIP/TARファイル、および単一のバイナリデータ要素の任意のコレクションにアクセスできるようにし、すべてが1つの階層的なフォルダーツリーの一部であるかのようにします。

en: In PyMuPDF, archives are currently only used by :ref:`Story` objects to specify where to look for fonts, images and other resources.
ja: PyMuPDFでは、アーカイブは現在、フォント、画像、およびその他のリソースを検索する場所を指定するために :ref:`Story` オブジェクトによってのみ使用されています。

en: **Method / Attribute**
ja: **メソッド / 属性**

en: **Short Description**
ja: **簡単な説明**

en: add new data to the archive
ja: アーカイブに新しいデータを追加する

en: check if given name is a member
ja: 名前で指定されたデータを読む

en: read the data given by the name
ja: 名前で指定されたデータを読む

en: list[dict] of archive items
ja: アーカイブアイテムのリスト[辞書]

en: **Class API**
ja: クラス API

en: Creates a new archive. Without parameters, an empty archive is created.
ja: 新しいアーカイブを作成します。パラメーターが指定されない場合、空のアーカイブが作成されます。

en: If provided, `content` may be one of the following:
ja: 提供される場合、`content` は次のいずれかであることができます：

en: another Archive: the archive is being made a sub-archive of the new one.
ja: 別の Archive: アーカイブは新しいアーカイブのサブアーカイブになります。

en: a string: this must be the name of a local folder or file. `pathlib.Path` objects are also supported.
ja: 文字列: これはローカルフォルダまたはファイルの名前である必要があります。`pathlib.Path` オブジェクトもサポートされています。

en: A **folder** will be converted to a sub-archive, so its files (and any sub-folders) can be accessed by their names.
ja: **フォルダ** はサブアーカイブに変換され、そのファイル（およびサブフォルダ）は名前でアクセスできます。

en: A **file** will be read with mode `"rb"` and these binary data (a `bytes` object) be treated as a single-member sub-archive. In this case, the `path` parameter is **mandatory** and should be the member name under which this item can be found / retrieved.
ja: **ファイル** はモード `"rb"` で読み取られ、これらのバイナリデータ（ `bytes` オブジェクト）は単一のメンバーサブアーカイブとして扱われます。この場合、`path` パラメーターは **必須** で、このアイテムが見つかる/取得できるメンバー名である必要があります。

en: a `zipfile.ZipFile` or `tarfile.TarFile` object: Will be added as a sub-archive.
ja: `zipfile.ZipFile` または `tarfile.TarFile` オブジェクト: サブアーカイブとして追加されます。

en: a Python binary object (`bytes`, `bytearray`, `io.BytesIO`): this will add a single-member sub-archive. In this case, the `path` parameter is **mandatory** and should be the member name under which this item can be found / retrieved.
ja: Python バイナリオブジェクト（ `bytes`、`bytearray` 、`io.BytesIO` ）: これは単一のメンバーサブアーカイブを追加します。この場合、`path` パラメーターは **必須** で、このアイテムが見つかる/取得できるメンバー名である必要があります。

en: a tuple `(data, name)`: This will add a single-member sub-archive with the member name `name`. `data` may be a Python binary object or a local file name (in which case its binary file content is used). Use this format if you need to specify `path`.
ja: タプル`(data, name)`: これはメンバー名 `name` を持つ単一のメンバーサブアーカイブを追加します。`data` はPythonバイナリオブジェクトまたはローカルファイル名である可能性があります（その場合、バイナリファイルのコンテンツが使用されます）。`path` を指定する必要がある場合は、このフォーマットを使用してください。

en: a Python sequence: This is a convenience format to specify any combination of the above.
ja: Pythonシーケンス: これは上記のいずれかの組み合わせを指定するための便益フォーマットです。

en: If provided, `path` must be a string.
ja: 提供される場合、`path` は文字列である必要があります。

en: If `content` is either binary data or a file name, this parameter is mandatory and must be the name under which the data can be found.
ja: `content` がバイナリデータまたはファイル名の場合、このパラメーターは必須で、データが見つかる名前である必要があります。

en: Otherwise this parameter is optional. It can be used to simulate a folder name or a mount point, under which this sub-archive's elements can be found. For example this specification `Archive((data, "name"), "path")` means that `data` will be found using the element name `"path/name"`. Similar is true for other sub-archives: to retrieve members of a ZIP sub-archive, their names must be prefixed with `"path/"`. The main purpose of this parameter probably is to differentiate between duplicate names.
ja: それ以外の場合、このパラメーターはオプションです。これは、このサブアーカイブの要素が見つかるマウントポイントまたはフォルダ名をシミュレートするために使用できます。たとえば、この仕様 `Archive((data, "name"), "path")` は、データが要素名 "`"path/name"` で見つかります。他のサブアーカイブについても同様です：ZIPサブアーカイブのメンバーを取得するには、その名前に `"path/"` を接頭辞として追加する必要があります。このパラメーターの主な目的は、重複する名前を区別することである可能性があります。

en: If duplicate entry names exist in the archive, always the last entry with that name will be found / retrieved. During archive creation, or appending more data to an archive (see :meth:`Archive.add`) no check for duplicates will be made. Use the `path` parameter to prevent this from happening.
ja: アーカイブ内に重複するエントリ名が存在する場合、常にその名前の最後のエントリが見つかり/取得されます。アーカイブの作成中、またはアーカイブにさらにデータを追加する際 :meth:`Archive.add` を参照）、重複をチェックしません。この問題を防ぐために path パラメーターを使用してください。

en: Append a sub-archive. The meaning of the parameters are exactly the same as explained above. Of course, parameter `content` is not optional here.
ja: サブアーカイブを追加します。パラメータの意味は上記とまったく同じです。もちろん、ここではパラメータ `content` はオプションではありません。

en: Checks whether an entry exists in any of the sub-archives.
ja: エントリがサブアーカイブのいずれかに存在するかどうかを確認します。

en: Parameters
ja: パラメータ:

en: The fully qualified name of the entry. So must include any `path` prefix under which the entry's sub-archive has been added.
ja: エントリの完全修飾名。エントリのサブアーカイブが追加されたパスのプレフィックスを含む必要があります。

en: Returns
ja: 戻り値:

en: `True` or `False`.
ja: `True` または `False` 。

en: Retrieve the data of an entry.
ja: エントリのデータを取得します。

en: The binary data (`bytes`) of the entry. If not found, an exception is raised.
ja: エントリのバイナリデータ（ `bytes` ）です。見つからない場合は例外が発生します。

en: A list of the archive's sub-archives. Each list item is a dictionary with the following keys:
ja: アーカイブのサブアーカイブのリストです。各リストアイテムは、次のキーを持つ辞書です：

en: `entries` -- a list of (top-level) entry names in this sub-archive.
ja: `entries` - このサブアーカイブ内の（トップレベルの）エントリ名のリスト。

en: `fmt` -- the format of the sub-archive. This is one of the strings "dir" (file folder), "zip" (ZIP archive), "tar" (TAR archive), or "tree" for single binary entries or file content.
ja: `fmt` - サブアーカイブの形式。これは文字列 "dir"（ファイルフォルダ）、"zip"（ZIPアーカイブ）、"tar"（TARアーカイブ）、または単一のバイナリエントリまたはファイルコンテンツの場合は "tree" のいずれかです。

en: `path` -- the value of the `path` parameter under which this sub-archive was added.
ja: `path` - このサブアーカイブが追加されたパラメータの値です。

en: **Example:**
ja: **例：**

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