Chapter 5. Customizing an existing configuration
Prev | Part I. Guide | Next

## Chapter 5. Customizing an existing configuration

This chapter is not a tutorial. It will merely give you some recipes. If you want to understand what you are doing, please refer to Configuration elements.

Let's suppose you want to customize one of the DocBook 5, DocBook 4 or XHTML configurations, here's what to do.

1. Create in ``XXE_user_preferences_dir`/addon/`[8] a subdirectory which will contain all the files comprising your customization.

   The name of this directory is not important. Let's suppose you have created ``XXE_user_preferences_dir`/addon/custom/.`

2. Copy one of the following template files depending on which configuration you want to customize:

   Configuration Name | Procedure
   --- | ---
   DocBook v5+ | Copy 0docbook5.xxe to `custom/`.
   DocBook | Copy 0docbook.xxe to `custom/`.
   XHTML Strict | Copy 0xhtml_strict.xxe to `custom/`.
   XHTML Transitional | Copy 0xhtml_loose.xxe to `custom/`.

   For example, `0docbook5.xxe`[9] looks like this:

       <configuration name="DocBook v5+"
         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="xxe-config:docbook5/docbook5.xxe" />

       </configuration>

3. This step involves adding one or more configuration elements after the `include` element. This is done using any XML or text editor. Each of the following sections describes a common customization step.

4. Restart XXE.

[8] `XXE_user_preferences_dir` is documented in 1.

[9] The ``funny'' name, starting with a "`0`", has its utility if you happen to create your customization in ``XXE_install_dir`/addon/` rather than in ``XXE_user_preferences_dir`/addon/`.

Prev | Up | Next
3.1. CALS table editor command | Home | 1. Adding a custom document template