Webhelp Glossary help

Bob.Conlin
Posts: 22

Webhelp Glossary help

Tue Apr 17, 2012 3:10 am

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: 4144

Re: Webhelp Glossary help

Tue Apr 17, 2012 4:56 pm

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

Re: Webhelp Glossary help

Thu Apr 19, 2012 6:14 pm

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: 4144

Re: Webhelp Glossary help

Fri Apr 20, 2012 11:48 am

Hi Bob,

Thank you for letting us know.


Regards,
Sorin

Return to “DITA (Editing and Publishing DITA Content)”

Who is online

Users browsing this forum: No registered users and 0 guests