Tagging "production" vs. "non-production" content in DITA topics

Posts: 9
Joined: Wed Jan 04, 2017 3:48 pm

Tagging "production" vs. "non-production" content in DITA topics

Post by gchale3rd » Fri Aug 17, 2018 10:58 pm

I am currently migrating WebHelp topics authored in RoboHelp to DITA topics authored in Oxygen. I need a way to control the environment (Production vs. QA or Test) to which topics or content chunks within a topic should be published.

Example: I have a topic or a content chunk that I only want to display in the QA and Test environments. In RoboHelp, I apply a conditional tag to the topic or content chunk. When I compile the help output for the QA and Test environments, I include the conditional tag in my build. When I compile the help output for the Production environment, I exclude the conditional tag from my build.

Is there a way to achieve this same control with DITA topics in Oxygen?

In Oxygen, I am using a DITA OT transform to output the topics as JSON objects. The JSON objects in turn are consumed by our portal using an API that we developed.

Posts: 669
Joined: Mon Dec 05, 2011 6:04 pm

Re: Tagging "production" vs. "non-production" content in DITA topics

Post by Costin » Mon Aug 20, 2018 1:06 pm


You could use the profiling support in oXygen to include/exclude some resources in the resulted output.
Fore more information on using profiling attributes/condition sets or using a ditaval file to filter those resources, please consult our User-Guide:
https://www.oxygenxml.com/doc/versions/ ... odes2.html
https://www.oxygenxml.com/doc/versions/ ... -file.html

There are also some video demonstrations that show how profiling works in oXygen.
Just type "profiling" in the search filter from the Video resources section on our website to see only the relevant videos.

Costin Sandoi
oXygen XML Editor and Author Support

Post Reply