Adding color version 2022-10-19 (e28b337).

Signed-off-by: Daniel Baumann <daniel@debian.org>

plugins/55/color/README.md

@@ -0,0 +1,18 @@
+# color Plugin
+
+This is a plugin for [dokuwiki](https://www.dokuwiki.org/start)..
+
+See the plugin  [homepage](https://www.dokuwiki.org/plugin:color) for detailed documentation. Here we provide a brief summary of the required syntax:
+
+```
+<color ⟨fg color⟩[/⟨bg color⟩[/⟨ignored text⟩]]>⟨text⟩</color>
+<color ⟨fg color⟩:⟨bg color⟩[:⟨ignored text⟩]>⟨text⟩</color>
+```
+
+- Square brackets indicates optional parts.
+
+- `⟨fg color⟩` and `⟨bg color⟩` are CSS color specifications. Either one may be empty, in which case it is ignored.
+
+- In the first syntax, the color specification(s) MUST NOT include a slash (`/`).
+- In the second syntax, the color specification(s) MUST NOT include a colon character (`:`). We do not know any legal CSS color specification that does include a colon, nor do we anticipate that one will appear in the future.
+- The resulting HTML is a `<span>` element containing `⟨text⟩`, colorized with the given foreground and background colors.

plugins/55/color/plugin.info.txt

@@ -0,0 +1,7 @@
+base   color
+author Harald Hanche-Olsen
+email  harald.hanche-olsen@ntnu.no
+date   2022-10-19
+name   color syntax plugin
+desc   Write colored text in DokuWiki.
+url    https://www.dokuwiki.org/plugin:color

plugins/55/color/script.js

@@ -0,0 +1,91 @@
+/* JavaScript function to create color toolbar in Dokuwiki */
+/* see http://www.dokuwiki.org/plugin:color for more info */
+
+color_icobase = "../../plugins/color/images/";
+
+if(window.toolbar != undefined) {
+  toolbar[toolbar.length] = {
+    "type":"picker",
+    "title":"Color Text",
+    "icon":color_icobase+"toolbar_icon.png",
+    "list":[{
+      "type":"format",
+      "title":"Gray Colored Text",
+      "icon":color_icobase+"picker_light_gray.png",
+      "open":"<color #c3c3c3>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Rose Highlighted Text",
+      "icon":color_icobase+"picker_rose.png",
+      "open":"<color #ffaec9>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Red Highlighted Text",
+      "icon":color_icobase+"picker_red.png",
+      "open":"<color #ed1c24>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Orange Highlighted Text",
+      "icon":color_icobase+"picker_orange.png",
+      "open":"<color #ff7f27>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Gold Highlighted Text",
+      "icon":color_icobase+"picker_gold.png",
+      "open":"<color #ffc90e>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Yellow Highlighted Text",
+      "icon":color_icobase+"picker_yellow.png",
+      "open":"<color #fff200>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Light Yellow Highlighted Text",
+      "icon":color_icobase+"picker_light_yellow.png",
+      "open":"<color #efe4B0>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Green Highlighted Text",
+      "icon":color_icobase+"picker_green.png",
+      "open":"<color #22b14c>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Lime Highlighted Text",
+      "icon":color_icobase+"picker_lime.png",
+      "open":"<color #b5e61d>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Turquoise Highlighted Text",
+      "icon":color_icobase+"picker_turquoise.png",
+      "open":"<color #00a2e8>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Light Turquoise Highlighted Text",
+      "icon":color_icobase+"picker_light_turquoise.png",
+      "open":"<color #99d9ea>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Blue-Gray Highlighted Text",
+      "icon":color_icobase+"picker_blue_gray.png",
+      "open":"<color #7092be>",
+      "close":"</color>"
+    }, {
+      "type":"format",
+      "title":"Lavender Highlighted Text",
+      "icon":color_icobase+"picker_lavender.png",
+      "open":"<color #c8bfe7>",
+      "close":"</color>"
+    }]
+  };
+}

plugins/55/color/syntax.php

@@ -0,0 +1,115 @@
+<?php
+/**
+ * Plugin Color: Sets new colors for text and background.
+ * 
+ * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
+ * @author     Christopher Smith <chris@jalakai.co.uk>
+ */
+ 
+// must be run within DokuWiki
+if(!defined('DOKU_INC')) die();
+  
+/**
+ * All DokuWiki plugins to extend the parser/rendering mechanism
+ * need to inherit from this class
+ */
+class syntax_plugin_color extends DokuWiki_Syntax_Plugin {
+ 
+    function getType(){ return 'formatting'; }
+    function getAllowedTypes() { return array('formatting', 'substition', 'disabled'); }   
+    function getSort(){ return 158; }
+    function connectTo($mode) { $this->Lexer->addEntryPattern('<color.*?>(?=.*?</color>)',$mode,'plugin_color'); }
+    function postConnect() { $this->Lexer->addExitPattern('</color>','plugin_color'); }
+ 
+ 
+    /**
+     * Handle the match
+     */
+    function handle($match, $state, $pos, Doku_Handler $handler){
+        switch ($state) {
+          case DOKU_LEXER_ENTER :
+              $str = substr($match, 6, -1);
+              if (false === strpbrk($str,':')){
+                 $m = explode('/', $str);
+              } else {
+                 $m = explode(':', $str);
+              }
+              $color = $this->_specToCSS('color', $m[0]);
+              $background = $this->_specToCSS('background-color',
+                                              isset($m[1]) ? $m[1] : null);
+              return [$state, [$color, $background]];
+ 
+          case DOKU_LEXER_UNMATCHED :  return array($state, $match);
+          case DOKU_LEXER_EXIT :       return array($state, '');
+        }
+        return array();
+    }
+ 
+    /**
+     * Create output
+     */
+    function render($mode, Doku_Renderer $renderer, $data) {
+        if($mode == 'xhtml'){
+            list($state, $match) = $data;
+            switch ($state) {
+              case DOKU_LEXER_ENTER :      
+                list($color, $background) = $match;
+                $renderer->doc .= "<span style='$color $background'>"; 
+                break;
+ 
+              case DOKU_LEXER_UNMATCHED :  $renderer->doc .= $renderer->_xmlEntities($match); break;
+              case DOKU_LEXER_EXIT :       $renderer->doc .= "</span>"; break;
+            }
+            return true;
+        }
+        if($mode == 'odt'){
+            list($state, $match) = $data;
+            switch ($state) {
+              case DOKU_LEXER_ENTER :      
+                list($color, $background) = $match;
+                if (class_exists('ODTDocument')) {
+                    $renderer->_odtSpanOpenUseCSS (NULL, 'style="'.$color.$background.'"');
+                }
+                break;
+ 
+              case DOKU_LEXER_UNMATCHED :
+                $renderer->cdata($match);
+                break;
+
+              case DOKU_LEXER_EXIT :
+                if (class_exists('ODTDocument')) {
+                    $renderer->_odtSpanClose();
+                }
+                break;
+            }
+            return true;
+        }
+        if($mode == 'metadata'){
+            list($state, $match) = $data;
+            switch ($state) {
+              case DOKU_LEXER_UNMATCHED :
+                if ($renderer->capture) $renderer->cdata($match);
+                break;
+            }
+            return true;
+        }
+        return false;
+    }
+  
+    // Build a CSS attribute:value pair.
+    function _specToCSS($attrib, $c) {
+        $c = trim($c);
+        return ((!empty($c) &&
+                 $this->_isValid($c)) ? $attrib.':'.$c.';'
+                                      : null);
+    }
+
+    // validate color value $c
+    // this is cut price validation - only to ensure there is nothing harmful
+    // just ensure that no illegal characters are included therein
+    // leave it to the browsers to ignore a faulty colour specification
+    function _isValid($c) {
+        return (false === strpbrk($c, '"\'<>&;'));
+    }
+}
+?>