Customizable GUI Skins
APPLICATION AREAS |
---|
|
PROJECTS |
Research- and Metadata Handling Corporate & Interface Design (under Rework) |
edit |
Preparation of eSciDoc Installation[edit]
Since version 5.x PubMan supports customizable stylesheets. A dedicated installtion of PubMan is required integrate external stylesheets.
Once the installations is done the pubman properties need to be changed in
/pubman_installer/src/main/resources/configuration/pubman.properties
the file is usually deployed in:
/jboss/server_eclipse/jboss-4.2.2.GA/server/default/conf/pubman.properties
The following links can be replaced with custom stylesheets (explained below):
escidoc.pubman.stylesheet.standard.url=./resources/eSciDoc_CSS_v2/themes/skin_PubMan/styles/theme.css
escidoc.pubman.stylesheet.standard.type=stylesheet
escidoc.pubman.stylesheet.standard.apply=true
escidoc.pubman.stylesheet.contrast.url=./resources/eSciDoc_CSS_v2/themes/skin_highContrast/styles/theme.css
escidoc.pubman.stylesheet.contrast.type=alternate stylesheet
escidoc.pubman.stylesheet.contrast.apply=true
escidoc.pubman.stylesheet.classic.url=./resources/eSciDoc_CSS_v2/themes/skin_classic/styles/theme.css
escidoc.pubman.stylesheet.classic.type=alternate stylesheet
escidoc.pubman.stylesheet.classic.apply=true
External style sheets can thus be fetched by URL. To be able to recognize the change after deployment without reload it is useful to change the cookie version number to any other value.
escidoc.pubman.cookie.version=1.0
Additionally the favicon can be fetched the same way.
escidoc.pubman.favicon.url=./resources/pubman_favicon.ico
escidoc.pubman.favicon.apply=true
External and Internal Stylesheets[edit]
The internal stylesheet(s) are deployed to the jBoss whereas an external can be fetched elswhere with the topmost CSS layer only. The structure of external CSS should look like this:
./skin_name
../images
../styles
appearance.css
images.css
theme.css
Customizing the Topmost CSS Layer[edit]
It is not recommended to change the underlying CSS layers because dimensions and positions might change in a unexpeced manner.
appearance.css[edit]
This file holds any coloring and font related appearance separately. The file is structured as following:
- CDDL HEADER START
- Color Table (useful for keeping an overview on replaced stuff)
- General Definitions (Fonts, Elements)
- Component Related Definitions
Component Related The stylesheet is mostly ordered in functional areas here.
images.css[edit]
Images are defined as background images and can be found here separately. Usually they point to the image folder next to the style folder.