Linking content reference files to a ditamap?

[cmsigman]

Hi all

I am posting this on behalf of a former student who, with very little DITA background, has been tasked with some prototyping for her company. Unfortunately I have not worked in a DITA shop for some years, so my own command is rusty. We are hoping someone here can help out!

She has created a very basic DITA project in oXygen 16.1. The project has some simple topics, a few topics with content references, and some topics that use attributes for filtering. She is attempting to import the project into another tool, but it appears that the only files that import from the oXygen project are those that are immediately connected to the ditamap. Anything that is not part of the map (such as all of the .dita files created when she makes a new conref file) is saved in the referenced folder.

She is trying to determine whether she missed a step when creating her project or saving the conref files. Is there a place to put the files so they would be part of the map?

Thanks for any help you can provide.

Christine Sigman

[Radu]

Hi Christine,

Probably that import tool she is using looks and imports only topics directly linked in the DITA Map.
So your student could refer to each topic which contains reusable content also in the DITA Map with references like:

Code: Select all

<topicref href="reusables/reusableFigures.dita" processing-role="resource-only"/>

This will mean that the "reusableFigures.dita" topic will not appear in the TOC but that importing tool might take it into account for the import.

Or course I also agree with the advice you received on the DITA Users list, you could use keys and conkeyrefs and use keydef's in the DITA Map to refer to the reusable content topics.

Regards,
Radu