doxygen-users

[Doxygen-users] XSLT for Doxygen XML output

[Francesco M. <f18...@ya...>]

Hi,
    I need to customize the HTML output of Doxygen, in just few points, 
in a way that's not possible just using CSS.
I'd like to do it using XSLT over the doxygen's XML output. However 
googling I couldn't find any XSLT which I can take as basis and which 
transforms doxygen XML output in something _similar_ to doxygen HTML 
output....

I tried to write an XSLT which takes as input the doxygen HTML instead 
of the doxygen XML but I found that sometimes doxygen writes stuff like:

...
<dl class="note" compact>
...

which even if is valid HTML4 (I'm not sure), is not XML-valid and thus 
xsltproc refuses to process it...

So my questions are:

  1) has anyone ever written an XSLT which transforms doxyXML to 
something similar to doxyHTML ?

  2) has anyone ever written a PerlMod which transforms doxyPerlMod to 
something similar to doxyHTML ?

  3) is an XHTML doxygen backend being written? when will it be ready?
    (I ask this because XHTML would be processable with XSLT without 
troubles, unlike HTML4)

  4) which are the other possibilities for customizing doxygen's HTML 
output (*) ?

Thanks,
Francesco


(*) = searching doxygen mailing list archives I've seen this is a common 
question; maybe it would be nice to put a chapter about this in the 
doxygen manual.

Re: [Doxygen-users] XSLT for Doxygen XML output

[Gorgonz <go...@we...>]

Hi Francesco,

first of all, i would suppose, that a carefully defined XML-Output would be the best
approach. It opens many ways to transform the collected data from source to arbitrary
output formats with different XSLT files. But you will have to pay a price: It will be
much slower to produce your final output, compared to the flex/bison kind.

So, let us talk about the things, that you can't do with usual tags resp. user-tags. Maybe
 it is just a few steps away to find a solution without need for XSLT. Give us some
examples from your point of view.

I will use this answer now to add an own story ;-) :

What I'm missing is the possibility to hide/show divisions in the html output. Usually you
will do this with a little javascript function, that one can activate by pressing on a
small icon, that shows a plus-sign resp. minus-sign. Since there may be many of this icons
on one html-page, one needs an unique class id.


Francesco Montorsi schrieb:
> Hi,
>     I need to customize the HTML output of Doxygen, in just few points, 
> in a way that's not possible just using CSS.
> I'd like to do it using XSLT over the doxygen's XML output. However 
> googling I couldn't find any XSLT which I can take as basis and which 
> transforms doxygen XML output in something _similar_ to doxygen HTML 
> output....
> 
> I tried to write an XSLT which takes as input the doxygen HTML instead 
> of the doxygen XML but I found that sometimes doxygen writes stuff like:
> 
> ...
> <dl class="note" compact>
> ...