Icon Themes
Explanation
An Icon Theme maps each name of the XWiki Icon Set to something that can be drawn, and the wiki draws its icons through the one theme it has selected. A theme of type image maps every name to a picture file; a theme of type font maps it to the CSS classes of a glyph.
Two themes ship with the XWiki Standard flavor, and are the two the XWiki Development Team supports:
| Theme | Type | Status |
|---|---|---|
| Font Awesome | Font | Selected by default |
| Silk | Image | Deprecated XWiki 18.0.0. Use Font Awesome instead. Still bundled and selectable |
Further themes are published as extensions, among them Glyphicons, Material and Font Awesome 5; the Extensions wiki lists them all. A wiki can also carry a theme written for itself.
FAQ
What happens when the Icon Theme has no mapping for an icon?
XWiki falls back to the icon set built into the distribution, which draws the Silk pictures, so something is still displayed. That fallback can be switched off per call, on the displayIcon macro and in a script.
Why do the bundled Font Awesome mappings use older fa- class names?
The theme maps the Icon Set to Font Awesome 4 class names and loads Font Awesome's version 4 compatibility stylesheet next to the current one, so those names keep working as the bundled Font Awesome release moves on.
More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.
