Create DITA content with multiple same conkeyrefs

Posts: 5

Create DITA content with multiple same conkeyrefs

Thu Sep 06, 2018 5:02 am

We would like to create DITA content with conkeyref.
conkeyref defines several identical keys,
For example, I would like to control which keys are referred to by filtering with keys such as ditavalref.

Code: Select all

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE bookmap PUBLIC "-//OASIS//DTD DITA BookMap//EN" "bookmap.dtd">
        <mainbooktitle>Autoring Test</mainbooktitle>
        <ditavalref href="ja.ditaval"/>
        <topicref keys="IMG" targetDestination="ja" href="cImageDefinition-ja.dita"/>
        <topicref keys="IMG" targetDestination="en" href="cImageDefinition-en.dita"/>
    <chapter navtitle="Image Authoring Test">
        <topicref href="cImageAuthoringTest.dita" format="dita"/>

In the case of inserting an element to be referenced by selecting a key to be reused from the GUI of oXygen,
We seems it is useful to use the Reuse Content window or the DITA Reusable Components view.
However, if more than one same conkey ref key is defined, the Reuse Content window will only refer to the previously defined key.
In the Components tab of the DITA Reusable Components view, all the keys are displayed.

After defining multiple conkeyrefs of the same key, we want to distinguish which key to use,
for example in a way like ditavalref, and display only one of the keys in these views.

ditavalref does not have to be used necessarily.
It is not necessary to use Reuse Content window or DITA Reusable Components view only. We can also use other UI.

Is there a way to display only one of the keys in these views?
Posts: 5987

Re: Create DITA content with multiple same conkeyrefs

Thu Sep 06, 2018 8:49 am

Hi Aruga,

Oxygen does not use ditalref information when gathering keys from the DITA Map. You can specify more than one ditavalref element inside a topicref and this in effect branches the publishing but on the editing side it would be quite unclear how to present keys if for example in the frontmatter you would do this:

Code: Select all

        <ditavalref href="ja.ditaval"/>
        <ditavalref href="en.ditaval"/>

We do have something called "Profiling condition sets".
In the Oxygen Preferences->Editor / Edit Modes / Author / Profiling/Conditional Text page there is a "Profiling Condition Sets" table. You can add a new profiling condition set there are refer to a DITAVAL file from it.
Then if the main DITA Map is opened in the DITA Maps Manager view, there is a funnel-shapped drop down button on the toolbar which allows you to apply a profiling condition set. Oxygen will start gathering keys and presenting based on that applied filter. You can create more than one profiling condition sets, for example one for Japanese and one for English.

Radu Coravu
<oXygen/> XML Editor
Posts: 5

Re: Create DITA content with multiple same conkeyrefs

Thu Sep 06, 2018 10:48 am

Hi Radu,

Thank you for your quick reply.
* I forgot to write a greeting in my previous sentence. Sorry.

oXygen Editor is wonderful!
Our problem is solved by "Profiling Condition Sets".
Thank you very much.


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

Who is online

Users browsing this forum: No registered users and 0 guests