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

Posts: 9

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

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: 428

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

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

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

Who is online

Users browsing this forum: No registered users and 2 guests