Which DITA 1.2 Feature

13 views
Skip to first unread message

Tatyana P

unread,
Jun 19, 2017, 11:25:53 AM6/19/17
to DITA-OT Users
Hello,

I'm new to the DITA 1.2 and 1.3 features. Could you advise on what feature to use to resolve the following scenario:

Reuse the same topic in a couple of places in the same publication but in the two places its content slightly differs.

Might have seen this advertised in one of the DITA conferences but can't quite say whether that were keys or something else.

Thank you.

Radu Coravu

unread,
Jun 20, 2017, 1:07:28 AM6/20/17
to Tatyana P, DITA-OT Users
Hi Tatyana,

There is no DITA 1.2 feature to help you with this.
But with DITA 1.3 there is a feature called key scoping which can be used to this effect.
I wrote some time ago a small blog post about DITA 1.3 key scopes:
http://blog.oxygenxml.com/2015/08/dita-13-key-scopes-next-generation-of.html

Regards,
Radu

--
You received this message because you are subscribed to the Google Groups "DITA-OT Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to dita-ot-users+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Eliot Kimber

unread,
Jun 20, 2017, 10:34:00 AM6/20/17
to Radu Coravu, Tatyana P, DITA-OT Users
In DITA 1.2 you have two options:

1. Use conref push to push different content into the same base topic used in two different locations. Use @keys on the topicrefs to the topic being pushed to and use @copy-to on each topicref to ensure you get distinct result files.
2. Create a base topic that has the common content and then create separate topics that have just the differences and conref the common content into the topics with the differences.

As Radu says, DITA 1.3 key scopes address this requirement much better, if DITA 1.3 is an option for you.

Cheers,

Eliot
--
Eliot Kimber
Reply all
Reply to author
Forward
0 new messages