Re: A small detail on the syntax of field list markers

On 2025-04-06, Karl O. Pinc wrote:

...

>>   * Escaped whitespace characters are removed from the output document
>>     together with the escaping backslash. This allows for
>>     character-level inline markup.

...

> FYI, a more universal example
> is adding links to footnotes at the end of a sentence,
> without an extra space between the period and the footnote
> number/link.

>   A footnoted sentence.\ [#f1]_

>   .. rubric:: Footnotes

>   .. [#f1] Text of the footnote.

Yes, this is another use case. Thank you for reminding.


Personally, I rely on the `trim_footnote_reference_space`__ configuration
setting. It's default depends on the `footnote_reference`__ style:

  The footnote space is trimmed if the reference style is "superscript",
  and it is left if the reference style is "brackets".

The advantage is that this way, there is no need to change the source when
switching the footnote reference style between "superscript" and "brackets".

Regards,
Günter

__ https://docutils.sourceforge.io/docs/user/config.html#trim-footnote-reference-space
__ https://docutils.sourceforge.io/docs/user/config.html#footnote-references



_______________________________________________
Docutils-develop mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/docutils-develop

Please use "Reply All" to reply to the list.