Difference between revisions of "FreeplaneJrubyInstaller Addon"

From Freeplane - free mind mapping and knowledge management software
Line 2: Line 2:
  
  
=== What is FreeplaneJrubyInstaller ===
+
=== Introduction ===
  
Its an addon to '''add support for .rb (ruby) scripts in Freeplane''', so that you can use .groovy .js '''and .rb''' scripts
+
This addon '''adds support for .rb (ruby) scripts in Freeplane''', so that you can use .groovy .js '''and .rb''' scripts
  
  
  
Freeplane supports .groovy and .js (javascript) scripts out-of-the-box. This addon adds support for .rb (ruby) scripts, enabling you to use:
+
Freeplane supports .groovy and .js (javascript) scripts out-of-the-box. This addon adds support for .rb (ruby) scripts, enabling you to use: <code>&lt;freeplane-user-dir&gt;/scripts/my_ruby_script.rb</code> besides .groovy and .js scripts.
  
<code>&lt;freeplane-user-dir&gt;/scripts/my_ruby_script.rb</code> besides .groovy and .js scripts
+
Also, after this addon is installed, future plugins can as well make use of ruby scripts (via the "scripts" node, just like with .groovy scripts)
  
It does this by using internally the [http://jruby.org/ Jruby interpreter], which is capable of running ruby scripts with access to Java objects (Freeplane-java-objects!)
 
  
  
 +
All this is possible because Freeplane was programmed with good design (applause to the devs :) ), using JSR223 that allows external scripting engines to be added, such as the [http://jruby.org/ Jruby interpreter] that is capable of running ruby scripts with access to Java objects (Freeplane-java-objects!).
  
=== Install FreeplaneJrubyInstaller in Freeplane ===
+
  
You dont need to manually download anything, all downloads are automatic.
+
=== How to install the FreeplaneJrubyInstaller Addon in Freeplane ===
  
To install the addon follow the instructions bellow (to enlarge an image, click on it):
+
You dont need to manually download anything, all downloads are automatic. To install the addon follow the instructions bellow (click on any image to enlarge it):
  
 
* Check that your Java version is &gt;= 1.7 (Jruby requires it). If you want to update your Java, goto https://java.com/en/download/
 
* Check that your Java version is &gt;= 1.7 (Jruby requires it). If you want to update your Java, goto https://java.com/en/download/
Line 27: Line 27:
  
 
* Copy to your clipboard THE-URL-TO-THE-ADDON: <code>https://raw.githubusercontent.com/zipizap/FreeplaneJrubyInstaller/master/addon_lab/FreeplaneJrubyInstaller-v1.6.addon.mm</code>
 
* Copy to your clipboard THE-URL-TO-THE-ADDON: <code>https://raw.githubusercontent.com/zipizap/FreeplaneJrubyInstaller/master/addon_lab/FreeplaneJrubyInstaller-v1.6.addon.mm</code>
* Follow me:
+
* Follow the images:
  
 
[[File:img1.png|frame|400x200px|none|link={{filepath:img1.png}}]]<br />
 
[[File:img1.png|frame|400x200px|none|link={{filepath:img1.png}}]]<br />

Revision as of 14:04, 11 April 2016


Introduction

This addon adds support for .rb (ruby) scripts in Freeplane, so that you can use .groovy .js and .rb scripts


Freeplane supports .groovy and .js (javascript) scripts out-of-the-box. This addon adds support for .rb (ruby) scripts, enabling you to use: <freeplane-user-dir>/scripts/my_ruby_script.rb besides .groovy and .js scripts.

Also, after this addon is installed, future plugins can as well make use of ruby scripts (via the "scripts" node, just like with .groovy scripts)


All this is possible because Freeplane was programmed with good design (applause to the devs :) ), using JSR223 that allows external scripting engines to be added, such as the Jruby interpreter that is capable of running ruby scripts with access to Java objects (Freeplane-java-objects!).


How to install the FreeplaneJrubyInstaller Addon in Freeplane

You dont need to manually download anything, all downloads are automatic. To install the addon follow the instructions bellow (click on any image to enlarge it):

Img0.png
Img1.png


Img2.png


Img3.png


Img4.png


Img5.png


Img6.png



  • Open Freeplane for a second-time, and:
Img7.png


Img8.png


Img9.png


Img10.png



  • Open Freeplane for a third-time, and:
Img11.png



  • The following final window should appear, which indicates that Jruby is now installed in Freeplane. Hurray, the addon is installed!
Img12.png