Cannot transform DocBook topic to PDF?

Here should go questions about transforming XML with XSLT and FOP.
Posts: 88
Joined: Wed Feb 11, 2015 11:25 pm
Location: San Francisco, California USA

Cannot transform DocBook topic to PDF?

Post by RBVanDyke » Wed Jan 01, 2020 10:55 pm

For <oXygen/> XML Editor 21.1, build 2019120214.

I receive errors when trying to generate a one-page DocBook 5.1 topic as PDF.

I've only just begun exploring DocBook. So the problem may simply be my inexperience.
  • The DocBook topic's XML validates without error
  • Transformation Scenario == XML with XSLT -> DocBook PDF
The transformation fails to complete. oXygen XML outputs the following Transformation Problems message:
System ID: /home/rbv/oXygenProjects/DocBook0501/DBOOK_0501_Resume_as_topic.xml
Scenario: DocBook PDF
XML file: /home/rbv/oXygenProjects/DocBook0501/DBOOK_0501_Resume_as_topic.xml
XSL file: /usr/local/oxygen/frameworks/docbook/xsl/fo/docbook_custom.xsl
Document type: DocBook 5
Engine name: Saxon6.5.5
Severity: error
Description: Processing terminated by xsl:message at line 164

The Messages tab contains the following:
System ID: /usr/local/oxygen/frameworks/docbook/xsl/fo/profile-docbook.xsl
Description: [Saxon6.5.5] ERROR: Document root element for FO output must be one of the following elements: appendix article bibliography book chapter colophon dedication glossary index part preface qandaset refentry reference sect1 section set setindex
Start location: 164:0
It's easy to see that topic is NOT included in the list of acceptable document root elements for FO.

Is the absence of topic an accidental omission? Seems to this newbie that one should be able to transform a DocBook 5.1 topic into PDF?

Cheers & thanks in advance,

Posts: 7431
Joined: Fri Jul 09, 2004 5:18 pm

Re: Cannot transform DocBook topic to PDF?

Post by Radu » Mon Jan 06, 2020 4:00 pm

Hi Riley,

For topics, I once tried using them in a DocBook assembly file by applying an intermediary XSLT to expand the DocBook assembly to a DocBook article, but I did not try to output one DocBook topic directly to PDF. Probably there are very few people using DocBook topics.

This is probably a good question to ask on the DocBook users list. They seem to be working on new changes to the DocBook XSLTs but I don't think they officially released a new version of the XSLTs.

Radu Coravu
<oXygen/> XML Editor

Post Reply