commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Bernhard Grünewaldt <bernh...@gruenewaldt.net>
Subject Re: [math] xdoc latex <-> mathml support
Date Mon, 29 Dec 2008 00:02:06 GMT
see below:

Luc Maisonobe schrieb:
> 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).


Ok, I will add the docu to the xdoc files in the repo.
(I will generate a diff and mail it to you)

How about adding MathML to the generated xdoc xhtml pages.
Here is a example xhtml page with mathml support:
https://www.gruenewaldt.net/public/mathml.xhtml

Here is described how to convert latex to mathml:
https://www.gruenewaldt.net/trac/blog/latex-and-mathml

If we add the mathml namespace we could use mathml.

Header just has to look like this:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0//EN"
               "http://www.w3.org/TR/MathML2/dtd/xhtml-math11-f.dtd" [
  <!ENTITY mathml "http://www.w3.org/1998/Math/MathML">
]>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">


We could add the latex syntax as html comments above the mathml
statements, so everybody can easily change the euqation using the
latex2mathml converter.

> 
> 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
> 
> 

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


Mime
View raw message