DOC: add warning about docutils breaking HTML bibliographies

spatialaudio · Jan 7, 2023 · 9dc1984 · 9dc1984
1 parent 68fc1c4
commit 9dc1984
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/doc/a-normal-rst-file.rst b/doc/a-normal-rst-file.rst
@@ -227,6 +227,15 @@ but at the end of the document.
 For a possible work-around,
 see https://github.com/mcmtroffaes/sphinxcontrib-bibtex/issues/156.
 
+.. warning::
+
+    With ``docutils`` versions 0.18 and 0.19,
+    the HTML output after the bibliography is broken,
+    see https://github.com/mcmtroffaes/sphinxcontrib-bibtex/issues/309.
+    This problem will be fixed in the next ``docutils`` version
+    (either 0.19.1 or 0.20).
+
+
 Footnote citations
 ^^^^^^^^^^^^^^^^^^