Re: [Boost-docs] [docbook->html] support for MathML

Subject: Re: [Boost-docs] [docbook->html] support for MathML
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2011-10-30 09:38:14

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of
> Steven Watanabe
> Sent: Saturday, October 29, 2011 7:07 PM
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] [docbook->html] support for MathML
> 
> AMDG
> 
> On 10/29/2011 10:27 AM, Paul A. Bristow wrote:
> >
> > I'm overcome with an urge to insert a math equation into a Quickbook
> > document ;-)
> >
> > Is this ready for amateur use yet?
> >
> 
> Not really.  The existing support I added to the docbook processing is designed to handle
equations
> produced by doxygen.
> Generating it from inside quickbook is
> a bit awkward.  You can do it using escaped docbook like this:
> 
> '''<inlineequation>
> <inlinemediaobject>
> <imageobject role="html">
> <imagedata fileref="images/normal.png"/> </imageobject> <textobject
> role="tex">$\frac{1}{\sqrt{2\pi\sigma^2}}e^{-\frac{\left(x-\mu\right)^2}{2\sigma^2}}$</textobject>
> </inlinemediaobject>
> </inlineequation>'''
> 
> The PNG image is still needed as a fallback.
> Without it you'll end up with the raw
> TeX if Javascript is disabled or the  MathJax server is inaccessible.

A 'extra' PNG image seems a big nuisance.

I will continue to use the existing sub and super and Greek and math templates?

Feasible - if less beautiful ;-) 

At least Unicode symbols don't go fuzzy as you change the display size (unlike PNG and other
images).

And my equation(s) will fit onto one line without too much loss of mathematical clarity.

Thanks

Paul

---
Paul A. Bristow,
Prizet Farmhouse, Kendal LA8 8AB  UK
[phone]  07714330204
pbristow_at_[hidden]