Generating DITA XML Output

QDoc Manual.

Article lu fois.

L'auteur

The Qt Company Ltd.

L'article

Publié le 27 décembre 2024 - Mis à jour le 27 décembre 2024

Liens sociaux

Generating DITA XML Output▲

<Unknown command>contentspageQDoc Manual

QDoc can generate DITA XML output.

In your configuration file, set your outputformats variable to DITAXML, and send the output to an appropriate directory:

Sélectionnez

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:

Sélectionnez

macro.aacute.DITAXML       = "&amp;aacute;"
macro.Aring.DITAXML        = "&amp;Aring;"
macro.aring.DITAXML        = "&amp;aring;"
macro.Auml.DITAXML         = "&amp;Auml;"
macro.br.DITAXML           = " "
macro.BR.DITAXML           = " "
macro.copyright.DITAXML    = "&amp;copy;"
macro.eacute.DITAXML       = "&amp;eacute;"
macro.hr.DITAXML           = " "
macro.iacute.DITAXML       = "&amp;iacute;"
macro.oslash.DITAXML       = "&amp;oslash;"
macro.ouml.DITAXML         = "&amp;ouml;"
macro.raisedaster.DITAXML  = "&lt;sup&gt;*&lt;/sup&gt;"
macro.rarrow.DITAXML       = "&amp;rarr;"
macro.reg.DITAXML          = "&lt;sup&gt;&amp;reg;&lt;/sup&gt;"
macro.uuml.DITAXML         = "&amp;uuml;"
macro.mdash.DITAXML        = "&amp;mdash;"
macro.emptyspan.DITAXML    = " "

You can also set default values for some of the tags in the DITA <prolog> and <metadata> elements:

Sélectionnez

dita.metadata.default.author      = Qt Development Frameworks
dita.metadata.default.permissions = all
dita.metadata.default.publisher   = Qt Project
dita.metadata.default.copyryear = 2020
dita.metadata.default.copyrholder = Qt Project
dita.metadata.default.audience = programmer

See the \meta command for more details on DITA metadata.

▲

< minimum.qdocconf

QA Pages >

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants :