Translations of this page:
  • Printable version
  • Tell by mail
  • Export to OpenOffice
  • Export to PDF
  • Export to csv
  • Export to Timeline
  • Add page to book
  • Tools:

Fusion directory theme system

A theme is defined by:

  1. A folder in html/themes
  2. A folder with the same name in ihtml/themes

The folder in html/themes contains:

  1. A index.theme file following the Icon Theme Specification
  2. The icons as described in the index.theme file, usually in an icons folder
  3. Replacements for any css file

The folder in ihtml should have the same name and should contain replacements for any template file.

Icon theme file

Here is the minimal index.theme file to inherit another icon theme.

[Icon Theme]
Name=MyTheme
Comment=Example from documentation
Inherits=oxygen

For an example of a more complex index.theme file look at the one of the default theme: https://git.fusiondirectory.org/gitweb/?p=main/fusiondirectory.git;a=blob;f=html/themes/breezy/index.theme;h=a8adbcbea8e9cf20fc3447232bacba54e4fbaa41;hb=refs/heads/master

All main icon themes should be working, you can activate them by using a symlink in the right folder. For instance on Debian if I want gnome icon theme:

ls -l /usr/share/fusiondirectory/html/themes/
drwxr-xr-x 4 root root 4096 Mar 16 10:24 breezy/
drwxr-xr-x 4 root root 4096 Mar 16 10:24 legacy/
lrwxrwxrwx 1 root root   23 Jun 12  2014 gnome -> /usr/share/icons/gnome//

Replacements of css and tpl files

Any file you see in html/themes/breezy or ihtml/themes/breezy can be overridden by placing in your theme a file with the same name (css goes in html, tpl in ihtml).

Note that the file html/themes/breezy/theme.css is empty so that you can safely override it without losing anything from the default theme. Consider using it for theme making only small modifications.

en/documentation_dev/themes.txt · Last modified: 2016/10/06 12:00 by Côme Chilliet
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0