hi, On Sun, May 04, 2014 at 11:31:58PM +0200, Stéphane Blondon wrote: > Hello, > > 2014-05-04 15:59 GMT+02:00 Osamu Aoki <osamu_aoki_h...@nifty.com>: > > On Thu, May 01, 2014 at 12:47:13AM +0200, Stéphane Blondon wrote: > >> For example: > >> <a id="needdocs"> > >> <p> > >> The following is the > >> <span class="emphasis"> > >> documentation which you should read along with this document: > >> </p> > >> </a> > >> > >> However, there are never href attributes so the tags are still not > >> usable in this case. > > > > Rwally, these are used to jump from the index at the top of page. > > You're right, I completely missed the (obvious) reason. > > So the <a> tag should be only added in the <h2> tag for each section > and not in other places in the DOM tree.
How about <h3> tag for chapters? https://www.debian.org/doc/manuals/maint-guide/dother.en.html#manpage1 This URL is linked from https://www.debian.org/doc/manuals/maint-guide/index.en.html The source goes as: <div class="section"> <div class="titlepage"> <div> <div> <h3 class="title"><a id="manpage1"/>5.15.1. <code class="filename">manpage.1.ex</code></h3> </div> </div> </div> <p> ... h1 tag may be removed from the current chunked html files without functional loss since the chapter can be accessed by the filename. <h1 class="title"><a id="dother"/>Chapter 5. Other files under the <code class="filename">debian</code> directory</h1> I do not see any use of #dother since we do not build 1 page html now. These taggings are configured in the style-html.xsl in the source as: <xsl:param name="toc.section.depth">4</xsl:param> <xsl:param name="section.label.includes.component.label" select="1"/> <xsl:param name="section.autolabel" select="1"/> This is just a minor customization. If something simple as this solves your concern, I can do it... > In this case: > - the id will be unique. I do not understand what you mean by "unique". Unless I am careful not to make id tags unique, it creates broken link. > - there will be no rendering problem. Problem is I am not seeing *rendering problem* here to understand your concern. Can you post screenshot somewhere or mail it to BTS. screen capture + your comment on it as some graphics form... Regards, Osamu -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
