Re: [Doxygen-users] DocBook/XML
Brought to you by:
dimitri
Menu
▾
▴
Re: [Doxygen-users] DocBook/XML
|
From: Hunter M. <hma...@vi...> - 2001-10-26 17:12:42
|
Attached are 2 XSL stylesheets. They work against doxygen xml output. One (test.xsl) is to be used with fop to produce pdf. The other (dox2db.xsl) produces DocBook. See NOTEs. THESE STYLESHEETS ARE EXTREMELY CRUDE. :-) I basically started teaching myself this stuff when I hurt my back last weekend and started reading "The XSL Companion". Just yesterday I hacked the fo example into a DocBook example. It only formats a compound name at the top of a new page (in the pdf, the docbook appearance depends on the stylsheet you use with it), the compound detailed description, and then just dumps the memberdef type and name. It's more educational than useful. I have used test.xsl to produce a 205 page pdf (of a great deal of whitespace :-). The Docbook example is less tested as my docbook tools/skills are still fledgling. I am using doxygen 1.2.11.1 code -> xml fop 0.20.1 xsl+xml -> pdf saxon (see below) xsl+xml -> xml (docbook in this case) The saxon I use is the saxon-catalog package from the debian "testing" pool. I will include the package info below. Did I mention that these are VERY CRUDE and ignore most of the info that doxygen produces!!!!???? I hope this helps someone. I am sending this to devel (I hope) and users. Please forgive me if you find this annoying. I will not be so bothersome in the future. hunter EXAMPLE USAGE: ./fop.sh -xsl test.xsl -xml doxygen.xml test.pdf saxoncat doxygen.xml dox2db.xsl -o db.xml NOTE: There are descrepancies between the doxygen XML output and the DTD that is supplied with doxygen. Minor stuff, just be aware. NOTE!!!! The raw doxygen xml output is broken. For some reason, there are extra </highlight> tags that are thrown in before SOME </sourcecode> tags. The following perl script fixed MY example, your mileage may vary. A .bak backup file is made for you. perl -pi.bak -e 's#</highlight> </sourcecode>#</sourcecode>#;' file.xml *********** Output of "apt-cache show saxon-catalog" *********** Package: saxon-catalog Priority: optional Section: contrib/text Installed-Size: 108 Maintainer: Mark Johnson <mr...@de...> Architecture: all Version: 20000203-5 Depends: java-common, lib-saxon-java (>= 6.4.4), arbortext-catalog, libcrimson-java Suggests: docbook-xsl (>= 1.45) Filename: pool/contrib/s/saxon-catalog/saxon-catalog_20000203-5_all.deb Size: 11646 MD5sum: ad6d14954830316f502f434c7802c63f Description: Catalog support and wrapper the Saxon XSLT Processor This package provides a simple front-end to Saxon for processing XML source files with XSL stylesheets. Catalog support is provided by an extension class to Norm Walsh's Arbortext Catalog Classes. . A wrapper script for general saxon usage is also included. . This package works well for processing DocBook XML sources. . Author: Jirka Kosek <ji...@ko...> Homepage: http://www.kosek.cz/xml/saxon/ On Fri, Oct 26, 2001 at 07:31:30PM +0300, Anton G Sergeev wrote: > Petr, > > my proposal is to switch output format to DocBook and use another (not > DoxyGen) tools to generate output forms. There are a lot of tools you can > use to produce HTML, HTML Help, PDF etc. from one DocBook/XML source. > > With best regards, > Anton. > > > > > > "Prikryl,Petr" <PRI...@sk...> > 26.10.2001 17:30 > > > To: Anton G Sergeev <ag...@ml...>, dox...@li... > cc: > Subject: RE: [Doxygen-users] DocBook/XML > > > Hi Anton and others, > > As far as I know, XML part of the doxygen development is > focused on a kind of internal intermediate format that follows > XML syntax. The goal is to define it so, that all the output > generators could use it to generate the final output form (HTML, > LaTeX, RTF, etc.). DocBook XML may be one example > of another (new) output form. > > You are invited to share your knowledge related to XML. > Possibly, the dox...@li... > is better place for such discussions. > > See you, > Petr > > -- > Petr Prikryl, SKIL, spol. s r.o., pri...@sk... > > > -----Original Message----- > > From: Anton G Sergeev [SMTP:ag...@ml...] > > Sent: Friday, October 26, 2001 11:09 AM > > To: dox...@li... > > Subject: [Doxygen-users] DocBook/XML > > > > Hi all, > > > > IMHO there is very good DTD for computer texts including API > description. > > This is DocBook. The full information can be found on these web-sites: > > > > http://www.oasis-open.org/docbook > > http://www.docbook.org > > http://nwalsh.com/docbook > > http://web.oreilly.com/news/docbooklic_0901.html > > http://docbook.sourceforge.net > > > > With best regards, > > Anton Sergeev. > > > > ======================================================================== > > Message: 2 > > Date: Wed, 24 Oct 2001 15:58:12 -0700 > > From: Hunter Marshall <hma...@vi...> > > To: dox...@li... > > Subject: Re: [Doxygen-users] xml > > > > On Thu, Oct 18, 2001 at 09:51:04PM +0200, Dimitri van Heesch wrote: > > > On Thu, Oct 18, 2001 at 10:26:00AM -0700, Hunter Marshall wrote: > > > > I will begin working with a smaller case. Is the doxygen.dtd file in > > > > doxygen-1.2.11.1/addon/xmlparse the associated DTD? > > > > > > No, it is just something that could be used as a starting point ;-) > > > Any help on writing a proper DTD is highly welcomed. > > > > After playing with xsl/fop, I think that maybe the DTD structure might > > be an area for experimentation. For example, I am finding that the > > numbering control in XSLT (<xsl:number>) does not go outside a > > sequence of sibling nodes. I suppose some cool XSL hacker could do > > it. It's not like LaTeX where you can tap your own custom counter when > > you want the next number value in a sequence. > > > > What I mean is that the numbering works well for something like > > > > chap > > sec > > subsec > > subsec > > sec > > subsec > > chap > > sec > > subsec > > > > Whereas the doxygen DTD (at a highlevel) looks like > > > > compounddef > > compoundname > > sectiondef > > memberdef (the dtd and the output differ on this) > > memberdef > > memberdef > > sectiondef > > memberdef > > detaileddescriptio > > > > I don't have any suggestions yet. I am just now realizing the impact > > of DTD design on the ease of processing. > > > > hunter > > > > PS Should this go to doxygen-develop? Or to a smaller group than > > doxygen-users? > > > > _______________________________________________ > > Doxygen-users mailing list > > Dox...@li... > > https://lists.sourceforge.net/lists/listinfo/doxygen-users > > > > > _______________________________________________ > Doxygen-users mailing list > Dox...@li... > https://lists.sourceforge.net/lists/listinfo/doxygen-users > |
