Fix some anchors and markdown quirks

docs/advanced.md

@@ -401,7 +401,6 @@ stable user interface. They may be imported from
 ```
 
 (tmpdir)=
-
 ## Changing temporary storage location
 
 OCRmyPDF generates many temporary files during processing.

docs/cloud.md

@@ -1,7 +1,7 @@
 % SPDX-FileCopyrightText: 2025 James R. Barlow
 % SPDX-License-Identifier: CC-BY-SA-4.0
 
-{#ocr-service}
+(ocr-service)=
 
 # Online deployments
 
@@ -53,7 +53,7 @@ depending on the command line given. A rule of thumb would be to allow
 cloud servers or small VM partitions should be provisioned with plenty
 of extra space, if say, a 500 page file might be sent.
 
-To change the temporary directory, see [tmpdir](advanced#tmpdir).
+To change the temporary directory, see [tmpdir](#tmpdir).
 
 On Amazon Web Services or other cloud vendors, consider setting your
 temporary directory to [empheral

docs/conf.py

@@ -26,9 +26,7 @@
 
 # -- General configuration ------------------------------------------------
 
-# If your documentation needs a minimal Sphinx version, state it here.
-#
-# needs_sphinx = '1.0'
+needs_sphinx = '8'
 
 import datetime
 
@@ -58,10 +56,6 @@ templates_path = ['_templates']
 # The suffix(es) of source filenames.
 source_suffix = {'.rst': 'restructuredtext', '.md': 'markdown', '.txt': 'markdown'}
 
-# The encoding of source files.
-#
-# source_encoding = 'utf-8-sig'
-
 # The master toctree document.
 master_doc = 'index'
 
@@ -70,8 +64,8 @@ project = 'ocrmypdf'
 
 year = str(datetime.date.today().year)
 copyright = (
-    f'{year}, James R. Barlow. ',
-    'Licensed under Creative Commons Attribution-ShareAlike 4.0.',
+    f'{year}, James R. Barlow. '
+    + 'Licensed under Creative Commons Attribution-ShareAlike 4.0'
 )
 author = 'James R. Barlow'
 

docs/introduction.md

@@ -1,10 +1,3 @@
----
-substitutions:
-  image: |-
-    ```{image} images/bitmap_vs_svg.svg
-    ```
----
-
 % SPDX-FileCopyrightText: 2022 James R. Barlow
 % SPDX-License-Identifier: CC-BY-SA-4.0
 

docs/pdfsecurity.md

@@ -1,4 +1,4 @@
-{#security}
+(security)=
 
 # PDF security issues