Re: Standardizing help paths




    Elliot> since there is no way to find the HTML file that
    Elliot> corresponds to a specific piece of the SGML source.

When I write docs, I always use an "id" attribute in my
chapter/section tags, and that makes for predictable filenames.  My
attributes are usually canonicalized from the title of that section,
but that is not necessary.

David, I would propose that you enforce this in your guideline for
GNOME docs, and make sure that the auto-generator does this.

For example, my "intro to docbook" document has:

<book id="docbook-intro">

...

  <chapter id="What-is-this">
    <title>What is this?</title>
    <sect1 id="a-tutorial-for-hacker-writers">
	<title>A tutorial for hacker&ndash;writers</title>
      <para>
	This booklet has two main goals:
      </para>

...



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]