[Fatal Error] stage2.fo:1:17127: The reference to entity "T2" must end with the ';' delimiter.

[DeekshaBhagat]

DITA Version - 4.2.3
Using Dita Java API to create pdf from the topic using a custom plugin.

The topic.xml contains ampersand. We are escaping ampersand with "&" before sending it to dita-ot.
Still, we get the error
"[Fatal Error] stage2.fo:1:17127: The reference to entity "T2" must end with the ';' delimiter."

topic.xml

<title >T&1</title>

desc

This topic fails while rendering

Kindly help with the issue. I have sent a full day. Couldn't find anything yet.

[jlacour31]

Have you tried escaping ampersand using & in the DITA source file?

[jlacour31]

From what I tested, transforming a ditamap containing a similar topic with the default DITA-OT 4.2.3 PDF2 plugin generates a correct output:

Could you try to generate the PDF without any custom plugin? By simply running something like: dita -v -f pdf2 -i map.ditamap -o out\pdf

[DeekshaBhagat]

True it works fine with pdf2. When I run the dita-ot command in the command prompt, it works fine.
I used the below command on a Windows machine -
dita --input=D:/work_dsi/DITAOT/input/topic.xml --format=pdf2 -o D:/work_dsi/DITAOT/out

But, we use DITA-OT java API to render PDFs.

try {
ProcessorFactory pf = ProcessorFactory.newInstance(ditaOTDir);
pf.setBaseTempDir(ditaTempDir);
Processor p = pf.newProcessor(renderFormat).setInput(mapFile).setOutputDir(outDir).createDebugLog(true)
.setProperties(ditaProperties).cleanOnFailure(true);
p.run();
}

Rendering fails at p.run()

Error - Caused by: java.io.IOException: Failed to read document: The reference to entity "T2" must end with the ';' delimiter.
at org.dita.dost.store.StreamStore.getDocument(StreamStore.java:73)
at com.idiominc.ws.opentopic.fo.i18n.PreprocessorTask.execute(PreprocessorTask.java:75)
... 36 common frames omitted
Caused by: org.xml.sax.SAXParseException: The reference to entity "T2" must end with the ';' delimiter.
at org.apache.xerces.parsers.DOMParser.parse(Unknown Source)
at org.apache.xerces.jaxp.DocumentBuilderImpl.parse(Unknown Source)
at java.xml/javax.xml.parsers.DocumentBuilder.parse(DocumentBuilder.java:178)
at org.dita.dost.store.StreamStore.getDocument(StreamStore.java:71)
... 37 common frames omitted

[DeekshaBhagat]

Do you think this is any bug in the current dita-ot version or dita-ot Java API

[raducoravu]

Are you sure the "mapFile" on which you apply the processing from the Java code is the same file with the "topic.xml" on which you applied the command line publishing? Or is it possible from the Java code you are applying the transformation on a DITA Map which refers to multiple topics, of which one of them has inside something like "&T2" instead of having it escaped like "&amp;T2"?

[DeekshaBhagat]

DitaMap.xml file

topic1.xml

The error -
[Fatal Error] :1:353: The reference to entity "M2" must end with the ';' delimiter.
[Fatal Error] stage2.fo:1:17127: The reference to entity "T2" must end with the ';' delimiter.

The logs -
2025-02-06 15:11:11
/ExecutionFramework/linux_a64/docs/javaserver/dita-ot/plugins/org.dita.pdf2/build.xml:337: java.io.IOException: Failed to read document: The reference to entity "T2" must end with the ';' delimiter.
at org.apache.tools.ant.ProjectHelper.addLocationToBuildException(ProjectHelper.java:582)
at org.apache.tools.ant.taskdefs.Ant.execute(Ant.java:440)
at org.apache.tools.ant.taskdefs.CallTarget.execute(CallTarget.java:106)
at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:299)
at java.base/jdk.internal.reflect.DirectMethodHandleAccessor.invoke(DirectMethodHandleAccessor.java:103)
at java.base/java.lang.reflect.Method.invoke(Method.java:586)
at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:99)
at org.apache.tools.ant.Task.perform(Task.java:350)
at org.apache.tools.ant.Target.execute(Target.java:449)
at org.apache.tools.ant.Target.performTasks(Target.java:470)
at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1401)
at org.apache.tools.ant.Project.executeTarget(Project.java:1374)
at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExecutor.java:41)
at org.apache.tools.ant.Project.executeTargets(Project.java:1264)
at org.dita.dost.Processor.run(Processor.java:233)
... 12 common frames omitted
Caused by: org.apache.tools.ant.BuildException: java.io.IOException: Failed to read document: The reference to entity "T2" must end with the ';' delimiter.
at com.idiominc.ws.opentopic.fo.i18n.PreprocessorTask.execute(PreprocessorTask.java:100)
at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:299)
at java.base/jdk.internal.reflect.DirectMethodHandleAccessor.invoke(DirectMethodHandleAccessor.java:103)
at java.base/java.lang.reflect.Method.invoke(Method.java:586)
at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:99)
at org.apache.tools.ant.Task.perform(Task.java:350)
at org.apache.tools.ant.Target.execute(Target.java:449)
at org.apache.tools.ant.Target.performTasks(Target.java:470)
at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1401)
at org.apache.tools.ant.helper.SingleCheckExecutor.executeTargets(SingleCheckExecutor.java:36)
at org.apache.tools.ant.Project.executeTargets(Project.java:1264)
at org.apache.tools.ant.taskdefs.Ant.execute(Ant.java:437)
... 25 common frames omitted
Caused by: java.io.IOException: Failed to read document: The reference to entity "T2" must end with the ';' delimiter.
at org.dita.dost.store.StreamStore.getDocument(StreamStore.java:73)
at com.idiominc.ws.opentopic.fo.i18n.PreprocessorTask.execute(PreprocessorTask.java:75)
... 36 common frames omitted
Caused by: org.xml.sax.SAXParseException: The reference to entity "T2" must end with the ';' delimiter.
at org.apache.xerces.parsers.DOMParser.parse(Unknown Source)
at org.apache.xerces.jaxp.DocumentBuilderImpl.parse(Unknown Source)
at java.xml/javax.xml.parsers.DocumentBuilder.parse(DocumentBuilder.java:178)
at org.dita.dost.store.StreamStore.getDocument(StreamStore.java:71)
... 37 common frames omitted
2025-02-06 15:11:11
org.dita.dost.exception.DITAOTException: null
at org.dita.dost.Processor.run(Processor.java:236)

Note - Could this be an encoding issue?

[DeekshaBhagat]

The PDF rendering fails, when we use our custom plugin.
We also use theme file to decorate our pdf.

We are referencing com.elvorita.pdf plugin.
Looks like something fails, whenever we apply themes only.