Documentation: Round 3 of syntax updates.

Author: jamie-lemon

docs/annot.rst

@@ -365,7 +365,7 @@ There is a parent-child relationship between an annotation and its page. If the
 
       :rtype: bool
 
-      This method is the only way to change the colors of a FreeText annotation. You cannot use `:meth:Annot.set_colors` for this purpose. But be aware that for rich-text annotations, the text color is never changed. The text color is set by the *text_color* entry of the *info* dictionary. This is a limitation of MuPDF and not a bug.
+      This method is the only way to change the colors of a FreeText annotation. You cannot use :meth:`Annot.set_colors` for this purpose. But be aware that for rich-text annotations, the text color is never changed. The text color is set by the ``text_color`` entry of the ``info`` dictionary. This is a limitation of |MuPDF| and not a bug.
 
       .. caution:: Using this method inside a :meth:`Page.annots` loop is **not recommended!** This is because most annotation updates require the owning page to be reloaded -- which cannot be done inside this loop. Please use the example coding pattern given in the documentation of this generator.
 

docs/app4.rst

@@ -55,63 +55,63 @@ A set of eight files is used for the performance testing. With each file we have
      - **KB/page**
      - **Textsize/page**
      - **Notes**
-   * - `adobe.pdf`_
+   * - `adobe.pdf`
      - 32,472,771
      - 1,310
      - 794
      - 32,096
      - 24
      - 1,942
      - linearized, many links / bookmarks
-   * - `artifex-website.pdf`_
+   * - `artifex-website.pdf`
      - 31,570,732
      - 47
      - 46
      - 2,035
      - 656
      - 3,538
      - graphics oriented
-   * - `db-systems.pdf`_
+   * - `db-systems.pdf`
      - 29,326,355
      - 1,241
      - 0
      - 0
      - 23
      - 2,142
      -
-   * - `fontforge.pdf`_
+   * - `fontforge.pdf`
      - 8,222,384
      - 214
      - 31
      - 242
      - 38
      - 1,058
      - mix of text & graphics
-   * - `pandas.pdf`_
+   * - `pandas.pdf`
      - 10,585,962
      - 3,071
      - 536
      - 16,554
      - 3
      - 1,539
      - many pages
-   * - `pymupdf.pdf`_
+   * - `pymupdf.pdf`
      - 6,805,176
      - 478
      - 276
      - 5,277
      - 14
      - 1,937
      - text oriented
-   * - `pythonbook.pdf`_
+   * - `pythonbook.pdf`
      - 9,983,856
      - 669
      - 198
      - 1,953
      - 15
      - 1,929
      -
-   * - `sample-50-MB-pdf-file.pdf`_
+   * - `sample-50-MB-pdf-file.pdf`
      - 52,521,850
      - 1
      - 0

docs/locales/ja/LC_MESSAGES/about.mo

@@ -111,13 +111,13 @@ msgstr "ライセンスと著作権"
 
 #: ../../about.rst:90 d2b1eb94b7a9461b9b9bd6171afc1f0c
 msgid ""
-"|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 "
+"|PyMuPDF| and |MuPDF| are now available under both, open-source "
+"|AGPL| and commercial license agreements. Please read the full "
+"text of the |AGPL| license agreement, available in the "
+"distribution material (file COPYING) and `on the GNU license page "
 "<https://www.gnu.org/licenses/agpl-3.0.html>`_, 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 "
+"cannot meet the requirements of the |AGPL|, please contact "
 "`Artifex <https://artifex.com/contact/pymupdf-inquiry.php?utm_source=rtd-"
 "pymupdf&utm_medium=rtd&utm_content=inline-link>`_ for more information "
 "regarding a commercial license."

docs/locales/ja/LC_MESSAGES/about.po

@@ -75,7 +75,7 @@ msgid ""
 msgstr "演算子は2つのオブジェクトを含むバイナリ演算子または単項演算子になります。"
 
 #: ../../algebra.rst:22 ff83ad4ef4924a928f7fe7c91f007de7
-#, fuzzy
+
 msgid ""
 "The resulting type of **binary** operations is either a **new object of "
 "the left operand's class,** a bool or (for dot products) a float."
@@ -88,7 +88,7 @@ msgid ""
 msgstr "単項演算の結果は、同じクラスの新しいオブジェクト、bool型、またはfloat型のいずれかです。"
 
 #: ../../algebra.rst:26 a1336f1afec74044ada260ccd870436a
-#, fuzzy
+
 msgid ""
 "The binary operators `+, -, *, /` are defined for all classes. They "
 "*roughly* do what you would expect -- **except, that the second operand "
