On 01/31/2017 06:35 PM, nobili, philippe wrote:
We are in the process to upgrade to XXE-7.3 to take advantage of
DocBook-5.1 assemblies for some of our products documentation.
We successfully ported our DocBook (4) customization to DocBook-5.1;
The stock -as of XXE v7.3- "DocBook v5.1+ configuration" add-on contains
in fact *two* configurations:
1) <XXE_install_dir>/addon/config/docbook51/docbook51.xxe contains a
configuration called "DocBook v5.1+".
This configuration is used to parametrize XXE when a DocBook 5.1 book,
chapter, section, topic, etc, is opened in XXE.
It contains process commands like (excerpts from
docbook51_convert_menu.incl):
---
<command name="db51.toPS">
<process>
<subProcess name="{db51}toPS.step0" parameter="%*" />
<mkdir dir="images/callouts" />
<copyProcessResources
resources="@docbook5-config:xsl/images/svg_images.list"
to="images" />
<copyProcessResources
resources="@docbook5-config:xsl/images/callouts/svg_callouts.list"
to="images/callouts" />
<transform stylesheet="docbook5-config:xsl/fo/docbook.xsl"
file="__doc.xml" to="__doc.fo">
<info>
<label>Convert to PDF, PostScript</label>
<documentation>http://docbook.sourceforge.net/release/xsl/current/doc/fo/%{parameter.name|paper.type}.html</documentation>
<documentation>http://docbook.sourceforge.net/release/xsl/current/doc/fo/%{attribute-set.name|formal.object.properties}.html</documentation>
<alternateStylesheet
location="docbook5-config:xsl/fo/profile-docbook.xsl"
label="Profiling stylesheet" />
<alternateStylesheets name="db51.toPS.alternateXSLT" />
</info>
<parameter name="use.extensions">1</parameter>
<parameter name="paper.type">A4</parameter>
<parameter name="toc.section.depth">3</parameter>
<parameter name="section.autolabel">1</parameter>
<parameter name="callout.graphics">1</parameter>
<parameter name="shade.verbatim">1</parameter>
<parameter name="ulink.show">0</parameter>
<parameter name="variablelist.as.blocks">1</parameter>
<parameterGroup name="db51.toPS.transformParameters" />
</transform>
<processFO processor="XEP" file="__doc.fo" to="__doc.%0">
<parameter name="OUTPUT_FORMAT">%0</parameter>
<!-- Workaround XEP bug: renderx #22766 -->
<parameter name="VALIDATE">false</parameter>
<parameter name="PDF.PDF_VERSION">1.5</parameter>
<parameterGroup name="db51.toPS.XEPParameters" />
<!-- If XEP plug-in has not been installed, try FOP plug-in. -->
<processFO processor="FOP" file="__doc.fo" to="__doc.%0">
<parameter name="renderer">%0</parameter>
<parameter name="strict-validation">false</parameter>
<parameterGroup name="db51.toPS.FOPParameters" />
</processFO>
</processFO>
</process>
</command>
---
2) <XXE_install_dir>/addon/config/docbook51/assembly.xxe contains a
configuration called "DocBook Assembly v5.1+".
This configuration is used to parametrize XXE when a DocBook 5.1
*assembly* (only an assembly, not a book, not a chapter, not a section,
not a topic, etc) is opened in XXE.
It contains process commands like (excerpts from
assembly_convert_menu.incl):
---
<command name="asm.toPS">
<process>
<subProcess name="{asm}toPS.step0" parameter="%*" />
<mkdir dir="images/callouts" />
<copyProcessResources
resources="@docbook5-config:xsl/images/svg_images.list"
to="images" />
<copyProcessResources
resources="@docbook5-config:xsl/images/callouts/svg_callouts.list"
to="images/callouts" />
<transform stylesheet="docbook5-config:xsl/fo/docbook.xsl"
file="__doc.xml" to="__doc.fo">
<info>
<label>Convert to PDF, PostScript</label>
<documentation>http://docbook.sourceforge.net/release/xsl/current/doc/fo/%{parameter.name|paper.type}.html</documentation>
<documentation>http://docbook.sourceforge.net/release/xsl/current/doc/fo/%{attribute-set.name|formal.object.properties}.html</documentation>
<alternateStylesheet
location="docbook5-config:xsl/fo/profile-docbook.xsl"
label="Profiling stylesheet" />
<alternateStylesheets name="asm.toPS.alternateXSLT" />
</info>
<parameter name="use.extensions">1</parameter>
<parameter name="paper.type">A4</parameter>
<parameter name="toc.section.depth">3</parameter>
<parameter name="section.autolabel">1</parameter>
<parameter name="callout.graphics">1</parameter>
<parameter name="shade.verbatim">1</parameter>
<parameter name="ulink.show">0</parameter>
<parameter name="variablelist.as.blocks">1</parameter>
<parameterGroup name="asm.toPS.transformParameters" />
</transform>
<processFO processor="XEP" file="__doc.fo" to="__doc.%0">
<parameter name="OUTPUT_FORMAT">%0</parameter>
<!-- Workaround XEP bug: renderx #22766 -->
<parameter name="VALIDATE">false</parameter>
<parameter name="PDF.PDF_VERSION">1.5</parameter>
<parameterGroup name="asm.toPS.XEPParameters" />
<!-- If XEP plug-in has not been installed, try FOP plug-in. -->
<processFO processor="FOP" file="__doc.fo" to="__doc.%0">
<parameter name="renderer">%0</parameter>
<parameter name="strict-validation">false</parameter>
<parameterGroup name="asm.toPS.FOPParameters" />
</processFO>
</processFO>
</process>
</command>
---
Note that the two above process commands differ only by their command
"prefixes". The first one uses "{db51}" and "db51.". The second one uses
{asm} and "asm.".
Therefore:
If you managed to successfully customize the "DocBook v5.1+"
configuration in a "0docbook51.xxe" file importing stock
"docbook51.xxe". (Reference:
http://www.xmlmind.com/xmleditor/_distrib/doc/configure/customizing.html)
Then repeat what you did in a "0assembly.xxe" file importing stock
"assembly.xxe", simply do not forget to replace command prefix "db51."
by "asm.".
Sample "0assembly.xxe":
---
<configuration name="DocBook Assembly v5.1+"
mimeType="application/x-docbook-assembly+xml"
icon="xxe-config:common/mime_types/xml-green.png"
xmlns="http://www.xmlmind.com/xmleditor/schema/configuration";
xmlns:cfg="http://www.xmlmind.com/xmleditor/schema/configuration";
xmlns:xi="http://www.w3.org/2001/XInclude";
xmlns:xlink="http://www.w3.org/1999/xlink";
xmlns:db="http://docbook.org/ns/docbook";>
<include location="docbook51-config:assembly.xxe"/>
<parameterGroup name="asm.toPS.transformParameters">
<parameter name="variablelist.as.blocks">1</parameter>
</parameterGroup>
<parameterGroup name="asm.toRTF.transformParameters">
<parameterGroup name="asm.toPS.transformParameters"/>
</parameterGroup>
</configuration>
---
how should we proceed to make DocBook-5.1 assemblies use it rather than the
stock DocBook customization when converting assemblies into the target
publishing format ?
If my memory serves me well you use "xxetool convert" to convert your
XML documents to other formats. Reference:
http://www.xmlmind.com/xmleditor/_distrib/doc/xxetool/index.html
It works exactly the same for DocBook 5.1 assemblies, but with process
commands having names starting with prefix "asm.".
xxetool is self-documenting:
---
$ xxetool convert
asm.toEclipseHelp
asm.toEpub
asm.toHTML
asm.toHTML1
asm.toHTMLHelp
asm.toJavaHelp
asm.toJavaHelpWithPrefix
asm.toPSFile
asm.toRTF
asm.toWebHelp
db5.toEclipseHelp
db5.toEpub
...
docb.toWebHelp
xhtml.toPSFile
xhtml.toRTF
---
Example (of course, "my_doc.xml" contains an assembly):
---
xxetool convert -p highlight.source 1 -p admon.graphics 1 \
asm.toPSFile my_doc.xml \
-s pdf -s pdf -u my_doc.pdf
---
Please download the full source of tutorial "DocBook Assemblies and
Topics for the Impatient" from
http://www.xmlmind.com/tutorials/DocBookAssemblies/DocBookAssemblies_src.zip
and take a look at the makefile it contains.
--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support
