Key definitions are not resolved when publishing an individual topic PDF

Post here questions and problems related to editing and publishing DITA content.
antonyterrence
Posts: 41
Joined: Thu Jun 02, 2022 1:39 pm

Key definitions are not resolved when publishing an individual topic PDF

Post by antonyterrence »

In Oxygen XML Author, key definitions are not resolved in the output when a single/individual topic is transformed PDF using the PDF XSL FO scenario. Is there a way to pass the key definitions map to the process. I used the args.resources parameter. But it's not working.
Radu
Posts: 9436
Joined: Fri Jul 09, 2004 5:18 pm

Re: Key definitions are not resolved when publishing an individual topic PDF

Post by Radu »

Hi Antony,

This should work, the args.resources publishing param was added for this exact use case.
https://www.dita-ot.org/dev/parameters/ ... .resources
What value did you set to it?
What errors do you get when publishing? Do you get any errors that the root map could not be processed for some reason?
Can you reduce your DITA topic to a very small sample with only a keyref for example? Do you have both keyrefs and conkeyrefs in the topic? Are both keyrefs and conkeyrefs not resolved in the PDF output? Or are only conkeyrefs not resolved?
How about if you also enable the "fix.external.refs" publishing parameter?

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
antonyterrence
Posts: 41
Joined: Thu Jun 02, 2022 1:39 pm

Re: Key definitions are not resolved when publishing an individual topic PDF

Post by antonyterrence »

Hi Radu,
I tried the following:
  • args.resources = file:/C:/git/-doc/common/keys.ditamap
  • args.resources = ../../common/keys.ditamap (relative path)
I also tried seting the fix.external.refs.com.oxygenxml param to true.
I keep getting this error:
[DOTX008E] File 'file:/C:/Program%20Files/Oxygen%20XML%20Editor%2024/file:/C:/git/doc/common/keys.ditamap' does not exist or cannot be loaded.
Last edited by antonyterrence on Mon Sep 05, 2022 10:21 am, edited 1 time in total.
Radu
Posts: 9436
Joined: Fri Jul 09, 2004 5:18 pm

Re: Key definitions are not resolved when publishing an individual topic PDF

Post by Radu »

Hi Antony,
How about if you try to pass it as a file path (and not URL path) like:

Code: Select all

args.resources = C:/git/-doc/common/keys.ditamap
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
antonyterrence
Posts: 41
Joined: Thu Jun 02, 2022 1:39 pm

Re: Key definitions are not resolved when publishing an individual topic PDF

Post by antonyterrence »

This combination seems to work:
  • The value of args.resources should be a file path.
  • generate.copy.outer = 3
  • fix.external.refs.com.oxygenxml = true
Post Reply