Magnus G?fvert wrote: > > > As I think I mentioned in a previous email we have a current inhouse > docbook toolchain which also include xsl customaztion layer, and we now > intend to move to XXE with it's bundled tools. The plan is to bundle our > customization in an inhouse addon. In my attempts so far I have got into > a few difficulties, which probably are just due to my ignorance: >
No, it's because you need to perform pretty advanced tasks. Please consider hiring us to do the move to XXE. See "Customization Service", http://www.xmlmind.com/xmleditor/customization_service.html > 1. I cannot get the admon or callout graphics to work for any output > format. Images are not found during conversion, and I wonder where the > graphics should be located. I tried to set the admin.graphics.path, > which normally in relative to the output directory, but no success. I > also tried some other locations and settings with no luck. Any hint? When you generate an HTML file, this file needs to point to, let's say, a warning icon. That is, the generated HTML file contains: --- <img src="VALUE_OF_PARAMETER_admon.graphics.path_PARAMETER/warning.png"/> --- OK, that's fine, but the DocBook XSLT stylesheets will not *copy* the admon or callout graphics files to the directory called "VALUE_OF_PARAMETER_admon.graphics.path_PARAMETER/". The DocBook XSLT stylesheets just generate the right reference. If you are using XXE or convertdoc, it is the copyProcessResources child element of a process command which does this job: --- <mkdir dir="images/callouts" /> <copyProcessResources resources="xsl/images/draft.png" to="images" /> <copyProcessResources resources="@xsl/images/callouts/png_callouts.list" to="images/callouts" /> --- See http://www.xmlmind.com/xmleditor/_distrib/doc/commands/copyProcessResources.html. This is an excerpt of XXE_install_dir/addon/config/docbook5/xslMenu.incl: --- <command name="db5.convertStep1"> <process> <mkdir dir="resources" /> <mkdir dir="raw" /> <copyDocument to="__doc.xml"> <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="(https|http|ftp)://.*" /> <resources match=".+\.(txt|text|htm|html|xml|h|c|cpp|java|js|tcl|py|pl|rb)" copyTo="." /> <resources match=".+\.(png|jpg|jpeg|gif)" copyTo="resources" /> <resources match="(?:.+/)?(.+)\.(\w+)" copyTo="raw" referenceAs="resources/$1.png" /> <resources match=".+" copyTo="resources" /> </copyDocument> <convertImage from="raw" to="resources" format="png" /> <mkdir dir="images/callouts" /> <copyProcessResources resources="xsl/images/draft.png" to="images" /> <copyProcessResources resources="@xsl/images/callouts/png_callouts.list" to="images/callouts" /> </process> </command> --- An XXE process command is similar to an ant task, just more specialized. See http://www.xmlmind.com/xmleditor/_distrib/doc/commands/process.html In the above process command, you can see that copying callout graphics is addressed but the process command, but not copying admon graphics. > > 2. It is written in the MathML plugin documentation Appendix B last > paragraph > <http://www.xmlmind.com/xmleditor/_distrib/doc/mathml/help.pdf> (I > cannot find this file in my local installation) that "Because this > add-on customizes the stock DocBook 5 configuration bundled with XMLmind > XML Editor, it is not possible to install it in conjunction with other > add-ons which also customize the DocBook 5 configuration." Which is > pretty much what I want to do with our local customization. If I > understand correctly, this should still be possible by creating a new > DocBook 5 configuration using the technique described in Appendix B? Yes. You need to create a custom DocBook 5 configuration, but you cannot call it "DocBook v5+" as the MathML add-on already creates a custom DocBook 5 configuration called "DocBook v5+". > > 3. During conversion, a conversion log is displayed in the "Executing > command" dialog. Unfortunately, this dialog closes automatically at > termination. Is there any way to keep it open, or in any other way > access this log? (I cannot file any log file or similar.) This would be > good for debugging when working with customizations. This one is easy. See "Status messages", http://www.xmlmind.com/xmleditor/_distrib/doc/help/statusTool.html > is it possible to > set a debug level to control verbosity of conversion outputs? > This only possible when converting DITA documents (http://www.xmlmind.com/xmleditor/_distrib/doc/dita/preprocess_options.html#com.xmlmind.xmleditext.dita.PreprocessingOptionsEditor), and in all cases, FOP is too verbose (it reports many false errors. Example: foreign attributes are allowed by the XSL-FO spec.).
