Michael B. wrote: > > Many thanks for the links and offer to extend the evaluation period. > I've managed to solve the font problem. Your other comments make me > wonder on something though. > > I've already been looking through the customisable document conversion > attributes and properties, but found that some of things I want to edit > (header.content) are not available. Is there where I need to start > hunting through config files to find the necessary elements, because > there seem to be hundreds of includes in docbook.xsl and I guess it > could be in any one of them? > > Is there any guidance on where to start looking for the appropriate > files for this, and is it even recommended to start making changes at > this level? (I notice your comments on 'maybe not the right tool' and > also another in FAQ suggesting hiring a consultant) >
------- Case I) If the change you want to make can be implemented by the means of parameters and attribute-sets (that is, it's a purely declarative task), then you can do it entirely from within XXE without being an XSL expert. For example, attribute-set "header.content.properties" (properties of page header content), can be changed using a specialized editor of our own called "XMLmind XSL Customizer". This specialized editor is invoked by Menu item "Options|Customize Configuration|Customize Document Conversion Stylesheets". References: * DocBook attribute-sets are documented here: http://docbook.sourceforge.net/release/xsl/current/doc/fo/index.html (look for all identifiers ending with .properties). * "Customize Document Conversion Stylesheets" is documented here: http://www.xmlmind.com/xmleditor/_distrib/doc/help/com.xmlmind.xmleditapp.kit.part.ConversionStylesheetsEditor.html * "XMLmind XSL Customizer" is documented here: http://www.xmlmind.com/xmleditor/_distrib/doc/help/com.xmlmind.xslcustom.Customizer.html -------- Case II) If the change you want to make requires you to override an XSL template (that is, it's a kind of programming task), then: [a] You can use XXE to create a template file for your customization of the DocBook XSL stylesheet. (This task is not as trivial as it seems, so you'd better use XXE to do it.) Once this done, XXE will use your customization of the DocBook XSL stylesheet rather than the stock DocBook XSL stylesheet. [b] You need to find out which XSL template (i.e. element xsl:template) you'll have to override. This indeed requires you to browse dozens of .xsl files found in: XXE_install_dir/addon/config/docbook/xsl/fo/ for DocBook 4, XXE_install_dir/addon/config/docbook5/xsl/fo/ for DocBook 5. However skimming through "DocBook XSL: The Complete Guide" by Bob Stayton may help you find your path through this maze. [c] You can use XXE to start a third-party text editor in order to add to the .xsl file created during step [a] the code of the XSL template. Of course, unless you are proficient in XSL, you'll have to hire a consultant to program one or more xsl:template elements. References: * "Customize Document Conversion Stylesheets" is documented here: http://www.xmlmind.com/xmleditor/_distrib/doc/help/com.xmlmind.xmleditapp.kit.part.ConversionStylesheetsEditor.html * "DocBook XSL: The Complete Guide" by Bob Stayton. http://www.sagehill.net/docbookxsl/ Note that XXE can automatically create for you what Bob Stayton calls a "customization layer" -- http://www.sagehill.net/docbookxsl/CustomMethods.html#WriteCustomization In case I), you can use "XMLmind XSL Customizer" to populate the "customization layer". In case II), you are on you own: you (or the expert you have hired) need to use a text editor in order to populate the "customization layer". -- XMLmind XML Editor Support List [email protected] http://www.xmlmind.com/mailman/listinfo/xmleditor-support
