Differences

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

--- plugin:ditaa [2016-02-15 23:26] – [Example] 37.115.223.10
+++ plugin:ditaa [2024-01-01 19:52] (current) – screenshot Aleksandr
@@ Line 6: / Line 6: @@
 email      : andi@splitbrain.org
 type       : syntax
-lastupdate : 2016-02-02
+lastupdate : 2016-06-24
-compatible : lemming, anteater, rincewind, angua, weatherwax, adora belle
+compatible : Lemming, Anteater, Rincewind, Angua, Weatherwax, Adora Belle, Hrun, Detritus
 depends    :
 conflicts  :
-similar    : Graphviz, diagram
+similar    : Graphviz, diagram, a2s
 tags       : media, images, diagram, java
@@ Line 24: / Line 24: @@
 ===== Download and Installation =====
-Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the URL given above. 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.
 ==== Changes ====
@@ Line 32: / Line 32: @@
 ===== Configuration =====
-The plugin provides a configuration setting in the [[plugin:config|config manager]] to specify the path to your Java interpreter. When set, the tool will run ditaa locally on your server to create the graphics. The ditaa jar file is included in the plugin, you do not need to download it separately.
+The plugin provides a configuration setting in the [[plugin:config|config manager]] to specify the path to your Java interpreter. When set, the tool will run the original ditaa locally on your server to create the graphics. The ditaa jar file is included in the plugin, you do not need to download it separately.
-<del>When you do not provide a Java interpreter path in the config, the plugin will use the webservice at ditaa.org to create the images. Having Java available on your server is now completely optional!</del>\\
+When you not provide a Java path, the plugin will instead use an alternative implementation of ditaa written in go. The plugin comes with 64bit versions for Windows and Linux, but will try downloading different binaries if needed. Please note that the go version has not all the features of the orginal ditaa in Java.
-:!: **ditaa.org is down since long time** (02.12.2012 acc. below comment), and is still down today 17.12.2015. --- //tmomas//
 ===== Syntax =====
@@ Line 55: / Line 54: @@
 | height=//<num>//    | height=0      | Same as above but for height. Only works when a width is given as well |
 | //<num>//x//<num>// | 0x0           | Combines the above parameters into one. That's a lowercase x! |
-| <float>X            | 1.0X          | Tells ditaa to scale the image. Eg. 2.0X makes the final image twice as big. That's an uppercase X |
+| <float>X            | 1.0X          | Tells ditaa to scale the image. Eg. 2.0X makes the final image twice as big. That's an uppercase X (only with Java)|
-| (no)round           | noround       | Enable or disable round corners for all boxes |
+| (no)round           | noround       | Enable or disable round corners for all boxes  (only with Java)|
-| (no)shadow          | shadow        | Enable or disable box shadows |
+| (no)shadow          | shadow        | Enable or disable box shadows  (only with Java)|
-| (no)antialias       | antialias     | Enable or disable antialiasing |
+| (no)antialias       | antialias     | Enable or disable antialiasing  (only with Java)|
-| (no)edgesep         | edgesep       | Enable or disabling the separation of box edges where boxes directly touch |
+| (no)edgesep         | edgesep       | Enable or disabling the separation of box edges where boxes directly touch  (only with Java)|
 | left center right   |               | Align the image to the left, center or right. Default does no alignment (inline)|
@@ Line 66: / Line 65: @@
 Not all shape selector tags are documented on the ditaa site. A quick source scan revealed:
-^ tag  ^ Description   ^
+^ tag      ^ Description   ^
-| {c}  | decision(Choice)  |
+| ''{c}''  | decision (Choice)  |
-| {d}  | document  |
+| ''{d}''  | document  |
-| {io} | input/output, parallelogram  |
+| ''{io}'' | input/output, parallelogram  |
-| {mo} | manual operation  |
+| ''{mo}'' | manual operation  |
-| {o}  | ellipse, circle  |
+| ''{o}''  | ellipse, circle  |
-| {s}  | storage  |
+| ''{s}''  | storage  |
-| {tr} | trapezoid (looks like an inverted {mo} )  |
+|'' {tr}'' | trapezoid (looks like an inverted ''{mo}'')  |
 ===== Example =====
