Ruby Macro

Last modified by Thomas Mortagne on 2024/07/05 14:31

ruby-16x16.pngRendering macro to execute Ruby script
TypeJAR
Category
Developed by

Thomas Mortagne, XWiki Development Team

Active Installs1
Rating
0 Votes
LicenseGNU Lesser General Public License 2.1

Installable with the Extension Manager

Description

This is a shortcut for Script Macro equivalent to {{script language="ruby"}} for executing ruby scripts.

Usage

{{ruby}}
require 'java'
include_class 'java.util.TreeSet'
set = TreeSet.new
set.add "foo"
set.add "Bar"
set.add "baz"
set.each do |v|
 puts "value: #{v}"
end
{{/ruby}}

Parameters definition

See the Script Macro for details.

Example

{{ruby}}
if $xcontext.getUser() != "XWiki.XWikiGuest" then
 puts "Hello [[#{$xcontext.getUser()}]]!"
else
 puts "You are not logged in!"
end
{{/ruby}}

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager).

You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.

Release Notes

v9.4.8.0

The following translation have been updated with this release:

v9.4.7.0

v9.4.5.0

v9.4.4.0

v9.3.11.0

v9.3.9.0.1

The following translation have been updated with this release:

v9.3.9.0

v9.2.20.1

v9.2.13.1

v9.2.13.0

v9.2.9.0

v9.1.2.0

  • The extension is now a Contrib extension synchronized on JRuby versions.
  • Upgraded to JRuby 9.1.2.0

Dependencies

Dependencies for this extension (org.xwiki.contrib:macro-ruby 9.4.8.0):

  • org.xwiki.platform:xwiki-platform-rendering-macro-script 16.2.0
  • org.jruby:jruby 9.4.8.0

Get Connected