Webhelp Glossary help

Post here questions and problems related to editing and publishing DITA content.
Bob.Conlin
Posts: 22
Joined: Sun Aug 14, 2011 5:21 am

Webhelp Glossary help

Post by Bob.Conlin »

Using a topichead and glossrefs (with print="yes") to individual glossentry dita files I was able to get my pdf glossary to look exactly as expected: Glossary title with individual entries to browse thru. When I transformed to CHM & Webhelp the output was not as expected. In my searches for solutions I found http://www.oxygenxml.com/samples/DITA-W ... index.html which has a glossary that looks great. Please let me know how this was done & what am I missing. Here is a sample of my glossary in the ditamap:

Code: Select all

    <topichead navtitle="Glossary" type="topic">
<glossref href="Glossary/DITA.dita" keys="dita" print="yes"/>
sorin_ristache
Posts: 4141
Joined: Fri Mar 28, 2003 2:12 pm

Re: Webhelp Glossary help

Post by sorin_ristache »

Hello,

If it is a map (your map has a root element map) you should include the glossary entries as in the following fragment:

Code: Select all

 <topichead navtitle="Glossary" locktitle="yes">
<topicref href="Glossary/DITA.dita" type="glossentry" keys="dita" print="yes"/>
</topichead>
If it is a bookmap (your map has a root element bookmap) you should include the entries as in:

Code: Select all

  <backmatter>
<booklists>
<glossarylist navtitle="Glossary" locktitle="yes">
<topicref href="Glossary/DITA.dita" type="glossentry" keys="dita" print="yes"/>
</glossarylist>
</booklists>
</backmatter>

Regards,
Sorin
Bob.Conlin
Posts: 22
Joined: Sun Aug 14, 2011 5:21 am

Re: Webhelp Glossary help

Post by Bob.Conlin »

Hi Sorin,
This is what I found to work to get the Glossaries that I wanted.

Code: Select all

<topichead navtitle="Glossary" locktitle="yes" audience="pdf">
<!-- Works for PDF -->
<glossref href="Glossary/DITA.dita" keys="dita" print="yes"/>
<glossref href="Glossary/DITAMap.dita" keys="ditamap" print="yes"/>
</topichead>
<!-- Works for WebHelp and CHM -->
<topicref href="GlossaryGroupRef.dita" type="topic" audience="chm"/>
Then in GlossaryGroupRef.dita I have:

Code: Select all

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE glossgroup PUBLIC "-//OASIS//DTD DITA Glossary Group//EN" "glossgroup.dtd">
<glossgroup id="glossgroup_wsc_rns_yf">
<title>Glossary</title>
<glossentry id="dita" conref="Glossary\DITA.dita#dita">
<glossterm/>
</glossentry>
<glossentry id="ditamap" conref="Glossary\DITAMap.dita#ditamap">
<glossterm/>
</glossentry>
</glossgroup>
Plus a little conditional profiling in the transformations for audience="pdf" or "chm" (works for webhelp & html too) and were good to go.
sorin_ristache
Posts: 4141
Joined: Fri Mar 28, 2003 2:12 pm

Re: Webhelp Glossary help

Post by sorin_ristache »

Hi Bob,

Thank you for letting us know.


Regards,
Sorin
Post Reply