Skip to main content
hadih26673991
Inspiring
September 23, 2019
Question

DITA referencing and conref

  • September 23, 2019
  • 1 reply
  • 1141 views

Hi, I have a question regarding the use of conref in DITA. I have created a simple DITA concept file, see attached for a snapshot of the structure view. In this file, I have few nested concepts with clear ids. Now, I would like to refer to the individual concepts of this file using conref. What I have in mind is something like text insets. For instance, I would like to pull only the concept "europe" into a different file. Using a ditamap, I was only able to pull the whole file into the ditamap. But this is not exactly what I have in mind as I would like to avoid breaking down my files into very small pieces.

 

Hadi

This topic has been closed for replies.

1 reply

Adobe Employee
September 24, 2019

Hi Hadi

 

Can you share some more details or probably drop me an email and i could help you out with the same.

 

Thanks

Amitoj Singh

Email: amisingh@adobe.com

hadih26673991
Inspiring
September 24, 2019

Hi Amitoj, Thank you for your help. I have prepared a graphics, helping me explain, see attached. Basically, what I am trying to build is a structured user manual interface or call it a project, where I can store small pieces of topics inside bigger xml files as warehouse topics. These xml files can include from one to multiple topics with individual IDs that I can use later on to refer to. In my project, we have a user manual for each of our products as well as for each language (each user manual is translated into some different languages). And since there are many identical parts between the different user manuals as well as between the different languages, we would like to benefit from the re-use ability of structured authoring. In my short search in the web, I realized that DITA offers different ways of doing that. One way would be conref. Maybe I understood it wrong, but what I realized is that with conrefs, one can create different smaller topics in an xml files and then independently reuse those topics in other xml files or in a ditamap. However, when I created a ditamap, I was not able to pull the individual concepts that I have marked in my DITA concept files. In the ditamap, I do not see conref as an element like topicref. Using topicref, I insert the whole xmlfile into the ditamap though. Best, Hadi