PyMuPDF 1.23.0rc1 - en to ja translation catalogue (95 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: The Basics
ja: 基本

en: Opening a File
ja: ファイルを開く

en: To open a file, do the following:
ja: ファイルを開くには、以下の手順を実行してください：

en: **Taking it further**
ja: **さらに進む**

en: See the :ref:`list of supported file types<Supported_File_Types>` and :ref:`The How to Guide on Opening Files <HowToOpenAFile>` for more advanced options.
ja: より高度なオプションについては、:ref:`サポートされている <Supported_File_Types>` と :ref:`ファイルを開く方法ガイド<HowToOpenAFile>` のリストを参照してください。

en: Extract text from a |PDF|
ja: |PDF| からテキストを抽出する

en: To extract all the text from a |PDF| file, do the following:
ja: |PDF| ファイルからすべてのテキストを抽出するには、以下の手順を実行してください：

en: There are many more examples which explain how to extract text from specific areas or how to extract tables from documents. Please refer to the :ref:`How to Guide for Text<RecipesText>`.
ja: 特定の領域からテキストを抽出する方法や、文書から表を抽出する方法など、さらに多くの例があります。テキストの方法ガイドを参照してください。

en: **API reference**
ja: **APIリファレンス**

en: Extract images from a |PDF|
ja: |PDF| から画像を抽出する

en: To extract all the images from a |PDF| file, do the following:
ja: |PDF| すべての画像を抽出するには、以下の手順を実行してください：

en: Merging |PDF| files
ja: |PDF| ファイルの結合

en: To merge |PDF| files, do the following:
ja: |PDF| ファイルを結合するには、以下の手順を実行してください：

en: Merging |PDF| files with other types of file
ja: |PDF| ァイルと他の種類のファイルを結合する

en: With :meth:`Document.insert_file` you can invoke the method to merge :ref:`supported files<Supported_File_Types>` with |PDF|. For example:
ja: :meth:`Document.insert_file` を使用すると、サポートされているファイルをPDFと結合するメソッドを呼び出すことができます。例えば：

en: It is easy to join PDFs with :meth:`Document.insert_pdf` & :meth:`Document.insert_file`. Given open |PDF| documents, you can copy page ranges from one to the other. You can select the point where the copied pages should be placed, you can revert the page sequence and also change page rotation. This Wiki `article <https://github.com/pymupdf/PyMuPDF/wiki/Inserting-Pages-from-other-PDFs>`_ contains a full description.
ja: :meth:`Document.insert_pdf` と :meth:`Document.insert_file` を使用すれば、PDFを簡単に結合できます。開かれたPDF文書がある場合、片方のPDFから別のPDFへページの範囲をコピーすることができます。コピーされたページが配置される位置を選択することができ、ページの順序を元に戻すこともできます。さらに、ページの回転も変更することができます。詳細な説明はこの `Wiki <https://github.com/pymupdf/PyMuPDF/wiki/Inserting-Pages-from-other-PDFs>`_ の記事に記載されています。

en: The GUI script `join.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/join-documents/join.py>`_ uses this method to join a list of files while also joining the respective table of contents segments. It looks like this:
ja: GUIスクリプト `join.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/join-documents/join.py>`_ では、この方法を使用してファイルのリストを結合し、それぞれの目次セグメントも結合します。スクリプトの見た目は以下のようになっています:

en: Adding a watermark to a |PDF|
ja: |PDF| ファイルにウォータマークを追加する方法

en: To add a watermark to a |PDF| file, do the following:
ja: |PDF| ファイルにウォータマークを追加するには、以下の手順を実行してください:

en: Adding watermarks is essentially as simple as adding an image at the base of each |PDF| page. You should ensure that the image has the required opacity and aspect ratio to make it look the way you need it to.
ja: ウォータマークを追加することは、基本的には各PDFページの底辺に画像を追加するだけです。画像が必要な透明度とアスペクト比を持っていることを確認して、必要な見た目になるようにします。

en: In the example above a new image is created from each file reference, but to be more performant (by saving memory and file size) this image data should be referenced only once - see the code example and explanation on :meth:`Page.insert_image` for the implementation.
ja: 前述の例では、各ファイル参照から新しい画像が作成されていますが、メモリとファイルサイズを節約するために、この画像データは1回だけ参照されるようにすると、パフォーマンスが向上します - Page.insert_image()のコード例と説明を参照してください。

en: Adding an image to a |PDF|
ja: |PDF| に画像を追加する

en: To add an image to a |PDF| file, for example a logo, do the following:
ja: PDFファイルに画像を追加するためには、例えばロゴを追加する場合、以下の手順を実行してください：

en: As with the watermark example you should ensure to be more performant by only referencing the image once if possible - see the code example and explanation on :meth:`Page.insert_image`.
ja: ウォータマークの例と同様に、できる限り画像を1回だけ参照することで、より効率的な処理を行うようにしてください。詳細は :meth:`Page.insert_image` のコード例と説明を参照してください。

en: Rotating a |PDF|
ja: |PDF| を回転させる

en: To add a rotation to a page, do the following:
ja: ページに回転を追加するには、以下の手順を実行してください：

en: Cropping a |PDF|
ja: |PDF| のトリミング

en: To crop a page to a defined :ref:`Rect<Rect>`, do the following:
ja: 定義された矩形 :ref:`Rect<Rect>` にページをトリミングするには、以下の手順を実行してください：

en: :index:`Attaching Files <triple: attach;embed;file>`
ja: :index:`ファイルの添付 <triple: attach;embed;file>`

en: To attach another file to a page, do the following:
ja: 別のファイルをページに添付するには、以下の手順を実行してください：

en: When adding the file with :meth:`Page.add_file_annot` note that the third parameter for the `filename` should include the actual file extension. Without this the attachment possibly will not be able to be recognized as being something which can be opened. For example, if the `filename` is just *"attachment"* when view the resulting PDF and attempting to open the attachment you may well get an error. However, with *"attachment.pdf"* this can be recognized and opened by PDF viewers as a valid file type.
ja: :meth:`Page.add_file_annot` でファイルを追加する際には、ファイル名を指定する第三引数には実際のファイルの拡張子を含める必要があります。これがないと、添付ファイルが開けるものとして認識されない可能性があります。例えば、ファイル名が単に「attachment」とだけ指定されている場合、生成されたPDFを見て添付ファイルを開こうとするとエラーが発生するかもしれません。しかし、「attachment.pdf」と指定されている場合、PDFビューアーで有効なファイルタイプとして認識され、開くことができます。

en: The default icon for the attachment is by default a "push pin", however you can change this by setting the `icon` parameter.
ja: 添付ファイルのデフォルトアイコンは「押しピン」ですが、 `icon` パラメータを設定することでこれを変更することができます。

en: :index:`Embedding Files <triple: attach;embed;file>`
ja: :index:`ファイルを埋め込む <triple: attach;embed;file>`

en: To embed a file to a document, do the following:
ja: ファイルを文書に埋め込むには、以下の手順を実行してください：

en: As with :ref:`attaching files<The_Basics_Attaching_Files>`, when adding the file with :meth:`Document.embfile_add` note that the first parameter for the `filename` should include the actual file extension.
ja: ファイルを添付する場合と同様に、 :meth:`Document.embfile_add` でファイルを追加する際には、ファイル名を指定する第一引数には実際のファイルの拡張子を含める必要があります

en: Deleting Pages
ja: ページを削除する

en: To delete a page from a document, do the following:
ja: 文書からページを削除するには、以下の手順を実行してください：

en: To delete a multiple pages from a document, do the following:
ja: 複数のページを文書から削除するには、以下の手順を実行してください：

en: The page index is zero-based, so to delete page 10 of a document you would do the following `doc.delete_page(9)`.
ja: ページのインデックスは0から始まるため、文書の10ページ目を削除するには、以下のようにします:  `doc.delete_page(9)`。

en: Similarly, `doc.delete_pages(from_page=9, to_page=14)` will delete pages 10 - 15 inclusive.
ja: 同様に、 `doc.delete_pages(from_page=9, to_page=14)` は、ページ10からページ15までを含む範囲のページを削除します。

en: Re-Arranging Pages
ja: ページを再配置する

en: To re-arrange pages, do the following:
ja: ページを再配置するには、以下の手順を実行してください：

en: Copying Pages
ja: ページをコピーする

en: To copy pages, do the following:
ja: ページをコピーするには、以下の手順を実行してください：

en: Selecting Pages
ja: ページを選択する

en: To select pages, do the following:
ja: ページを選択するには、以下の手順を実行してください：

en: With |PyMuPDF| you have all options to copy, move, delete or re-arrange the pages of a |PDF|. Intuitive methods exist that allow you to do this on a page-by-page level, like the :meth:`Document.copy_page` method.
ja: |PyMuPDF| を使用すると、 |PDF| のページをコピー、移動、削除、または再配置するためのオプションがすべて揃っています。 :meth:`Document.copy_page` メソッドのように、ページ単位で直感的なメソッドを使用してこれらの操作を行うことができます。

en: Or you alternatively prepare a complete new page layout in form of a :title:`Python` sequence, that contains the page numbers you want, in the sequence you want, and as many times as you want each page. The following may illustrate what can be done with :meth:`Document.select`
ja: または、 :title:`Python` のシーケンスとして完全な新しいページレイアウトを準備し、希望するページ番号を希望する順序で含め、必要なページ数だけ繰り返すこともできます。次の例は、 :meth:`Document.select` を使用した可能性を示しています。

en: Now let's prepare a PDF for double-sided printing (on a printer not directly supporting this):
ja: 以下のように、両面印刷用にPDFを準備しましょう（直接これをサポートしていないプリンターで）：

en: The number of pages is given by `len(doc)` (equal to `doc.page_count`). The following lists represent the even and the odd page numbers, respectively:
ja: ページ数は `len(doc)`（ `doc.page_count` と同じ）で与えられます。以下のリストは、それぞれ偶数ページと奇数ページの番号を表しています：

en: This snippet creates the respective sub documents which can then be used to print the document:
ja: このスニペットは、それぞれのサブドキュメントを作成し、それらを使用してドキュメントを印刷することができます：

en: For more information also have a look at this Wiki `article <https://github.com/pymupdf/PyMuPDF/wiki/Rearranging-Pages-of-a-PDF>`_.
ja: 詳細については、この `ウィキの記事 <https://github.com/pymupdf/PyMuPDF/wiki/Rearranging-Pages-of-a-PDF>`_ もご覧ください。

en: The following example will reverse the order of all pages (**extremely fast:** sub-second time for the 756 pages of the :ref:`AdobeManual`):
ja: 次の例は、すべてのページの順序を逆にするものです（非常に高速:  :ref:`AdobeManual` リファレンスの756ページをサブセカンドの時間で処理します）。

en: This snippet duplicates the PDF with itself so that it will contain the pages *0, 1, ..., n, 0, 1, ..., n* **(extremely fast and without noticeably increasing the file size!)**:
ja: このスニペットは、PDFを自身と重複させることで、ページ0、1、…、n、0、1、…、nを含むようにします（非常に高速で、ファイルサイズをほとんど増やさずに実現します！）：

en: Adding Blank Pages
ja: 空白のページを追加する

en: To add a blank page, do the following:
ja: 空白のページを追加するには、以下の手順を行います：

en: Use this to create the page with another pre-defined paper format:
ja: 以下の方法を使用して、別の事前定義された用紙フォーマットを使ってページを作成します：

en: The convenience function :meth:`paper_size` knows over 40 industry standard paper formats to choose from. To see them, inspect dictionary :attr:`paperSizes`. Pass the desired dictionary key to :meth:`paper_size` to retrieve the paper dimensions. Upper and lower case is supported. If you append "-L" to the format name, the landscape version is returned.
ja: 便利な関数 :meth:`paper_size` は、40以上の業界標準の用紙フォーマットを選択できます。それらを確認するには、辞書 attr:`paperSizes`  を調べてください。用紙の寸法を取得するために、希望する辞書キーを :meth:`paper_size` に渡します。大文字と小文字の両方がサポートされています。フォーマット名に「-L」を追加すると、横長バージョンが返されます。

en: Here is a 3-liner that creates a |PDF|: with one empty page. Its file size is 460 bytes:
ja: 以下は、1ページの空白の |PDF|: を作成するための3行のコードです。ファイルサイズは460バイトです。

en: Inserting Pages with Text Content
ja: ページにテキストコンテンツを挿入する

en: Using the :meth:`Document.insert_page` method also inserts a new page and accepts the same `width` and `height` parameters. But it lets you also insert arbitrary text into the new page and returns the number of inserted lines.
ja: :meth:`Document.insert_page` メソッドを使用すると、新しいページが挿入され、同じ幅と高さのパラメーターが受け入れられます。しかし、このメソッドでは新しいページに任意のテキストを挿入することができ、挿入された行数が返されます。

en: The text parameter can be a (sequence of) string (assuming UTF-8 encoding). Insertion will start at :ref:`Point` (50, 72), which is one inch below top of page and 50 points from the left. The number of inserted text lines is returned.
ja: テキストパラメーターは、UTF-8エンコーディングを想定している（シーケンスの）文字列です。挿入はページの上端から1インチ下であるポイント :ref:`Point` (50, 72) から始まり、左から50ポイントの位置です。挿入されたテキストの行数が返されます。

en: Splitting Single Pages
ja: 単一のページを分割する

en: This deals with splitting up pages of a |PDF| in arbitrary pieces. For example, you may have a |PDF| with *Letter* format pages which you want to print with a magnification factor of four: each page is split up in 4 pieces which each going to a separate |PDF| page in *Letter* format again.
ja: この方法は、 |PDF| のページを任意の部分に分割することに関連しています。例えば、Letterフォーマットのページを含む |PDF| を、4倍の拡大率で印刷したい場合を考えてみましょう。各ページは4つの部分に分割され、それぞれが再びLetterフォーマットの個別の |PDF| ページになります。

en: Combining Single Pages
ja: 単一のページを結合する

en: This deals with joining |PDF| pages to form a new |PDF| with pages each combining two or four original ones (also called "2-up", "4-up", etc.). This could be used to create booklets or thumbnail-like overviews.
ja: これは、2つまたは4つの元のページを組み合わせた新しい |PDF| を作成することを意味します（または「2-up」、「4-up」などとも呼ばれます）。これは、ブックレットやサムネイルのような概要を作成するために使用できます。

en: |PDF| Encryption & Decryption
ja: |PDF| の暗号化と復号化

en: Starting with version 1.16.0, |PDF| decryption and encryption (using passwords) are fully supported. You can do the following:
ja: バージョン1.16.0から、PDFの暗号化と復号化（パスワードを使用）が完全にサポートされています。以下のことができます：

en: Check whether a document is password protected / (still) encrypted (:attr:`Document.needs_pass`, :attr:`Document.is_encrypted`).
ja: ドキュメントがパスワード保護されているか、（まだ）暗号化されているかを確認する（:attr:`Document.needs_pass`, :attr:`Document.is_encrypted`）。

en: Gain access authorization to a document (:meth:`Document.authenticate`).
ja: ドキュメントへのアクセス権を取得する（:meth:`Document.authenticate`）。

en: Set encryption details for PDF files using :meth:`Document.save` or :meth:`Document.write` and
ja: :meth:`Document.save` または :meth:`Document.write` を使用して、PDFファイルの暗号化詳細を設定する。

en: decrypt or encrypt the content
ja: 内容の復号化または暗号化

en: set password(s)
ja: パスワードの設定

en: set the encryption method
ja: 暗号化方式の設定

en: set permission details
ja: 権限の詳細設定

en: A PDF document may have two different passwords:
ja: PDF文書には2つの異なるパスワードが存在する場合があります：

en: The **owner password** provides full access rights, including changing passwords, encryption method, or permission detail.
ja: オーナーパスワード：パスワードを変更したり、暗号化方法を変更したり、権限の詳細を含む完全なアクセス権を提供します。

en: The **user password** provides access to document content according to the established permission details. If present, opening the |PDF| in a viewer will require providing it.
ja: ユーザーパスワード：文書の内容にアクセスするための権限詳細に基づいてアクセスを提供します。存在する場合、ビューアでPDFを開く際にユーザーパスワードを入力する必要があります。

en: Method :meth:`Document.authenticate` will automatically establish access rights according to the password used.
ja: メソッド :meth:`Document.authenticate` は、使用されるパスワードに基づいて自動的にアクセス権を確立します。

en: The following snippet creates a new |PDF| and encrypts it with separate user and owner passwords. Permissions are granted to print, copy and annotate, but no changes are allowed to someone authenticating with the user password.
ja: 以下のスニペットは新しい |PDF| を作成し、別々のユーザーパスワードとオーナーパスワードで暗号化します。印刷、コピー、注釈付けの権限が与えられますが、ユーザーパスワードで認証するユーザーに対しては変更は許可されません

en: Opening this document with some viewer (Nitro Reader 5) reflects these settings:
ja: このドキュメントをいくつかのビューア（Nitro Reader 5など）で開くと、これらの設定が反映されます：

en: **Decrypting** will automatically happen on save as before when no encryption parameters are provided.
ja: 暗号化パラメータが提供されていない場合、保存時に自動的に復号化されます。

en: To **keep the encryption method** of a PDF save it using `encryption=fitz.PDF_ENCRYPT_KEEP`. If `doc.can_save_incrementally() == True`, an incremental save is also possible.
ja: PDFの暗号化方法を保持するには、`encryption=fitz.PDF_ENCRYPT_KEEP` を使用して保存します。また、 `doc.can_save_incrementally() == True` であれば、増分保存も可能です

en: To **change the encryption method** specify the full range of options above (`encryption`, `owner_pw`, `user_pw`, `permissions`). An incremental save is **not possible** in this case.
ja: 暗号化方法を変更する場合は、上記のすべてのオプション（`encryption`、`owner_pw`、`user_pw`、`permissions`）を指定します。この場合、増分保存はできません。

en: Extracting Tables from a :title:`Page`
ja: ページからのテーブルの抽出

en: Tables can be found and extracted from any document :ref:`Page`.
ja: 表はどのドキュメントの :ref:`Page` からも見つけて抽出できます。

en: Getting Page Links
ja: ページリンクの取得

en: Links can be extracted from a :ref:`Page` to return :ref:`Link` objects.
ja: :ref:`Page` からリンクを抽出して :ref:`Link` オブジェクトを返すことができます。

en: Getting All Annotations from a Document
ja: ドキュメントからすべての注釈を取得する

en: Annotations (:ref:`Annot`) on pages can be retrieved with the `page.annots()` method.
ja: ページ上の注釈 (:ref:`Annot`) は、`page.annots()` メソッドを使用して取得できます。

en: Converting PDF Documents
ja: PDF ドキュメントの変換

en: We recommend the pdf2docx_ library which uses **PyMuPDF** and the **python-docx** library to provide simple document conversion from **PDF** to **DOCX** format.
ja: PyMuPDF を使用する pdf2docx_ ライブラリと、**PDF** から **DOCX** 形式への簡単なドキュメント変換を提供する **python-docx** ライブラリをお勧めします。

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