Differences

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

--- plugin:pot [2022-01-10 16:51] – [potid] Aleksandr
+++ plugin:pot [2024-02-13 23:29] (current) – compatible with "Igor" Aleksandr
@@ Line 6: / Line 6: @@
 email      :
 type       : syntax
-lastupdate : 2022-01-09
+lastupdate : 2022-08-03
-compatible : Hogfather
+compatible : Hogfather, Igor
 depends    :
 conflicts  :
 similar    : calc, fields
-tags       : calculation
+tags       : calculation, math
 downloadurl:  https://codeberg.org/agapetus/pot/archive/dokuwiki_plugin_pot.zip
@@ Line 44: / Line 44: @@
 The values are a simple line of entries in the format: "''%%key=value | key=value | key=value%%''"
-^ key  ^ shortcut  ^ (default) value  ^ why  ^
+^ key               ^ shortcut                      ^ (default) value                                                                                                                                               ^ why                                                                                                    ^
-| set  |   | any number or word,  | with this key word you will set a page default, see below  |
+| ''set''           |                               | any number or word                                                                                                                                            | with this key word you will set a page default, see below                                              |
-| potid  | @value or #value  | unique id for this pot, see below: shortcut  | necessary if you want to use this pot-result within an other pot  |
+| ''potid''         | ''@value''\\ or\\ ''#value''  | unique id for this pot, see below: shortcut                                                                                                                   | necessary if you want to use this pot-result within an other pot                                       |
-| decimals  |   | (0) how many numbers after the decimal point  |   |
+| ''decimals''      |                               | (0) how many numbers after the decimal point                                                                                                                  |                                                                                                        |
-| currency  |   | () symbols ( €, $, ...) or letters (EUR, DOL, ...)  |   |
+| ''currency''      |                               | () symbols ( €, $, ...) or letters (EUR, DOL, ...)                                                                                                            |                                                                                                        |
-| width  |   | (0) length of the result field in the format: 10px  | if you need all numbers nicely below the other  |
+|                   |                               | you can use " _ " to place the currency before or after the value: eg. "_ €" is replaced to "value €" and "€ _" is replaced to "€ value" (default ist after)  |                                                                                                        |
-| formula  |   | (false) true  | shows the formula if true  |
+| ''width''         |                               | (0) length of the result field in the format: 10px                                                                                                            | if you need all numbers nicely below the other                                                         |
-| display  |   | (flex) none  | none if you need to hide the pot ( it is still shown in the html code!)  |
+| ''formula''       |                               | (false) true                                                                                                                                                  | shows the formula if true                                                                              |
-| float  | !  | (left) right  |   |
+| ''display''       |                               | (flex) none                                                                                                                                                   | none if you need to hide the pot ( it is still shown in the html code!)                                |
-| sepmil  |   | (,)  | the sign which separates the thousand (1.000,00)  |
+| ''float''         | ''!''                         | (left) right                                                                                                                                                  |                                                                                                        |
-| sepdec  |   | (.)  | the sign which separates the decimals (0,00)  |
+| ''sepmil''        |                               | (,)                                                                                                                                                           | the sign which separates the thousand (1.000,00)                                                       |
-| defaultentry  | ~value  |   | shortcut, if you have used "set=3" you can use ~3 to call all settings done within the pot with set=3  |
+| ''sepdec''        |                               | (.)                                                                                                                                                           | the sign which separates the decimals (0,00)                                                           |
-| color+  |   |   | set a color for results above 0  |
+| ''defaultentry''  | ''~value''                    |                                                                                                                                                               | shortcut, if you have used "set=3" you can use ~3 to call all settings done within the pot with set=3  |
-| color-  |   |   | set a color for results beneath 0  |
+| ''color+''        |                               |                                                                                                                                                               | set a color for results above 0                                                                        |
-| type  |   | (formula) text  | the pot can be used to calculate formulas or to set and reuse text  |
+| ''color-''        |                               |                                                                                                                                                               | set a color for results beneath 0                                                                      |
+| ''type''          |                               | (formula) text                                                                                                                                                | the pot can be used to calculate formulas or to set and reuse text                                     |
 === More examples ===
@@ Line 96: / Line 97: @@
 With "potid" you can set individual names to each pot. If not, it will be set automatically. There is a simple rule in the automatically set name, it ads an rising number to the last potid set. Simply set ''potid=example5'' and the next pots will have: example6, example7, example8,... until you set a new name where the rising starts again.
-==== hortcuts ====
+==== Shortcuts ====
-Some signs are definde as shortcuts. You might use them in the "format" part.
+Some signs are definde as shortcuts. You might use them in the ''format'' part.
-  <pot @example_5 > 1 </pot>                           is identical to  <pot potid=example_5 > 1 </pot>
+''%%<pot @example_5 > 1 </pot>%%'' is identical to ''%%<pot potid=example_5 > 1 </pot>%%''
-| shortcut | the same as |  |
+^ Shortcut    ^ the same as ^^
-| @value  | potid=value |  |
+| ''@value''  | ''potid=value'' |  |
-| #value | potid=value_(uniqueNumber) | nice to use in tables and to sum them with {#value} later |
+| ''#value''  | ''potid=value_(uniqueNumber)'' | nice to use in tables and to sum them with ''{#value}'' later |
-| ! | float= right | probebly best in tables to have your numbers nicely on the right side |
+| ''!''       | ''float=right'' | probebly best in tables to have your numbers nicely on the right side |
-| ~value | defaultentry=value | fetches page settings which were set erlier with "set=value" |
+| ''~value''  | ''defaultentry=value'' | fetches page settings which were set erlier with ''set=value'' |
-==== text ====
+==== Text ====
 To use this plugin for text entries simply write:
-  <POT> my text </POT>         or      <pot format=text > my text </pot>
+  <POT> my text </POT>
-You can use this text later on the page with {@value}. A other plugin with similar functions: [[https://www.dokuwiki.org/plugin:fields|plugin fields]].
+or
+  <pot format=text > my text </pot>
-==== WYSiWYG editor ====
+You can use this text later on the page with ''{@value}''. A other plugin with similar functions: [[plugin:fields|Fields Plugin]].
-Unfortunately, error messages occur when using [[https://www.dokuwiki.org/plugin:prosemirror|plugin:prosemirror]] and
-[[https://www.dokuwiki.org/plugin:edittable|plugin:edittable]]. The error messages occur when preview is clicked in the editor. After regular saving of the page the display is as usual.
+==== WYSIWYG editor ====
+Unfortunately, error messages occur when using [[plugin:prosemirror|Prosemirror Plugin]] and [[plugin:edittable|Edittable Plugin]]. The error messages occur when preview is clicked in the editor. After regular saving of the page the display is as usual.
@@ Line 131: / Line 135: @@
 This first attempt is only done with php. That is why the calculations and name assignments are made from top to bottom. Possibly, at some point, a variant with javascript will be created in order to be able to retrieve the set values on the whole page unhindered.
-==== developer notes ====
+==== Developer notes ====
 Unfortunately, I do not have the necessary time or knowledge to maintain this plugin permanently or to improve it significantly. Please feel free to use, copy and fork the plugin.