updated documentation in style.ini

style.ini

@@ -2,13 +2,17 @@
 ; for limitations of the ini format used here
 
 ; To extend this file or make changes to it, it is recommended to create
-; a style.local.ini file to prevent losing any changes after an upgrade.
+; a local conf/tpl/<template-folder-name>/style.ini file to prevent losing
+; any changes after an upgrade.
 ; Please don't forget to copy the section your changes should be under
 ; (i.e. [stylesheets] or [replacements]) into that file as well.
 
 ; Define the stylesheets your template uses here. The second value
 ; defines for which output media the style should be loaded. Currently
 ; print, screen and all are supported.
+; You can reference CSS and LESS files here. Files referenced here will
+; be checked for updates when considering a cache rebuild while files
+; included through LESS' @import statements are not
 
 [stylesheets]
 
@@ -40,6 +44,8 @@ css/print.css             = print
 ; This section is used to configure some placeholder values used in
 ; the stylesheets. Changing this file is the simplest method to
 ; give your wiki a new look.
+; Placeholders defined here will also be made available as LESS variables
+; (with surrounding underscores removed, and the prefix @ini_ added)
 
 [replacements]
 
@@ -47,26 +53,26 @@ css/print.css             = print
 ;------ guaranteed dokuwiki color placeholders that every plugin can use
 
 ; main text and background colors
-__text__           = "#333"
-__background__     = "#fff"
+__text__           = "#333"                 ; @ini_text
+__background__     = "#fff"                 ; @ini_background
 ; alternative text and background colors
-__text_alt__       = "#999"
-__background_alt__ = "#eee"
+__text_alt__       = "#999"                 ; @ini_text_alt
+__background_alt__ = "#eee"                 ; @ini_background_alt
 ; neutral text and background colors
-__text_neu__       = "#666"
-__background_neu__ = "#ddd"
+__text_neu__       = "#666"                 ; @ini_text_neu
+__background_neu__ = "#ddd"                 ; @ini_background_neu
 ; border color
-__border__         = "#ccc"
+__border__         = "#ccc"                 ; @ini_border
 
 ; highlighted text (e.g. search snippets)
-__highlight__      = "#ff9"
+__highlight__      = "#ff9"                 ; @ini_highlight
 
 ;--------------------------------------------------------------------------
 
 ; these are used for links
-__existing__       = "#090"
-__missing__        = "#f30"
+__existing__       = "#090"                 ; @ini_existing
+__missing__        = "#f30"                 ; @ini_missing
 
 ; widths
-__site_width__          = "64em"
-__sidebar_width__       = "16em"
+__site_width__     = "64em"                 ; @ini_site_width
+__sidebar_width__  = "16em"                 ; @ini_sidebar_width