<abbreviated-form keyref="xxx"/>

Bob.Conlin
Posts: 22

<abbreviated-form keyref="xxx"/>

Sun Aug 21, 2011 8:18 am

I figured out abbrevlist rendering a glosslist, that works ok. Next I'm trying to get <abbreviated-form keyref="xxx"/> to work. I have the glossary information in place that works to populate the abbrevlist but when I try <abbreviated-form keyref="xxx"/> nothing is rendered in the topic.
In Acronyms.dita My gloss entry looks like this:
<glossentry id="xxx">
<glossterm>Test Acronym (xxx)</glossterm>
<glossBody>
<glossSurfaceForm>Test Acronym</glossSurfaceForm>
<glossAlt>
<glossAcronym>xxx</glossAcronym>
</glossAlt>
</glossBody>
</glossentry>

In the map I have:
<glossref keys="xxx" href="Acronyms.dita"/>
<topicref href="Test_Topic.dita"/>

In the topic I have:
<abbreviated-form keyref="xxx"/> a couple of times.

My understanding is that the SurfaceForm should render on first usage and the Acronym should render on every occurrence thereafter. I get nothing in any occurrence. What am I missing? Thanks for the help.
Radu
Posts: 5221

Re: <abbreviated-form keyref="xxx"/>

Tue Aug 23, 2011 11:08 am

Hi Bob,

Sorry for the delay, we are getting close to releasing Oxygen 13.
I also took a look at the samples you sent on our support email address.
As you may know Oxygen uses the DITA Open Toolkit to publish DITA content to various output sources.

In my opinion if you had a glossgroup like this:

Code: Select all

<glossgroup id="ggr">
  <title>Acronyms</title>
  <glossentry id="glossEntryID">....


and it was referenced in the DITA Map like this:

Code: Select all

 <glossref keys="keyName" href="AcronymTestGloss.dita"/>...


then the correct way to reference it would be like:

Code: Select all

<abbreviated-form keyref="keyName/glossEntryID"/>


So the key ref also needs to specify the ID of the glossentry inside the glossgroup (as there may be more than one glossentries in the file).
Unfortunately this approach does not seem to work neither in the XHTML or PDF outputs.

If you had a standalone glossentry DITA file like this:

Code: Select all

<glossentry id="glossEntryID">....


which was referenced in the DITA Map like:

Code: Select all

 <glossref keys="keyName" href="glossentry.dita"/>...


then the correct way to reference it would be like:

Code: Select all

<abbreviated-form keyref="keyName"/>


The second approach works for XHTML but not for PDF. Actually I added a bug for this on the DITA Bugs List a while ago.

http://sourceforge.net/tracker/index.php?func=detail&aid=3137178&group_id=132728&atid=725074

Unfortunately the bug was not resolved.

I think this is a case in which the DITA 1.2 specification was not yet properly implemented in the DITA Open Toolkit publishing processor.
Maybe you can also ask around on the DITA Users List, see what workarounds others are using.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Bob.Conlin
Posts: 22

Re: <abbreviated-form keyref="xxx"/>

Fri Aug 26, 2011 6:21 am

Thanks for checking it out for me. I thought the problem was something I was doing. The OT is up to 1.5.4. Is there a way to test with that OT?
Radu
Posts: 5221

Re: <abbreviated-form keyref="xxx"/>

Fri Aug 26, 2011 9:12 am

Hi Bob,

Oxygen comes with a bundled DITA OT installation but it does not force you to use the bundled version for your transformations.
You can edit your transformation scenario to point to another DITA OT installation like:

http://www.oxygenxml.com/doc/ug-oxygen/index.html?q=/doc/ug-oxygen/tasks/use-new-dita-ot.html

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

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

Who is online

Users browsing this forum: No registered users and 3 guests