Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

xref with format pdf, txt, .. do not work properly in DITA OT 3.x

See original GitHub issue

Expected Behavior

I have a dita Topic that contains file references to different formats (txt, pdf, docx, zip). The files are located in the same Directory as the dita Topic file. When transforming this Topic to xthml I would expect that the files are also copied to the Output Directory. According to the spec at least pdf and txt should be supported: https://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/langRef/attributes/theformatattribute.html

<!DOCTYPE dita PUBLIC "-//OASIS//DTD DITA Composite//EN" "ditabase.dtd">
<dita>
  <topic id="id_40a72787efc94c2a8bb6e60f8cac2b2c">
	<title>Test</title>
	<shortdesc>Test format attribute with zip, pdf, ...</shortdesc>
	<body>
		<p>
			<ul>
				<li><xref href="Test.pdf" format="pdf">pdf file</xref></li>
				<li><xref href="Test.zip" format="zip">zip file</xref></li>
				<li><xref href="Test.docx" format="docx">docx file</xref></li>
				<li><xref href="Test.txt" format="txt">txt file</xref></li>
			</ul>
		</p>
	</body>
  </topic>
</dita>

Actual Behavior

With DITA OT 2.4 all files are copied to the Output Directory and the links work correctly. With DITA OT 3.x the files are NOT copied to the Output Directory. Consequently the links do not work.

Possible Solution

Steps to Reproduce

Copy of the error message, log file or stack trace

Environment

DITA-OT version: dita-ot 3.0.2
Operating system and version: Windows
How did you run DITA-OT? (dita command, Ant, startcmd, oXygen, other editor, CMS, etc.)

//Xhtml with dita-ot 3.0.2
"C:\dita-ot-3.0.2\bin\dita" --input=Test.ditamap --output=out\xhtml302 --format=xhtml --temp=temp302 --logfile=log302.xml --clean.temp=no --verbose

//Xhtml with dita-ot 2.4
"C:\\dita-ot-2.4\bin\dita" --input=Test.ditamap --output=out\xhtml24 --format=xhtml --temp=temp24 --logfile=log24.xml --clean.temp=no --verbose

Transformation type: xhtml

Issue Analytics

State:
Created 6 years ago
Reactions:1
Comments:10 (10 by maintainers)

Top GitHub Comments

2reactions

jelovirtcommented, Jan 10, 2019

I think the most Ant-like option would be to add support for

<ditafileset>
  <exclude format="dita"/>
  <exclude format="ditamap"/>
  <exclude format="ditaval"/>
</ditafileset>

0reactions

raducoravucommented, Dec 20, 2018

Something like:

     <ditafileset format="dita" exclude="true"/>

which would mean copy all resources excluding the “dita” ones. And afterwards we would join the “copy-image” and “copy-html” targets to a single “copy-other” target.

Top Results From Across the Web

DITA-OT error messages

Message ID Severity Message text DOTA013F Fatal Cannot find the specified DITAVAL ' %1 '. DOTJ012F Fatal Failed to parse the input file ' %1...

xref to PDF - PDF is not being copied to the output directory

I have tried using the using generate.copy.outer=3 parameter. ... The DITA OT won't copy that PDF just because you put it in an...

Xref text resolution on elements without title - Oxygen XML Editor

Hi, In DITA if you use an xref without text, that's the title of linked element that it gets in output (PDF,WebHelp).

DITA Open Toolkit Release 1.6

generate-debug-attributes controls debug attribute generation and can be used to reduce ... #948 For PDF output, xml:lang does not work at the element...

External reference (xref) file is missing or unresolved in ...

Opening a drawing shows a message about missing xrefs. "One or more referenced files could not be located or read. What do you...