[oXygen-user] Analyzing Map Validation Logs

Radu Coravu
Fri Sep 17 03:35:26 CDT 2010

  Hi Roger,

Thanks for pointing out this situation.
If you know of others, they are welcomed.
So the smart thing to do for the validation checker would be not to 
report any error if the key definition has no reference defined on it.
We'll probably fix this also in a minor Oxygen 12 release.
So watch this feed to be notified when this happens:


Radu Coravu
<oXygen/>   XML Editor, Schema Editor and XSLT Editor/Debugger

On 9/17/2010 12:39 AM, Roger wrote:
> On 2010-09-16 08:53, Radu Coravu wrote:
>> We'll also try to add some more checkboxes in the dialog which
>> configures the DITA Map validation options so that users can have more
>> control and uncheck the warnings which are less important to them.
> Hi Radu,
> That would be useful indeed. I find the feature very useful and it has
> helped me spot a number of potential problems quickly, but the output is
> full of complaints about keys that are actually working fine.
> It seems to work OK when<keydef>  elements are used to associate a key with
> a file name like this:
>      <keydef keys="name-of-key" href="path/to/file.dita"/>
> But it doesn't seem to understand that<keydef>  elements can also be used to
> define variables like this:
>      <keydef keys="version">
>        <topicmeta>
>          <keywords>
>            <keyword></keyword>
>          </keywords>
>        </topicmeta>
>      </keydef>
> I use this approach a lot to maintain variable definitions in the master map
> file for a project, and then reference them in text like this:
> “What's new in<keyword keyref="productname"/>  <keyword keyref="version"/>”
> When used this way, the<oXygen/>  map validation routine complains there's
> no file associated with the key, but in this case that's not necessary and
> the text is substituted as intended in all output formats.
> Should I be doing something differently to please<oXygen/>, or does the
> tool need to learn this way of using keys?
> Regards,
> Roger

More information about the oXygen-user mailing list