[debiandoc-sgml-pkgs] Bug#402122: debiandoc-sgml: HTML output should include LINK tags in HEAD

Fri Dec 8 11:42:10 CET 2006

Package: debiandoc-sgml
Severity: wishlist

I notice that the HTML version of new-maint[1], and presumably other
Debian documentation, lacks LINK[2] tags in the HEAD header.  These tags
make it a little easier to read large documents in some browsers, such
as emacs-w3m or firefox (with the Link Widgets extension).

Here is an extensive example from an XHTML document:

    <head>
      <title>The Elements of Programming</title>
      <link rel="stylesheet" type="text/css" href="book-Z-C.css" title="default" />
      <link rel="Start" href="book.xhtml" title="Cover Page" />
      <link rel="First" href="book.xhtml" title="Cover Page" />
      <link rel="Copyright" href="book-Z-H-02.xhtml" title="Copyright" />
      <link rel="Contents" href="book-Z-H-04.xhtml" title="Table of Contents" />
      <link rel="End" href="book-Z-H-36.xhtml" title="References" />
      <link rel="Index" href="book-Z-H-37.xhtml" title="List of Exercises" />
      <link rel="Index" href="book-Z-H-38.xhtml" title="Index" />
      <link rel="Up" href="book-Z-H-09.xhtml" title="Building Abstractions with Procedures" />
      <link rel="Subsection" href="#sec_1.1.1" title="Expressions" />
      <link rel="Subsection" href="#sec_1.1.2" title="Naming and the Environment" />
      <link rel="Subsection" href="#sec_1.1.3" title="Evaluating Combinations" />
      <link rel="Subsection" href="#sec_1.1.4" title="Compound Procedures" />
      <link rel="Subsection" href="#sec_1.1.5" title="The Substitution Model for Procedure Application" />
      <link rel="Subsection" href="#sec_1.1.6" title="Conditional Expression and Predicates" />
      <link rel="Subsection" href="#sec_1.1.7" title="Example: Square Roots by Newton's Method" />
      <link rel="Subsection" href="#sec_1.1.8" title="Procedures as Black-box Abstractions" />
      <link rel="Next" href="book-Z-H-11.xhtml" title="Procedures and the Processes They Generate" />
      <link rel="Prev" href="book-Z-H-09.xhtml" title="Building Abstractions with Procedures" />
      <meta name="robots" content="noindex,follow" />
      <meta name="generator" content="tex2page 4o" />
    </head>

Particularly desirable are the Next and Prev relations.

I assume that debiandoc-sgml is responsible for generating HTML output
from debiandoc sources.  If this is not the case, this bug should be
reassigned.

[1] http://www.us.debian.org/doc/manuals/maint-guide/ch-start.en.html
[2] http://www.w3.org/TR/html4/struct/links.html#h-12.3