You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Escaped colons are allowed in references to URLs in reStructuredText.
For example, the following reStructuredText file (file ecaairtu-example.rst) is valid:
While `Labyrinth Lord: Revised Edition`_ (LLRE; PDF and POD) has been
criticized for not being a completely faithful retro-clone of the
Moldvay/Cook/Marsh Basic/Expert D&D rules (B/X), I think it still
holds a useful spot.
.. _Labyrinth Lord\: Revised Edition: https://www.drivethrurpg.com/product/64332/Labyrinth-Lord-Revised-Edition
Notice that the colon in the middle of hyperlink reference on the first
line is not escaped, but the colon in the middle of the hyperlink
target on the last line is escaped with a backslash, since an
unescaped colon is what ends the reference id of the hyperlink target.
and the following version of the docutils toolchain:
rst2html (Docutils 0.16 [release], Python 3.9.7, on linux)
My OS information is:
Linux ulrich 5.13.8-100.fc33.x86_64 #1 SMP Wed Aug 4 14:15:51 UTC 2021 x86_64 x86_64 x86_64 GNU/Linux
Fedora release 33 (Thirty Three)
For the reStructuredText file above, the resulting html output (ecaairtu-example-pandoc.html) generated by pandoc is:
<p>While <a href="">Labyrinth Lord: Revised Edition</a> (LLRE; PDF and POD) has been criticized for not being a completely faithful retro-clone of the Moldvay/Cook/Marsh Basic/Expert D&D rules (B/X), I think it still holds a useful spot.</p>
and it was generated by the command
pandoc -r rst -w html --output=ecaairtu-example-pandoc.html ecaairtu-example.rst
which produces the error message:
[WARNING] Reference not found for 'labyrinth lord: revised edition' at ecaairtu-example.rst line 1 column 41
The html output (ecaairtu-example-docutils.html) as generated by the docutils tool chain (and omitting the uninteresting header and footer) is
<p>While <a class="reference external" href="https://www.drivethrurpg.com/product/64332/Labyrinth-Lord-Revised-Edition">Labyrinth Lord: Revised Edition</a> (LLRE; PDF and POD) has been
criticized for not being a completely faithful retro-clone of the
Moldvay/Cook/Marsh Basic/Expert D&D rules (B/X), I think it still
holds a useful spot.</p>
and is generated by the command
rst2html ecaairtu-example.rst | sed '1,/^<div class="document">/d'| sed -e '1,2d' -e '\%</div>%,$d'>ecaairtu-example-docutils.html
and produces no error messages.
The text was updated successfully, but these errors were encountered:
Escaped colons are allowed in references to URLs in reStructuredText.
For example, the following reStructuredText file (file
ecaairtu-example.rst
) is valid:Notice that the colon in the middle of hyperlink reference on the first
line is not escaped, but the colon in the middle of the hyperlink
target on the last line is escaped with a backslash, since an
unescaped colon is what ends the reference id of the hyperlink target.
I'm using the following version of Pandoc:
and the following version of the docutils toolchain:
My OS information is:
For the reStructuredText file above, the resulting
html
output (ecaairtu-example-pandoc.html
) generated by pandoc is:and it was generated by the command
which produces the error message:
The
html
output (ecaairtu-example-docutils.html
) as generated by the docutils tool chain (and omitting the uninteresting header and footer) isand is generated by the command
and produces no error messages.
The text was updated successfully, but these errors were encountered: