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

## Chapter 5. Customizing an existing configuration

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.

Prev | Up | Next
3.1. CALS table editor command | Home | 1. Structure of a configuration file customizing an existing configuration