Günter Milde

Results 84 comments of Günter Milde

Regarding spurious warnings, see also my comment on the issue page. https://github.com/sphinx-doc/sphinx/issues/13383#issuecomment-2872393837

The Docutils LaTeX writer implements a similar "classes emulation" for all block-elements (environments). ~~~rst .. code-block:: :class: red crucial 1+1 ~~~ becomes ~~~latex \begin{DUclass}{code} \begin{DUclass}{red} \begin{DUclass}{crucial} \begin{quote} \begin{alltt} 1+1 \end{alltt}...

> An additional, related question: the `id1` hyperlink target previously emitted for the `figure` is now placed into a LaTeX `\phantomsection`; is that something we should be concerned about? This...

> I think we should a bit, as the HTML output has somehow gotten rid of this extra target. Admittedly `\phantomsection\label{\detokenize{index:id1}}` following a (cross-) reference implemented by `\hyperref` mark-up does...

> But now regarding the source ... This makes the issue a lot clearer: Let's assume there is a "section1" somewhere, then ~~~ `subsection `_. ~~~ is translated to the...

Aside: There is a misnomer in the test sample: ~~~ > Embedded standalone hyperlink reference: `subsection `_. ~~~ A [standalone hyperlink](https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#standalone-hyperlinks) is always external and must start with a recognized...

The test failure uncovers a Sphinx LaTeX writer bug and a possible improvement: Bug: The Sphinx LaTeX writer writes a label for an *indirect hyperlink target*. Indirect targets are handled...

> It seems the source of our problems is in > > ``` > if node.get('refid'): Indeed. (Aside, it should be changed to `if 'refid' in node:`.) > prev_node =...

> but I have a difficulty understanding "hyperlink reference having alias" terminology. Hyperlinks with embedded URI or alias are the most complex part. If you want to comprehend rST hyperlink...

> [...] The second chunk has similarly `latex:latex-elements` label after an internal cross reference, and this should not exist and did not exist with using Docutils 0.21.2 because for some...