FusionDirectory theme system¶
A theme is defined by:
- A folder in html/themes
- A folder with the same name in ihtml/themes
The folder in html/themes contains:
- An index.theme file following the Icon Theme Specification
- The icons as described in the index.theme file, usually in an icons folder
- 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
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.