On 10/16/2015 11:28 PM, Martin Goik wrote:
When converting a Docbook5 document containing MathML markup to Html
XMLMind will generate images showing embedded equations within the
generated html markup.
I'd like to keep the mathml code during the transformation and use
mathjax. So generated Html output should look like:
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml";> <head>
<title></title>
<script type="text/x-mathjax-config">MathJax.Hub.Config({tex2jax:
{inlineMath: [['$','$'], ['\\(','\\)']]}});</script>
<script
src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML";></script>
</head>
<body><p> When <math xmlns="http://www.w3.org/1998/Math/MathML";>
<mi>a</mi>
<mo>≠</mo>
<mn>0</mn> </math> ...
So I'll have to inhibit XMLMind converting MathML markup to images and
supply extra <script> tags to the generated Html <head> section. The
latter may be achieved by modifying the XSL templates. But how do I
achive the first part in a simple and effective mannner? Both the
MathML related documentation and the Mail archives didn't give me a
real clue.
--> The stock DocBook 5 configuration is found here:
<XXE_install_dir>/addon/config/docbook5/
The "Convert Document" submenu is specified here:
<XXE_install_dir>/addon/config/docbook5/docbook5_convert_menu.incl
After examining its modular content (caused by the support of DocBook
5.1 assemblies and topics), we can say that you need to redefine command
"{db5}toHTML.step0":
---
<command name="{db5}toHTML.step0">
<process>
<mkdir dir="raw" />
<mkdir dir="resources" />
<copyDocument to="__doc.xml">
<!--
=================================================================
Support for DocBook 5 imagedata/svg:svg, imagedata/mml:math
and *equation/mml:math.
================================================================== -->
<cfg:extract xmlns=""
xmlns:db5="http://docbook.org/ns/docbook";
xmlns:svg="http://www.w3.org/2000/svg";
xpath="//db5:imagedata/svg:svg" toDir="raw">
<cfg:attribute name="fileref"
value="resources/{$url.rootName}.png" />
</cfg:extract>
<cfg:extract xmlns=""
xmlns:db5="http://docbook.org/ns/docbook";
xmlns:mml="http://www.w3.org/1998/Math/MathML";
xpath="//db5:imagedata/mml:math" toDir="raw">
<cfg:attribute name="fileref"
value="resources/{$url.rootName}.png" />
</cfg:extract>
<cfg:extract xmlns=""
xmlns:db5="http://docbook.org/ns/docbook";
xmlns:mml="http://www.w3.org/1998/Math/MathML";
xpath="//db5:equation/mml:math |
//db5:informalequation/mml:math |
//db5:inlineequation/mml:math" toDir="raw">
<db5:imagedata fileref="resources/{$url.rootName}.png" />
</cfg:extract>
<resources match="^[a-zA-Z][a-zA-Z0-9.+-]*:/.+" />
<resources include="text" match=".+"
resolve="true" />
<resources include="image" match=".+\.(png|jpg|jpeg|gif)"
copyTo="resources" />
<resources include="image" match="(?:.+/)?(.+)\.(\w+)"
copyTo="raw" referenceAs="resources/$1.png" />
<resources exclude="text image" match=".+"
copyTo="resources" />
</copyDocument>
<convertImage from="raw" to="resources" format="png" />
</process>
</command>
---
specified in:
<XXE_install_dir>/addon/config/docbook5/docbook5_convert_input.incl
The new command "{db5}toHTML.step0" would be:
---
<command name="{db5}toHTML.step0">
<process>
<mkdir dir="raw" />
<mkdir dir="resources" />
<copyDocument to="__doc.xml">
<resources match="^[a-zA-Z][a-zA-Z0-9.+-]*:/.+" />
<resources include="text" match=".+"
resolve="true" />
<resources include="image" match=".+\.(png|jpg|jpeg|gif|svg|mml)"
copyTo="resources" />
<resources include="image" match="(?:.+/)?(.+)\.(\w+)"
copyTo="raw" referenceAs="resources/$1.png" />
<resources exclude="text image" match=".+"
copyTo="resources" />
</copyDocument>
<convertImage from="raw" to="resources" format="png" />
</process>
</command>
---
1) While at it, I also made some modifications to let the generated
(X)HTML contain SVG.
2) The modifications made deal with embedded MathML or SVG and also
linked MathML or SVG files.
3) If your MathML files have an extension different from ".mml", please
change attribute match=".+\.(png|jpg|jpeg|gif|svg|mml)"
--> In order to redefine command "{db5}toHTML.step0", you need to
customize the DocBook 5 configuration as explained here:
Chapter 5. Customizing an existing configuration
http://www.xmlmind.com/xmleditor/_distrib/doc/configure/customizing.html
You'll find attached to this email a custom 0docbook5.xxe file
implementing the above changes. This 0docbook5.xxe should work fine.
I've used it to generate a XHTML page containing embedded MathML and SVG
and Firefox displayed it just fine.
----------
IMPORTANT: Do not forget to clear or temporarily disable the "Quick
Start" cache if you want XXE to see your 0docbook5.xxe.
This is done by unchecking the corresponding checkboxes in Options →
Preferences, Advanced|Cached Data section.
http://www.xmlmind.com/xmleditor/_distrib/doc/help/advancedOptions.html#cacheOptions
<?xml version='1.0' encoding='UTF-8'?>
<configuration name="DocBook v5+" mimeType="application/x-docbook-5+xml"
icon="xxe-config:common/mime_types/docbook.png"
xmlns="http://www.xmlmind.com/xmleditor/schema/configuration";
xmlns:cfg="http://www.xmlmind.com/xmleditor/schema/configuration";
xmlns:db="http://docbook.org/ns/docbook";
xmlns:svg="http://www.w3.org/2000/svg";
xmlns:xi="http://www.w3.org/2001/XInclude";
xmlns:xlink="http://www.w3.org/1999/xlink";
xmlns:html="http://www.w3.org/1999/xhtml";>
<include location="docbook5-config:docbook5.xxe"/>
<command name="{db5}toHTML.step0">
<process>
<mkdir dir="raw" />
<mkdir dir="resources" />
<copyDocument to="__doc.xml">
<resources match="^[a-zA-Z][a-zA-Z0-9.+-]*:/.+" />
<resources include="text" match=".+"
resolve="true" />
<resources include="image" match=".+\.(png|jpg|jpeg|gif|svg|mml)"
copyTo="resources" />
<resources include="image" match="(?:.+/)?(.+)\.(\w+)"
copyTo="raw" referenceAs="resources/$1.png" />
<resources exclude="text image" match=".+"
copyTo="resources" />
</copyDocument>
<convertImage from="raw" to="resources" format="png" />
</process>
</command>
<parameterGroup name="db5.toHTML.transformParameters">
<!-- Allow SVG in the result tree -->
<parameter name="use.svg">1</parameter>
<!-- The DocBook XSL stylesheets cannot format MathML content, but it will
pass the markup through so that a downstream processor can format
it. -->
</parameterGroup>
</configuration>
--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support
