From 81cb7c2f9cdf5038595399f3afecae526f72f4d0 Mon Sep 17 00:00:00 2001 From: goodger Date: Mon, 25 Apr 2005 01:12:00 +0000 Subject: added bug: HTML fragment identifiers & duplicate target names git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk/docutils@3252 929543f6-e4f2-0310-98a6-ba3bd3dd1d04 --- BUGS.txt | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) (limited to 'BUGS.txt') diff --git a/BUGS.txt b/BUGS.txt index 2f036d24b..4e97af5a1 100644 --- a/BUGS.txt +++ b/BUGS.txt @@ -222,6 +222,39 @@ Also see the `SourceForge Bug Tracker`_. four +* IDs are based on names. Explicit hyperlink targets have priority + over implicit targets. But if an explicit target comes after an + implicit target with the same name, the ID of the first (implicit) + target remains based on the implicit name. Since HTML fragment + identifiers based on the IDs, the first target keeps the name. For + example:: + + .. contents:: + + Section + ======= + + .. _contents: + + Subsection + ---------- + + text with a reference to contents_ and section_ + + .. _section: + + This paragraph is explicitly targeted with the name "section". + + When processed to HTML, the 2 internal hyperlinks (to "contents" & + "section") will work fine, but hyperlinks from outside the document + using ``href="...#contents"`` and ``href="...#section"`` won't work. + Such external links will connect to the implicit targets (table of + contents and "Section" title) instead of the explicit targets + ("Subsection" title and last paragraph). + + Hyperlink targets with duplicate names should be assigned new IDs + unrelated to the target names (i.e., "id"-prefix serial IDs). + .. Local Variables: -- cgit v1.2.1