@@ -113,7 +113,7 @@ msgstr ""
 " 、 :data:`rect_like` 、 :data:`quad_like` 、または :data:`matrix_like` と呼びます。"
 
 #: ../../algebra.rst:31 d93daa3887f04faead0f46a53b4c2a9a
-#, fuzzy
+
 msgid ""
 "Rectangles support **additional binary** operations: **intersection** "
 "(operator `\"&\"`), **union** (operator `\"|\"`) and **containment** "
@@ -126,7 +126,7 @@ msgid ""
 "binary operator then the expression `a °= b` is always valid and the same"
 " as `a = a ° b`. Therefore, be careful and do **not** do `p1 *= p2` for "
 "two points, because thereafter \"p1\" is a **float**."
-msgstr ""
+msgstr "バイナリ演算子は「インプレース演算」を完全にサポートしています。つまり、"°"がバイナリ演算子である場合、式 ``a °= b`` は常に有効であり、 ``a = a ° b`` と同じです。したがって、2つの点に対して ``p1 *= p2`` を行わないように注意してください。なぜなら、その後「p1」は浮動小数点数になってしまうからです。"
 
 #: ../../algebra.rst:37 b197551ac91841fba96a5406efd0e076
 msgid "Unary Operations"
@@ -199,14 +199,14 @@ msgid ""
 "These are expressions like `a ° b` where \"°\" is any of the operators "
 "`+, -, *, /`. Also binary operations are expressions of the form `a == b`"
 " and `b in a`."
-msgstr ""
+msgstr "これらは ``a ° b`` のような式であり、ここで「°」は ``+``, ``-``, ``*``, ``/`` などの演算子のいずれかです。また、バイナリ演算には ``a == b`` や ``b in a`` のような形式の式も含まれます。"
 
 #: ../../algebra.rst:55 347337c08b6e49ba8133b876c65de703
 msgid ""
 "If \"b\" is a number, then the respective operation is executed for each "
 "component of \"a\". Otherwise, if \"b\" is **not a number,** then the "
 "following happens:"
-msgstr ""
+msgstr "もし「b」が数値である場合、それぞれの演算は「a」の各コンポーネントに対して実行されます。一方、「b」が数値ではない場合、以下のことが起こります："
 
 #: ../../algebra.rst:61 882647f50a3548ada51850492e59336c
 msgid "a+b, a-b"
@@ -221,7 +221,7 @@ msgid "a*m, a/m"
 msgstr ""
 
 #: ../../algebra.rst:62 7d3849829e3b4508827663e012314f30
-#, fuzzy
+
 msgid ""
 "\"a\" can be a point, rectangle or matrix and \"m\" is a "
 ":data:`matrix_like`. *\"a/m\"* is treated as *\"a*~m\"* (see note below "
@@ -239,7 +239,7 @@ msgstr ""
 
 #: ../../algebra.rst:67 55f9b0922451482484ef7fe2110fefb7
 msgid "returns the **vector dot product** for a point \"a\" and point-like \"b\"."
-msgstr ""
+msgstr "点「a」と点のような「b」に対して、ベクトルの内積を返します。"
 
 #: ../../algebra.rst:68 2c02e64b04dd47a89a57341e5557c6f4
 msgid "a&b"
@@ -385,7 +385,7 @@ msgstr "以下は、点 `p1` と点 `p2` を結ぶ直線の中点を求めます
 msgid ""
 "Compute the **vector dot product** of two points. You can compute the "
 "**cosine of angles** and check orthogonality."
-msgstr ""
+msgstr "2つの点のベクトル内積を計算します。これにより、角度のコサインを計算したり、直交性を確認したりすることができます。"
 
 #: ../../algebra.rst:149 05936628739f4f5392d49359e0f8860d
 msgid "Manipulation with \"like\" Objects"

docs/locales/ja/LC_MESSAGES/algebra.mo

@@ -45,14 +45,20 @@ msgstr "PDFのみ。"
 
 #: ../../annot.rst:11 58f32778ecd843849cffbac30da6580a
 msgid ""
-"Quote from the :ref:`AdobeManual`: \"An annotation associates an object "
+"Quote from the :ref:`AdobeManual`:"
+msgstr ""
+":ref:`AdobeManual` からの引用: "
+
+msgid ""
+"*\"An annotation associates an object "
 "such as a note, sound, or movie with a location on a page of a PDF "
 "document, or provides a way to interact with the user by means of the "
-"mouse and keyboard.\""
+"mouse and keyboard.\"*"
 msgstr ""
-":ref:`AdobeManual` からの引用: "
 "「注釈は、ノート、音声、動画などのオブジェクトをPDFドキュメントのページ上の位置に関連付けるか、マウスとキーボードを介してユーザーと対話する手段を提供します。」"
 
