Differences

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

--- template:starter [2014-05-27 02:37] – added "minimal" version ach
+++ template:starter [2024-01-21 14:21] (current) – template updated ach
@@ Line 5: / Line 5: @@
 author        : Anika Henke
 email         : anika@selfthinker.org
-lastupdate    : 2014-05-19
+lastupdate    : 2024-01-21
-compatible    : "Ponder Stibbons"
+compatible    : Frusterick Manners, Elenor of Tsort, Detritus, "Ponder Stibbons", Hrun, Greebo, Hogfather, 2023-04-04
 depends       :
 conflicts     :
 similar       :
 screenshot_img: :template:starter_template.png
-tags          : start, discussion, simple, sidebar, userpage
+tags          : start, simple, sidebar
-downloadurl   : https://github.com/selfthinker/dokuwiki_template_starter/archive/stable.zip
+downloadurl   : https://github.com/selfthinker/dokuwiki_template_starter/zipball/master
 bugtracker    : https://github.com/selfthinker/dokuwiki_template_starter/issues
 sourcerepo    : https://github.com/selfthinker/dokuwiki_template_starter
 donationurl   : https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=11071728
 ----
 The **Starter Template** is designed to be the starting point of your custom template. It has a lot of inline comments in the code which should explain many things. It focuses less on design, but more on maintainability.
@@ Line 36: / Line 35: @@
 ===== Download and Install ======
-  * For Ponder Stibbons: Use the extension manager to install this template.
+  * For DokuWiki version 2014-05-05 (Ponder Stibbons) and later: Use the extension manager to install this template.
   * For Binky or Weatherwax: You can {{:template:dokuwiki_template_starter.zip|download an older version}}.
-  * If you need to support even older DokuWikis, you can use the [[https://github.com/selfthinker/dokuwiki_template_starter/tree/backwards-compatible|"backwards-compatible" branch]].
   * If you're interested in a more stripped down version of the template, you can use the [[https://github.com/selfthinker/dokuwiki_template_starter/tree/minimal|"minimal" branch]]. That version hardly uses any CSS at all and doesn't include any additional functionalities.
 Refer to [[:template]] on how to install and use templates in DokuWiki.
 ===== Configuration ======
@@ Line 47: / Line 46: @@
 ^config option         ^description                                                         ^default value   ^
-^ ''userPage''         | User page (''@USER@'' is replace by the corresponding user name)   | ''user:@USER@'' |
-^ ''discussionPage''   | Discussion page (''@ID@'' is replaced by the corresponding page ID)| ''discussion:@ID@'' |
 ^ ''hideTools''        | hide editing and other tools when not logged in                    | ''0''          |
+^ ''sidebarIsNav''     | use a ''nav'' element around the sidebar if it's mainly used for navigation, otherwise use an ''aside'' element (new since version 2021-01-25) | ''1''          |
-===== Event hooks =====
+Config options in previous versions (removed in version 2021-01-25):
-Since 2013-11-18 the following three event hooks are supported:
+  * ''discussionPage'': Discussion page functionality was removed and can be replaced by using the [[:plugin:talkpage|Talkpage Plugin]]; just change the ''talkns'' option from 'talk' to 'discussion' to use the same namespace as before
+  * ''userPage'': User page functionality was removed and can be replaced by using the [[:plugin:userpage|Userpage Plugin]]
-  * ''[[devel:event:TEMPLATE_USERTOOLS_DISPLAY]]'': for changing or adding to items in the user tools (login, admin, etc)
-  * ''[[devel:event:TEMPLATE_SITETOOLS_DISPLAY]]'': for changing or adding to items in the site tools (recent changes, sitemap, etc)
-  * ''[[devel:event:TEMPLATE_PAGETOOLS_DISPLAY]]'': for changing or adding to items in the user tools (edit page, old revisions, etc)
-The items can be accessed via ''%%$event->data['items']%%''.
 ===== More Info ======
-==== To Do =====
-  * improve print styles
 ==== Credits =====
@@ Line 76: / Line 67: @@
 {{rss>https://github.com/selfthinker/dokuwiki_template_starter/commits/master.atom date}}
 ==== Demo ====
@@ Line 91: / Line 83: @@
   * [[writers|Writer's]]
   * [[zenlike|Zenlike]]
+  * [[benjamin|Benjamin]]
+  * [[template:stm|STM]]
 ===== Comments =====
@@ Line 99: / Line 94: @@
 ==== How to translate this theme? ====
-There are two files to translate:
+There are three files to translate:
-  * [[https://github.com/selfthinker/dokuwiki_template_starter/blob/master/lang/en/lang.php|lang/en/lang.php]] is for everything you see on the frontend (although the "accessibility headlines" are hidden for most users). This file is the most important to translate.
+  * [[https://github.com/selfthinker/dokuwiki_template_starter/blob/master/lang/en/lang.php|lang/en/lang.php]] is for everything you see on the frontend (although the "accessibility headlines" are hidden for most users) plus descriptions for style.ini placeholders which the [[plugin:Styling]] plugin in the admin section uses. This file is the most important to translate.
   * [[https://github.com/selfthinker/dokuwiki_template_starter/blob/master/lang/en/settings.php|lang/en/settings.php]] is for the configuration admin. This file is not as important as the other, as it will only be seen by the admin(s).
+  * [[https://github.com/selfthinker/dokuwiki_template_starter/blob/master/lang/en/style.txt|lang/en/style.txt]] is for extra information about configuration of the template displayed under the form of the [[plugin:Styling]] plugin in the admin section.
 You can either send me language files to update by email or post them here or in the [[https://github.com/selfthinker/dokuwiki_template_starter/issues|bugtracker]]. Please have a look at the [[https://github.com/selfthinker/dokuwiki_template_starter/tree/master/lang|available translations]] first.
@@ Line 137: / Line 133: @@
 > Thanks. That's fixed since today's release. --- [[user>ach|Anika Henke]] //2014-05-19 03:24//