From 9c33d2d0d4fc03ff4f93e9f00bb7639fbb6bd23c Mon Sep 17 00:00:00 2001
From: Jamie Lemon <jamie.lemon@artifex.com>
Date: Tue, 2 Dec 2025 15:39:48 +0000
Subject: [PATCH] Docs: Fixes some error warnings when building

also updates the version translations for Japanese
---
 changes.txt                                   |   2 +-
 docs/footer.rst                               |   2 ++
 docs/header.rst                               |  20 ++++++---------
 .../locales/ja/LC_MESSAGES/pymupdf4llm/api.mo | Bin 51369 -> 51369 bytes
 docs/locales/ja/LC_MESSAGES/version.mo        | Bin 973 -> 1602 bytes
 docs/locales/ja/LC_MESSAGES/version.po        |  24 ++++++++----------
 docs/the-basics.rst                           |   4 +--
 docs/version.rst                              |   4 +--
 8 files changed, 23 insertions(+), 33 deletions(-)

diff --git a/changes.txt b/changes.txt
index f1a01b89c..e4b28d4ef 100644
--- a/changes.txt
+++ b/changes.txt
@@ -672,7 +672,7 @@ Other:
 
 * Other:
 
-  * Fixed bug in set_xml_metadata(), PR `3112 https://github.com/pymupdf/PyMuPDF/pull/3112>`_: Fix pdf_add_stream metadata error
+  * Fixed bug in set_xml_metadata(), PR `3112 <https://github.com/pymupdf/PyMuPDF/pull/3112>`_: Fix pdf_add_stream metadata error
   * Fixed lack of `.parent` member in `TextPage` from `Annot.get_textpage()`.
   * Fixed bug in `Page.add_widget()`.
 
diff --git a/docs/footer.rst b/docs/footer.rst
index 7e652a942..e734bf95a 100644
--- a/docs/footer.rst
+++ b/docs/footer.rst
@@ -1,3 +1,5 @@
+.. _documentation_footer:
+
 ----
 
 .. raw:: html
diff --git a/docs/header.rst b/docs/header.rst
index 483db67fc..18b5f2298 100644
--- a/docs/header.rst
+++ b/docs/header.rst
@@ -28,10 +28,6 @@
 
     <cite>PyMuPDF Pro</cite>
 
-.. |PDF| raw:: html
-
-    <cite>PDF</cite>
-
 .. |PyMuPDF4LLM| raw:: html
 
     <cite>PyMuPDF4LLM</cite>
@@ -40,6 +36,14 @@
 
     <cite>PyMuPDF Layout</cite>
 
+.. |MuPDF| raw:: html
+
+    <cite>MuPDF</cite>
+
+.. |PDF| raw:: html
+
+    <cite>PDF</cite>
+
 .. |Markdown| raw:: html
 
     <cite>Markdown</cite>
@@ -52,14 +56,6 @@
 
     <cite>TXT</cite>
 
-.. |MuPDF| raw:: html
-
-    <cite>MuPDF</cite>
-
-.. |PDF| raw:: html
-
-    <cite>PDF</cite>
-
 .. |AGPL| raw:: html
 
     <cite>AGPL</cite>
diff --git a/docs/locales/ja/LC_MESSAGES/pymupdf4llm/api.mo b/docs/locales/ja/LC_MESSAGES/pymupdf4llm/api.mo
index 3a1abbd60519319c5c05f68afc1fc6a004753509..3d53057a9d944d2cfaa69084317fed7ea69023c5 100644
GIT binary patch
delta 17
ZcmZ2Ek$L4r<_)~EOm+#I`DJIV1^_rv1{nYV

