Chapter 5. Customizing an existing configuration

Table of Contents

1. Structure of a configuration file customizing an existing configuration
2. Customization items
2.1. Custom CSS style sheet
2.2. Custom bindings
2.3. Custom tool bar
2.4. Custom menu
2.5. Custom parameters for the XSLT style sheet used to convert DocBook documents to RTF, PostScript and PDF
2.5.1. Extensively customizing the conversion process

A sample customization of the stock DocBook may be downloaded and installed using XXE add-on manager (Options|Install Add-ons). This configuration contains the following files and directories: mydocbook.xxe, mydocbook.css, mydocbook.xsl, icons/.

Caution

If you choose to install the above configuration in XXE_install_dir/addon/, then you'll have to manually rename mydocbook.xxe to 0mydocbook.xxe.

If you choose to install the above configuration in XXE_user_preferences_dir/addon/ (add-on manager's default), then there is nothing special to do.

Why? When XXE finds several configurations having the same name and when these configurations have the same priority, XXE loads the configuration having a file basename which lexicographically precedes the others. More information about this in next chapter.

  • Stock docbook.xxe is named "DocBook" and custom mydocbook.xxe is also named "DocBook".

  • Stock docbook.xxe and custom mydocbook.xxe being located in a subdirectory of XXE_install_dir/addon/ are both system configurations. They have the same priority.

  • docbook.xxe precedes mydocbook.xxe but 0mydocbook.xxe precedes docbook.xxe.

  • Renaming mydocbook.xxe to 0mydocbook.xxe when mydocbook.xxe is installed in XXE_user_preferences_dir/addon/ is not needed because user configurations have priority over system configurations.