-{{ http://img696.imageshack.us/img696/7251/foom.png?nolink&|Ditaa Example}}
+{{ https://trello.com/1/cards/6593097735813b365132052a/attachments/659309a641fe725dbda9056c/download/Ditaa-Plugin-Screenshot.png?nolink&recache|Ditaa Example}}
 <code>
 <ditaa round noedgesep right>
-                              +-------+
+    +--------+   +-------+    +-------+
-    +--------+   +-------+    |       |
     |        | --+ ditaa +--> |       |
     |  Text  |   +-------+    |diagram|
@@ Line 94: / Line 92: @@
 </ditaa>
 </code>
-===== Discussion =====
-Would it be possible to embed active dokuwiki links, or even implement an imagemap for the rendered png, so the boxes can become active links - a bit like flowchartwiki ? -- //LS 20120111//
+===== Further Doc =====
-==== Workaround for wrong java version ====
+  * [[http://ditaa.sourceforge.net/|ditaa @ sourceforge]]
-Ditaa did not work out of the box as the servers default version of java was 1.5 \\
-I created therefor a small bat file called CorrectJavaDitaa.bat containing the following text:
-<code dos CorrectJavaDitaa.bat>
-set JAVA_HOME=F:\oracle\product\middleware\jdk160_24
-path %JAVA_HOME%\bin;%PATH%
-java %*
-</code>
-%%F:\oracle\product\middleware\jdk160_24%% is a version 1.6 of java ;-) \\
-In the config screen of DokuWiki the value of java was set to the location of the bat file: \\
-| The path to your Java runtime interpreter (eg. /usr/bin/java). Leave empty to use remote rendering at ditaa.org. | %% F:\Tools\Apache2.2\htdocs\dokuwiki\lib\plugins\ditaa\CorrectJavaDitaa.bat %% |
-Hope this may help others, also in setting other environmental parameters to get the jvm behave as needed \\
- // JH - 29-may-2013 //
-thanks a lot. it is not just workaround, it is a must!
-I use version java1.7
- // AQ - 13-feb-2014 //
-==== Bugs ====
-Ditaa don't understand non-latin characters. For example: Cyrillic.
-The server at ditaa.org seems to be down, and has not been responsive for a while.   --- [[user>turnermm|Myron Turner]] //2012/12/04 04:00//\\
-Confirmed, ditaa.org still down --- //tmomas 2015/12/17//
-----
-Ditaa works with Cyrillic/Russian perfect! But in Dokuwiki preferences your must:
-Ditaa Plugin pref
-plugin»ditaa»java
-The path to your Java runtime interpreter
-(eg. /usr/bin/java). Leave empty to use
-remote rendering at ditaa.org.
-- type something (without quotes) - "C:/Program Files/jre6/bin/java.exe"
-==== broken.png is displayed / plugin doesn't render your image, OpenJDK ====
-I found that ditaa recently broke on my system - running <code> java -jar ditaa.jar testin.txt testout.png</code> from the command-line (where testin.txt contains some ditaa markup) produced <code>
-...
-Caused by: java.lang.Error: Probable fatal error:No fonts found.
-...</code>
-This seems to happen on OpenJDK on Linux, and was resolved by installing the dejavu font package. On Gentoo:<code>sudo emerge media-fonts/dejavu</code>
- --- [[user>tomgreen|tomgreen]] //2014-05-27 02:19//
-==== farm mode ====
-This plugin fails in farm mode. Report to the [[https://github.com/splitbrain/dokuwiki-plugin-ditaa/issues/11|Github issue]].
-You can workaround adding one line in ''<farmer>/lib/plugin/ditaa/syntax.php''<code php>
-    function _cachename($data,$ext){
-        unset($data['width']);
-        unset($data['height']);
-        unset($data['align']);
-  +++   unset($data['animal']);
-        return getcachename(join('x',array_values($data)),'.ditaa.'.$ext);
-    }
-</code>
- --- [[user>atisne|atisne]] //2014-10-10 15:25//