+
+
 #: ../../annot.rst:13 a1ef865437ed4e5b8622fb4c309b374d
 msgid ""
 "There is a parent-child relationship between an annotation and its page. "
@@ -128,7 +134,6 @@ msgid ":meth:`Annot.get_textpage`"
 msgstr ""
 
 #: ../../annot.rst:25 f960592668bb4d61a14db7770f245ff7
-#, fuzzy
 msgid "create a TextPage for the annotation"
 msgstr "アノテーションのためのポップアップを作成します"
 
@@ -442,8 +447,8 @@ msgid ""
 msgstr "（v1.19.2で新規追加）インチあたりのドット数で指定された解像度。 `None` でない場合、matrixパラメータは無視されます。"
 
 #: ../../annot.rst:81 b77081c57af64088978ad2f41b248bd4
-msgid "a colorspace to be used for image creation. Default is *pymupdf.csRGB*."
-msgstr "画像の作成に使用されるカラースペース。デフォルトは *pymupdf.csRGB* です。"
+msgid "a colorspace to be used for image creation. Default is ``pymupdf.csRGB``."
+msgstr "画像の作成に使用されるカラースペース。デフォルトは ``pymupdf.csRGB`` です。"
 
 #: ../../annot.rst:84 2dcd533cb5c24787bf3ef2ea667576c1
 msgid "whether to include transparency information. Default is ``False``."
@@ -470,19 +475,18 @@ msgid ":ref:`Pixmap`"
 msgstr ""
 
 #: ../../annot.rst:90 0b7db7e99f7746abad597233349afdaf
-#, fuzzy
 msgid ""
 "If the annotation has just been created or modified, you should "
 ":meth:`Document.reload_page` the page first via `page = "
 "doc.reload_page(page)`."
 msgstr ""
-"注釈が作成または変更されたばかりの場合、まず *page = doc.reload_page(page)* "
+"注釈が作成または変更されたばかりの場合、まず ``page = doc.reload_page(page)`` "
 "を使用してページを再読み込みする必要があります。"
 
 #: ../../annot.rst:92 672b6b5650554da988247bd501528456
 msgid ""
 "The pixmap will have *\"premultiplied\"* pixels if `alpha=True`. To learn"
-" about some background, e.g. look for \"Premultiplied alpha\" `here "
+" about some background, e.g. look for \"Premultiplied alpha\" `in this online glossary "
 "<https://en.wikipedia.org/wiki/Glossary_of_computer_graphics#P>`_."
 msgstr ""
 
@@ -590,11 +594,11 @@ msgstr "アノテーションのためのポップアップを作成します"
 msgid ""
 "indicator bits controlling the content available for subsequent text "
 "extractions and searches -- see the parameter of :meth:`Annot.get_text`."
-msgstr ""
+msgstr "後続のテキスト抽出や検索に利用可能なコンテンツを制御する指標ビット --  :meth:`Annot.get_text` のパラメータを参照してください。"
 
 #: ../../annot.rst:144 a0916e69962b40559ccefc18b36fe7ab
 msgid "restrict extracted text to this area."
-msgstr ""
+msgstr "抽出されるテキストをこのエリアに制限します。"
 
 #: ../../annot.rst 10c25cc74cf14a4487da85267fd798e1
 #: 23ab237bc68240aab0c5942ffd105dbc 491acd8d88934a05b86aa6b039da0c4b
@@ -1008,9 +1012,9 @@ msgstr "バージョン1.16.9で変更: 色を直接設定できるようにし
 
 #: ../../annot.rst:310 d388c00f532d4aecafa4def64bd6c525
 msgid ""
-"Changes the \"stroke\" and \"fill\" colors for supported annotation types"
-" -- not all annotations accept both."
-msgstr "サポートされている注釈タイプに対して「ストローク」と「塗りつぶし」の色を変更します – すべての注釈が両方を受け入れるわけではありません。"
+"Changes the \"stroke\" and \"fill\" colors for supported annotation types -- not all annotation types accept both. **Do not use this method at all for FreeText annotations** because it has its special conventions to deal with up to three colors (border, fill, text)."
+msgstr "サポートされている注釈タイプに対して「ストローク」と「塗りつぶし」の色を変更します – すべての注釈が両方を受け入れるわけではありません。FreeText注釈にはこのメソッドを一切使用しないでください。
+このタイプの注釈は、境界線、塗りつぶし、テキストの最大3つの色を扱うための特別な規則があるためです。"
 
 #: ../../annot.rst:312 6de264581c6f4f85a50cbe3ab18a7397
 msgid ""