delta 17
ZcmZ2Ek$L4r<_)~EObK?I`DJIV1^_s61{nYV

diff --git a/docs/locales/ja/LC_MESSAGES/version.mo b/docs/locales/ja/LC_MESSAGES/version.mo
index b28338ab36c740a355417ae5ed0dfd669b462694..4bb268556da3a585005dbca3ee29403c3e86b0a9 100644
GIT binary patch
delta 796
zcmZutOKTHR7`^F3H-e9q3z6$yQ(ElOMM3Jq7P@fdrkQ4L%)n%3Iy0#aSdx3Eg{qMn
zLeaWtyYNMQf(R`w5!|`xU(m&8i2VufJok>#L>%UD?&JHubM84j{`o}p>zSc-hVK|~
z4w%xLp6?FUBft_c3cLXtz&GF`FrQ&;6TAst0<H`I*zXTAb`AU!d<dQxVyp;0In3A>
z@FJK^xU-SZBO!P$sFccqU6@@EVdVH;j$5A1bNy#oHtC04ELx?&6?~>LU7oo*d1*8|
zb~!uF^S&2bju-Ks)3I!0>cZ*Yg=V6;Y^a;V>4HY8H!6XXw_LZ<9mt)Chr$(BBy3*t
zL%|E7m@f-2MonC_yi|e1xfAo-j_Y#25DSmb30w=FN29Kb%`ULwe383iLFlqS8m0{m
zx6X&ciba?X*6pG+Cu|$i#^HxknOdg$PdFrB_60*qwbxW<<ps${B%hO9Be_j-o#Zmr
z6#L$~PjZ#yd#cI)&`7=_`K~uGlJ)jO9JWZ+&8TIp&yw8GgStUNKXuo9HgGphvN=BZ
zxO!B3(%#+utJ0lKYL(PIxIEh4@9asfn(UbWfYhEg3NZzfTcl)f`&&vHlq8f$N?ud4
zK?$tYJ0D@{(~s6c*XEXa0bQ5>tM6*JpCX<ICYv22*2FU~O`Fq!DQyw&PM`V<-}y%H

delta 165
zcmX@abC%ubo)F7a1|VPtVi_Pd0dbIk50E__h<$-r2Z)~naV;YQgAfp32C^qGF)(BR
z=@g&=6YnXC)&x}gmIk=E)hHz9r6|-u*pmeqqu62Wd`A7vwoG-5NJ<|!u7E2IV(Ek{
IeZVpU08P3kga7~l

diff --git a/docs/locales/ja/LC_MESSAGES/version.po b/docs/locales/ja/LC_MESSAGES/version.po
index e9eed7858..5ef659857 100644
--- a/docs/locales/ja/LC_MESSAGES/version.po
+++ b/docs/locales/ja/LC_MESSAGES/version.po
@@ -19,33 +19,29 @@ msgstr ""
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: Babel 2.10.3\n"
 
-#: ../../version.rst:3 d1fbe6ff1d5549fb8be875f6d37c584b
+#: ../../version.rst:1 d1fbe6ff1d5549fb8be875f6d37c584b
 msgid "This documentation covers PyMuPDF |version|."
 msgstr "このドキュメントは |version| までのすべてのバージョンを対象としています。"
 
-#: ../../version.rst:5 133bf913bb004c8ca82964184ed7628c
+#: ../../version.rst:3 133bf913bb004c8ca82964184ed7628c
 msgid ""
-"The major and minor versions of |PyMuPDF| and |MuPDF| will always be the "
-"same. Only the third qualifier (patch level) may deviate from that of "
-"|MuPDF|."
-msgstr ""
-"|PyMuPDF| と |MuPDF| のメジャーおよびマイナーバージョンは常に同じになります。第三の修飾子（パッチレベル）のみが |MuPDF|"
-" のものと異なる場合があります。"
+"The major and minor versions of PyMuPDF and MuPDF will always be the same. Only the third qualifier (patch level) may deviate from that of MuPDF."
+msgstr "PyMuPDF と MuPDF のメジャーおよびマイナーバージョンは常に同じになります。第三の修飾子（パッチレベル）のみが MuPDF のものと異なる場合があります。"
 
-#: ../../version.rst:7 994720d99f72419ebd711b2cf71dcefb
+#: ../../version.rst:5 994720d99f72419ebd711b2cf71dcefb
 msgid ""
 "Typically PyMuPDF is released more frequently than MuPDF so it will often"
 " be the case that the patch level of PyMuPDF will be greater than the "
 "embedded MuPDF."
-msgstr ""
+msgstr "通常、PyMuPDFはMuPDFよりも頻繁にリリースされるため、PyMuPDFのパッチレベルが組み込まれたMuPDFのパッチレベルよりも大きくなることがよくあります。"
 
-#: ../../version.rst:11 371aa251e8314b9aad7c870f54636f80
+#: ../../version.rst:9 371aa251e8314b9aad7c870f54636f80
 msgid "For example PyMuPDF-1.24.5 contains MuPDF-1.24.2."
-msgstr ""
+msgstr "例えば、PyMuPDF-1.24.5にはMuPDF-1.24.2が含まれています。"
 
-#: ../../version.rst:13 7c7d7d87d7e14441959c236fee7d2ee5
+#: ../../version.rst:11 7c7d7d87d7e14441959c236fee7d2ee5
 msgid "Also see `pymupdf_version` and `mupdf_version`."
-msgstr ""
+msgstr "pymupdf_versionとmupdf_versionも参照してください。"
 
 #~ msgid ""
 #~ "This documentation covers **PyMuPDF "
diff --git a/docs/the-basics.rst b/docs/the-basics.rst
index 9bab2728b..9cd6d927b 100644
--- a/docs/the-basics.rst
+++ b/docs/the-basics.rst
@@ -444,8 +444,6 @@ To delete a page from a document, do the following:
 
 To delete a multiple pages from a document, do the following:
 
-.. raw:: html
-
 .. code-block:: python
 
     import pymupdf
@@ -670,7 +668,7 @@ To add a blank page, do the following:
 Inserting Pages with Text Content
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Using the :meth:`Document.insert_page` method also inserts a new page and accepts the same `width` and `height` parameters. But it lets you also insert arbitrary text into the new page and returns the number of inserted lines.
+Using the :meth:`Document.insert_page` method also inserts a new page and accepts the same ``width`` and ``height`` parameters. But it lets you also insert arbitrary text into the new page and returns the number of inserted lines.
 
 .. code-block:: python
 
diff --git a/docs/version.rst b/docs/version.rst
index 13deb580f..463c39973 100644
--- a/docs/version.rst
+++ b/docs/version.rst
@@ -1,8 +1,6 @@
-----
-
 This documentation covers PyMuPDF |version|.
 
-The major and minor versions of |PyMuPDF| and |MuPDF| will always be the same. Only the third qualifier (patch level) may deviate from that of |MuPDF|.
+The major and minor versions of PyMuPDF and MuPDF will always be the same. Only the third qualifier (patch level) may deviate from that of MuPDF.
 
 Typically PyMuPDF is released more frequently than MuPDF so it will often be
 the case that the patch level of PyMuPDF will be greater than the embedded