Differences

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

--- plugin:dokupp [2013-09-19 18:29] – complete syntax description Klap-in
+++ plugin:dokupp [2018-05-30 22:02] (current) – [DokuPP Plugin] Klap-in
@@ Line 1: / Line 1: @@
-====== DokuPlusPlus Plugin ======
+====== DokuPP Plugin ======
 ---- plugin ----
 description: DokuPP (DokuPlusPlus) provides automatic counters
 author     : Luis Machuca Bezzaza
-email      : luis [dot] machuca [at] gulix [dot] cl
+email      : luis.machuca [at] gulix.cl
 type       : Syntax
-lastupdate : 2011-02-02
+lastupdate : 2013-09-29
-compatible : ≥ //Lemming//
+compatible : Lemming
 depends    :
 conflicts  :
-similar    :
+similar    : autonumbering
-tags       : numbering formatting
+tags       : numbering formatting counter
-downloadurl: http://ryan.gulix.cl/dw/_media/desarrollo/dokuwiki/dw-plugin-dokupp-latest.zip
+downloadurl: http://chiselapp.com/user/lmachucab/repository/dokuwiki-plugin-dokupp/zip/dw-dokupp.zip?uuid=trunk
-bugtracker : # eg. http://github.com/ryan.chappelle/dokuwiki-plugin-dokupp/issues
+bugtracker : https://chiselapp.com/user/lmachucab/repository/dokuwiki-plugin-dokupp/reportlist
-sourcerepo : # eg. http://github.com/ryan.chappelle/dokuwiki-plugin-dokupp/
+sourcerepo : http://chiselapp.com/user/lmachucab/repository/dokuwiki-plugin-dokupp/
 donationurl:
 ----
+This plugin basically allows one to set up "magic counters" to provide numbering of items (nearly) anywhere one wants. If at some point you need to break and continue a numbered list and the list formatting plugins do not look like they would provide this easily, for example, then perhaps you can try this one!
 ===== Installation =====
-Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
+:!: The author strongly recommends uninstalling previous versions of this plugin before installing to prevent class name conflicts.
 ===== Examples/Usage =====
-See the plugin in action [[http://ryan.gulix.cl/dw/desarrollo/dokuwiki/plugin-dokupp|in the Official Demo Page]].
+See the plugin in action [[http://ryan.gulix.cl/dw/desarrollo/dokuwiki/plugin-dokupp|in the Official Demo Page]]. FIXME
 ===Counter===
@@ Line 39: / Line 44: @@
 </code>
-===Reinitialize===
+===Select and Setup===
-Default the counter starts at zero. To start at a higher value you put first ''@#=//number//@''.
+You can create your own, named counter, and assign an initial value to it. When you select a counter by name, all subsequent invocations of ''@#@'' syntax will refer to that counter until you decide to select another one.
+<code>
+Select (or create) a counter named 'houses', starting at one: @#houses=1@
+Select (or create) a counter named 'trees', starting at seven: @#trees=7@
+Select the 'houses' counter again, continue where it left: @#houses=@
+Select the default, unnamed counter, continue where it left: @#=@
+</code>
+Counter names must be single words in lowercase (eg.: "''itemperemployee'' not ''item_per_employee'' or ''ItemPerEmployee'').
+The **default (unnamed)** counter starts at zero. To start it at a higher value select it with a new number: ''@#=//number//@''.
 <code>
@@ Line 58: / Line 74: @@
 ===== Syntax =====
-In the current version (''dokupp-0'') the following syntax is allowed:
+In the current version (2013-09) the following syntax is allowed:
-  * Use ''@#=//number//@'' to (re)initialize the counter.
+  * Use ''@#=//number//@'' to (re)initialize the default counter.
     * When left out the counter starts at zero
     * You can reinitialize the counter as much as you like.
   * Use ''@#@'' to invoke the counter and display its current value.
+  * Use ''@#name@'' to select a new counter.
+    * You can reinitialize them as much as you like as well: ''@#name=7@''.
-Initializing the counter (this produces no observable output by default):
+**Initializing the counter** (this produces no observable output by default):
 <code>
 @#=5@  // initializes with the value 5//
 </code>
+**Invoking the counter**:
-Invoking the counter:
 <code>
 The following shows the number @#@, and this @#@ showed the next number.
@@ Line 78: / Line 96: @@
 ====Limitations====
-Only one counter can exist in a page. Therefore it is not possible to have another nested counter.
+<del>Only one counter can exist in a page</del>. Not anymore! **Rejoice**!
 :!: Using insertion plugins like [[plugin:include]] may break the display of the counter.
@@ Line 84: / Line 102: @@
 ===== Development =====
-This plugin is currently experimental and it is in a very early stage of development. Check the official demo page in order to see what do I have in store for this plugin.
+Caveats, sample snapshots and a ChangeLog are provided at the official demo site.
-Caveats, bugs and fixes, sample snapshots and a ChangeLog are provided at the official demo site.
+Issues can be submitted to the source repo's tracker (following or commenting on issues requires a login).
-^ Other Plugins by\\ Luis Machuca:   | [[plugin:progrecss]]\\ [[plugin:tooltip]]\\ [[plugin:clock]]\\ [[plugin:divalign2]]\\ [[plugin:countdown]]\\ [[plugin:noiewarning]]\\ [[plugin:hide]]\\ [[plugin:gil]]   |
 ===== FAQ =====
@@ Line 97: / Line 113: @@
 No discussion yet?