Explanation

XWiki supports one icon set, referred to in the documentation as the XWiki Icon Set. It is a list of icon names, and it is the abstraction that makes Icon Themes interchangeable: content, macros and code ask for a name, and the selected theme decides what is drawn.

Every name of the Set, with the value each theme maps it to, is listed on the Icons page of the Developer Guide. XWiki aims to keep an equivalent of every Silk icon in each theme, so that content written before Icon Themes existed keeps rendering.

Icon naming convention

In order to keep long term consistency on the icon names, a set of rules have been discussed. Those must be followed when introducing a new icon to the XWiki Icon Set.

• Use kebab-case.
• For composite icon names, the main noun is the first in the name.
• Remove hyphens from compound nouns.

Examples:

• file-add and not add-file because the main noun is file here add is the action
• pdf-export and not export-pdf because the main noun is pdf and export is the action.
• bullet-black and not black-bullet because the main noun is bullet and black is an adjective
• emoticon-smile and not smile-emoticon because the main noun is emoticon and smile is a complementary noun.
• fastforward is a compound noun from which we removed the hyphen.
• file-pdf and not pdf-file because in the meaning of this icon, the main meaning is file, while pdf only helps to refine the meaning. On the contrary, pdf-file would mean that we want a file variation on the main concept of pdf.