Theme

From ZekrWiki

Revision as of 15:41, 26 November 2010 by Mohsen (Talk | contribs)
(diff) ←Older revision | Current revision (diff) | Newer revision→ (diff)
Jump to: navigation, search

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.

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 theme from either of these locations:

  1. workspace\theme
  2. [Zekr installation directory]/res/ui/theme

Other resources (such as translation packs, language packs, recitations, etc.) can be removed by a similar procedure, and can be removed from their corresponding folder.

Retrieved from "http://zekr.org/wiki/Theme"
Personal tools