Using MathML for formulas in docbook

[Albert Astals Cid]

El dimarts, 14 de juny de 2022, a les 21:49:04 (CEST), Johnny Jazeix va escriure:
> Hi,
> 
> After discussing with a French contributor translating KStars, we noticed
> that some formulas were stored as images where we can potentially use
> MathML formulas to display them.
> 
> There is the <equation> tag that do not require MathML but some of the
> formulas use fractions (
> https://invent.kde.org/education/kstars/-/blob/master/doc/lambda_ex.png for
> example) and I didn't find how to display them the same without MathML.
> 
> Is there any existing docbook that uses MathML? If I understand correctly,
> the way to tell we use MathML is using a specific doctype (
> http://www.sagehill.net/docbookxsl/MathML.html) but as we already
> customized one for KDE, it may not be easy to do it.

Using it's specific docttype it's just for the files that are exclusively mathml and they are supposed to be included from other docbook files, no?

That should be fine as far as i understand, see for example stuff like kstars/doc/faq.docbook it doesn't even have a doctype because it's just included from the "main" file.

My bigger concern is that this is an extra compile-time dependency so we need to find a way to express that in CMakeLists.txt so people don't start getting some strange compile time errors when compiling the docbbok (and we probably need to include that in the CI images).

My current suggestion, give it a quick try to see if it works :D

Cheers,
  Albert

> 
> Cheers,
> 
> Johnny
>