PyMuPDF 1.23.0rc1 - en to ja translation catalogue (60 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: Installation
ja: インストール

en: Requirements
ja: 要件

en: All the examples below assume that you are running inside a Python virtual environment. See: https://docs.python.org/3/library/venv.html for details. We also assume that `pip` is up to date.
ja: 以下のすべての例は、Pythonの仮想環境内で実行していると仮定しています。詳細については、https://docs.python.org/3/library/venv.html を参照してください。また、pipが最新であると仮定しています。

en: For example:
ja: 例えば:

en: PyMuPDF should be installed using pip with::
ja: PyMuPDFをインストールするには、次のようにpipを使用してください::

en: This will install from a Python wheel if one is available for your platform.
ja: この方法でインストールすると、対象のプラットフォームに対応するPythonのwheelファイルがある場合は、それを使用してインストールされます。

en: Installation when a suitable wheel is not available
ja: 適切なwheelファイルが利用できない場合のインストール方法

en: If a suitable Python wheel is not available, pip will automatically build from source using a Python sdist.
ja: 適切なPythonのwheelファイルが利用できない場合、pipは自動的にPythonのsdistからビルドします。

en: **This requires C/C++ development tools to be installed**:
ja: **これにはC/C++の開発ツールがインストールされている必要があります：**

en: On Windows:
ja: Windowsの場合:

en: Install Visual Studio 2019. If not installed in a standard location, set environmental variable `PYMUPDF_SETUP_DEVENV` to the location of the `devenv.com` binary.
ja: Visual Studio 2019をインストールしてください。標準の場所にインストールされていない場合は、環境変数 `PYMUPDF_SETUP_DEVENV` を `devenv.com` バイナリの場所に設定してください

en: Having other installed versions of Visual Studio, for example Visual Studio 2022, can cause problems because one can end up with MuPDF and PyMuPDF code being compiled with different compiler versions.
ja: 他のバージョンのVisual Studio（例：Visual Studio 2022）がインストールされている場合、異なるコンパイラバージョンでMuPDFとPyMuPDFのコードがコンパイルされる可能性があるため、問題が発生することがあります。

en: As of `PyMuPDF-1.20.0`, the required MuPDF source code is already in the sdist and is automatically built into PyMuPDF.
ja: `PyMuPDF-1.20.0` 現在、必要なMuPDFのソースコードがsdistに含まれており、自動的にPyMuPDFに組み込まれています。

en: Notes
ja: メモ

en: Wheels are available for Windows (32-bit Intel, 64-bit Intel), Linux (64-bit Intel, 64-bit ARM) and Mac OSX (64-bit Intel, 64-bit ARM), Python versions 3.7 and up.
ja: Windows（32ビットIntel、64ビットIntel）、Linux（64ビットIntel、64ビットARM）、およびMac OSX（64ビットIntel、64ビットARM）用のホイールが利用可能で、Pythonバージョン3.7以上に対応しています。

en: Wheels are not available for Python installed with `Chocolatey <https://chocolatey.org/>`_ on Windows. Instead install Python using the Windows installer from the python.org website, see: http://www.python.org/downloads
ja: `Chocolatey <https://chocolatey.org/>`_ を使用してWindowsにインストールされたPythonには、ホイールが利用できません。代わりに、python.orgのウェブサイトからWindowsインストーラーを使用してPythonをインストールしてください。詳細は、以下を参照してください：http://www.python.org/downloads

en: PyMuPDF does not support Python versions prior to 3.8. Older wheels can be found in `this <https://github.com/pymupdf/PyMuPDF-Optional-Material/tree/master/wheels-upto-Py3.5>`_ repository and on `PyPI <https://pypi.org/project/PyMuPDF/>`_. Please note that we generally follow the official Python release schedules. For Python versions dropping out of official support this means, that generation of wheels will also be ceased for them.
ja: PyMuPDFはPythonバージョン3.8以前をサポートしていません。古いバージョンのホイールは、`この <https://github.com/pymupdf/PyMuPDF-Optional-Material/tree/master/wheels-upto-Py3.5>`_ リポジトリや `PyPI <https://pypi.org/project/PyMuPDF/>`_ でも見つけることができます

en: There are no **mandatory** external dependencies. However, some optional feature are available only if additional components are installed:
ja: 必須の外部依存関係はありません。ただし、追加のコンポーネントをインストールした場合にのみ、一部のオプション機能が利用可能です：

en: `Pillow <https://pypi.org/project/Pillow/>`_ is required for :meth:`Pixmap.pil_save` and :meth:`Pixmap.pil_tobytes`.
ja: `Pillow <https://pypi.org/project/Pillow/>`_ は :meth:`Pixmap.pil_save` と :meth:`Pixmap.pil_tobytes` の実行に必要です。

en: `fontTools <https://pypi.org/project/fonttools/>`_ is required for :meth:`Document.subset_fonts`.
ja: `fontTools <https://pypi.org/project/fonttools/>`_ は :meth:`Document.subset_fonts` の実行に必要です。

en: `pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_ is a collection of nice fonts to be used for text output methods.
ja: `pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_ は、テキスト出力の方法に使用するための素敵なフォントのコレクションです。

en: `Tesseract-OCR <https://github.com/tesseract-ocr/tesseract>`_ for optical character recognition in images and document pages. Tesseract is separate software, not a Python package. To enable OCR functions in PyMuPDF, the software must be installed and the system environment variable `"TESSDATA_PREFIX"` must be defined and contain the `tessdata` folder name of the Tesseract installation location. See below.
ja: `Tesseract-OCR <https://github.com/tesseract-ocr/tesseract>`_ は、画像やドキュメントページの光学文字認識（OCR）のためのソフトウェアです。TesseractはPythonのパッケージではなく、独立したソフトウェアです。PyMuPDFでOCR機能を有効にするには、Tesseractソフトウェアをインストールし、システム環境変数の `"TESSDATA_PREFIX"` を定義して、Tesseractのインストール場所にある `tessdata` フォルダの名前を含める必要があります。以下を参照してください。

en: You can install these additional components at any time -- before or after installing PyMuPDF. PyMuPDF will detect their presence during import or when the respective functions are being used.
ja: これらの追加コンポーネントはいつでもインストールできます。PyMuPDFのインストール前または後に行うことができます。PyMuPDFは、これらのコンポーネントがインポート時または対応する機能が使用される際に検出します。

en: Build and install from local PyMuPDF checkout and optional local MuPDF checkout
ja: ローカルの PyMuPDF チェックアウトとオプションのローカル MuPDF チェックアウトからビルドしてインストールします。

en: Install C/C++ development tools as described above.
ja: 上記に記載されているように、C/C++の開発ツールをインストールしてください。

en: Enter a Python venv and update pip, as described above.
ja: 上記に記載されているように、Pythonのvenvに入り、pipをアップデートしてください。

en: Get a PyMuPDF source tree:
ja: PyMuPDFのソースツリーを取得します：

en: Clone the PyMuPDF git repository::
ja: PyMuPDFのGitリポジトリをクローンしてください::

en: Or download and extract a `.zip` or `.tar.gz` source release from https://github.com/pymupdf/PyMuPDF/releases.
ja: または、https://github.com/pymupdf/PyMuPDF/releases から `.zip` または `.tar.gz` 形式のソースリリースをダウンロードして展開してください。

en: Build and install PyMuPDF::
ja: PyMuPDFをビルドしてインストールしてください::

en: This will automatically download a specific hard-coded MuPDF source release, and build it into PyMuPDF.
ja: これにより、特定のハードコードされたMuPDFソースリリースが自動的にダウンロードされ、PyMuPDFにビルドされます。

en: Build and install PyMuPDF using a local MuPDF source tree:
ja: ローカルのMuPDFソースツリーを使用してPyMuPDFをビルドおよびインストールする場合は、次の手順に従ってください：

en: Clone the MuPDF git repository::
ja: MuPDFのGitリポジトリをクローンします：

en: Build PyMuPDF, specifying the location of the local MuPDF tree with the environmental variables `PYMUPDF_SETUP_MUPDF_BUILD`::
ja: 環境変数 `PYMUPDF_SETUP_MUPDF_BUILD` を使用して、ローカルな MuPDF ツリーの場所を指定して PyMuPDF をビルドします::

en: Building for different Python versions in same PyMuPDF tree:
ja: 同じPyMuPDFツリー内で異なるPythonバージョン用にビルドする方法：

en: PyMuPDF will build for the version of Python that is being used to run `pip`. To run `pip` with a specific Python version, use `python -m pip` instead of `pip`.
ja: PyMuPDF は、`pip` を実行する Python のバージョンに対応してビルドされます。特定の Python バージョンで pip を実行するには、`pip` の代わりに `python -m pip` を使用してください。

en: So for example on Windows one can build different versions with::
ja: したがって、Windows 上で異なるバージョンをビルドする場合、次のようにできます::

en: or::
ja: または::

en: When running Python scripts that use PyMuPDF, make sure that the current directory is not the `PyMuPDF/` directory.
ja: PyMuPDFを使用するPythonスクリプトを実行する際は、現在のディレクトリが `PyMuPDF/` ディレクトリでないことを確認してください。

en: Otherwise, confusingly, Python will attempt to import `fitz` from the local `fitz/` directory, which will fail because it only contains source files.
ja: そうでない場合、Pythonは混乱する可能性があります。Pythonはローカルの `fitz/` ディレクトリから `fitz` をインポートしようとしますが、それはソースファイルのみを含んでいるため、失敗します。

en: Running tests
ja: テストの実行

en: Having a PyMuPDF tree available allows one to run PyMuPDF's `pytest` test suite::
ja: PyMuPDFのディレクトリが利用可能な場合、PyMuPDFの `pytest` テストスイートを実行できます。::

en: Notes about using a non-default MuPDF
ja: 非デフォルトのMuPDFを使用する際の注意事項

en: Using a non-default build of MuPDF by setting environmental variable `PYMUPDF_SETUP_MUPDF_BUILD` can cause various things to go wrong and so is not generally supported:
ja: 環境変数 `PYMUPDF_SETUP_MUPDF_BUILD` を設定して非デフォルトのMuPDFビルドを使用すると、さまざまな問題が発生する可能性があるため、一般的にはサポートされていません。

en: If MuPDF's major version number differs from what PyMuPDF uses by default, PyMuPDF can fail to build, because MuPDF's API can change between major versions.
ja: もしMuPDFのメジャーバージョン番号がPyMuPDFがデフォルトで使用するものと異なる場合、PyMuPDFはビルドに失敗する可能性があります。なぜなら、MuPDFのAPIはメジャーバージョン間で変更されることがあるからです。

en: Runtime behaviour of PyMuPDF can change because MuPDF's runtime behaviour changes between different minor releases. This can also break some PyMuPDF tests.
ja: PyMuPDFのランタイム動作は、異なるマイナーリリース間でMuPDFのランタイム動作が変更されるため、変わる可能性があります。これは一部のPyMuPDFのテストにも影響を及ぼすことがあります。

en: If MuPDF was built with its default config instead of PyMuPDF's customised config (for example if MuPDF is a system install), it is possible that `tests/test_textbox.py:test_textbox3()` will fail. One can skip this particular test by adding `-k 'not test_textbox3'` to the `pytest` command line.
ja: MuPDFがPyMuPDFのカスタマイズされた設定ではなく、デフォルトの設定でビルドされた場合（たとえば、MuPDFがシステムにインストールされた場合）、`tests/test_textbox.py:test_textbox3()` が失敗する可能性があります。この特定のテストをスキップするには、`pytest` コマンドラインに `-k 'not test_textbox3'` を追加してください。

en: Enabling Integrated OCR Support
ja: 統合OCRサポートの有効化

en: If you do not intend to use this feature, skip this step. Otherwise, it is required for both installation paths: **from wheels and from sources.**
ja: もしこの機能を使用しない場合は、このステップをスキップしてください。それ以外の場合は、**ホイールからのインストールとソースからのインストールの両方** に必要です。

en: PyMuPDF will already contain all the logic to support OCR functions. But it additionally does need Tesseract's language support data, so installation of Tesseract-OCR is still required.
ja: PyMuPDFにはすでにOCR機能をサポートするためのロジックが含まれていますが、追加でTesseractの言語サポートデータが必要です。そのため、Tesseract-OCRのインストールが依然として必要です。

en: The language support folder location must be communicated either via storing it in the environment variable `"TESSDATA_PREFIX"`, or as a parameter in the applicable functions.
ja: 言語サポートフォルダの場所は、`"TESSDATA_PREFIX"` という環境変数に保存するか、適用される関数のパラメータとして指定する必要があります。

en: So for a working OCR functionality, make sure to complete this checklist:
ja: OCR機能を正常に動作させるために、以下のチェックリストを完了してください：

en: Install Tesseract.
ja: Tesseractをインストールしてください

en: Locate Tesseract's language support folder. Typically you will find it here:
ja: Tesseractの言語サポートフォルダを見つけてください。通常、以下の場所にあります：

en: Unix systems: `/usr/share/tesseract-ocr/4.00/tessdata`
ja: Unixシステム: `/usr/share/tesseract-ocr/4.00/tessdata`

en: Set the environment variable `TESSDATA_PREFIX`
ja: 環境変数 `TESSDATA_PREFIX` を設定してください：

en: Unix systems: `declare -x TESSDATA_PREFIX=/usr/share/tesseract-ocr/4.00/tessdata`
ja: Unixシステム: `declare -x TESSDATA_PREFIX=/usr/share/tesseract-ocr/4.00/tessdata`

en: On Windows systems, this must happen outside Python -- before starting your script. Just manipulating `os.environ` will not work!
ja: Windowsシステムでは、これはPythonの外部で行われる必要があります。スクリプトを実行する前に行ってください。`os.environ` を操作するだけではうまく動作しません！
