Differences

This shows you the differences between two versions of the page.

--- devel:style.ini [2014-04-23 12:46] – [[stylesheets]] 86.101.231.69
+++ devel:style.ini [2023-09-22 22:23] (current) – Klap-in
@@ Line 1: / Line 1: @@
 ====== Template style.ini ======
-The ''style.ini'' is a [[wp>INI_file|ini file]] in each [[template]]'s directory((if the template supports it)) configuring the generation of [[CSS]] styles. It has two sections: [stylesheets] and [replacements] described below.
+The ''style.ini'' is an [[wp>INI_file|ini file]] in each [[template]]'s directory((if the template supports it)) configuring the generation of [[CSS]] styles. It has two sections: [stylesheets] and [replacements] described below. With the [[plugin:styling|{{https://raw.githubusercontent.com/dokuwiki/dokuwiki/master/lib/plugins/styling/admin.svg?16}}]][[plugin:styling|Styling Plugin]] wiki admins could preview and change the replacement values via the admin interface, before it is stored in this file.
 ===== [stylesheets] =====
@@ Line 18: / Line 18: @@
 These replacements can also be used as [[less#accessing_styleini_placeholders|LESS variables]].
+The Styling Plugin let users preview and change the appearance of any template based on the defined replacements. See the [[plugin:styling|Styling Plugin]] for details.
 ==== Guaranteed color placeholders ====
@@ Line 23: / Line 25: @@
 The 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.
-^placeholder variable		^meaning			^
+^ placeholder variable        ^ meaning                                                                                 ^
-^''%%__background__%%''		|main background color		|
+^ ''%%__background__%%''      | main background color                                                                   |
-^''%%__background_alt__%%''	|alternative background color	|
+^ ''%%__background_alt__%%''  | alternative background color (also used for the theme color in the [[devel:manifest]])  |
-^''%%__background_neu__%%''	|neutral background color	|
+^ ''%%__background_neu__%%''  | neutral background color                                                                |
-^''%%__border__%%''		|border color			|
+^ ''%%__border__%%''          | border color                                                                            |
-^''%%__text__%%''		|main text color		|
+^ ''%%__text__%%''            | main text color                                                                         |
-^''%%__text_alt__%%''		|alternative text color		|
+^ ''%%__text_alt__%%''        | alternative text color                                                                  |
-^''%%__text_neu__%%''		|neutral text color		|
+^ ''%%__text_neu__%%''        | neutral text color                                                                      |
-^''%%__highlight__%%''		|highlighted text color (**new** since Adora Belle) |
+^ ''%%__highlight__%%''       | highlighted text color (**new** since Adora Belle)                                      |
+^ ''%%__link__%%''            | the general link color (**new** since Greebo)                                           |
+Template authors should generally try to reuse the placeholder names of the default template.
 ===== Example =====
-See for example the [[https://github.com/selfthinker/dokuwiki_template_starter/blob/master/style.ini|style.ini]] of the Starter template for an overview of the file.
+See for example the [[https://github.com/selfthinker/dokuwiki_template_starter/blob/master/style.ini|style.ini]] of the Starter template for an overview of the file. If your are a wiki admin who like to modify the style, please use a [[#local style.ini]].
 ===== Local style.ini =====
-In Adora Belle you can overwrite ''style.ini'' values in ''style.local.ini'' files. Since Binky that file location has moved to the more [[:farms|farm]]-friendly **''conf/tpl/<tpl>/style.ini''** (where ''<tpl>'' needs to be substituted with the name of the template folder). (Just create it if it doesn't exist.) This prevents losing those changes after an upgrade. The file still needs to include each section (i.e. ''[stylesheets]'' or ''[replacements]'') and paths are relative to the added ini file.
+Local changes can be stored in a local ''style.ini'' at the location ''conf/tpl/<tpl>/style.ini''. (Where ''<tpl>'' needs to be substituted with the name of the template folder. Just create it if it doesn't exist.)
+This prevents losing those changes after an upgrade. The file still needs to include each section (i.e. ''[stylesheets]'' or ''[replacements]'') and paths are relative to the added ini file.
+If you use the [[plugin:styling|{{https://raw.githubusercontent.com/dokuwiki/dokuwiki/master/lib/plugins/styling/admin.svg?16}}]][[plugin:styling|Styling Plugin]] you can preview and change the replacement values via the admin interface, before it is stored in this file.
 Example: