user debian-...@lists.debian.org usertags 613946 docbook-xml-transition tags 616042 - wontfix severity 616042 minor thanks
Hi, On Fri, Mar 04, 2011 at 04:18:28PM -0600, Jonathan Nieder wrote: > >> retitle -1 debiandoc2html: <link> titles should not have embedded tags > > ... > > I think you might have misunderstood the bug. I am very happy that > the <link> tags are included; the only problem is that the "title" > attribute contains embedded tags. As the HTML standard explains: > > The title attribute gives the title of the link. With one > exception, it is purely advisory. The value is text. I see. > All user agents I know that display the "title" attribute do display > it as plain text. > > That said, I would agree with calling it wishlist/wontfix. I'm > reopening the bug for documentation, so people looking at the BTS can > find another reason to switch to docbook. ... > > There are some console browsers such as w3m which can > > handle this OK. > > That sounds like a bug in w3m, then. Though I do not actually see the > <link> tags when I open policy in w3m --- are you sure w3m even tries > to handle this? I do not know. At least it did not bother me when creating UTF-8 plain text from 1-page HTML :-) (Usually, link tags are not used for that.) > All the examples of anchor targets (<a name="foo">) in the HTML > standard use it to enclose some descriptive text or similar content. > Christoph's example of using a stylesheet to highlight link targets > certainly puts it in the realm of what the WCAG are supposed to > describe. But I admit, I cannot find any document that comes out and > says so. Ok, I trust you here. I now understand issue I flip-flopped and this is different. Anyway, what is requited is: current <link href="ap-pkg-alternatives.html" rel="appendix" title="F Alternative versions of an interface - <code>update-alternatives</code> (from old Packaging Manual)"> to be <link href="ap-pkg-alternatives.html" rel="appendix" title="F Alternative versions of an interface - update-alternatives (from old Packaging Manual)"> This may be a bug which can be quickly fixed. I guess dropping all <...> should be enough. I can even agree this to be minor bug which is annoynig enough. > > I should say the more useful wishlist bug is "debian-policy should use > > DocBook XML for source" :-) > > *nod* Now that the debiandoc side has been nicely filed away, I'm > retitling the bug. Hint to anyone working on this: the debconf spec > is already DocBook XML, so you can steal its rules. By the way, just make DocBook XML is as easy as $ debiandoc2dbk -1 somefile.sgml If you are worried about preserving entity etc., there are some tricks to use. See http://wiki.debian.org/DocbookXmlTransition As I have used this debiandoc2dbk command, I have found few bugs... such as in examples and <copyright> needs to be repeated etc. This bug on debiandoc2html's <link> tag is a nice one to fix together in next upload. Osamu > Jonathan > -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org