Re: [Doxygen-develop] DITA XML Output cxxAPIMap.dtd Missing

[<jon...@no...>]

Hi, Joel.

To build the doxygen generated DITA (or the qdoc generated DITA for that matter) you need to install the Cxx specialisation plug-in which can be downloaded from https://projects.developer.nokia.com/doxygen_dita/files/cxxapirefv0.7.0.zip. The Cxx plug-in depends on the apiref plug-in so you will need to install that also. It's available for download from the DITA OT website.

Instructions on how to install a plug-in are available on the DITA OT sourceforge site, http://dita-ot.sourceforge.net/dev_ref/useplugin.html.

That will produce a basic html build of your content. You will then want to create your own plug-in that contains the css etc. that you want to apply to the documentation.

Regards,
Jonathan.

-----Original Message-----
From: ext Joel Sherrill [mailto:joe...@OA...] 
Sent: 07 July 2011 19:55
To: Harrington Jonathan (Nokia-SD/London)
Cc: dox...@li...
Subject: DITA XML Output cxxAPIMap.dtd Missing

Hi,

I hope I am not wandering too far from Doxygen.
Using the Nokia patch, I now have generated DITA XML for RTEMS.  I placed it in a dita subdirectory next to the latex and html.
I have installed the dita-ot 1.5.3 and
can build its html help sample OK.

I took their ant file and copied it to the Doxygen dita output directory.  It runs along for a bit and then ends with this:

BUILD FAILED
/users/joel/doxygen/onlinedocs/doxygen/cpukit/dita/doxygen_html.xml:25: 
The following error occurred while executing this line:
/users/joel/doxygen/DITA-OT1.5.3/build.xml:27: The following error occurred while executing this line:
/users/joel/doxygen/DITA-OT1.5.3/build_preprocess.xml:30: Failed to run
pipeline: [DOTJ012F][FATAL] Failed to parse the input file 'RTEMS CPU Kit with SuperCore.ditamap' due to the following exception. This may indicate that a plug-in for your document type is missing. Please correct the input based on the following message from the XML parser: 
:/users/joel/doxygen/onlinedocs/doxygen/cpukit/dita/dtd/cxxAPIMap.dtd
(No such file or directory)

I think it is pretty clear the the Doxygen generated DITA XML expects to find a cxxAPIMap.dtd file.
Where does one get this set of DTDs?

I am assuming it is obvious once I have a kit of the DTD files where they go in the dita-ot.

Thanks in advance.

-- 
Joel Sherrill, Ph.D.             Director of Research&  Development
joe...@OA...        On-Line Applications Research
Ask me about RTEMS: a free RTOS  Huntsville AL 35805
    Support Available             (256) 722-9985