Generating DITA XML Output
QDoc can generate DITA XML output.
In your configuration file, set your outputformats
variable to DITAXML
, and send the output to an appropriate directory:
outputdir = $QTDIR/doc/ditaxml outputformats = DITAXML
And include these macros in your configuration file to prevent QDoc from doing some escaping that doesn't validate in XML:
macro.aacute.DITAXML = "á" macro.Aring.DITAXML = "Å" macro.aring.DITAXML = "å" macro.Auml.DITAXML = "Ä" macro.br.DITAXML = " " macro.BR.DITAXML = " " macro.copyright.DITAXML = "©" macro.eacute.DITAXML = "é" macro.hr.DITAXML = " " macro.iacute.DITAXML = "í" macro.oslash.DITAXML = "ø" macro.ouml.DITAXML = "ö" macro.raisedaster.DITAXML = "<sup>*</sup>" macro.rarrow.DITAXML = "→" macro.reg.DITAXML = "<sup>®</sup>" macro.uuml.DITAXML = "ü" macro.mdash.DITAXML = "—" macro.emptyspan.DITAXML = " "
You can also set default values for some of the tags in the DITA <prolog>
and <metadata>
elements:
dita.metadata.default.author = Qt Development Frameworks dita.metadata.default.permissions = all dita.metadata.default.publisher = Qt Project dita.metadata.default.copyryear = 2018 dita.metadata.default.copyrholder = Qt Project dita.metadata.default.audience = programmer
See the \meta command for more details on DITA metadata.
© 2019 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.