1==== Template style.ini ====
2
3The ''style.ini'' is a [[wp>INI_file|ini file]] in each [[doku>template]]'s directory((if the template supports it)) configuring the generation of [[doku>devel:css|CSS]] styles. It has two sections: [stylesheets] and [replacements] described below.
4
5=== [stylesheets] ===
6
7This part defines which CSS files are loaded. Each line is defined as follow:
8
9  cssfile.css = mode
10
11''cssfile.css'' is your file name and ''mode'' is one of the supported output modes as described at [[CSS#Stylesheet Modes|mode]].
12
13The stylesheet can also be a ''.less'' file. (See [[doku>devel:less|LESS]]).
14
15=== [replacements] ===
16
17DokuWiki's CSS dispatcher is able to replace placeholders in the loaded stylesheets which are configured through the ''[replacements]'' section in the templates ''style.ini''. This is especially useful for defining a color scheme once and reuse these colors in all files.
18
19These replacements can also be used as [[doku>devel:less#accessing_styleini_placeholders|LESS variables]].
20
21== Guaranteed color placeholders ==
22
23The following placeholders are the only ones that are safe to be used by plugins. All templates have to implement these at least, but are free to add more.
24
25^placeholder variable		^meaning			^
26^''%%__background__%%''		|main background color		|
27^''%%__background_alt__%%''	|alternative background color	|
28^''%%__background_neu__%%''	|neutral background color	|
29^''%%__border__%%''		|border color			|
30^''%%__text__%%''		|main text color		|
31^''%%__text_alt__%%''		|alternative text color		|
32^''%%__text_neu__%%''		|neutral text color		|
33^''%%__highlight__%%''		|highlighted text color (**new** since Adora Belle) |
34^''%%__link__%%''		|the general link color (**new** since Greebo) |
35
36Template authors should generally try to reuse the placeholder names of the default template.
37
38=== See also ===
39  * [[doku>devel:style.ini]]
40