Theme
From ZekrWiki
Contents |
Definition
In Zekr context, Theme is a package of Velocity macros (.vm files) plus some cascading style sheets (.css files) and a theme descriptor namely theme.properties in which some display properties (mostly about fonts) is set.
How to write a theme
Themes are used to customize user interface for Quran/translation rendering. This can be done either by customizing colors, borders, images and fonts through CSS files or by modifying .vm files which actually hold HTML templates.
In order to write your own theme, copy an existing one, renaming the directory (hence theme ID) and then customize its velocity and CSS files and fill properties in theme.properties file as you like.
Each theme has a unique name, which is the name of it's base directory which holds theme files (should be the same as theme zip archive). Theme name can be set in theme.properties.
Installation
For installation use Tools > Add > Theme, and choose as many them as you want. Then restart Zekr and set change your theme through Tools > Options > Theme combo box.
Removal
For removing a theme, first make sure that this theme is not set as default Zekr theme (Options > Theme combo box). If not, close the application and remove that them from either of these locations:
Windows
- C:\Documents and Settings\[your username]\.zekr\theme
- [zekr installation directory]/res/ui/theme
Linux
- ~/.zekr/theme
- [zekr installation directory]/res/ui/theme
