SF.net SVN: docutils:[10155 ] trunk/docutils

Revision: 10155
          http://sourceforge.net/p/docutils/code/10155
Author:   milde
Date:     2025-06-06 08:29:30 +0000 (Fri, 06 Jun 2025)
Log Message:
-----------
LaTeX writer: avoid LaTeX warnings about "empty anchors".

Disable the "hyperref" package's footnote handling.

(Docutils implements its own footnote handling to support multiple footnote
marks to the same footnote text with hyperlinks and backlinks).

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/docutils/writers/latex2e/__init__.py
    trunk/docutils/test/functional/expected/cyrillic.tex
    trunk/docutils/test/functional/expected/latex_babel.tex
    trunk/docutils/test/functional/expected/latex_cornercases.tex
    trunk/docutils/test/functional/expected/latex_docinfo.tex
    trunk/docutils/test/functional/expected/latex_leavevmode.tex
    trunk/docutils/test/functional/expected/latex_literal_block.tex
    trunk/docutils/test/functional/expected/latex_literal_block_fancyvrb.tex
    trunk/docutils/test/functional/expected/latex_literal_block_listings.tex
    trunk/docutils/test/functional/expected/latex_literal_block_verbatim.tex
    trunk/docutils/test/functional/expected/latex_literal_block_verbatimtab.tex
    trunk/docutils/test/functional/expected/latex_memoir.tex
    trunk/docutils/test/functional/expected/length_units_latex.tex
    trunk/docutils/test/functional/expected/length_units_xetex.tex
    trunk/docutils/test/functional/expected/standalone_rst_latex.tex
    trunk/docutils/test/functional/expected/standalone_rst_xetex.tex
    trunk/docutils/test/functional/expected/xetex-cyrillic.tex
    trunk/docutils/test/test_writers/test_latex2e_parts.py

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/HISTORY.rst	2025-06-06 08:29:30 UTC (rev 10155)
@@ -32,6 +32,7 @@
   - Replace `Writer.bibtex_reference_resolver()` with a transform.
   - `LaTeXTranslator.visit_inline()` now inserts labels for the
     node's IDs.
+  - Disable "hyperref" footnote handling to avoid "empty anchor" warnings.
 
 * docutils/writers/manpage.py
 

Modified: trunk/docutils/docutils/writers/latex2e/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/latex2e/__init__.py	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/docutils/writers/latex2e/__init__.py	2025-06-06 08:29:30 UTC (rev 10155)
@@ -1365,14 +1365,17 @@
                            for path in stylesheet_list]
 
         # PDF setup
-        if self.hyperlink_color.lower() in ('0', 'false', ''):
-            self.hyperref_options = ''
-        else:
-            self.hyperref_options = ('colorlinks=true,'
-                                     f'linkcolor={self.hyperlink_color},'
-                                     f'urlcolor={self.hyperlink_color}')
+        # avoid warnings about empty anchors with \DUfootnotetext:
+        self.hyperref_options = ['hyperfootnotes=false']
+        # link color (default is "blue"):
+        if self.hyperlink_color.lower() not in ('0', 'off', 'no', 'false', ''):
+            self.hyperref_options.append('colorlinks=true,'
+                                         f'linkcolor={self.hyperlink_color},'
+                                         f'urlcolor={self.hyperlink_color}')
         if settings.hyperref_options:
-            self.hyperref_options += ',' + settings.hyperref_options
+            self.hyperref_options.append(settings.hyperref_options)
+        # wrap and align (cf. PreambleCmds.linking):
+        self.hyperref_options = ',\n              '.join(self.hyperref_options)
 
     # Auxiliary Methods
     # -----------------

Modified: trunk/docutils/test/functional/expected/cyrillic.tex
===================================================================
--- trunk/docutils/test/functional/expected/cyrillic.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/cyrillic.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -19,7 +19,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/latex_babel.tex
===================================================================
--- trunk/docutils/test/functional/expected/latex_babel.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/latex_babel.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -25,7 +25,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/latex_cornercases.tex
===================================================================
--- trunk/docutils/test/functional/expected/latex_cornercases.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/latex_cornercases.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -119,7 +119,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/latex_docinfo.tex
===================================================================
--- trunk/docutils/test/functional/expected/latex_docinfo.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/latex_docinfo.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -16,7 +16,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/latex_leavevmode.tex
===================================================================
--- trunk/docutils/test/functional/expected/latex_leavevmode.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/latex_leavevmode.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -142,7 +142,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/latex_literal_block.tex
===================================================================
--- trunk/docutils/test/functional/expected/latex_literal_block.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/latex_literal_block.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -28,7 +28,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/latex_literal_block_fancyvrb.tex
===================================================================
--- trunk/docutils/test/functional/expected/latex_literal_block_fancyvrb.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/latex_literal_block_fancyvrb.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -28,7 +28,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/latex_literal_block_listings.tex
===================================================================
--- trunk/docutils/test/functional/expected/latex_literal_block_listings.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/latex_literal_block_listings.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -34,7 +34,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/latex_literal_block_verbatim.tex
===================================================================
--- trunk/docutils/test/functional/expected/latex_literal_block_verbatim.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/latex_literal_block_verbatim.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -27,7 +27,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/latex_literal_block_verbatimtab.tex
===================================================================
--- trunk/docutils/test/functional/expected/latex_literal_block_verbatimtab.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/latex_literal_block_verbatimtab.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -28,7 +28,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/latex_memoir.tex
===================================================================
--- trunk/docutils/test/functional/expected/latex_memoir.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/latex_memoir.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -183,7 +183,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/length_units_latex.tex
===================================================================
--- trunk/docutils/test/functional/expected/length_units_latex.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/length_units_latex.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -35,7 +35,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/length_units_xetex.tex
===================================================================
--- trunk/docutils/test/functional/expected/length_units_xetex.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/length_units_xetex.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -65,7 +65,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/standalone_rst_latex.tex
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_latex.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/standalone_rst_latex.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -182,7 +182,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/standalone_rst_xetex.tex
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_xetex.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/standalone_rst_xetex.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -48,7 +48,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/functional/expected/xetex-cyrillic.tex
===================================================================
--- trunk/docutils/test/functional/expected/xetex-cyrillic.tex	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/functional/expected/xetex-cyrillic.tex	2025-06-06 08:29:30 UTC (rev 10155)
@@ -25,7 +25,8 @@
 % hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

Modified: trunk/docutils/test/test_writers/test_latex2e_parts.py
===================================================================
--- trunk/docutils/test/test_writers/test_latex2e_parts.py	2025-06-03 21:10:47 UTC (rev 10154)
+++ trunk/docutils/test/test_writers/test_latex2e_parts.py	2025-06-06 08:29:30 UTC (rev 10155)
@@ -61,7 +61,8 @@
     'pdfsetup': r"""% hyperlinks:
 \ifdefined\hypersetup
 \else
-  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[hyperfootnotes=false,
+              colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
   \usepackage{bookmark}
   \urlstyle{same} % normal text font (alternatives: tt, rm, sf)
 \fi

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.