commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Luc Maisonobe <Luc.Maison...@free.fr>
Subject Re: [math] latex and graphviz plugin for apache commons math moinmoin wiki
Date Sun, 28 Dec 2008 17:10:24 GMT
Bernhard Grünewaldt a écrit :
> Hello,
> 
> I am new here so I don't know if it's correct to ask here for it, but:
> 
> Is it possible to have the latex and graphviz plugin for the apache
> commons wiki installed?
> 
> Latex Plugin:  http://moinmo.in/ParserMarket/latex
> Graphviz Plugin: http://moinmo.in/GraphVizForMoin
> Math Wiki: http://wiki.apache.org/commons/Math
> 
> I would like to add a documentation about the FastHadamardTransformer
> which includes latex equations and some nice graphs:
> http://wiki.apache.org/commons/Transformers/FastHadamardTransformer
> 
> Or is this page the right place for it?
> http://commons.apache.org/math/userguide/transform.html

I think this is a better place. It is the official user guide which is
bundled with the source.

> If yes, which syntax (MoinMoin syntax, Dokuwiki, plain HTML) does it use?

It uses xdoc described here:
http://maven.apache.org/doxia/references/xdoc-format.html

The source files are in the subversion tree. Starting from the top
directory of the project where the pom.xml files is, the user guide
directory is here: src/site/xdoc/userguide. The html files are generated
using maven2 thanks to the following command:

  mvn site

Unfortunately, this format does not support mathematical syntax. In
fact, depending on doxia version, it may even not support standard HTML
4.0 entities like &pi; or &nabla; (see
http://jira.codehaus.org/browse/DOXIA-237). The current published
version of doxia seems to be 1.0-alpha-4, but according to this message
(http://markmail.org/message/z5n4tdiaohaxlqey) new versions should be
published soon.

Doxia supports others formats as well, and they can even be mixed on a
page basis (i.e. you can have one page generated from apt, another one
from xdoc ...). The following page lists several supported modules:
http://maven.apache.org/doxia/doxia/doxia-modules/index.html. The
documentation is ... scarce. Beware that some formats are output formats
only (typically LaTeX).

As far as I am concerned, I would be happy to change our documentation
format to something more math-friendly. I think we will at least have to
wait until the new version of doxia is published and look at what it
provides (and perhaps contribute to it if time allows).

Luc


> 
> thanks.
> 
> Bernhard Grünewaldt
> 
> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
> 


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Mime
View raw message