@@ -1029,11 +1033,9 @@ msgstr "上記を参照してください。"
 
 #: ../../annot.rst:316 13a268dfb4a44682b64f2e122fe775e3
 msgid ""
-"*Changed in v1.18.5:* To completely remove a color specification, use an "
-"empty sequence like `[]`. If you specify `None`, an existing "
-"specification will not be changed."
+"To completely remove a color specification, use an empty sequence like `[]`. If you specify `None`, an existing specification will not be changed."
 msgstr ""
-"*バージョン1.18.5で変更:*  色の仕様を完全に削除するには、`[]` のような空のシーケンスを使用してください。`None` "
+"色の仕様を完全に削除するには、`[]` のような空のシーケンスを使用してください。`None` "
 "を指定した場合、既存の仕様は変更されません。"
 
 #: ../../annot.rst:321 941d573346c9417a9e600b67f4c4cdfb
@@ -1094,16 +1096,15 @@ msgstr ""
 "注釈のブレンドモードを変更または設定します。有効な値についてはPDF標準のブレンドモードを参照してください。"
 
 #: ../../annot.rst:353 ae8e841246674f4ab53acaa575475903
-#, fuzzy
 msgid "change :data:`fontsize` of the text. 'FreeText' annotations only."
 msgstr "テキストのフォントサイズを変更します。 'FreeText' 注釈のみです。"
 
 #: ../../annot.rst:354 26cc7f290781487ea2c8260b485b91f9
-msgid "change the text color. 'FreeText' annotations only."
+msgid "change the text color. 'FreeText' annotations only. This has the same effect as ``border_color``. Note that the text color of rich-text annotations cannot be changed at all because it is set by HTML / CSS syntax and part of the text itself."
 msgstr "テキストの色を変更します。 'FreeText' 注釈のみです。"
 
 #: ../../annot.rst:355 b98848bcd4c84b94b4f2339e929facdb
-msgid "change the border color. 'FreeText' annotations only."
+msgid "change the border color. 'FreeText' annotations only. This has the same effect as ``text_color``."
 msgstr "境界線の色を変更します。 'FreeText' 注釈のみです。"
 
 #: ../../annot.rst:356 ea1d7e13b3fc45dcaeaa3bd564ccba38
@@ -1156,6 +1157,10 @@ msgstr ""
 ":meth:`Page.annots` ループ内でこのメソッドを使用することは **お勧めしません！** "
 "これは、ほとんどの注釈の更新には所有ページの再読み込みが必要であり、このループ内で行うことはできないためです。このジェネレータのドキュメントで提供されている例のコーディングパターンを使用してください。"
 
+#: ../../annot.rst:368
+msgid "This method is the only way to change the colors of a FreeText annotation. You cannot use :meth:`Annot.set_colors` for this purpose. But be aware that for rich-text annotations, the text color is never changed. The text color is set by the ``text_color`` entry of the ``info`` dictionary. This is a limitation of |MuPDF| and not a bug."
+msgstr "このメソッドは、FreeText注釈の色を変更する唯一の方法です。この目的には、 :meth:`Annot.set_colors()`  を使用することはできません。 ただし、リッチテキスト注釈の場合は注意が必要です。テキストの色は変更されず、 ``info``  辞書の  ``text_color``  エントリによって設定されます。 これは |MuPDF| の制限であり、不具合ではありません。"
+
 #: ../../annot.rst:370 ff9bc4bf0cdd4acc976c156f5a315306
 msgid "Basic information of the annot's attached file."
 msgstr "アノットが添付されたファイルの基本情報。"
@@ -1561,7 +1566,7 @@ msgstr ""
 "ページの表面よりも下に凹んだように見える模擬的な浮き彫りの矩形、 **\"U\"** （Underline）= 注釈矩形の底部に沿った単一の線。"
 
 #: ../../annot.rst:557 43804865211f4957b4ab00f844766472
-#, fuzzy
+
 msgid ""
 "*clouds* -- an integer indicating a \"cloudy\" border, where ``n`` is an "
 "integer `-1 <= n <= 2`. A value `n = 0` indicates a straight line (no "

docs/locales/ja/LC_MESSAGES/algebra.po

@@ -523,7 +523,6 @@ msgid ""
 msgstr "画像を含む出力バリアントを使用する際に画像に興味がない場合、必ず該当するビットをオフに設定してください。これにより、パフォーマンスが向上し、スペース要件が大幅に削減されます。"
 
 #: ../../app1.rst:304 4babe75226f64adeb13494c473d77bda
-#, fuzzy
 msgid "To show the effect of `TEXT_INHIBIT_SPACES` have a look at this example::"
 msgstr "`TEXT_INHIBIT_SPACES`  の効果を示すために、この例をご覧ください："