From ef9bca23d041e5768f17b001d58c8d39bcff43e9 Mon Sep 17 00:00:00 2001 From: Jamie Lemon Date: Thu, 28 Mar 2024 16:55:27 +0000 Subject: [PATCH] Documentation: Adds macro for PyMuPDF and PDF titles in .rst --- docs/about.rst | 6 +- docs/app4.rst | 28 ++--- docs/document-writer-class.rst | 2 +- docs/header.rst | 7 ++ docs/how-to-open-a-file.rst | 14 +-- docs/index.rst | 6 +- docs/locales/ja/LC_MESSAGES/about.mo | Bin 4487 -> 4452 bytes docs/locales/ja/LC_MESSAGES/about.po | 10 +- docs/locales/ja/LC_MESSAGES/app4.mo | Bin 12494 -> 12333 bytes docs/locales/ja/LC_MESSAGES/app4.po | 48 ++++---- .../ja/LC_MESSAGES/document-writer-class.mo | Bin 5527 -> 5531 bytes .../ja/LC_MESSAGES/document-writer-class.po | 4 +- .../ja/LC_MESSAGES/how-to-open-a-file.mo | Bin 6159 -> 6167 bytes .../ja/LC_MESSAGES/how-to-open-a-file.po | 40 +++--- docs/locales/ja/LC_MESSAGES/index.mo | Bin 3079 -> 3037 bytes docs/locales/ja/LC_MESSAGES/index.po | 10 +- ...cipes-common-issues-and-their-solutions.mo | Bin 25123 -> 25074 bytes ...cipes-common-issues-and-their-solutions.po | 14 +-- .../ja/LC_MESSAGES/recipes-multiprocessing.mo | Bin 3369 -> 3341 bytes .../ja/LC_MESSAGES/recipes-multiprocessing.po | 8 +- docs/locales/ja/LC_MESSAGES/the-basics.mo | Bin 25192 -> 24849 bytes docs/locales/ja/LC_MESSAGES/the-basics.po | 116 +++++++++--------- docs/locales/ja/LC_MESSAGES/tutorial.mo | Bin 47535 -> 47521 bytes docs/locales/ja/LC_MESSAGES/tutorial.po | 4 +- docs/locales/ja/LC_MESSAGES/vars.mo | Bin 18402 -> 18395 bytes docs/locales/ja/LC_MESSAGES/vars.po | 2 +- docs/recipes-annotations.rst | 4 +- ...ipes-common-issues-and-their-solutions.rst | 8 +- docs/recipes-drawing-and-graphics.rst | 4 +- docs/recipes-multiprocessing.rst | 6 +- docs/the-basics.rst | 50 ++++---- docs/tutorial.rst | 4 +- docs/vars.rst | 2 +- 33 files changed, 204 insertions(+), 193 deletions(-) diff --git a/docs/about.rst b/docs/about.rst index 216144398..379bb01ad 100644 --- a/docs/about.rst +++ b/docs/about.rst @@ -15,7 +15,7 @@ Features Comparison Feature Matrix ~~~~~~~~~~~~~~~~~~~ -The following table illustrates how :title:`PyMuPDF` compares with other typical solutions. +The following table illustrates how |PyMuPDF| compares with other typical solutions. .. include:: about-feature-matrix.rst @@ -28,7 +28,7 @@ Performance -To benchmark :title:`PyMuPDF` performance against a range of tasks a test suite with a fixed set of :ref:`8 PDFs with a total of 7,031 pages` containing text & images is used to obtain performance timings. +To benchmark |PyMuPDF| performance against a range of tasks a test suite with a fixed set of :ref:`8 PDFs with a total of 7,031 pages` containing text & images is used to obtain performance timings. Here are current results, grouped by task: @@ -49,7 +49,7 @@ License and Copyright -:title:`PyMuPDF` and :title:`MuPDF` are now available under both, open-source :title:`AGPL` and commercial license agreements. Please read the full text of the :title:`AGPL` license agreement, available in the distribution material (file COPYING) and `here `_, to ensure that your use case complies with the guidelines of the license. If you determine you cannot meet the requirements of the :title:`AGPL`, please contact `Artifex `_ for more information regarding a commercial license. +|PyMuPDF| and :title:`MuPDF` are now available under both, open-source :title:`AGPL` and commercial license agreements. Please read the full text of the :title:`AGPL` license agreement, available in the distribution material (file COPYING) and `here `_, to ensure that your use case complies with the guidelines of the license. If you determine you cannot meet the requirements of the :title:`AGPL`, please contact `Artifex `_ for more information regarding a commercial license. .. raw:: html diff --git a/docs/app4.rst b/docs/app4.rst index 7d290376f..7ca5d1ff3 100644 --- a/docs/app4.rst +++ b/docs/app4.rst @@ -19,9 +19,9 @@ The following three sections deal with different performance aspects: * :ref:`Document Copying` - This includes opening and parsing :title:`PDFs`, then writing them to an output file. Because the same basic activities are also used for joining (merging) :title:`PDFs`, the results also apply to these use cases. * :ref:`Text Extraction` - This extracts plain text from :title:`PDFs` and writes it to an output text file. -* :ref:`Page Rendering` - This converts :title:`PDF` pages to image files looking identical to the pages. This ability is the basic prerequisite for using a tool in :title:`Python GUI` scripts to scroll through documents. We have chosen a medium-quality (resolution 150 DPI) version. +* :ref:`Page Rendering` - This converts |PDF| pages to image files looking identical to the pages. This ability is the basic prerequisite for using a tool in :title:`Python GUI` scripts to scroll through documents. We have chosen a medium-quality (resolution 150 DPI) version. -Please note that in all cases the actual speed in dealing with :title:`PDF` structures is not directly measured: instead, the timings also include the durations of writing files to the operating system's file system. This cannot be avoided because tools other than :title:`PyMuPDF` do not offer the option to e.g., separate the image **creation** step from the following step, which **writes** the image into a file. +Please note that in all cases the actual speed in dealing with |PDF| structures is not directly measured: instead, the timings also include the durations of writing files to the operating system's file system. This cannot be avoided because tools other than |PyMuPDF| do not offer the option to e.g., separate the image **creation** step from the following step, which **writes** the image into a file. So all timings documented include a common, OS-oriented base effort. Therefore, performance **differences per tool are actually larger** than the numbers suggest. @@ -130,7 +130,7 @@ A set of eight files is used for the performance testing. With each file we have Tools used ------------- -In each section, the same fixed set of :title:`PDF` files is being processed by a set of tools. The set of tools used per performance aspect however varies, depending on the supported tool features. +In each section, the same fixed set of |PDF| files is being processed by a set of tools. The set of tools used per performance aspect however varies, depending on the supported tool features. All tools are either platform independent, or at least can run on both, :title:`Windows` and :title:`Unix` / :title:`Linux`. @@ -140,20 +140,20 @@ All tools are either platform independent, or at least can run on both, :title:` * - **Tool** - **Description** - * - :title:`PyMuPDF` + * - |PyMuPDF| - The tool of this manual. * - PDFrw_ - A pure :title:`Python` tool, being used by :title:`rst2pdf`, has interface to :title:`ReportLab`. * - PyPDF2_ - A pure :title:`Python` tool with a large function set. * - PDFMiner_ - - A pure :title:`Python` to extract text and other data from :title:`PDF`. + - A pure :title:`Python` to extract text and other data from |PDF|. * - XPDF_ - A command line utility with multiple functions. * - PikePDF_ - A :title:`Python` package similar to :title:`PDFrw`, but based on :title:`C++` library :title:`QPDF`. * - PDF2JPG_ - - A :title:`Python` package specialized on rendering :title:`PDF` pages to :title:`JPG` images. + - A :title:`Python` package specialized on rendering |PDF| pages to :title:`JPG` images. @@ -163,13 +163,13 @@ All tools are either platform independent, or at least can run on both, :title:` Copying / Joining / Merging ---------------------------------- -How fast is a :title:`PDF` file read and its content parsed for further processing? The sheer parsing performance cannot directly be compared, because batch utilities always execute a requested task completely, in one go, front to end. :title:`PDFrw` too, has a *lazy* strategy for parsing, meaning it only parses those parts of a document that are required in any moment. +How fast is a |PDF| file read and its content parsed for further processing? The sheer parsing performance cannot directly be compared, because batch utilities always execute a requested task completely, in one go, front to end. :title:`PDFrw` too, has a *lazy* strategy for parsing, meaning it only parses those parts of a document that are required in any moment. -To find an answer to the question, we therefore measure the time to copy a :title:`PDF` file to an output file with each tool, and do nothing else. +To find an answer to the question, we therefore measure the time to copy a |PDF| file to an output file with each tool, and do nothing else. These are the :title:`Python` commands for how each tool is used: -:title:`PyMuPDF` +|PyMuPDF| .. code-block:: python @@ -209,7 +209,7 @@ These are the :title:`Python` commands for how each tool is used: **Observations** -These are our run time findings in **seconds** along with a base rate summary compared to :title:`PyMuPDF`: +These are our run time findings in **seconds** along with a base rate summary compared to |PyMuPDF|: .. list-table:: :header-rows: 1 @@ -287,7 +287,7 @@ The following table shows plain text extraction durations. All tools have been u **Observations** -These are our run time findings in **seconds** along with a base rate summary compared to :title:`PyMuPDF`: +These are our run time findings in **seconds** along with a base rate summary compared to |PyMuPDF|: .. list-table:: :header-rows: 1 @@ -359,13 +359,13 @@ These are our run time findings in **seconds** along with a base rate summary co Page Rendering -------------------------- -We have tested rendering speed of :title:`PyMuPDF` against :title:`pdf2jpg` and :title:`XPDF` at a resolution of 150 DPI, +We have tested rendering speed of |PyMuPDF| against :title:`pdf2jpg` and :title:`XPDF` at a resolution of 150 DPI, These are the :title:`Python` commands for how each tool is used: -:title:`PyMuPDF` +|PyMuPDF| .. code-block:: python @@ -398,7 +398,7 @@ These are the :title:`Python` commands for how each tool is used: **Observations** -These are our run time findings in **seconds** along with a base rate summary compared to :title:`PyMuPDF`: +These are our run time findings in **seconds** along with a base rate summary compared to |PyMuPDF|: .. list-table:: diff --git a/docs/document-writer-class.rst b/docs/document-writer-class.rst index a0900e19f..a2ee3d008 100644 --- a/docs/document-writer-class.rst +++ b/docs/document-writer-class.rst @@ -13,7 +13,7 @@ DocumentWriter This class represents a utility which can output various :ref:`document types supported by PyMuPDF`. -In :title:`PyMuPDF` only used for outputting PDF documents whose pages are populated by :ref:`Story` DOMs. +In |PyMuPDF| only used for outputting PDF documents whose pages are populated by :ref:`Story` DOMs. Using DocumentWriter_ also for other document types might happen in the future. diff --git a/docs/header.rst b/docs/header.rst index b96a9d41b..bf42af684 100644 --- a/docs/header.rst +++ b/docs/header.rst @@ -17,6 +17,13 @@
This class is for PDF only.
+.. |PyMuPDF| raw:: html + + PyMuPDF + +.. |PDF| raw:: html + + PDF .. raw:: html diff --git a/docs/how-to-open-a-file.rst b/docs/how-to-open-a-file.rst index 51d08aea5..ce7c5e729 100644 --- a/docs/how-to-open-a-file.rst +++ b/docs/how-to-open-a-file.rst @@ -14,7 +14,7 @@ Opening Files Supported File Types ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -:title:`PyMuPDF` can open files other that just :title:`PDF`. +|PyMuPDF| can open files other than just |PDF|. The following file types are supported: @@ -48,11 +48,11 @@ Assume that *"some.file"* is actually an **XPS**. Open it like so: .. note:: - :title:`PyMuPDF` itself does not try to determine the file type from the file contents. **You** are responsible for supplying the file type information in some way -- either implicitly, via the file extension, or explicitly as shown with the `filetype` parameter. There are pure :title:`Python` packages like `filetype `_ that help you doing this. Also consult the :ref:`Document` chapter for a full description. + |PyMuPDF| itself does not try to determine the file type from the file contents. **You** are responsible for supplying the file type information in some way -- either implicitly, via the file extension, or explicitly as shown with the `filetype` parameter. There are pure :title:`Python` packages like `filetype `_ that help you doing this. Also consult the :ref:`Document` chapter for a full description. - If :title:`PyMuPDF` encounters a file with an unknown / missing extension, it will try to open it as a :title:`PDF`. So in these cases there is no need for additional precautions. Similarly, for memory documents, you can just specify `doc=fitz.open(stream=mem_area)` to open it as a :title:`PDF` document. + If |PyMuPDF| encounters a file with an unknown / missing extension, it will try to open it as a |PDF|. So in these cases there is no need for additional precautions. Similarly, for memory documents, you can just specify `doc=fitz.open(stream=mem_area)` to open it as a |PDF| document. - If you attempt to open an unsupported file then :title:`PyMuPDF` will throw a file data error. + If you attempt to open an unsupported file then |PyMuPDF| will throw a file data error. ---------- @@ -62,14 +62,14 @@ Opening Files as Text ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -:title:`PyMuPDF` has the capability to open any plain text file as a document. In order to do this you should provide the `filetype` parameter for the `fitz.open` function as `"txt"`. +|PyMuPDF| has the capability to open any plain text file as a document. In order to do this you should provide the `filetype` parameter for the `fitz.open` function as `"txt"`. .. code-block:: python doc = fitz.open("my_program.py", filetype="txt") -In this way you are able to open a variety of file types and perform the typical **non-PDF** specific features like text searching, text extracting and page rendering. Obviously, once you have rendered your `txt` content, then saving as :title:`PDF` or merging with other :title:`PDF` files is no problem. +In this way you are able to open a variety of file types and perform the typical **non-PDF** specific features like text searching, text extracting and page rendering. Obviously, once you have rendered your `txt` content, then saving as |PDF| or merging with other |PDF| files is no problem. Examples @@ -103,7 +103,7 @@ Opening a `JSON` file And so on! -As you can imagine many text based file formats can be *very simply opened* and *interpreted* by :title:`PyMuPDF`. This can make data analysis and extraction for a wide range of previously unavailable files suddenly possible. +As you can imagine many text based file formats can be *very simply opened* and *interpreted* by |PyMuPDF|. This can make data analysis and extraction for a wide range of previously unavailable files suddenly possible. diff --git a/docs/index.rst b/docs/index.rst index 3c862289c..07bab7e2a 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -16,12 +16,12 @@ -Welcome to :title:`PyMuPDF` +Welcome to |PyMuPDF| ================================ -:title:`PyMuPDF` is a high-performance **Python** library for data extraction, analysis, conversion & manipulation of **PDF** (and other) documents. +|PyMuPDF| is a high-performance **Python** library for data extraction, analysis, conversion & manipulation of **PDF** (and other) documents. -:title:`PyMuPDF` is hosted on `GitHub `_ and registered on `PyPI `_. +|PyMuPDF| is hosted on `GitHub `_ and registered on `PyPI `_. ---- diff --git a/docs/locales/ja/LC_MESSAGES/about.mo b/docs/locales/ja/LC_MESSAGES/about.mo index 444efaadead62d93bdc9726e82b6648e59d3b265..305d0627d2a53ce78a6d2c573dd205df7dc07df8 100644 GIT binary patch delta 327 zcmYk$F-yZx6o%n1x7CnnQc9_d4n=Ws6h&|oN+|^;gW%%iqJsqyq9_5e4nNw=N#@i-)&BPOkT_#g_6D;ser~v4IIN6>|zlgF~&ZQ zV3d(ga2;3i4Hs}eE4^YJ4|!V~lCHS@FPOtkUu(a`zArs6XyOVkk}{5` zxQDm+^O1>B=>}(U2Ya}M)j*mi=pN4q?uDuEeA+mhH(nAQEXPr~lBDh7`aoB3pZ`0X mF}ue0-D_jLpfRvyFLQ|#{@o~*-jDCnR!~fr@)eu-=jI!N8$Qbb delta 359 zcmZY3ze_@46vpxAzFZS;d9%VnT%@Lcj6vXBHWh+HPz@491-67Y5rjyCmICPxH8h2P zf$#1n?hynLEx9z7(A>Ai?)2fD!#U3x&R)*7m(R|PG;${-w1Pc+$8Wsn_Dfu` containing text & images is used to obtain " "performance timings." msgstr "" ":ref:`8つのPDFファイル（合計7,031ページ）` " -"にテキストと画像が含まれている固定されたセットのテストスイートを使用して、:title:`PyMuPDF` " +"にテキストと画像が含まれている固定されたセットのテストスイートを使用して、|PyMuPDF| " "のパフォーマンスをさまざまなタスクに対してベンチマークします。" #: ../../about.rst:34 c8b8933c46404fdb9f64f1ab30f0348b @@ -80,7 +80,7 @@ msgstr "ライセンスと著作権" #: ../../about.rst:52 b3b1f9567d8e45b99c0a43821f16d943 msgid "" -":title:`PyMuPDF` and :title:`MuPDF` are now available under both, open-" +"|PyMuPDF| and :title:`MuPDF` are now available under both, open-" "source :title:`AGPL` and commercial license agreements. Please read the " "full text of the :title:`AGPL` license agreement, available in the " "distribution material (file COPYING) and `here " diff --git a/docs/locales/ja/LC_MESSAGES/app4.mo b/docs/locales/ja/LC_MESSAGES/app4.mo index 96d76a9228ac50f93410284c4d9074b909b968d7..bad62393ac142587399b4b1857037f490a212e4b 100644 GIT binary patch delta 1105 zcmYk)T}abW7{~G7TxQd3WiFSmweqF3iG?N!N%SIUiWZp{m5CNbtU@%977KfW%BV&} zVHqJ^Wmuz|2&Hbsg2Lz`Rz$8hya~LLE~37t{fC1;`#k47=jA!)>`mLy{;SUeg*M5a zB%PL2JWo1+53w2398xJB#!Yw&EAS(>nS8Qz1iR3WU$7karbu24VivwcQu>TO_M5^{ z+PhN~P&Yxw0*Oz3{9I>1Kc1mox=^~0A#`H%BIzz3#I2Z^Cb_W=JFo*yq2qWCQx;3> z@fuz>{b&klPM0#VEj=K42>f(xzya*UFtUg0UD13inu)!*1pCn3%pj)Xd+ew12+pM) z$dC%~JeqZeEJu;0HGx(5!wlp$!e2nrs4`7 zvjZ4(IZYNrMO=sS-R=tx|87p8iXU0l@ z%Y9{~pXFu8N{x72v8wF(zF1ZMf(BdM9^t~uIkU~6r(}4x6^fM9#HN*dE8?e}EZu4Q E2O9anxc~qF delta 1270 zcmZwFOGs5w6vpxIYUZn}W}5lR@{#7NGBUA2gq2xpNk~mh9SD|2VOm(yHBF-j5gbg& z2ob|13gJM6T0+p1Xi``RMP-v31yVK$>Ay9C;|(tNxA!`GueHwJ=T6nD>MNt3Y?tKg zFSSa_36N^g#tMuMl-A%0+<^m_i{G&tQ-h>BJdZ8-12-V zGJhN;t-_aR@=X2Jk8UZUDBOgZ9tNC-YLS;zBbp5zxE#AN9`9iizCn}V7am7<`yud)mLeS91dYiHmE zXCN#n-u@ZraxSxf2e-K#>+E*-erLq`81gXeU$y3vrrC-Ep;5lx(Wl`h^EO9EOnNW# zi@fINsA~1c^g04|QEZ;GRjV_8+OfoHTmHfku*(wS=ABDJVx%*ReJS~{vqO6(rPSr! hVtH!b0` - これには :title:`PDF` " -"ファイルの開閉と解析、そしてそれらを出力ファイルに書き込む作業が含まれます。同じ基本的なアクティビティは、:title:`PDF` " +":ref:`ドキュメントのコピー` - これには |PDF| " +"ファイルの開閉と解析、そしてそれらを出力ファイルに書き込む作業が含まれます。同じ基本的なアクティビティは、|PDF| " "ファイルの結合（マージ）にも使用されるため、結果はこれらのユースケースにも適用されます。" #: ../../app4.rst:21 1a7f5ad501254fd7a107af66c268bf1d @@ -65,12 +65,12 @@ msgid "" ":ref:`Text Extraction` - This extracts plain text " "from :title:`PDFs` and writes it to an output text file." msgstr "" -":ref:`テキスト抽出` - これにより :title:`PDF` " +":ref:`テキスト抽出` - これにより |PDF| " "ファイルから平文テキストが抽出され、テキストファイルに書き込まれます。" #: ../../app4.rst:22 e98d3027103e4d78a44f61d827c3f7ad msgid "" -":ref:`Page Rendering` - This converts :title:`PDF` " +":ref:`Page Rendering` - This converts |PDF| " "pages to image files looking identical to the pages. This ability is the " "basic prerequisite for using a tool in :title:`Python GUI` scripts to " "scroll through documents. We have chosen a medium-quality (resolution 150" @@ -83,15 +83,15 @@ msgstr "" #: ../../app4.rst:24 78870da8c87d47ac8169606f5a870a4e msgid "" "Please note that in all cases the actual speed in dealing with " -":title:`PDF` structures is not directly measured: instead, the timings " +"|PDF| structures is not directly measured: instead, the timings " "also include the durations of writing files to the operating system's " "file system. This cannot be avoided because tools other than " -":title:`PyMuPDF` do not offer the option to e.g., separate the image " +"|PyMuPDF| do not offer the option to e.g., separate the image " "**creation** step from the following step, which **writes** the image " "into a file." msgstr "" -":title:`PDF` " -"構造の処理速度そのものを直接測定するのではなく、すべての場合において、タイミングにはファイルをオペレーティングシステムのファイルシステムに書き込む時間も含まれることに注意してください。これは回避できない要因です。なぜなら、:title:`PyMuPDF`" +"|PDF| " +"構造の処理速度そのものを直接測定するのではなく、すべての場合において、タイミングにはファイルをオペレーティングシステムのファイルシステムに書き込む時間も含まれることに注意してください。これは回避できない要因です。なぜなら、|PyMuPDF|" " 以外のツールでは、例えばイメージの **作成** ステップと、イメージをファイルに **書き込む** " "後続のステップを分離するオプションが提供されていないためです。" @@ -435,11 +435,11 @@ msgstr "使用されるツール" #: ../../app4.rst:133 219d589c98e946219baf738ac0403616 msgid "" -"In each section, the same fixed set of :title:`PDF` files is being " +"In each section, the same fixed set of |PDF| files is being " "processed by a set of tools. The set of tools used per performance aspect" " however varies, depending on the supported tool features." msgstr "" -"各セクションでは、同じ固定されたセットの :title:`PDF` " +"各セクションでは、同じ固定されたセットの |PDF| " "ファイルが一連のツールによって処理されます。ただし、性能の側面ごとに使用されるツールのセットは、サポートされるツールの機能に応じて異なります。" #: ../../app4.rst:135 ad5b106d9d4d49fca12efdd52cfeb24d @@ -461,7 +461,7 @@ msgstr "説明" #: ../../app4.rst:143 ../../app4.rst:172 ../../app4.rst:368 #: 3428180373e8445eabe26f9ce8d67353 8f38222c05a145e6a1e887f8d37b78c6 #: 90d20f28c9964670811ef58cff20808e -msgid ":title:`PyMuPDF`" +msgid "|PyMuPDF|" msgstr "" #: ../../app4.rst:144 fd8df1c7718447729103820cdbf3e85c @@ -493,8 +493,8 @@ msgid "PDFMiner_" msgstr "" #: ../../app4.rst:150 aa445565c33446238c181df3eb7c3660 -msgid "A pure :title:`Python` to extract text and other data from :title:`PDF`." -msgstr ":title:`PDF` からテキストやその他のデータを抽出するための純粋な :title:`Python` ツールです。" +msgid "A pure :title:`Python` to extract text and other data from |PDF|." +msgstr "|PDF| からテキストやその他のデータを抽出するための純粋な :title:`Python` ツールです。" #: ../../app4.rst:151 058b23f57d454765a50f6665dfee540e msgid "XPDF_" @@ -522,9 +522,9 @@ msgstr "" #: ../../app4.rst:156 959d755f2de44163b578a87be30993c0 msgid "" -"A :title:`Python` package specialized on rendering :title:`PDF` pages to " +"A :title:`Python` package specialized on rendering |PDF| pages to " ":title:`JPG` images." -msgstr ":title:`PDF` ページを :title:`JPG` 画像にレンダリングすることに特化した :title:`Python` パッケージです。" +msgstr "|PDF| ページを :title:`JPG` 画像にレンダリングすることに特化した :title:`Python` パッケージです。" #: ../../app4.rst:164 ff6e5dd3df614a07a7dfc154fcd9db95 msgid "Copying / Joining / Merging" @@ -532,24 +532,24 @@ msgstr "コピー / 結合 / マージ" #: ../../app4.rst:166 77ec351e142d49cf9fe7d1a219ece8c4 msgid "" -"How fast is a :title:`PDF` file read and its content parsed for further " +"How fast is a |PDF| file read and its content parsed for further " "processing? The sheer parsing performance cannot directly be compared, " "because batch utilities always execute a requested task completely, in " "one go, front to end. :title:`PDFrw` too, has a *lazy* strategy for " "parsing, meaning it only parses those parts of a document that are " "required in any moment." msgstr "" -":title:`PDF` " +"|PDF| " "ファイルの読み取りおよびそのコンテンツの解析は、どれだけ高速に行われるのでしょうか？純粋な解析の性能を直接比較することはできません。なぜなら、バッチユーティリティは常に要求されたタスクを一度に完全に実行するからです。" " :title:`PDFrw` も解析の際には *レイジー* な戦略を採用しており、必要な瞬間に必要な部分のみを解析します。" #: ../../app4.rst:168 99d1875072034e0a8a239e326eccc4f2 msgid "" "To find an answer to the question, we therefore measure the time to copy " -"a :title:`PDF` file to an output file with each tool, and do nothing " +"a |PDF| file to an output file with each tool, and do nothing " "else." msgstr "" -"したがって、この質問に答えるために、各ツールで :title:`PDF` " +"したがって、この質問に答えるために、各ツールで |PDF| " "ファイルを出力ファイルにコピーする時間を計測し、それ以外の操作は行いません。" #: ../../app4.rst:170 ../../app4.rst:365 0b5fce24efce4d4e861fac0a608e7267 @@ -580,8 +580,8 @@ msgstr "**観察結果**" #: e12eebe2e3cc47c086217676521e04e7 msgid "" "These are our run time findings in **seconds** along with a base rate " -"summary compared to :title:`PyMuPDF`:" -msgstr "以下は、実行時間の結果（ **秒単位**）と、 :title:`PyMuPDF` との比較における基本レートの要約です：" +"summary compared to |PyMuPDF|:" +msgstr "以下は、実行時間の結果（ **秒単位**）と、 |PyMuPDF| との比較における基本レートの要約です：" #: ../../app4.rst:218 ../../app4.rst:296 ../../app4.rst:408 #: 1076732c4650415d9ae9712245ce04d6 4bf8949048cd4b0f8b92915d0b57b775 @@ -1002,10 +1002,10 @@ msgstr "ページのレンダリング" #: ../../app4.rst:362 ea2f8df7d39645c4bb770f5cd16724e5 msgid "" -"We have tested rendering speed of :title:`PyMuPDF` against " +"We have tested rendering speed of |PyMuPDF| against " ":title:`pdf2jpg` and :title:`XPDF` at a resolution of 150 DPI," msgstr "" -"私たちは、解像度150 DPIで :title:`PyMuPDF` のレンダリング速度を :title:`pdf2jpg` と " +"私たちは、解像度150 DPIで |PyMuPDF| のレンダリング速度を :title:`pdf2jpg` と " ":title:`XPDF` と比較しました。" #: ../../app4.rst:382 c05749a2902448aa82540c72fe24e9ea diff --git a/docs/locales/ja/LC_MESSAGES/document-writer-class.mo b/docs/locales/ja/LC_MESSAGES/document-writer-class.mo index 858157158e90ca2f3b3af2b57a3538685ced7a91..a871b56a997ceff716defefb4a187c52339ac785 100644 GIT binary patch delta 354 zcmXBQze_?<7>Dt%*B_arrUo`O)X*Td+90@;G!)*Z1ZiqXXbO~+iw5=ww0I3{tU(8t zOGvaSL4%D!(3&*n;1)s8rRj6d%Nd^cbW+{a^;z>o(y331-~=o9fh|1rOKE(=ZS)4D zI%YA0LoDDomNB;=tzi#0@dfX3hDo%8(moFG)+7A{)l`hZO-NeBKCa*x8$5VNH|S_d z`odS-!iTVQg`Zf&GWCx*LN~yQN>%LQ9mbcXT^!;u{^ApsVmY?wkc^8I=@M;J;(zlF q?s0v_DMqMse`JmqxbE~kBV*ArYX=o`CvQ3Dz74}LYfd|0ME?L8HZ+$2 delta 349 zcmWmAu}gwc6o&El`!E$r%?xsKad41Y6B}GK8VZGmTpAjL1jh`8(4qc-s8FKD6m*k2 zMNlLyw$|d-A`LmTh0xG*r{CpphUeVdR3~*&Z5>KF@<<_k!x~QT3=0d=8opy19j{c! z3~r#o0)Ar!H+@nZyO_jR?BWbp@zO8t-~jI&>DRB8A`GqrQVe^zg3s7w;R9{Z-lFt{ zV_e5!P&&s?EMb}Y2Yf;sP!CHd*ui@YElGJacz|v=?%MT&HaZTv%f`BhZf k#uuDofI2(>LHiSN(|1O$uh`hF6?0qW*pqP0jn@tT1MR6ZLjV8( diff --git a/docs/locales/ja/LC_MESSAGES/document-writer-class.po b/docs/locales/ja/LC_MESSAGES/document-writer-class.po index 423e08d7b..88bb5512b 100644 --- a/docs/locales/ja/LC_MESSAGES/document-writer-class.po +++ b/docs/locales/ja/LC_MESSAGES/document-writer-class.po @@ -46,14 +46,14 @@ msgstr "バージョン1.21.0で導入" #: ../../document-writer-class.rst:11 080f3b240df14f778d3ada6e1fc8d539 msgid "" "This class represents a utility which can output various :ref:`document " -"types supported by MuPDF`." +"types supported by PyMuPDF`." msgstr "" "このクラスは、MuPDFで :ref:`サポートされている ` " "さまざまなドキュメントタイプを出力できるユーティリティを表します。" #: ../../document-writer-class.rst:13 4b8c1501568f4c2db58d84c078efe5df msgid "" -"In PyMuPDF only used for outputting PDF documents whose pages are " +"In |PyMuPDF| only used for outputting PDF documents whose pages are " "populated by :ref:`Story` DOMs." msgstr "" "PyMuPDFでは、:ref:`Story` " diff --git a/docs/locales/ja/LC_MESSAGES/how-to-open-a-file.mo b/docs/locales/ja/LC_MESSAGES/how-to-open-a-file.mo index 11970d27130871c4fc866db949874a383528950f..d9e176f4cce55722195d1da77fc59d48f44fae9f 100644 GIT binary patch delta 829 zcmYk&O=uHA6bJCPar0?n(oOo|2ROA9LDU8>q9TG6!O}{=f{Fzjl1&q7vSG7PlwimP z#hc(*KPm`90xdRGyBEcqltSxKD&j%Gtp^W9@#4XY|8zq(3&U^b&Fp(`=3ewswER^P zX9(X;j6E0|%|*wzAQ1VmZon__4Ll9GgUACvK?#0?7vLWlha=mN4`&zP09+M`0*G%q ziMruG7$z!Hm&*za!d`5gfFtlcEW&573L|a|_!#bo4R{o;!+sb*H$!j;zJgcaTNDm? ziJrhU+yYZd`mKg?P(^*ZkG9YxId>54hF*9V4#EUngp)`h1yLLpLRQ0mT>Aj__rX3m z26w>}Y`$itwf_`e!+HhQ;7MFN3cthAX2)S%D-9>%DYy!oFW|*H{e|Oj4TVR0@a$*B zthW@qF;I@A&Ixb^KRW}ldMjyp?RXT7euz}Ac?|v(y zs4Oe1Q<>ZpyPna~OwrP^iY%yM)IFaCenjjEvbZX&TiX~9j^sr-8U=n2f+zDz7(1e__DNVM~vyN zO9EdC&$e!LF><>#`xzOqW=3E4IfwlRj|GQ$s(1ciyEZc`FRg~y#=H8D+C#IlXjW%T c{kf^v%<2nM*Lhvq+mWK||7EX?TY>k&f65)fRR910 delta 854 zcmZwDJ!lhQ9LMqhC8=pjw7Dit8`I&cgHSB4>Z8FRP?M><40@ig|}EDp2oDjp@jS|f5C zH--P!8*+ipS_)5D)r(Dxc9-2?K z7K}-A!l@Q(_7?RsFznx8bMUNM41L?$w#KxKYSAiHY9-@j#V#ABT`pQi>lAmnJ8O{5rH=}v~bT{37SW{o){c7jBB~_2zY=3@S VKi6KE(>Jyi+?V?PfGQ;J{Q=Eh$D#lL diff --git a/docs/locales/ja/LC_MESSAGES/how-to-open-a-file.po b/docs/locales/ja/LC_MESSAGES/how-to-open-a-file.po index ff5171dbd..a899b7927 100644 --- a/docs/locales/ja/LC_MESSAGES/how-to-open-a-file.po +++ b/docs/locales/ja/LC_MESSAGES/how-to-open-a-file.po @@ -43,9 +43,13 @@ msgstr "ファイルを開く" msgid "Supported File Types" msgstr "サポートされているファイルタイプ" +msgid "|PyMuPDF| can open files other than just |PDF|." +msgstr "|PyMuPDF| は |PDF| 以外のファイルも開くことができます。" + + #: ../../how-to-open-a-file.rst:18 960f8812128e4242a5224e9dbbf7d2ee -msgid ":title:`PyMuPDF` supports the following file types:" -msgstr ":title:`PyMuPDF` は以下のファイルタイプをサポートしています：" +msgid "The following file types are supported:" +msgstr "|PyMuPDF| は以下のファイルタイプをサポートしています：" #: ../../how-to-open-a-file.rst:25 4042ae18a49a41039f3dd338c0e1d7e1 msgid "How to Open a File" @@ -71,7 +75,7 @@ msgstr "例えば *\"some.file\"* が実際には **XPS** ファイルの場合 #: ../../how-to-open-a-file.rst:50 d9c808a1a9d843268d70ab08f3c77446 msgid "" -":title:`PyMuPDF` itself does not try to determine the file type from the " +"|PyMuPDF| itself does not try to determine the file type from the " "file contents. **You** are responsible for supplying the file type " "information in some way -- either implicitly, via the file extension, or " "explicitly as shown with the `filetype` parameter. There are pure " @@ -79,7 +83,7 @@ msgid "" "`_ that help you doing this. Also " "consult the :ref:`Document` chapter for a full description." msgstr "" -":title:`PyMuPDF` " +"|PyMuPDF| " "自体は、ファイルの内容からファイルタイプを判断しようとはしません。このため、ユーザーがファイルの拡張子などを通じて暗黙的に、または " "`filetype `_ " "パラメーターを通じて明示的にファイルタイプの情報を提供する責任があります。また、詳細な説明については :ref:`Document` " @@ -87,19 +91,19 @@ msgstr "" #: ../../how-to-open-a-file.rst:52 74eacc79c13f4814a08c67869dd2b6b2 msgid "" -"If :title:`PyMuPDF` encounters a file with an unknown / missing " -"extension, it will try to open it as a :title:`PDF`. So in these cases " +"If |PyMuPDF| encounters a file with an unknown / missing " +"extension, it will try to open it as a |PDF|. So in these cases " "there is no need for additional precautions. Similarly, for memory " "documents, you can just specify `doc=fitz.open(stream=mem_area)` to open " -"it as a :title:`PDF` document." +"it as a |PDF| document." msgstr "" -":title:`PyMuPDF` " +"|PyMuPDF| " "は不明なファイルや拡張子のないファイルはPDFとして開きます。このため、これらの場合は追加の情報は必要ありません。同様に、メモリ上のドキュメントの場合は、`doc=fitz.open(stream=mem_area)`" " と指定するだけでPDFドキュメントとして開くことができます。" #: ../../how-to-open-a-file.rst:54 ed99896a4b384a7fb065d400b4959d87 msgid "" -"If you attempt to open an unsupported file then :title:`PyMuPDF` will " +"If you attempt to open an unsupported file then |PyMuPDF| will " "throw a file data error." msgstr "サポートされていないファイルを開こうとした場合、PyMuPDFはファイルデータエラーをスローします。" @@ -109,11 +113,11 @@ msgstr "ファイルをテキストとして開く" #: ../../how-to-open-a-file.rst:64 a96ee67240d6467c908b8c4d5d2848e9 msgid "" -":title:`PyMuPDF` has the capability to open any plain text file as a " +"|PyMuPDF| has the capability to open any plain text file as a " "document. In order to do this you should provide the `filetype` parameter" " for the `fitz.open` function as `\"txt\"`." msgstr "" -":title:`PyMuPDF` には、プレーン テキスト ファイルをドキュメントとして開く機能があります。 " +"|PyMuPDF| には、プレーン テキスト ファイルをドキュメントとして開く機能があります。 " "これを行うには、`fitz.open` 関数の `filetype` パラメータを「txt」として指定する必要があります。" #: ../../how-to-open-a-file.rst:71 8b3cacc79e98462190f1a8841c706752 @@ -121,12 +125,12 @@ msgid "" "In this way you are able to open a variety of file types and perform the " "typical **non-PDF** specific features like text searching, text " "extracting and page rendering. Obviously, once you have rendered your " -"`txt` content, then saving as :title:`PDF` or merging with other " -":title:`PDF` files is no problem." +"`txt` content, then saving as |PDF| or merging with other " +"|PDF| files is no problem." msgstr "" -"このようにして、さまざまな種類のファイルを開いて、テキスト検索、テキスト抽出、ページ レンダリングなどの :title:`PDF` " -"に固有ではない一般的な機能を実行できます。 明らかに、txt コンテンツをレンダリングしたら、 :title:`PDF` として保存したり、他の " -":title:`PDF` ファイルと結合したりすることは問題ありません。" +"このようにして、さまざまな種類のファイルを開いて、テキスト検索、テキスト抽出、ページ レンダリングなどの |PDF| " +"に固有ではない一般的な機能を実行できます。 明らかに、txt コンテンツをレンダリングしたら、 |PDF| として保存したり、他の " +"|PDF| ファイルと結合したりすることは問題ありません。" #: ../../how-to-open-a-file.rst:75 ad904a19565a4d76813a4a93b547a6f8 msgid "Examples" @@ -151,11 +155,11 @@ msgstr "等々！" #: ../../how-to-open-a-file.rst:105 abfb5032a0fe4185ab4510d22f93a87d msgid "" "As you can imagine many text based file formats can be *very simply " -"opened* and *interpreted* by :title:`PyMuPDF`. This can make data " +"opened* and *interpreted* by |PyMuPDF|. This can make data " "analysis and extraction for a wide range of previously unavailable files " "suddenly possible." msgstr "" -"ご想像のとおり、多くのテキスト ベースのファイル形式は、:title:`PyMuPDF` によって非常に簡単に開いて解釈できます。 " +"ご想像のとおり、多くのテキスト ベースのファイル形式は、|PyMuPDF| によって非常に簡単に開いて解釈できます。 " "これにより、これまで利用できなかった広範囲のファイルのデータ分析と抽出が突然可能になります。" #: ../../footer.rst:71 ffe59a87a06749ba91ebe842e97511d8 diff --git a/docs/locales/ja/LC_MESSAGES/index.mo b/docs/locales/ja/LC_MESSAGES/index.mo index 072e59ec51084b8966af8678f1c2d7801d2204be..04c18347df489769bdb3d99cd18208458a85d6df 100644 GIT binary patch delta 349 zcmYMuze@sP9LMp`-JPU#hdaEMFvgSMIsB5Dd;TBD&rA#$(_ge#Mb7KP%VrXoma ziU_BM=EnYlXprV6_ukiVO|R$sw)4|m^bHcTzS>HSE?jMD~Q6vFZ(tfPr{CK{R?)@K>q*$ delta 380 zcmZY2ze@sf9LDkI^t4hBBG7`CLvIj_rl62;ikbrd1RDYchrk~oDCg185J7O!5D1n< zG(^L#MPp-gLzA@oAJqE@9CUhpzt88__v+c&rQ=>nvJB}Q@6f`{h*ZE`bg+skyucXV zU<-$MikYZ13Ul1Xk|`yyjYITs9kUGgxKYA){;zSldf?GrkkVnp;{Spj+~9wLVLrem z46u!Fc#m6zpZJAUeBx@@zmk+bFpn9Wpo+~}vwmExlskv5^4@;Mt~Kl<-!c2kvlai@ p>;{(c8=0#F`Iu|uX8Y~2_cHE#)0pM{ZDKGt?H?qsgU9$!^bcmsOuYaA diff --git a/docs/locales/ja/LC_MESSAGES/index.po b/docs/locales/ja/LC_MESSAGES/index.po index 5e2f1ec7d..78562cfc5 100644 --- a/docs/locales/ja/LC_MESSAGES/index.po +++ b/docs/locales/ja/LC_MESSAGES/index.po @@ -56,25 +56,25 @@ msgid "" msgstr "PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript" #: ../../index.rst:7 f9040b7772c0447b9debc9abdd7847e8 -msgid "Welcome to :title:`PyMuPDF`" +msgid "Welcome to |PyMuPDF|" msgstr "PyMuPDFへようこそ" #: ../../index.rst:9 0f762acb014144889cbd1b876a7e35d0 msgid "" -":title:`PyMuPDF` is a high-performance **Python** library for data " +"|PyMuPDF| is a high-performance **Python** library for data " "extraction, analysis, conversion & manipulation of **PDF** (and other) " "documents." msgstr "" -":title:`PyMuPDF` は、:title:`PDF` （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な " +"|PyMuPDF| は、|PDF| （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な " ":title:`Python` ライブラリです。" #: ../../index.rst:11 2fb9858fab404f8cb63595ad0ec31fff msgid "" -":title:`PyMuPDF` is hosted on `GitHub " +"|PyMuPDF| is hosted on `GitHub " "`_ and registered on `PyPI " "`_." msgstr "" -":title:`PyMuPDF` は `GitHub `_ " +"|PyMuPDF| は `GitHub `_ " "でホストされ、`PyPI `_ に登録されています。" #: ../../footer.rst:71 ../../index.rst:15 423054fc947e4f6f94e78ef0acda51c4 diff --git a/docs/locales/ja/LC_MESSAGES/recipes-common-issues-and-their-solutions.mo b/docs/locales/ja/LC_MESSAGES/recipes-common-issues-and-their-solutions.mo index d8d8f625e5420a3fd5647e17a2963bfbf6e4bc56..6145aa5edec4c8efd82142e2fe42b38072a4023f 100644 GIT binary patch delta 1188 zcmYMzYfQ~?9LMp`X+%qxQ&H(62~k9nj_DMVYZoC=$kHZF7Zx++Y=xK%JI!UwVtLTq zTAj6d&_;6EXgz6T^T6CzdZ6tzW7=Haf9GsHIj`UMcm4jp=l5@WW*X}=UGBF%mel7j zEyV`26ocKEi0`l-eFCIByo|;884qJdp!5N|unFx!QV~W?mkwYZ=Hn;yHA$8k(mdh~ z!LD;EgJn|{9nEws!^t614O*}rJKS+Ws5FIm03+}XGNkWVj6O3-9xLz?j^RbD4|65x zAMRS`#HsZAv56OkMA*oNMl>DeSdN4E7Ng1dUZix0cwm;~L`#$uM1S0DDFM@?U5Ql9 zkybE%9=ov@jrqqZ=Nc@VD|O<1+=zQALl3swXk^kToi9B#Cg4Lhu8fuZF>;}lMSnt^ zbQJ55Gv&k<#)IP71UnZ=+vwk&z=6aMF%g|hq+I%A5~T%LgGK_aScIlaqoiQX_E&zQq2OQXn?3l2RFO z=Z8DkG(^KFQGk_)h&%8IhNelUu?da;)SS)@*x)v{62D$8oy2k$*Woa>VCh=v3iCWN zBrdP!b^LAk92@X2GDQuP{TS!#B@I6oSl3Gz7|7;97&m=~R9_#_xbZaVb`6v84))_0 ztllKGVg6=U>Bo_?l}cH?u-tM~ z;f?LmT*h#jBthN8}Po7-+zm;OX>uNbh%^hC$ zGvVib%PLArqbBA)2pe?xMtt*}SnlwSc@^qj|1mYqy*}Pr=wpAi<&L9q^IDUmBC9*- EAKjD3=l}o! delta 1236 zcmZY8ZA^`E7{~G7F_W{xDTj)P@>neL948N@luCt2H5twGbJ@&t-=Fuwi^}r`eiUpZ|6JpRfCW54KopTP@c+jF*yHY|=uk z2$Z7D7-Mk&FJMHFl#O?>5WnML%pEViLod3p-Y(_ik_pltyn#9R4aZufjET}L;(}ml z23`!7p<^`elURh4LZlMRzn)9Dj>zu0z*M=`p^-6g*EE%yI1ojU*bEXG_iI0DQ>8H|9t-TpJ~&lh5Y6 zoW$G6p0dxAs_9>b_4sy-6Vl3JhN}1%7W2L!Rh2{a8u?UR->TYgu0@+i~ z(Y#3?nkAgRSUS!^)+N#?;xkJn&ZrARKESiYUD(UGEGBa%#jT*4#Cy?;198%LY+NNJ z(%%(EG{5P(HQay&y0C`$=UNVf)zr5XLlS7?O{`$t zB6e9o{9?Vt8T1vMxPWpqL{IP(?@!-pjAO#lWa$bW1`oo#sXuk1`U*nx#ty8+BCNw- z_#W@1`bu85QK}_wOY`0E2xYYrdxmVnEMhO37YNOef($34vXR2rQPJCbNS`49L>jDwu9T_Ae#MsdD3r8&u6{( z5i|<;Pg%gV)A#%J6iRLe~q=Y@xLyPcD-c?QG!NB!69>5Xg)9kz`_ is used here as an example)." msgstr "" @@ -84,14 +84,14 @@ msgstr "" #: ../../recipes-common-issues-and-their-solutions.rst:55 #: e52b714c6c6b46c5bc62aa39464bf8e1 -msgid "How to Convert Any Document to :title:`PDF`" -msgstr "どの文書も :title:`PDF` に変換する方法" +msgid "How to Convert Any Document to |PDF|" +msgstr "どの文書も |PDF| に変換する方法" #: ../../recipes-common-issues-and-their-solutions.rst:57 #: 18886b00544b4c53a37a440876f291ec msgid "" -"Here is a script that converts any :title:`PyMuPDF` :ref:`supported " -"document` to a :title:`PDF`. These include XPS, " +"Here is a script that converts any |PyMuPDF| :ref:`supported " +"document` to a |PDF|. These include XPS, " "EPUB, FB2, CBZ and image formats, including multi-page TIFF images." msgstr "" "以下は、任意のPyMuPDFが :ref:`サポートされている ` " @@ -112,7 +112,7 @@ msgstr ":title:`MuPDF` から発行されるメッセージの処理方法" #: ../../recipes-common-issues-and-their-solutions.rst:133 #: 14fa73535a414beda886330315639d3a msgid "" -"Since :title:`PyMuPDF` v1.16.0, **error messages** issued by the " +"Since |PyMuPDF| v1.16.0, **error messages** issued by the " "underlying :title:`MuPDF` library are being redirected to the Python " "standard device *sys.stderr*. So you can handle them like any other " "output going to this devices." diff --git a/docs/locales/ja/LC_MESSAGES/recipes-multiprocessing.mo b/docs/locales/ja/LC_MESSAGES/recipes-multiprocessing.mo index dc540fdae3b9edf6b555488c105923e99de345a7..baa79e61943cb8621cf54dd5043164cf78d9f3ad 100644 GIT binary patch delta 226 zcmZ1})hjhYr~Wnr1H(HYUJAsg7#SE+fOG*91H&O8eHBRa1L+ye3=E|}dIgYf2GVjY z3=HN#dJ&M$1=6>G^cS7a;#B8v{cOkgvtgz;F=AZ|7iOs0PxWoD2*+K=GqM zS`Ns+#08|vfQ*k^3=B(vbOtvN18H6!28L-sx@_Xf&zv;@mA<6`E^alG&oFi)c$?Fi S+L@5J|5$q25!}hMdHMh_ATKun delta 254 zcmeB`S}8R_r~VNG1H(HYUIWAz85tN-fOH)b1H&O8{TN8|1LcHCoC`>m0U2!E3=B(vbS;q10Mbf43=DIDboa!Qp9QQ+GD~t&tr7w%eM^idT<@ZZAR#FtSKLI%gSbhfjpj8SiD%@t z3^fr34e_X6MwuxpjG3Yn)tH+4V0xQUreh{LouSjw|IRt5U;62{*FJmiwa;GroX6KJ zyRKRq)2re{B-vYJAQoW=R^xDN#tyuI8MwtqgSR!K(#=dumG zIDZeia5sLyxvfXPV38+SjTdn(_4)y=p&}8i^8()@4%S3gU^K2W$G@fG;MvM@dg_)Ru2T;SiXv05o5+;q*pKri8;xBMA{)EXG7^#;q9my$`s1i0K zspL9NBfmVR@e3U>JZ(Wg3jdNfIgMM0k4K68h)L1x8vDiQC5S?Gu5GSkKyE(4jSsVcN-2*6lo%!hRd)MCty7F zQ41AfJ=S9e8}c8|MIz3p@JoA<0M`(|WRe>1;B{3=YH$Z$!p)d6k@F9r(Mh8LpW+M_ zEMs&z@kI)K7{^gqwa`6OZ_tgZB)%MviXUPnzQA2rZqrY|XDVM5aWrOP2ex4pg@1*e z(>Q-G)tF8#Nc;dhF=VEGOP_NSZ}9x!Y~FzW0zUE!#7F1wmY6eFB$fVGc#AmoJuWkG zPzoEuxvBh|=)WQ;+MDp zvookCeu=6-VX?^jxW}*?mlLP3SQ)mVS~r|yP%8}WS%CGO5~M|%ylxa{7`w92#@vnplk zs#OKW`I^00D=4z(J2YpBX4fCNo_a6p(=*6D*C*mNz3Hm(wT9_4XI3~%?YU0P>8NmO zd8H*q=0x{R-vt(9=BWPH&E^Zgt(IXuQ?|S%}Eae zJ~x|nfoIJD(}QZw{oDx+Fm~1*dd+BE4U5-XP1-(VA4j#x<_wE9*wr$k&%pn`u{(O? zW+R(Rjk+HhY^-RpMi>jlS}*sG=-KgDZB|LC=BTh2tt;f4T2kO#&8uuoDO2a_3XPd# z%-s-kKSY1+nZ>!K8`n7tN{ThBHp5{C?s=nc_Hrf1Ru~hm#7^|mC%Eop40UU9<-Lt3 zhZ4sat)CM^%rV&)UI?(Up&i+<5m W*KhmwbnQIfwQVzhHWJxrN7S0i#_Ta>+B9X;=m+vfnxkXWV>B)6e>zOE`ND7SbwBaCZKr?;_!|)t_hc__?&-NAh5{LPSyo=XyD<0@4G6chYMM5wU z`(ri+qYeGB0!QOcUvY}Ypp8Hzp2uzY8_vXyej;P>BQz7cj`?^WeLX~$u)3LGA*;4B zuR-&>i2)>sl{gWbunfPzWjJ-9l}PhIr^s9atptKt;2y4L9uR0HQjO-u{RUen7>Uiy z6L0{2h30}CxCE1ftP1SI=b68QDL9$3Y{m*afxjcgk~SxGxy|4N7LdRj)UA@a59#m1 zYP^Ag!$lhL0j|ZpBdoahNRjuL|B4-WWR%Dx*4Z73%sCZU;e1E%BguIKl$FB^o7 z;}pcB##^mu#J`zWO%OSSPReF}KRI56ZpdP!d$PG}-iRUWFDDpqNV$mQB6rce^+1=ca&i#a3|LBko!vy-`uo?JeBnz{c}>))*c&6c#_ZtOtk4hCg3 zJP7Y#4fdz8Ggz<*H!#04P2?bECtDleMe{_1Q$)VOc;w!S&vfhZjz+U(uVNUEr@x0V z8yDiA*oN~{ssBF=9*|Za(;4){L!@__$hVkI-OXD%f`97I@EoQRZ>aTOVFQ){@o*+<5#0 z9hi|L@&ca073TaY5!R4n=t3`EHsjT}7;ki$#&K6N-;b5pdy(~f;X-qtA8ZWFg<|-M zWW|YF@B*5Z$XFusG4tJAfPKUwcjT_A}#*49%H*N ztF0<3wy%>6dwHRmbN5F^O2Bh!QpTCUmL3bP2-?>p;uUmj*Cj@1vpt;ksa-+f7q znx*cuC+d4+XY@JGi0(^i?y9$cYHsSRJK4Fb(Oq@8^TSqatj~+BP`|$zJ5>o71LEp> zDG~kki7|maR=JQ+Z#XpSws69L-&;1dPaq!QPYpKW|s-G`Fka#}7_ld-1Tl>Ls_U ambSRJRz2)6zXoR8^kq3ijLQ5C9{&PRi&H!R diff --git a/docs/locales/ja/LC_MESSAGES/the-basics.po b/docs/locales/ja/LC_MESSAGES/the-basics.po index 6763aab29..99177471b 100644 --- a/docs/locales/ja/LC_MESSAGES/the-basics.po +++ b/docs/locales/ja/LC_MESSAGES/the-basics.po @@ -71,12 +71,12 @@ msgstr "" ":ref:`ファイルを開く方法ガイド` のリストを参照してください。" #: ../../the-basics.rst:42 258611bb78d846559294973447eaacea -msgid "Extract text from a :title:`PDF`" -msgstr ":title:`PDF` からテキストを抽出する" +msgid "Extract text from a |PDF|" +msgstr "|PDF| からテキストを抽出する" #: ../../the-basics.rst:44 ff421cb1fd78478f989932a177590f12 -msgid "To extract all the text from a :title:`PDF` file, do the following:" -msgstr ":title:`PDF` ファイルからすべてのテキストを抽出するには、以下の手順を実行してください：" +msgid "To extract all the text from a |PDF| file, do the following:" +msgstr "|PDF| ファイルからすべてのテキストを抽出するには、以下の手順を実行してください：" #: ../../the-basics.rst:66 ../../the-basics.rst:117 #: b3d57d84a021459aa27f5bc4e4b2b3f5 dd8bfd24b7154014a8c674177de5eb95 @@ -112,12 +112,12 @@ msgid ":meth:`Page.get_text`" msgstr ":meth:`Page.get_text`" #: ../../the-basics.rst:78 634b246be4154aa19de3533c78b77265 -msgid "Extract images from a :title:`PDF`" -msgstr ":title:`PDF` から画像を抽出する" +msgid "Extract images from a |PDF|" +msgstr "|PDF| から画像を抽出する" #: ../../the-basics.rst:80 d4268a3a86304f338781d63780e78c3f -msgid "To extract all the images from a :title:`PDF` file, do the following:" -msgstr ":title:`PDF` すべての画像を抽出するには、以下の手順を実行してください：" +msgid "To extract all the images from a |PDF| file, do the following:" +msgstr "|PDF| すべての画像を抽出するには、以下の手順を実行してください：" #: ../../the-basics.rst:121 fc6da4e40f6b420abd83a90907350206 msgid ":meth:`Page.get_images`" @@ -128,21 +128,21 @@ msgid ":ref:`Pixmap`" msgstr "" #: ../../the-basics.rst:132 c789a706489741c9bb804932692ba777 -msgid "Merging :title:`PDF` files" -msgstr ":title:`PDF` ファイルの結合" +msgid "Merging |PDF| files" +msgstr "|PDF| ファイルの結合" #: ../../the-basics.rst:134 db1e3b27e20843e5a7bea38dde5b6b95 -msgid "To merge :title:`PDF` files, do the following:" -msgstr ":title:`PDF` ファイルを結合するには、以下の手順を実行してください：" +msgid "To merge |PDF| files, do the following:" +msgstr "|PDF| ファイルを結合するには、以下の手順を実行してください：" #: ../../the-basics.rst:152 b1dcef5e5a1141af8ae02f1d177d1787 -msgid "Merging :title:`PDF` files with other types of file" -msgstr ":title:`PDF` ァイルと他の種類のファイルを結合する" +msgid "Merging |PDF| files with other types of file" +msgstr "|PDF| ァイルと他の種類のファイルを結合する" #: ../../the-basics.rst:154 745e5ce6d4c7470fb5a861ab95d1596d msgid "" "With :meth:`Document.insert_file` you can invoke the method to merge " -":ref:`supported files` with :title:`PDF`. For " +":ref:`supported files` with |PDF|. For " "example:" msgstr "" ":meth:`Document.insert_file` " @@ -151,7 +151,7 @@ msgstr "" #: ../../the-basics.rst:176 b80ef684aba44ceab64cd0261fcb4ed5 msgid "" "It is easy to join PDFs with :meth:`Document.insert_pdf` & " -":meth:`Document.insert_file`. Given open :title:`PDF` documents, you can " +":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 " @@ -195,17 +195,17 @@ msgid "" msgstr "" #: ../../the-basics.rst:204 6d7efa6aa21b4d94a3062a6b9ac7950b -msgid "Adding a watermark to a :title:`PDF`" -msgstr ":title:`PDF` ファイルにウォータマークを追加する方法" +msgid "Adding a watermark to a |PDF|" +msgstr "|PDF| ファイルにウォータマークを追加する方法" #: ../../the-basics.rst:206 02ac08cff2a54e4ab9b99b7a1542ab31 -msgid "To add a watermark to a :title:`PDF` file, do the following:" -msgstr ":title:`PDF` ファイルにウォータマークを追加するには、以下の手順を実行してください:" +msgid "To add a watermark to a |PDF| file, do the following:" +msgstr "|PDF| ファイルにウォータマークを追加するには、以下の手順を実行してください:" #: ../../the-basics.rst:230 45b06db8d1c64986ae82f16f17e771e0 msgid "" "Adding watermarks is essentially as simple as adding an image at the base" -" of each :title:`PDF` page. You should ensure that the image has the " +" 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." msgstr "ウォータマークを追加することは、基本的には各PDFページの底辺に画像を追加するだけです。画像が必要な透明度とアスペクト比を持っていることを確認して、必要な見た目になるようにします。" @@ -229,12 +229,12 @@ msgid ":meth:`Page.insert_image`" msgstr "" #: ../../the-basics.rst:246 0f1ff04214a646759e40209d1a69c71b -msgid "Adding an image to a :title:`PDF`" -msgstr ":title:`PDF` に画像を追加する" +msgid "Adding an image to a |PDF|" +msgstr "|PDF| に画像を追加する" #: ../../the-basics.rst:248 26f8b6bf4b7444039d3d82ba14fa2ac6 msgid "" -"To add an image to a :title:`PDF` file, for example a logo, do the " +"To add an image to a |PDF| file, for example a logo, do the " "following:" msgstr "PDFファイルに画像を追加するためには、例えばロゴを追加する場合、以下の手順を実行してください：" @@ -252,8 +252,8 @@ msgid ":ref:`Rect`" msgstr "" #: ../../the-basics.rst:286 0318ee4d3ab744cf96c2c2380e2bbea7 -msgid "Rotating a :title:`PDF`" -msgstr ":title:`PDF` を回転させる" +msgid "Rotating a |PDF|" +msgstr "|PDF| を回転させる" #: ../../the-basics.rst:288 0dcf12d54f1b4b29823afa6e3ad42ce6 msgid "To add a rotation to a page, do the following:" @@ -264,8 +264,8 @@ msgid ":meth:`Page.set_rotation`" msgstr "" #: ../../the-basics.rst:316 fcbc73878a054f8887e545db214b3812 -msgid "Cropping a :title:`PDF`" -msgstr ":title:`PDF` のトリミング" +msgid "Cropping a |PDF|" +msgstr "|PDF| のトリミング" #: ../../the-basics.rst:318 115c51b5a54849a093cb3693ea5a5f6e msgid "To crop a page to a defined :ref:`Rect`, do the following:" @@ -405,12 +405,12 @@ msgstr "ページを選択するには、以下の手順を実行してくださ #: ../../the-basics.rst:570 af4d93006de2455290ac661e13059bc4 msgid "" -"With :title:`PyMuPDF` you have all options to copy, move, delete or re-" -"arrange the pages of a :title:`PDF`. Intuitive methods exist that allow " +"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." msgstr "" -":title:`PyMuPDF` を使用すると、 :title:`PDF` " +"|PyMuPDF| を使用すると、 |PDF| " "のページをコピー、移動、削除、または再配置するためのオプションがすべて揃っています。 :meth:`Document.copy_page` " "メソッドのように、ページ単位で直感的なメソッドを使用してこれらの操作を行うことができます。" @@ -499,9 +499,9 @@ msgstr "" #: ../../the-basics.rst:688 62146317c0754859b8c82b6e8af2b773 msgid "" -"Here is a 3-liner that creates a :title:`PDF`: with one empty page. Its " +"Here is a 3-liner that creates a |PDF|: with one empty page. Its " "file size is 460 bytes:" -msgstr "以下は、1ページの空白の :title:`PDF`: を作成するための3行のコードです。ファイルサイズは460バイトです。" +msgstr "以下は、1ページの空白の |PDF|: を作成するための3行のコードです。ファイルサイズは460バイトです。" #: ../../the-basics.rst:702 271d6578fd87486a92afeaf6a5ae5b98 msgid ":meth:`Document.new_page`" @@ -545,16 +545,16 @@ msgstr "単一のページを分割する" #: ../../the-basics.rst:757 c2ec32b3ed0f4beaadc678d58b031b95 msgid "" -"This deals with splitting up pages of a :title:`PDF` in arbitrary pieces." -" For example, you may have a :title:`PDF` with *Letter* format pages " +"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 :title:`PDF` page in" +" split up in 4 pieces which each going to a separate |PDF| page in" " *Letter* format again." msgstr "" -"この方法は、 :title:`PDF` のページを任意の部分に分割することに関連しています。例えば、Letterフォーマットのページを含む " -":title:`PDF` " +"この方法は、 |PDF| のページを任意の部分に分割することに関連しています。例えば、Letterフォーマットのページを含む " +"|PDF| " "を、4倍の拡大率で印刷したい場合を考えてみましょう。各ページは4つの部分に分割され、それぞれが再びLetterフォーマットの個別の " -":title:`PDF` ページになります。" +"|PDF| ページになります。" #: ../../the-basics.rst:804 ../../the-basics.rst:865 #: 3face91ae7be401a8338c6416bce0bdb 5a64cc0e85564399b59366f94f9de467 @@ -577,21 +577,21 @@ msgstr "単一のページを結合する" #: ../../the-basics.rst:825 99df05f828104d299698c38facf17b84 msgid "" -"This deals with joining :title:`PDF` pages to form a new :title:`PDF` " +"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." msgstr "" -"これは、2つまたは4つの元のページを組み合わせた新しい :title:`PDF` " +"これは、2つまたは4つの元のページを組み合わせた新しい |PDF| " "を作成することを意味します（または「2-up」、「4-up」などとも呼ばれます）。これは、ブックレットやサムネイルのような概要を作成するために使用できます。" #: ../../the-basics.rst:884 ebe10de0298e43a581f99535c768ad49 -msgid ":title:`PDF` Encryption & Decryption" -msgstr ":title:`PDF` の暗号化と復号化" +msgid "|PDF| Encryption & Decryption" +msgstr "|PDF| の暗号化と復号化" #: ../../the-basics.rst:887 f244ce11d2f247cb83229d2ce86c3eb8 msgid "" -"Starting with version 1.16.0, :title:`PDF` decryption and encryption " +"Starting with version 1.16.0, |PDF| decryption and encryption " "(using passwords) are fully supported. You can do the following:" msgstr "バージョン1.16.0から、PDFの暗号化と復号化（パスワードを使用）が完全にサポートされています。以下のことができます：" @@ -642,7 +642,7 @@ msgstr "オーナーパスワード：パスワードを変更したり、暗号 #: ../../the-basics.rst:901 ecbc0559737c44709ba23cf8b5a39f51 msgid "" "The **user password** provides access to document content according to " -"the established permission details. If present, opening the :title:`PDF` " +"the established permission details. If present, opening the |PDF| " "in a viewer will require providing it." msgstr "ユーザーパスワード：文書の内容にアクセスするための権限詳細に基づいてアクセスを提供します。存在する場合、ビューアでPDFを開く際にユーザーパスワードを入力する必要があります。" @@ -654,12 +654,12 @@ msgstr "メソッド :meth:`Document.authenticate` は、使用されるパス #: ../../the-basics.rst:905 e4e12b31b47f473e812beb5fd01e6a8b msgid "" -"The following snippet creates a new :title:`PDF` and encrypts it with " +"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." msgstr "" -"以下のスニペットは新しい :title:`PDF` " +"以下のスニペットは新しい |PDF| " "を作成し、別々のユーザーパスワードとオーナーパスワードで暗号化します。印刷、コピー、注釈付けの権限が与えられますが、ユーザーパスワードで認証するユーザーに対しては変更は許可されません" #: ../../the-basics.rst:942 059a60808dab42bcaaf32bf2ed5e5566 @@ -769,8 +769,8 @@ msgstr "" #~ msgid "Supported File Types" #~ msgstr "サポートされているファイルタイプ" -#~ msgid ":title:`PyMuPDF` supports the following file types:" -#~ msgstr ":title:`PyMuPDF` は以下のファイルタイプをサポートしています：" +#~ msgid "|PyMuPDF| supports the following file types:" +#~ msgstr "|PyMuPDF| は以下のファイルタイプをサポートしています：" #~ msgid "" #~ "Opening with :index:`a Wrong File " @@ -788,17 +788,17 @@ msgstr "" #~ msgid "" #~ "There are many file types beyond " -#~ ":title:`PDF` which can be opened by " -#~ ":title:`PyMuPDF`, for more details see " +#~ "|PDF| which can be opened by " +#~ "|PyMuPDF|, for more details see " #~ "the list of :ref:`supported file " #~ "types`." #~ msgstr "" -#~ "「PyMuPDF」で開くことができるのは、:title:`PDF` " +#~ "「PyMuPDF」で開くことができるのは、|PDF| " #~ "に限らず、多くのファイルタイプがあります。詳細については、:ref:`サポートされているファイルタイプのリスト`" #~ " をご覧ください。" #~ msgid "" -#~ ":title:`PyMuPDF` itself does not try to" +#~ "|PyMuPDF| itself does not try to" #~ " determine the file type from the " #~ "file contents. **You** are responsible " #~ "for supplying the filetype info in " @@ -816,23 +816,23 @@ msgstr "" #~ "などの純粋なPythonパッケージがこのような操作をサポートしています。また、詳細な説明についてはドキュメントの章を参照してください。" #~ msgid "" -#~ "If :title:`PyMuPDF` encounters a file " +#~ "If |PyMuPDF| encounters a file " #~ "with an unknown / missing extension, " #~ "it will try to open it as a" -#~ " :title:`PDF`. So in these cases " +#~ " |PDF|. So in these cases " #~ "there is no need for additional " #~ "precautions. Similarly, for memory documents," #~ " you can just specify " #~ "`doc=fitz.open(stream=mem_area)` to open it as" -#~ " a :title:`PDF` document." +#~ " a |PDF| document." #~ msgstr "" -#~ ":title:`PyMuPDF` " +#~ "|PyMuPDF| " #~ "が不明な/欠落している拡張子のファイルに遭遇した場合、それをPDFとして開こうと試みます。したがって、これらの場合は追加の注意が必要ありません。同様に、メモリ上のドキュメントの場合は、`doc=fitz.open(stream=mem_area)`" #~ " と指定するだけでPDFドキュメントとして開くことができます" #~ msgid "" #~ "If you attempt to open an " -#~ "unsupported file then :title:`PyMuPDF` will" +#~ "unsupported file then |PyMuPDF| will" #~ " throw a file data error." #~ msgstr "サポートされていないファイルを開こうとした場合、PyMuPDFはファイルデータエラーをスローします。" diff --git a/docs/locales/ja/LC_MESSAGES/tutorial.mo b/docs/locales/ja/LC_MESSAGES/tutorial.mo index a032c1a8535dad1d166df9c7955d6139a332a961..d14971532470d8790a967b3ad593b53a20605c73 100644 GIT binary patch delta 1910 zcmX}sdrZ}39LMobhmcD(14T#>MNy2RVUkiHFfS+|w~Ce#;jO^R0Fe^8oEV51q!^W= z#wChNT8alvwni({jajqkGPjIPZH$%8z?qju>;3F;{c+Cg`F?-D^IX2q^PIz19c@<~ zM}BiS=SXskk)FYDd;quMQ`m!Z(KA+Bd51I)%ZMu%NfmetH{+H#DGdL_X7r1<{q-WR zXkvoYj;R<EJ$+N6_k(|An`j!U~jTihZoTgUrCXCu?EdV z_n;Yg_DU%W*C9VuADRWZrAk9sf@bAUGU`mcfwM3$oe#!4X-uY(jrU?9-iK8<1@~hB z9z`>eGZ=&ya2o!L(=jMR3dUG817)LGNG0BnhcFU9pX5cHgWB13U1MFc4<~pSQC-^-Eb6{vH_GxJt8_;akYpbN2=+6Or2Ys@o=dc6Y z7+>zsN~cJ4;so57BYERyG?j4Pwh0{!2!&m@bjfqfagDAg_FkoGU;w!>?xPNz+lL5!7>)*ix0kT4_`dC5MRP7#;dNPYQ*lc%8W zJN0cUXWn~P`jC9+9_d#cz+mj$YbSgf%>=*20KBt_Qf1MYMja`Fit%B*jx0vu`|J;n z;W-Alj4tx04oF{P>H9X0YnD=o$Iz5Ij;~cXggF@9%D*GNhsE?$(AUg589Yb+EM+h&>FSVPBwyQU@9$`rlutgo+g`gitRcRJU*Xn|rAAzI(EcTV zkEY~>hontdixf`In>3h=#xaEfT0Y?_5&!Y2bQl-#6^_H`i$0t%GoeuAX35cGJKTUp z#OKjWJnbkYroS-CHAtM$YtPoCW1I)#e57BenrWCl8bB``!HGDA5$NFLC14~zghd#I ztr&?vVF*t6jBAQ>(ezh@aoB)M@GK_bq!aeN9E{a`?lTS0CGE2#%oB?6qqYLg;qWdGf@kg9rmD^ z=nR?_{(>g))VcHHw2x{>HK&cU;*q>YUKUPR?sP~K{ekpAK|QUd+4 z>+B=lh=s)QuSzA@fp4M5Ytj(;RY&7TCP*sgEYZPJ@jOtuUiyl-8y8~<*{;&xw@C`c zU2jN5^bg{1#KC3K7~WSddC@&e$rFI^_~Z=n9S z=(tHEoQ^Av+)w3PXYsWHZ(sqYek}co2e6!ZTDv6nCQoZW0gat#&Mt!G zyYs*$yhuDs8O%;jej>e2fBPZ({@y(-@!l%+h<)vP@Lgi}qg-9wf^C@jsr{GyGn$gu z9ivLvj_zpPfBe6DC~wRp!EwxBV6vNPU1V^uh`BLG#AV17BQ-i8voEH2+-P7>&PT zCC?B E0ebvcX8-^I diff --git a/docs/locales/ja/LC_MESSAGES/tutorial.po b/docs/locales/ja/LC_MESSAGES/tutorial.po index bb4e9a098..57370dcdb 100644 --- a/docs/locales/ja/LC_MESSAGES/tutorial.po +++ b/docs/locales/ja/LC_MESSAGES/tutorial.po @@ -41,7 +41,7 @@ msgstr "チュートリアル" #: ../../tutorial.rst:11 1db8e9068f934af9a293843ffdb4bbe4 msgid "" -"This tutorial will show you the use of :title:`PyMuPDF`, :title:`MuPDF` " +"This tutorial will show you the use of |PyMuPDF|, :title:`MuPDF` " "in :title:`Python`, step by step." msgstr "このチュートリアルでは、PythonでのPyMuPDF、MuPDFのステップバイステップの使用方法を紹介します。" @@ -93,7 +93,7 @@ msgstr "" #: ../../tutorial.rst:37 94a769c214cb4082b8842e168cd476fe msgid "" -"So :title:`PyMuPDF` **cannot coexist** with packages named \"fitz\" in " +"So |PyMuPDF| **cannot coexist** with packages named \"fitz\" in " "the same Python environment." msgstr "したがって、PyMuPDFは同じPython環境で「fitz」という名前のパッケージと共存することはできません" diff --git a/docs/locales/ja/LC_MESSAGES/vars.mo b/docs/locales/ja/LC_MESSAGES/vars.mo index 6a4f9a44ec1900598d6c44a5115140c2c64a275a..00835ff4f505238b408cd01bbea266d8fe2f9239 100644 GIT binary patch delta 1365 zcmXZbO-NKx6u|K_Nv6p-CNt(_O=X#h)1XaOHh!i}g-A|`mO??4W@gwzOA%jC8}kdo zA*2tGB%_5Gq7X&PCR$jQwP_((Xr`M8Dx^jK(|a(?@7?p>z4zSn&YSDEeeSo7_1KJV z5pg(0GVw0PVFdZf2mYe)8*am8E1uvI$zhy^vo?`hT zaf-JIwKtAic48jmC#WS{Kp(DP zgpD$GnD>9Mi_Y`yG!v>pwvuM-T_rMr%rhjFr(8@7VI2?D^8$6^6zT>mSc!IytMRj_ zC+tIAa2S8$Yt%$u@R!d9OGrpEC}Sa3<8Hiz*YOSd*k8(sJ|Ka1T*nPJ$Jck2iS(a@ zk?P4P>c;O-yLTRAadnPJG&)cdPQo6{z)GC7?#JylUtuEZJRfGUzwGCNYD)vwU>{!L z1dHfkTuaNI$41oq)2In}510#LR&Ev zwaEri;}dukXYdeu^35hXXE}+b#A6EhGO!$7cpryx9JP5*Qhz;2gJm0bGVUs*{@RT( zMI!W#WT6MEQ5R}OO{fP;@G<&$Rm*sdamqoFM>v21;sGA=;#IP`Kzx|2{b&!G6(~jy zEmf%N-VXBZWpOb|fPRr#q%S1?u$gfY>i1iL+6&Jy8fV6zMThON9TjcmEfuA~j`7pZ GoBn@F@S@uQ delta 1372 zcmXZbO-NKx6u|NG60|HElNmoU%`7Wv8YZX78a2)D7Lkdl37H8>_913t)*_!$tui#r zMJS>n5eZg^^nq@QXqC}IvkU?kEeg$a)25IA;XN4M@80v?z4zR6@62@>^IgW1PQ&aG z5rot}{Pf-U)exygev%s_l82R;iTxOjpKO;fjDA?G zNFq97#gt+i9s(P&6(g_*Z{naGcgKm)lp<`w8jQyojKpO;gdt4g#sbX1X4_Hp)BlbK zFp0rYSQT%IT%&QGfbRSkhT|W*zj~83u@e)Bmm@z3^3a{##`X9RwF1v@8@|JNT*fmv z&EN*iVcRqK$hO1WERs&3GRaz?8?^$XxCbXtcese;B>#{(C4P&@ZrqRheLZUFgQ$r- zM=kXf_8TmU$LL?=9CzRwe2eA+jbs|*q@9AZxEKH0eIG%+8^>*LU?%;is3lxP4;tH< zkcGUc?|-w3j`Q!d5;}z}C9QaCl}H~l&XiQXaxt(H>-nIO1Jr@js0$cuvkaZ6@dnf# z_M%QWf-CqQHIdgmvRGgl35l07W@9y`;Q+Sd2lTMMloA~vfezfjizK$MXO)I}>H3lC z$vEo5A5m}b0qeSv+p&#)cQ*Cc+vvy< z;oe9(CSo<}L|0K0x`TQ67(E=-3SOq4oGbDG`!IueE+4tEjjT=+A0cZWIt#4|6eF9K z6R7jvE9AfDr7=!GFV8pRUWlv6%D4#i|67527hYi~&W*hY?Tv^G1RH|q>H;+-SB|ul N`_ is used here as an example). +This shows a potential use of |PyMuPDF| with another Python PDF library (the excellent pure Python package `pdfrw `_ is used here as an example). If a clean, non-corrupt / decompressed PDF is needed, one could dynamically invoke PyMuPDF to recover from many problems like so:: @@ -51,10 +51,10 @@ With the command line utility *pdftk* (`available ` to a :title:`PDF`. These include XPS, EPUB, FB2, CBZ and image formats, including multi-page TIFF images. +Here is a script that converts any |PyMuPDF| :ref:`supported document` to a |PDF|. These include XPS, EPUB, FB2, CBZ and image formats, including multi-page TIFF images. It features maintaining any metadata, table of contents and links contained in the source document:: @@ -130,7 +130,7 @@ It features maintaining any metadata, table of contents and links contained in t How to Deal with Messages Issued by :title:`MuPDF` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Since :title:`PyMuPDF` v1.16.0, **error messages** issued by the underlying :title:`MuPDF` library are being redirected to the Python standard device *sys.stderr*. So you can handle them like any other output going to this devices. +Since |PyMuPDF| v1.16.0, **error messages** issued by the underlying :title:`MuPDF` library are being redirected to the Python standard device *sys.stderr*. So you can handle them like any other output going to this devices. In addition, these messages go to the internal buffer together with any :title:`MuPDF` warnings -- see below. diff --git a/docs/recipes-drawing-and-graphics.rst b/docs/recipes-drawing-and-graphics.rst index 6e39b97e2..7a83a9953 100644 --- a/docs/recipes-drawing-and-graphics.rst +++ b/docs/recipes-drawing-and-graphics.rst @@ -11,13 +11,13 @@ PDF files support elementary drawing operations as part of their syntax. These a The syntax for such operations is defined in "A Operator Summary" on page 643 of the :ref:`AdobeManual`. Specifying these operators for a PDF page happens in its :data:`contents` objects. -:title:`PyMuPDF` implements a large part of the available features via its :ref:`Shape` class, which is comparable to notions like "canvas" in other packages (e.g. `reportlab `_). +|PyMuPDF| implements a large part of the available features via its :ref:`Shape` class, which is comparable to notions like "canvas" in other packages (e.g. `reportlab `_). A shape is always created as a **child of a page**, usually with an instruction like *shape = page.new_shape()*. The class defines numerous methods that perform drawing operations on the page's area. For example, *last_point = shape.draw_rect(rect)* draws a rectangle along the borders of a suitably defined *rect = fitz.Rect(...)*. The returned *last_point* **always** is the :ref:`Point` where drawing operation ended ("last point"). Every such elementary drawing requires a subsequent :meth:`Shape.finish` to "close" it, but there may be multiple drawings which have one common *finish()* method. -In fact, :meth:`Shape.finish` *defines* a group of preceding draw operations to form one -- potentially rather complex -- graphics object. :title:`PyMuPDF` provides several predefined graphics in `shapes_and_symbols.py `_ which demonstrate how this works. +In fact, :meth:`Shape.finish` *defines* a group of preceding draw operations to form one -- potentially rather complex -- graphics object. |PyMuPDF| provides several predefined graphics in `shapes_and_symbols.py `_ which demonstrate how this works. If you import this script, you can also directly use its graphics as in the following example:: diff --git a/docs/recipes-multiprocessing.rst b/docs/recipes-multiprocessing.rst index 8c4712c1c..ba2a5c359 100644 --- a/docs/recipes-multiprocessing.rst +++ b/docs/recipes-multiprocessing.rst @@ -16,11 +16,11 @@ Multiprocessing ============================== -:title:`MuPDF` has no integrated support for threading - calling itself "thread-agnostic". While there do exist tricky possibilities to still use threading with :title:`MuPDF`, the baseline consequence for :title:`PyMuPDF` is: +:title:`MuPDF` has no integrated support for threading - calling itself "thread-agnostic". While there do exist tricky possibilities to still use threading with :title:`MuPDF`, the baseline consequence for |PyMuPDF| is: **No Python threading support**. -Using :title:`PyMuPDF` in a :title:`Python` threading environment will lead to blocking effects for the main thread. +Using |PyMuPDF| in a :title:`Python` threading environment will lead to blocking effects for the main thread. However, there is the option to use :title:`Python's` *multiprocessing* module in a variety of ways. @@ -35,7 +35,7 @@ If you are looking to speed up page-oriented processing for a large document, us |toggleEnd| -Here is a more complex example involving inter-process communication between a main process (showing a GUI) and a child process doing :title:`PyMuPDF` access to a document. +Here is a more complex example involving inter-process communication between a main process (showing a GUI) and a child process doing |PyMuPDF| access to a document. |toggleStart| diff --git a/docs/the-basics.rst b/docs/the-basics.rst index a9dbae905..93b107eed 100644 --- a/docs/the-basics.rst +++ b/docs/the-basics.rst @@ -34,10 +34,10 @@ To open a file, do the following: .. _The_Basics_Extracting_Text: -Extract text from a :title:`PDF` +Extract text from a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -To extract all the text from a :title:`PDF` file, do the following: +To extract all the text from a |PDF| file, do the following: .. code-block:: python @@ -51,7 +51,7 @@ To extract all the text from a :title:`PDF` file, do the following: out.write(bytes((12,))) # write page delimiter (form feed 0x0C) out.close() -Of course it is not just :title:`PDF` which can have text extracted - all the :ref:`supported document file formats ` such as :title:`MOBI`, :title:`EPUB`, :title:`TXT` can have their text extracted. +Of course it is not just |PDF| which can have text extracted - all the :ref:`supported document file formats ` such as :title:`MOBI`, :title:`EPUB`, :title:`TXT` can have their text extracted. .. note:: @@ -79,10 +79,10 @@ Of course it is not just :title:`PDF` which can have text extracted - all the :r .. _The_Basics_Extracting_Images: -Extract images from a :title:`PDF` +Extract images from a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -To extract all the images from a :title:`PDF` file, do the following: +To extract all the images from a |PDF| file, do the following: .. code-block:: python @@ -160,10 +160,10 @@ This will return a dictionary of paths for any vector drawings found on the page .. _merge PDF: .. _join PDF: -Merging :title:`PDF` files +Merging |PDF| files ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -To merge :title:`PDF` files, do the following: +To merge |PDF| files, do the following: .. code-block:: python @@ -176,10 +176,10 @@ To merge :title:`PDF` files, do the following: doc_a.save("a+b.pdf") # save the merged document with a new filename -Merging :title:`PDF` files with other types of file +Merging |PDF| files with other types of file """"""""""""""""""""""""""""""""""""""""""""""""""""" -With :meth:`Document.insert_file` you can invoke the method to merge :ref:`supported files` with :title:`PDF`. For example: +With :meth:`Document.insert_file` you can invoke the method to merge :ref:`supported files` with |PDF|. For example: .. code-block:: python @@ -196,7 +196,7 @@ With :meth:`Document.insert_file` you can invoke the method to merge :ref:`suppo **Taking it further** - It is easy to join PDFs with :meth:`Document.insert_pdf` & :meth:`Document.insert_file`. Given open :title:`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 `_ contains a full description. + 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 `_ contains a full description. The GUI script `join.py `_ uses this method to join a list of files while also joining the respective table of contents segments. It looks like this: @@ -223,10 +223,10 @@ There is one *mathematical term* that you should feel comfortable with when usin .. _The_Basics_Watermarks: -Adding a watermark to a :title:`PDF` +Adding a watermark to a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -To add a watermark to a :title:`PDF` file, do the following: +To add a watermark to a |PDF| file, do the following: .. code-block:: python @@ -246,7 +246,7 @@ To add a watermark to a :title:`PDF` file, do the following: **Taking it further** - Adding watermarks is essentially as simple as adding an image at the base of each :title:`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. + 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. 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. @@ -261,10 +261,10 @@ To add a watermark to a :title:`PDF` file, do the following: .. _The_Basics_Images: -Adding an image to a :title:`PDF` +Adding an image to a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -To add an image to a :title:`PDF` file, for example a logo, do the following: +To add an image to a |PDF| file, for example a logo, do the following: .. code-block:: python @@ -297,7 +297,7 @@ To add an image to a :title:`PDF` file, for example a logo, do the following: .. _The_Basics_Rotating: -Rotating a :title:`PDF` +Rotating a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To add a rotation to a page, do the following: @@ -322,7 +322,7 @@ To add a rotation to a page, do the following: .. _The_Basics_Cropping: -Cropping a :title:`PDF` +Cropping a |PDF| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To crop a page to a defined :ref:`Rect`, do the following: @@ -550,7 +550,7 @@ To select pages, do the following: **Taking it further** - With :title:`PyMuPDF` you have all options to copy, move, delete or re-arrange the pages of a :title:`PDF`. Intuitive methods exist that allow you to do this on a page-by-page level, like the :meth:`Document.copy_page` method. + 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. 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` @@ -645,7 +645,7 @@ To add a blank page, do the following: 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. - Here is a 3-liner that creates a :title:`PDF`: with one empty page. Its file size is 460 bytes: + Here is a 3-liner that creates a |PDF|: with one empty page. Its file size is 460 bytes: .. code-block:: python @@ -708,7 +708,7 @@ Using the :meth:`Document.insert_page` method also inserts a new page and accept Splitting Single Pages ~~~~~~~~~~~~~~~~~~~~~~~~~~ -This deals with splitting up pages of a :title:`PDF` in arbitrary pieces. For example, you may have a :title:`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 :title:`PDF` page in *Letter* format again. +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. @@ -772,7 +772,7 @@ Example: Combining Single Pages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This deals with joining :title:`PDF` pages to form a new :title:`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. +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. .. code-block:: python @@ -827,11 +827,11 @@ Example: .. _The_Basics_Encryption_and_Decryption: -:title:`PDF` Encryption & Decryption +|PDF| Encryption & Decryption ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Starting with version 1.16.0, :title:`PDF` decryption and encryption (using passwords) are fully supported. You can do the following: +Starting with version 1.16.0, |PDF| decryption and encryption (using passwords) are fully supported. You can do the following: * Check whether a document is password protected / (still) encrypted (:attr:`Document.needs_pass`, :attr:`Document.is_encrypted`). * Gain access authorization to a document (:meth:`Document.authenticate`). @@ -845,11 +845,11 @@ Starting with version 1.16.0, :title:`PDF` decryption and encryption (using pass .. note:: A PDF document may have two different passwords: * The **owner password** provides full access rights, including changing passwords, encryption method, or permission detail. - * The **user password** provides access to document content according to the established permission details. If present, opening the :title:`PDF` in a viewer will require providing it. + * 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. Method :meth:`Document.authenticate` will automatically establish access rights according to the password used. -The following snippet creates a new :title:`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. +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. .. code-block:: python diff --git a/docs/tutorial.rst b/docs/tutorial.rst index 64da92c24..b1d0f5fa6 100644 --- a/docs/tutorial.rst +++ b/docs/tutorial.rst @@ -8,7 +8,7 @@ Tutorial .. highlight:: python -This tutorial will show you the use of :title:`PyMuPDF`, :title:`MuPDF` in :title:`Python`, step by step. +This tutorial will show you the use of |PyMuPDF|, :title:`MuPDF` in :title:`Python`, step by step. Because :title:`MuPDF` supports not only PDF, but also XPS, OpenXPS, CBZ, CBR, FB2 and EPUB formats, so does PyMuPDF [#f1]_. Nevertheless, for the sake of brevity we will only talk about PDF files. At places where indeed only PDF files are supported, this will be mentioned explicitly. @@ -34,7 +34,7 @@ The original rendering library for MuPDF was called *Libart*. .. note:: - So :title:`PyMuPDF` **cannot coexist** with packages named "fitz" in the same Python environment. + So |PyMuPDF| **cannot coexist** with packages named "fitz" in the same Python environment. .. _Tutorial_Opening_a_Document: diff --git a/docs/vars.rst b/docs/vars.rst index 31c5a54bb..457105819 100644 --- a/docs/vars.rst +++ b/docs/vars.rst @@ -3,7 +3,7 @@ =============================== Constants and Enumerations =============================== -Constants and enumerations of :title:`MuPDF` as implemented by :title:`PyMuPDF`. Each of the following variables is accessible as *fitz.variable*. +Constants and enumerations of :title:`MuPDF` as implemented by |PyMuPDF|. Each of the following variables is accessible as *fitz.variable*. Constants