A Zekr 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) are set. There are currently two built-in themes (Sky and Uthman Taha) available in all Zekr downloads, however, creating a new theme is quite simple.
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 HTML templates.
In order to write your own theme, copy an existing one, renaming the directory (which is taken as theme identifier) and then customize its Velocity and CSS files and fill properties in theme.properties file as you like. Each theme has a unique ID, 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.
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.
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 theme from either of these locations:
- [Zekr installation directory]/res/ui/theme