dvrResourceSuffix

Benny
Posts: 11
Joined: Wed Mar 01, 2017 12:33 pm

dvrResourceSuffix

Post by Benny » Tue Jan 08, 2019 5:29 pm

I am trying to better understand ditaval processing and dvrResourceSuffix.

If I would have the following map file, with file name: "datasheet-TMX.ditamap"

Code: Select all


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<map>
<title>Datasheet</title>
<ditavalref href="ditaval/TMX-53xCXP-S0020.ditaval">
<ditavalmeta>
<dvrResourceSuffix>-53xCXP-S0020</dvrResourceSuffix>
</ditavalmeta>
</ditavalref>
<ditavalref href="ditaval/TMX52-40xCLS-S00.ditaval">
<ditavalmeta>
<dvrResourceSuffix>52-40xCLS-S00</dvrResourceSuffix>
</ditavalmeta>
</ditavalref>
<keydef keys="general_reusables" href="datasheets-reuseables-container.dita"/>
<topicref href="functionality/tmx_cmos_functionality.dita"/>
<topicref href="interface/tmx_cmos_interface.dita"/>
<topicref href="mechanical/tmx_cmos_mounting_accuracy.dita"/>
<topicref href="compliance_reliability/tmx_cmos_compliance_reliability.dita"/>
<topicref href="cameramodels/tmx_cmos_models.dita"/>
</map>
I actually expected to get two pdfs out:
datasheet-TMX-53xCXP-S0020.pdf
datasheet-TMX52-40xCLS-S00.pdf

(I am using the "DITA Map PDF - based on HTML 5 & CSS" transformation scenario)
This expectation was set by the following source: https://www.oxygenxml.com/dita/1.3/spec ... uffix.html

Can someone explain why this does not work, or how I could get it working? I could make a transformation scenario for each datasheet, but I wonder if I could process them in series by using the dvrResourceSuffix. Also actually if I make a transformation scenario for each datasheet, where should I set the file name?

Radu
Posts: 6141
Joined: Fri Jul 09, 2004 5:18 pm

Re: dvrResourceSuffix

Post by Radu » Wed Jan 09, 2019 9:22 am

Hi Benny,

Maybe you could also ask this question on the DITA Users List as most of the members of the committee which developed the DITA 1.3 standard are registered on it.
From what I understand (and also the publishing works this way) the "dvrResourceSuffix" is used and has meaning when producing HTML-based documentation as in the output folder you fill have various HTML files having that suffix.
When generating PDF, you get only one PDF no matter how many "ditavalref" elements you have in the DITA Map, but that PDF will contain the merged branches of the publication.
So indeed if you want to obtain multiple PDFs, you need to apply multiple transformation scenarios.
In each transformation scenario in the "Parameters" list there is a "args.output.base" parameter which lets you define the name of the output PDF file.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

Benny
Posts: 11
Joined: Wed Mar 01, 2017 12:33 pm

Re: dvrResourceSuffix

Post by Benny » Fri Jan 11, 2019 6:59 pm

Hi Radu,

Thanks for the answer. It seems I thus have to use output scenarios.

However the args.output.base does not seem to exist in the standard list with parameters for the DITA map to pdf based on HTML5 & CSS scenario.

I tried to just add it but this did not change the output file name.

In the DITA map to pdf based on XSL FO there is the outputFile.base parameter. I tried to add this parameter to the based on HTML5 & CSS scenario but also this did not change the output file name.

Do you have any other suggestion?

Thanks

Radu
Posts: 6141
Joined: Fri Jul 09, 2004 5:18 pm

Re: dvrResourceSuffix

Post by Radu » Tue Jan 15, 2019 2:32 pm

Hi Benny,

Somehow I considered that you were using the classic XSL-FO based PDF output.
The args.output.base parameter will start to properly work for CSS-based publishing starting with Oxygen 21 (February 2019).

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

Post Reply