DITA: how do output the non-<abbreviated-form> of a glossent
Posted: Thu Oct 02, 2014 8:47 pm
Hi there,
I hope this is in the right place?
And I'll say thanks for your time first before getting into all the verbose detail below: )
I want to add a list of acronyms (loa) in my output (PDF and webhelp at this time). This should show the glossterm or glossSurfaceForm text (in my case, both are the same: I am happy to use either if I can get it working). In other words, it would print the long form of the glossentry and not the <abbreviated-form>.
I don't want items in the loa to be linked.
So I want a page in the PDF that is:
Acronyms used in this Help
Application Programming Interface (API)
Point of Sales (POS)
...
I don't want to print the entire acronym file (only either the <glossterm> or the <glossSurfaceForm>).
But I am also using the <abbreviated-form> as normal to reference the terms (glosssurfaceform on first occurrence, acronym on subsequent uses), and this all works perfectly.
I use a <map> to bind my topics (not a bookmap).
I've created a map to hold glossentry items: when I include them as topicrefs, the entire glossentry file prints out; when I include them as glossrefs nothing prints (as expected).
I've included the map that links glossentry items into the map.
*** I've created glossentry topics like this:
<glossentry id="glossentry_ol4_ghm_jp">
<glossterm>Application Programming Interface (API)</glossterm>
<glossdef></glossdef>
<glossBody>
<glossSurfaceForm>Application Programming Interface (API)</glossSurfaceForm>
<glossAlt>
<glossAcronym>API</glossAcronym>
</glossAlt>
</glossBody>
</glossentry>
*** I've included a map of these glossentry items, each added as (and this map is added as a mapref in the main map):
<map>
<title>DITA Topic Map</title>
<topicref href="common/source/GLOS_acrm_API.dita" keys="api"/>
...
</map>
*** I've referenced the item in topic as follows:
<li>Use the provided <abbreviated-form keyref="api"/> to do xyz...</li>
and this works as expected.
But I want to additionally include a list of acronyms.
Thanks so much for your time and help
I hope this is in the right place?
And I'll say thanks for your time first before getting into all the verbose detail below: )
I want to add a list of acronyms (loa) in my output (PDF and webhelp at this time). This should show the glossterm or glossSurfaceForm text (in my case, both are the same: I am happy to use either if I can get it working). In other words, it would print the long form of the glossentry and not the <abbreviated-form>.
I don't want items in the loa to be linked.
So I want a page in the PDF that is:
Acronyms used in this Help
Application Programming Interface (API)
Point of Sales (POS)
...
I don't want to print the entire acronym file (only either the <glossterm> or the <glossSurfaceForm>).
But I am also using the <abbreviated-form> as normal to reference the terms (glosssurfaceform on first occurrence, acronym on subsequent uses), and this all works perfectly.
I use a <map> to bind my topics (not a bookmap).
I've created a map to hold glossentry items: when I include them as topicrefs, the entire glossentry file prints out; when I include them as glossrefs nothing prints (as expected).
I've included the map that links glossentry items into the map.
*** I've created glossentry topics like this:
<glossentry id="glossentry_ol4_ghm_jp">
<glossterm>Application Programming Interface (API)</glossterm>
<glossdef></glossdef>
<glossBody>
<glossSurfaceForm>Application Programming Interface (API)</glossSurfaceForm>
<glossAlt>
<glossAcronym>API</glossAcronym>
</glossAlt>
</glossBody>
</glossentry>
*** I've included a map of these glossentry items, each added as (and this map is added as a mapref in the main map):
<map>
<title>DITA Topic Map</title>
<topicref href="common/source/GLOS_acrm_API.dita" keys="api"/>
...
</map>
*** I've referenced the item in topic as follows:
<li>Use the provided <abbreviated-form keyref="api"/> to do xyz...</li>
and this works as expected.
But I want to additionally include a list of acronyms.
Thanks so much for your time and help