====== colortag Plugin ======

---- plugin ----
description: Adds <colortag> syntax
author     : jno 
email      : jno@pisem.net 
type       : syntax
lastupdate : 2019-03-26
compatible : 2010-11-07, 2011-04-22, 2011-05-25, 2012-01-25a
depends    : 
conflicts  : 
similar    : 
tags       : tags

downloadurl: https://github.com/jn0/colortag/zipball/master
bugtracker : 
sourcerepo : https://github.com/jn0/colortag
donationurl: 

screenshot_img: https://trello.com/1/cards/5b5f612eb27400430f509709/attachments/5b5f62926adf4e308f57f70b/download/colortag.png
----

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

[[https://jno.undo.it/dokuwiki/doku.php?id=nk082|Live demo]]. FIXME

==== From this code ====

<code>
* <colortag char=+>brown,black,brown</colortag> 2×100Ом
* <colortag>brown,black,red</colortag> 1×1кОм
* <colortag>orange,orange,red</colortag> 1×3.3кОм
* <colortag>brown,black,orange</colortag> 2×10кОм
* <colortag>red,magenta,red</colortag> 1×2.7кОм
* <colortag>yellow,magenta,brown</colortag> 1×470Ом
</code>

==== one may get this picture ====

{{https://trello.com/1/cards/5b5f612eb27400430f509709/attachments/5b5f62926adf4e308f57f70b/download/colortag.png?recache|the render}}

===== Syntax =====

''<**colortag**[//attributes//]>//TAG//[,//TAG//,%%...%%]</**colortag**>''

  * **//TAG//** is either a //color//, or //color//'':''//char//, or //color//'':''//char//'':''//color//
    * **//color//** can be given (as for any HTML color field) by:
      * **black** --- name
      * **#1A2B3C** --- 6-digit hex
      * **#1AF** --- 3-digit hex
      * the last //color//, if any, is the //foreground// one
    * **//char//** is any //good// char to show (say, ''&bull;'')
  * //attributes// are now unused.

===== Configuration and Settings =====

  * One may edit **style.css** file in the plugin's directory to customize the render.\\ Actually, only the **table.colortag** specs (and below) are in use.

===== Development =====

=== Change Log ===

  * **2012-05-18**
    * //color//'':''//char// and //color//'':''//char//'':''//color// forms added:
      * ''<colortag>green:&bull;</colortag>''
      * ''<colortag>green:&bull;:lime</colortag>''
  * **2011-03-25**
    * verification of //color// value has been added
  * **2011-03-14**
    * Initial release

=== Known Bugs and Issues ===

  * <del>No verification is done on the //color// value. This may lead to code injection.</del>

=== ToDo/Wish List ===

  * make use of //attributes// to set color of the border lines.
  * <del>filter the //color// value to prevent abuse.</del>
  * tune up the ''style.css'' to reduce the vertical size of the resulting boxen.
  * implement (via //attributes//?) an automated way of mapping some device values to respective color codes (resistors, diodes, etc).\\ Something like ''<colortag **resistor=4.7kOhm**></colortag>''.

===== FAQ =====

  * //[none]//

===== Discussion =====

  * //none//