Page 1 of 1

DocBook WebHelp output missing </h3> for Glossary

Posted: Sat Jan 19, 2013 6:05 am
by P4jjb
Hi,

The DocBook 5 Webhelp output seems to have a bug when producing the Glossary.
From the first glossary entry and onwards, all the displayed text is in a bold font.
When I viewed the source, the first entry does have an <h3>. However, there's no </h3> after the glossary term or in the rest of the file.

Shouldn't the glossary have something like the following tag structure:

<dl>
<h3 class="title"/><dt>term</dt></h3><dd><p>term definition</p></dd>
<h3 class="title"/><dt>term</dt></h3><dd><p>term definition</p></dd>
<h3 class="title"/><dt>term</dt></h3><dd><p>term definition</p></dd>
</dl>

Code: Select all


<div class="glossary" id="glossary_lbk_3n2_x3">
<div class="titlepage">
<div>
<div>
<h1 class="title" id="glossary_lbk_3n2_x3">Glossary</h1>
</div>
</div>
</div>
<p>This glossary describes specific terms. For blah-specific and general version
management terms used in the documentation, see the <em class="citetitle">blah User’s
Guide</em>, <em class="citetitle">Appendix A: Glossary</em>.</p>
<div class="glossdiv" id="d5e5386">
[b]<h3 class="title"/>[/b]
<dl><dt>authentication</dt>
<dd><p>blah requires SSH authentication for pullers and pushers using SSH key pairs.</p>
<p>See Also <a class="link" href="glossary_lbk_3n2_x3.html#glossterm_j2k_3n2_x3" shape="rect">puller</a>,
<a class="link" href="glossary_lbk_3n2_x3.html#glossterm_k2k_3n2_x3" shape="rect">pusher</a>, and <a class="link" href="glossary_lbk_3n2_x3.html#glossterm_sdk_3n2_x3" shape="rect">blah public SSH key directory</a>[b]. .[/b]
</p>
</dd>
<dt>author</dt><dd><p>Person who authors a change, such as writing and editing code or creating text and binary
files.</p><p>The system always records the author’s name. However, the Administrator determines
whether an author must be a licensed user or not, and this decision drives how the system
records the author, as follows:
Thanks.

Re: DocBook WebHelp output missing </h3> for Glossary

Posted: Mon Jan 21, 2013 2:03 pm
by sorin_ristache
Hello,

Only the title of the glossary section is a H3 element, not every glossary or every glossary term. From the following Docbook XML fragment:

Code: Select all

<glossary>
<glossentry>
<glossterm>term1</glossterm>
<glossdef>
<para>def1</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>term2</glossterm>
<glossdef>
<para>def2</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>term3</glossterm>
<glossdef>
<para>def3</para>
</glossdef>
</glossentry>
</glossary>
I get the following output:

Code: Select all

<h3 style="background: none repeat scroll 0% 0% rgb(255, 255, 255); box-shadow: none;" class="title">Glossary</h3></div></div></div><dl><dt>term1</dt><dd><p>def1</p></dd><dt>term2</dt><dd><p>def2</p></dd><dt>term3</dt><dd><p>def3</p></dd></dl>
How did you insert the glossary terms in your XML document? Can you post a sample XML fragment?


Regards,
Sorin

Re: DocBook WebHelp output missing </h3> for Glossary

Posted: Tue Jan 22, 2013 11:06 pm
by P4jjb
Hi Sorin,

Apologies and thanks for the help. In short, I used <glossdiv> when I should've used <glosslist>. Once I wrapped all the <glossentry> in the <glosslist> tag, the <h3> title issue disappeared.

However, there's another display issue happening in the PDF. I'll post that in the FO forum.