Re: Standardizing help paths

[Karl EICHWALDER <ke gnu franken de>]

Thanks Elliot, for initiative to improve the GNOME help system!

"David C. Mason" <dcm@redhat.com> writes:

|   <sect1 id="foo">

[...]

|   HTML source:
|   
|   <div class="SECT1">
|     <h1 class="SECT1"><a name="FOO">Intro to Foo</a></h1>

2 issues to note:

1. The A element and its attribute will actually look this way:

    <a name="foo.html">


2. This only works iff sect1 is NOT the first section of a chapter; the
first section of a chapter is to be accessed this way:

<chapter id="chap-id">
 <title>
 <sect1 id="foo">
 ...
 <sect1 id="bar">

=>

<a name="chap-id.html#FOO">
<a name="bar.html">

At least, that's what I experienced while working with the DSSSL
stylesheets 1.42
(cf. http://www.franken.de/users/gnu/ke/emacs/emacs.html - in german).
I guess, it's configurable to convert every section into a separate
file.  If we want this, we've to make sure, the a chapter has to start
with text (<para>) before the first SECT1 element - otherwise it
(chap-id.html) doesn't look good.

-- 
work: ke@suse.de                          |
        : http://www.suse.de/~ke/             |       ------    ,__o
personal: ke@gnu.franken.de                   |      ------   _-\_<,
        : http://www.franken.de/users/gnu/ke/ |     ------   (*)/'(*)