<!--{{{-->
<link rel='alternate' type='application/rss+xml' title='RSS' href='index.xml'/>
<!--}}}-->

Background: #fff
Foreground: #000
PrimaryPale: #8cf
PrimaryLight: #18f
PrimaryMid: #04b
PrimaryDark: #014
SecondaryPale: #ffc
SecondaryLight: #fe8
SecondaryMid: #db4
SecondaryDark: #841
TertiaryPale: #eee
TertiaryLight: #ccc
TertiaryMid: #999
TertiaryDark: #666
Error: #f88

/*{{{*/
body {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];}

a {color:[[ColorPalette::PrimaryMid]];}
a:hover {background-color:[[ColorPalette::PrimaryMid]]; color:[[ColorPalette::Background]];}
a img {border:0;}

h1,h2,h3,h4,h5,h6 {color:[[ColorPalette::SecondaryDark]]; background:transparent;}
h1 {border-bottom:2px solid [[ColorPalette::TertiaryLight]];}
h2,h3 {border-bottom:1px solid [[ColorPalette::TertiaryLight]];}

.button {color:[[ColorPalette::PrimaryDark]]; border:1px solid [[ColorPalette::Background]];}
.button:hover {color:[[ColorPalette::PrimaryDark]]; background:[[ColorPalette::SecondaryLight]]; border-color:[[ColorPalette::SecondaryMid]];}
.button:active {color:[[ColorPalette::Background]]; background:[[ColorPalette::SecondaryMid]]; border:1px solid [[ColorPalette::SecondaryDark]];}

.header {background:[[ColorPalette::PrimaryMid]];}
.headerShadow {color:[[ColorPalette::Foreground]];}
.headerShadow a {font-weight:normal; color:[[ColorPalette::Foreground]];}
.headerForeground {color:[[ColorPalette::Background]];}
.headerForeground a {font-weight:normal; color:[[ColorPalette::PrimaryPale]];}

.tabSelected{color:[[ColorPalette::PrimaryDark]];
	background:[[ColorPalette::TertiaryPale]];
	border-left:1px solid [[ColorPalette::TertiaryLight]];
	border-top:1px solid [[ColorPalette::TertiaryLight]];
	border-right:1px solid [[ColorPalette::TertiaryLight]];
}
.tabUnselected {color:[[ColorPalette::Background]]; background:[[ColorPalette::TertiaryMid]];}
.tabContents {color:[[ColorPalette::PrimaryDark]]; background:[[ColorPalette::TertiaryPale]]; border:1px solid [[ColorPalette::TertiaryLight]];}
.tabContents .button {border:0;}

#sidebar {}
#sidebarOptions input {border:1px solid [[ColorPalette::PrimaryMid]];}
#sidebarOptions .sliderPanel {background:[[ColorPalette::PrimaryPale]];}
#sidebarOptions .sliderPanel a {border:none;color:[[ColorPalette::PrimaryMid]];}
#sidebarOptions .sliderPanel a:hover {color:[[ColorPalette::Background]]; background:[[ColorPalette::PrimaryMid]];}
#sidebarOptions .sliderPanel a:active {color:[[ColorPalette::PrimaryMid]]; background:[[ColorPalette::Background]];}

.wizard {background:[[ColorPalette::PrimaryPale]]; border:1px solid [[ColorPalette::PrimaryMid]];}
.wizard h1 {color:[[ColorPalette::PrimaryDark]]; border:none;}
.wizard h2 {color:[[ColorPalette::Foreground]]; border:none;}
.wizardStep {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];
	border:1px solid [[ColorPalette::PrimaryMid]];}
.wizardStep.wizardStepDone {background:[[ColorPalette::TertiaryLight]];}
.wizardFooter {background:[[ColorPalette::PrimaryPale]];}
.wizardFooter .status {background:[[ColorPalette::PrimaryDark]]; color:[[ColorPalette::Background]];}
.wizard .button {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::SecondaryLight]]; border: 1px solid;
	border-color:[[ColorPalette::SecondaryPale]] [[ColorPalette::SecondaryDark]] [[ColorPalette::SecondaryDark]] [[ColorPalette::SecondaryPale]];}
.wizard .button:hover {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::Background]];}
.wizard .button:active {color:[[ColorPalette::Background]]; background:[[ColorPalette::Foreground]]; border: 1px solid;
	border-color:[[ColorPalette::PrimaryDark]] [[ColorPalette::PrimaryPale]] [[ColorPalette::PrimaryPale]] [[ColorPalette::PrimaryDark]];}

#messageArea {border:1px solid [[ColorPalette::SecondaryMid]]; background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]];}
#messageArea .button {color:[[ColorPalette::PrimaryMid]]; background:[[ColorPalette::SecondaryPale]]; border:none;}

.popupTiddler {background:[[ColorPalette::TertiaryPale]]; border:2px solid [[ColorPalette::TertiaryMid]];}

.popup {background:[[ColorPalette::TertiaryPale]]; color:[[ColorPalette::TertiaryDark]]; border-left:1px solid [[ColorPalette::TertiaryMid]]; border-top:1px solid [[ColorPalette::TertiaryMid]]; border-right:2px solid [[ColorPalette::TertiaryDark]]; border-bottom:2px solid [[ColorPalette::TertiaryDark]];}
.popup hr {color:[[ColorPalette::PrimaryDark]]; background:[[ColorPalette::PrimaryDark]]; border-bottom:1px;}
.popup li.disabled {color:[[ColorPalette::TertiaryMid]];}
.popup li a, .popup li a:visited {color:[[ColorPalette::Foreground]]; border: none;}
.popup li a:hover {background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]]; border: none;}
.popup li a:active {background:[[ColorPalette::SecondaryPale]]; color:[[ColorPalette::Foreground]]; border: none;}
.popupHighlight {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];}
.listBreak div {border-bottom:1px solid [[ColorPalette::TertiaryDark]];}

.tiddler .defaultCommand {font-weight:bold;}

.shadow .title {color:[[ColorPalette::TertiaryDark]];}

.title {color:[[ColorPalette::SecondaryDark]];}
.subtitle {color:[[ColorPalette::TertiaryDark]];}

.toolbar {color:[[ColorPalette::PrimaryMid]];}
.toolbar a {color:[[ColorPalette::TertiaryLight]];}
.selected .toolbar a {color:[[ColorPalette::TertiaryMid]];}
.selected .toolbar a:hover {color:[[ColorPalette::Foreground]];}

.tagging, .tagged {border:1px solid [[ColorPalette::TertiaryPale]]; background-color:[[ColorPalette::TertiaryPale]];}
.selected .tagging, .selected .tagged {background-color:[[ColorPalette::TertiaryLight]]; border:1px solid [[ColorPalette::TertiaryMid]];}
.tagging .listTitle, .tagged .listTitle {color:[[ColorPalette::PrimaryDark]];}
.tagging .button, .tagged .button {border:none;}

.footer {color:[[ColorPalette::TertiaryLight]];}
.selected .footer {color:[[ColorPalette::TertiaryMid]];}

.sparkline {background:[[ColorPalette::PrimaryPale]]; border:0;}
.sparktick {background:[[ColorPalette::PrimaryDark]];}

.error, .errorButton {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::Error]];}
.warning {color:[[ColorPalette::Foreground]]; background:[[ColorPalette::SecondaryPale]];}
.lowlight {background:[[ColorPalette::TertiaryLight]];}

.zoomer {background:none; color:[[ColorPalette::TertiaryMid]]; border:3px solid [[ColorPalette::TertiaryMid]];}

.imageLink, #displayArea .imageLink {background:transparent;}

.annotation {background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]]; border:2px solid [[ColorPalette::SecondaryMid]];}

.viewer .listTitle {list-style-type:none; margin-left:-2em;}
.viewer .button {border:1px solid [[ColorPalette::SecondaryMid]];}
.viewer blockquote {border-left:3px solid [[ColorPalette::TertiaryDark]];}

.viewer table, table.twtable {border:2px solid [[ColorPalette::TertiaryDark]];}
.viewer th, .viewer thead td, .twtable th, .twtable thead td {background:[[ColorPalette::SecondaryMid]]; border:1px solid [[ColorPalette::TertiaryDark]]; color:[[ColorPalette::Background]];}
.viewer td, .viewer tr, .twtable td, .twtable tr {border:1px solid [[ColorPalette::TertiaryDark]];}

.viewer pre {border:1px solid [[ColorPalette::SecondaryLight]]; background:[[ColorPalette::SecondaryPale]];}
.viewer code {color:[[ColorPalette::SecondaryDark]];}
.viewer hr {border:0; border-top:dashed 1px [[ColorPalette::TertiaryDark]]; color:[[ColorPalette::TertiaryDark]];}

.highlight, .marked {background:[[ColorPalette::SecondaryLight]];}

.editor input {border:1px solid [[ColorPalette::PrimaryMid]];}
.editor textarea {border:1px solid [[ColorPalette::PrimaryMid]]; width:100%;}
.editorFooter {color:[[ColorPalette::TertiaryMid]];}

#backstageArea {background:[[ColorPalette::Foreground]]; color:[[ColorPalette::TertiaryMid]];}
#backstageArea a {background:[[ColorPalette::Foreground]]; color:[[ColorPalette::Background]]; border:none;}
#backstageArea a:hover {background:[[ColorPalette::SecondaryLight]]; color:[[ColorPalette::Foreground]]; }
#backstageArea a.backstageSelTab {background:[[ColorPalette::Background]]; color:[[ColorPalette::Foreground]];}
#backstageButton a {background:none; color:[[ColorPalette::Background]]; border:none;}
#backstageButton a:hover {background:[[ColorPalette::Foreground]]; color:[[ColorPalette::Background]]; border:none;}
#backstagePanel {background:[[ColorPalette::Background]]; border-color: [[ColorPalette::Background]] [[ColorPalette::TertiaryDark]] [[ColorPalette::TertiaryDark]] [[ColorPalette::TertiaryDark]];}
.backstagePanelFooter .button {border:none; color:[[ColorPalette::Background]];}
.backstagePanelFooter .button:hover {color:[[ColorPalette::Foreground]];}
#backstageCloak {background:[[ColorPalette::Foreground]]; opacity:0.6; filter:'alpha(opacity:60)';}
/*}}}*/

/*{{{*/
* html .tiddler {height:1%;}

body {font-size:.75em; font-family:arial,helvetica; margin:0; padding:0;}

h1,h2,h3,h4,h5,h6 {font-weight:bold; text-decoration:none;}
h1,h2,h3 {padding-bottom:1px; margin-top:1.2em;margin-bottom:0.3em;}
h4,h5,h6 {margin-top:1em;}
h1 {font-size:1.35em;}
h2 {font-size:1.25em;}
h3 {font-size:1.1em;}
h4 {font-size:1em;}
h5 {font-size:.9em;}

hr {height:1px;}

a {text-decoration:none;}

dt {font-weight:bold;}

ol {list-style-type:decimal;}
ol ol {list-style-type:lower-alpha;}
ol ol ol {list-style-type:lower-roman;}
ol ol ol ol {list-style-type:decimal;}
ol ol ol ol ol {list-style-type:lower-alpha;}
ol ol ol ol ol ol {list-style-type:lower-roman;}
ol ol ol ol ol ol ol {list-style-type:decimal;}

.txtOptionInput {width:11em;}

#contentWrapper .chkOptionInput {border:0;}

.externalLink {text-decoration:underline;}

.indent {margin-left:3em;}
.outdent {margin-left:3em; text-indent:-3em;}
code.escaped {white-space:nowrap;}

.tiddlyLinkExisting {font-weight:bold;}
.tiddlyLinkNonExisting {font-style:italic;}

/* the 'a' is required for IE, otherwise it renders the whole tiddler in bold */
a.tiddlyLinkNonExisting.shadow {font-weight:bold;}

#mainMenu .tiddlyLinkExisting,
	#mainMenu .tiddlyLinkNonExisting,
	#sidebarTabs .tiddlyLinkNonExisting {font-weight:normal; font-style:normal;}
#sidebarTabs .tiddlyLinkExisting {font-weight:bold; font-style:normal;}

.header {position:relative;}
.header a:hover {background:transparent;}
.headerShadow {position:relative; padding:4.5em 0em 1em 1em; left:-1px; top:-1px;}
.headerForeground {position:absolute; padding:4.5em 0em 1em 1em; left:0px; top:0px;}

.siteTitle {font-size:3em;}
.siteSubtitle {font-size:1.2em;}

#mainMenu {position:absolute; left:0; width:10em; text-align:right; line-height:1.6em; padding:1.5em 0.5em 0.5em 0.5em; font-size:1.1em;}

#sidebar {position:absolute; right:3px; width:16em; font-size:.9em;}
#sidebarOptions {padding-top:0.3em;}
#sidebarOptions a {margin:0em 0.2em; padding:0.2em 0.3em; display:block;}
#sidebarOptions input {margin:0.4em 0.5em;}
#sidebarOptions .sliderPanel {margin-left:1em; padding:0.5em; font-size:.85em;}
#sidebarOptions .sliderPanel a {font-weight:bold; display:inline; padding:0;}
#sidebarOptions .sliderPanel input {margin:0 0 .3em 0;}
#sidebarTabs .tabContents {width:15em; overflow:hidden;}

.wizard {padding:0.1em 1em 0em 2em;}
.wizard h1 {font-size:2em; font-weight:bold; background:none; padding:0em 0em 0em 0em; margin:0.4em 0em 0.2em 0em;}
.wizard h2 {font-size:1.2em; font-weight:bold; background:none; padding:0em 0em 0em 0em; margin:0.4em 0em 0.2em 0em;}
.wizardStep {padding:1em 1em 1em 1em;}
.wizard .button {margin:0.5em 0em 0em 0em; font-size:1.2em;}
.wizardFooter {padding:0.8em 0.4em 0.8em 0em;}
.wizardFooter .status {padding:0em 0.4em 0em 0.4em; margin-left:1em;}
.wizard .button {padding:0.1em 0.2em 0.1em 0.2em;}

#messageArea {position:fixed; top:2em; right:0em; margin:0.5em; padding:0.5em; z-index:2000; _position:absolute;}
.messageToolbar {display:block; text-align:right; padding:0.2em 0.2em 0.2em 0.2em;}
#messageArea a {text-decoration:underline;}

.tiddlerPopupButton {padding:0.2em 0.2em 0.2em 0.2em;}
.popupTiddler {position: absolute; z-index:300; padding:1em 1em 1em 1em; margin:0;}

.popup {position:absolute; z-index:300; font-size:.9em; padding:0; list-style:none; margin:0;}
.popup .popupMessage {padding:0.4em;}
.popup hr {display:block; height:1px; width:auto; padding:0; margin:0.2em 0em;}
.popup li.disabled {padding:0.4em;}
.popup li a {display:block; padding:0.4em; font-weight:normal; cursor:pointer;}
.listBreak {font-size:1px; line-height:1px;}
.listBreak div {margin:2px 0;}

.tabset {padding:1em 0em 0em 0.5em;}
.tab {margin:0em 0em 0em 0.25em; padding:2px;}
.tabContents {padding:0.5em;}
.tabContents ul, .tabContents ol {margin:0; padding:0;}
.txtMainTab .tabContents li {list-style:none;}
.tabContents li.listLink { margin-left:.75em;}

#contentWrapper {display:block;}
#splashScreen {display:none;}

#displayArea {margin:1em 17em 0em 14em;}

.toolbar {text-align:right; font-size:.9em;}

.tiddler {padding:1em 1em 0em 1em;}

.missing .viewer,.missing .title {font-style:italic;}

.title {font-size:1.6em; font-weight:bold;}

.missing .subtitle {display:none;}
.subtitle {font-size:1.1em;}

.tiddler .button {padding:0.2em 0.4em;}

.tagging {margin:0.5em 0.5em 0.5em 0; float:left; display:none;}
.isTag .tagging {display:block;}
.tagged {margin:0.5em; float:right;}
.tagging, .tagged {font-size:0.9em; padding:0.25em;}
.tagging ul, .tagged ul {list-style:none; margin:0.25em; padding:0;}
.tagClear {clear:both;}

.footer {font-size:.9em;}
.footer li {display:inline;}

.annotation {padding:0.5em; margin:0.5em;}

* html .viewer pre {width:99%; padding:0 0 1em 0;}
.viewer {line-height:1.4em; padding-top:0.5em;}
.viewer .button {margin:0em 0.25em; padding:0em 0.25em;}
.viewer blockquote {line-height:1.5em; padding-left:0.8em;margin-left:2.5em;}
.viewer ul, .viewer ol {margin-left:0.5em; padding-left:1.5em;}

.viewer table, table.twtable {border-collapse:collapse; margin:0.8em 1.0em;}
.viewer th, .viewer td, .viewer tr,.viewer caption,.twtable th, .twtable td, .twtable tr,.twtable caption {padding:3px;}
table.listView {font-size:0.85em; margin:0.8em 1.0em;}
table.listView th, table.listView td, table.listView tr {padding:0px 3px 0px 3px;}

.viewer pre {padding:0.5em; margin-left:0.5em; font-size:1.2em; line-height:1.4em; overflow:auto;}
.viewer code {font-size:1.2em; line-height:1.4em;}

.editor {font-size:1.1em;}
.editor input, .editor textarea {display:block; width:100%; font:inherit;}
.editorFooter {padding:0.25em 0em; font-size:.9em;}
.editorFooter .button {padding-top:0px; padding-bottom:0px;}

.fieldsetFix {border:0; padding:0; margin:1px 0px 1px 0px;}

.sparkline {line-height:1em;}
.sparktick {outline:0;}

.zoomer {font-size:1.1em; position:absolute; overflow:hidden;}
.zoomer div {padding:1em;}

* html #backstage {width:99%;}
* html #backstageArea {width:99%;}
#backstageArea {display:none; position:relative; overflow: hidden; z-index:150; padding:0.3em 0.5em 0.3em 0.5em;}
#backstageToolbar {position:relative;}
#backstageArea a {font-weight:bold; margin-left:0.5em; padding:0.3em 0.5em 0.3em 0.5em;}
#backstageButton {display:none; position:absolute; z-index:175; top:0em; right:0em;}
#backstageButton a {padding:0.1em 0.4em 0.1em 0.4em; margin:0.1em 0.1em 0.1em 0.1em;}
#backstage {position:relative; width:100%; z-index:50;}
#backstagePanel {display:none; z-index:100; position:absolute; margin:0em 3em 0em 3em; padding:1em 1em 1em 1em;}
.backstagePanelFooter {padding-top:0.2em; float:right;}
.backstagePanelFooter a {padding:0.2em 0.4em 0.2em 0.4em;}
#backstageCloak {display:none; z-index:20; position:absolute; width:100%; height:100px;}

.whenBackstage {display:none;}
.backstageVisible .whenBackstage {display:block;}
/*}}}*/

/***
StyleSheet for use when a translation requires any css style changes.
This StyleSheet can be used directly by languages such as Chinese, Japanese and Korean which need larger font sizes.
***/
/*{{{*/
body {font-size:0.8em;}
#sidebarOptions {font-size:1.05em;}
#sidebarOptions a {font-style:normal;}
#sidebarOptions .sliderPanel {font-size:0.95em;}
.subtitle {font-size:0.8em;}
.viewer table.listView {font-size:0.95em;}
/*}}}*/

/*{{{*/
@media print {
#mainMenu, #sidebar, #messageArea, .toolbar, #backstageButton, #backstageArea {display: none ! important;}
#displayArea {margin: 1em 1em 0em 1em;}
/* Fixes a feature in Firefox 1.5.0.2 where print preview displays the noscript content */
noscript {display:none;}
}
/*}}}*/

<!--{{{-->
<div class='header' macro='gradient vert [[ColorPalette::PrimaryLight]] [[ColorPalette::PrimaryMid]]'>
<div class='headerShadow'>
<span class='siteTitle' refresh='content' tiddler='SiteTitle'></span>&nbsp;
<span class='siteSubtitle' refresh='content' tiddler='SiteSubtitle'></span>
</div>
<div class='headerForeground'>
<span class='siteTitle' refresh='content' tiddler='SiteTitle'></span>&nbsp;
<span class='siteSubtitle' refresh='content' tiddler='SiteSubtitle'></span>
</div>
</div>
<div id='mainMenu' refresh='content' tiddler='MainMenu'></div>
<div id='sidebar'>
<div id='sidebarOptions' refresh='content' tiddler='SideBarOptions'></div>
<div id='sidebarTabs' refresh='content' force='true' tiddler='SideBarTabs'></div>
</div>
<div id='displayArea'>
<div id='messageArea'></div>
<div id='tiddlerDisplay'></div>
</div>
<!--}}}-->

<!--{{{-->
<div class='toolbar' macro='toolbar closeTiddler closeOthers +editTiddler > fields syncing permalink references jump'></div>
<div class='title' macro='view title'></div>
<div class='subtitle'><span macro='view modifier link'></span>, <span macro='view modified date'></span> (<span macro='message views.wikified.createdPrompt'></span> <span macro='view created date'></span>)</div>
<div class='tagging' macro='tagging'></div>
<div class='tagged' macro='tags'></div>
<div class='viewer' macro='view text wikified'></div>
<div class='tagClear'></div>
<!--}}}-->

<!--{{{-->
<div class='toolbar' macro='toolbar +saveTiddler -cancelTiddler deleteTiddler'></div>
<div class='title' macro='view title'></div>
<div class='editor' macro='edit title'></div>
<div macro='annotations'></div>
<div class='editor' macro='edit text'></div>
<div class='editor' macro='edit tags'></div><div class='editorFooter'><span macro='message views.editor.tagPrompt'></span><span macro='tagChooser'></span></div>
<!--}}}-->

To get started with this blank TiddlyWiki, you'll need to modify the following tiddlers:
* SiteTitle & SiteSubtitle: The title and subtitle of the site, as shown above (after saving, they will also appear in the browser title bar)
* MainMenu: The menu (usually on the left)
* DefaultTiddlers: Contains the names of the tiddlers that you want to appear when the TiddlyWiki is opened
You'll also need to enter your username for signing your edits: <<option txtUserName>>

These InterfaceOptions for customising TiddlyWiki are saved in your browser

Your username for signing your edits. Write it as a WikiWord (eg JoeBloggs)

<<option txtUserName>>
<<option chkSaveBackups>> SaveBackups
<<option chkAutoSave>> AutoSave
<<option chkRegExpSearch>> RegExpSearch
<<option chkCaseSensitiveSearch>> CaseSensitiveSearch
<<option chkAnimate>> EnableAnimations

----
Also see AdvancedOptions

<<importTiddlers>>

Runes allows data to be accessed declaratively.

Currently there are two mechanisms to access data:
* [[walks]] - a simple mechanism that treats the data in a Runestone as a di-graph, allowing to collect nodes in that graph
* [[Saxon]] - a powerful regular expression-like mechanism to match portions of the data

See also: [[Sample walks code]], [[Sample Saxon code]].

To use Runes in your application, ensure all the .jar files in the lib/ directory are on the classpath or available to your web application. 
Runes comes packaged in a number of jar files, with the following inter-dependencies:
<html>
<pre>
<font size=-1>
runes-core.jar
  Core classes, required by all plugins.
  depends on: fastutil, commons

runes-nlp.jar
  Natural language processing plugins.
  depends on: fastutil, opennlp-tools, lucene-core, core, commons

runes-odf.jar
  Plugins to represent ODF documents.
  depends on: dom4j, core, commons
  
runes-persistence.jar
  Persistence plugins.
  depends on: mysql-connector/j, jdbc-hsql, core, commons 

runes-rosetta.jar
  Extra data structures optimized to represent matrix data.
  depends on: fastutil, mtj, colt, core, commons

runes-walk.jar
  Basic access mechanism to Runes data.
  depends on: antlr, fastutil, core, commons

runes-saxon.jar
  Expressive access mechanism to Runes data, and also a metadata.
  depends on: core, commons

runes-rdf.jar
  Plugins that allow expressing data models as RDF ontologies.
  depends on: jena, core

runes-commons.jar
  Utility classes used by all modules.
  depends on: 
</font>
</pre>
</html>

Rune
Runestone
Stone

The following Rune prints 'Hello World' out to the terminal:
<html>
<pre>
<font size=-1>
public class HelloWorld implements Rune {

   public Set&lt;String&gt; analyseRequired(final Runestone stone, final Set&lt;String&gt; model) throws 
                                                            RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      return Collections.emptySet();         // does not require any data to be present in the Runestone
   }

   public Set&lt;String&gt; analyseProvided(final Runestone stone, final Set&lt;String&gt; model) throws 
                                                            RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      return Collections.emptySet();         // does not provide any data into the Runestone
   }

   public void carve(final Runestone stone) throws RunesExceptionNoSuchStructure, 
                           RunesExceptionNoSuchContent, RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      System.out.println("Hello World!");    // prints "Hello World" to the terminal
   }

   public String toString() {
      return "hello world rune";             // for logging purposes
   }

   public static void main(final String[] args) throws RunesExceptionRuneExecution,
                           RunesExceptionNoSuchContent, RunesExceptionCannotHandle, RunesExceptionNoSuchStructure {
      Runes.carve(new HelloWorld());         // Runes.carve() specifies a (partial) list of Runes to execute
   }
}
</font>
</pre>
</html>

The output obtained by executing the above application is the following:
<html>
<pre>
<font size=-1>
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] inferred stones:

INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] inferred runes:
[0] hello world rune

INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] running: hello world rune
Hello World!
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] done, this: 0:00:00.1, total: 0:0:0.38, available memory: 58Mb
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] done.
</font>
</pre>
</html>
Basic concepts required to understand the above output: [[Runes.carve]], [[Artisan]], [[Inferred Runes]], [[Inferred Stones]].
See also [[Creating your first plugin Rune]], [[Creating your first data sharing app]].

The following example illustrates how to require some data from other Runes, extending the example presented at [[Creating your first Rune]]:
<html>
<pre>
<font size=-1>
public class HelloMe implements Rune {

   public Set&lt;String&gt; analyseRequired(final Runestone stone, final Set&lt;String&gt; model) throws 
                                                            RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      return Collections.singleton("my_name");         // requires a name to be stored in the Runestone previous to executing
   }

   public Set&lt;String&gt; analyseProvided(final Runestone stone, final Set&lt;String&gt; model) throws 
                                                            RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      return Collections.emptySet();           // does not provide any data into the Runestone
   }

   public void carve(final Runestone stone) throws RunesExceptionNoSuchStructure, 
                              RunesExceptionNoSuchContent, RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      final String name = stone.&lt;String&gt;getContent("my_name").iterator().next();
      // prints "Hello <i>name</i>!" to the terminal, where <i>name</i> is the first random name obtained from the "my_name" Stone
      System.out.println("Hello " + name + '!');    
   }

   public String toString() {
      return "hello me";             // for logging purposes
   }

   public static void main(final String[] args) throws RunesExceptionRuneExecution, 
                              RunesExceptionNoSuchContent, RunesExceptionCannotHandle, RunesExceptionNoSuchStructure {
      Runes.carve(
            new RuneFiller("my_name", "John Smith"),    // fills in the 'my_name' stone with one data element
            new HelloMe()
      );
   }

}
</font>
</pre>
</html>

The output obtained by executing the above application is the following:

<html>
<pre>
<font size=-1>
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] inferred stones:
my_name

INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] inferred runes:
[0] filler of my_name
[1] hello me

INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] running: filler of my_name
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] done, this: 0:0:0.44, total: 0:0:0.80, available memory: 58Mb
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] running: hello me
Hello John Smith!
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] done, this: 0:00:00.2, total: 0:0:0.83, available memory: 58Mb
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] done.
</font>
</pre>
</html>
Basic concepts required to understand the above output: [[Runes.carve]], [[Artisan]], [[Inferred Runes]], [[Inferred Stones]].
See also [[Creating your first Rune]], [[Creating your first plugin Rune]].

Any Rune can modified to become a plugin. As a plugin, the Rune does not need to be explicitly instantiated by the user, but instead will be automatically instantiated by the framework whenever required.
Turning a Rune into a plugin involves two steps:
* adding a static block to the Rune class which registers it as a plugin;
* adding the fully qualified name of the Rune class to a [[plugin.runes]] file.

The following code shows an example of a simple plugin Rune, extending the one presented at [[Creating your first Rune]]:
<html>
<pre>
<font size=-1>
public class HelloWorldPlugin implements Rune {

   static {
      Runes.registerRune(HelloWorldPlugin.class, "hello world plugin");    // registers this rune as a plugin
   }

   public Set&lt;String&gt; analyseRequired(final Runestone stone, final Set&lt;String&gt; model) throws 
                                           RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      return Collections.emptySet();         // does not require any data to be present in the Runestone
   }

   public Set&lt;String&gt; analyseProvided(final Runestone stone, final Set&lt;String&gt; model) throws 
                                  RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      return Collections.singleton("hello_world_app");         // provides the custom type 'hello_world_app'
   }

   public void carve(final Runestone stone) throws RunesExceptionNoSuchStructure, RunesExceptionNoSuchContent, 
                              RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      System.out.println("Hello World!");    // prints "Hello World" to the terminal
   }

   public String toString() {
      return "hello world plugin rune";             // for logging purposes
   }

   public static void main(final String[] args) throws RunesExceptionRuneExecution, RunesExceptionNoSuchContent,
                              RunesExceptionCannotHandle, RunesExceptionNoSuchStructure {
      Runes.carve(new RuneShaper("hello_world_app"));         // requires some Rune that provides 'hello_world_app'
   }
</font>
</pre>
</html>

The output obtained by executing the above application is the following:
<html>
<pre>
<font size=-1>
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] inferred stones:
hello_world_app

INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] inferred runes:
[0] hello world plugin rune
[1] shaper [hello_world_app]

INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] running: hello world plugin rune
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] done, this: 0:00:00.0, total: 0:0:0.24, available memory: 58Mb
Hello World!
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] running: shaper [hello_world_app]
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] done, this: 0:00:00.0, total: 0:0:0.24, available memory: 58Mb
INFO [uk.ac.shef.wit.runes.artisan.ArtisanDefault:carve] done.
</font>
</pre>
</html>
Basic concepts required to understand the above output: [[Runes.carve]], [[Artisan]], [[Inferred Runes]], [[Inferred Stones]].
See also [[Creating your first Rune]], [[Creating your first data sharing app]].

/***
|''Name:''|CryptoFunctionsPlugin|
|''Description:''|Support for cryptographic functions|
***/
//{{{
if(!version.extensions.CryptoFunctionsPlugin) {
version.extensions.CryptoFunctionsPlugin = {installed:true};

//--
//-- Crypto functions and associated conversion routines
//--

// Crypto "namespace"
function Crypto() {}

// Convert a string to an array of big-endian 32-bit words
Crypto.strToBe32s = function(str)
{
	var be = Array();
	var len = Math.floor(str.length/4);
	var i, j;
	for(i=0, j=0; i<len; i++, j+=4) {
		be[i] = ((str.charCodeAt(j)&0xff) << 24)|((str.charCodeAt(j+1)&0xff) << 16)|((str.charCodeAt(j+2)&0xff) << 8)|(str.charCodeAt(j+3)&0xff);
	}
	while (j<str.length) {
		be[j>>2] |= (str.charCodeAt(j)&0xff)<<(24-(j*8)%32);
		j++;
	}
	return be;
};

// Convert an array of big-endian 32-bit words to a string
Crypto.be32sToStr = function(be)
{
	var str = "";
	for(var i=0;i<be.length*32;i+=8)
		str += String.fromCharCode((be[i>>5]>>>(24-i%32)) & 0xff);
	return str;
};

// Convert an array of big-endian 32-bit words to a hex string
Crypto.be32sToHex = function(be)
{
	var hex = "0123456789ABCDEF";
	var str = "";
	for(var i=0;i<be.length*4;i++)
		str += hex.charAt((be[i>>2]>>((3-i%4)*8+4))&0xF) + hex.charAt((be[i>>2]>>((3-i%4)*8))&0xF);
	return str;
};

// Return, in hex, the SHA-1 hash of a string
Crypto.hexSha1Str = function(str)
{
	return Crypto.be32sToHex(Crypto.sha1Str(str));
};

// Return the SHA-1 hash of a string
Crypto.sha1Str = function(str)
{
	return Crypto.sha1(Crypto.strToBe32s(str),str.length);
};

// Calculate the SHA-1 hash of an array of blen bytes of big-endian 32-bit words
Crypto.sha1 = function(x,blen)
{
	// Add 32-bit integers, wrapping at 32 bits
	add32 = function(a,b)
	{
		var lsw = (a&0xFFFF)+(b&0xFFFF);
		var msw = (a>>16)+(b>>16)+(lsw>>16);
		return (msw<<16)|(lsw&0xFFFF);
	};
	// Add five 32-bit integers, wrapping at 32 bits
	add32x5 = function(a,b,c,d,e)
	{
		var lsw = (a&0xFFFF)+(b&0xFFFF)+(c&0xFFFF)+(d&0xFFFF)+(e&0xFFFF);
		var msw = (a>>16)+(b>>16)+(c>>16)+(d>>16)+(e>>16)+(lsw>>16);
		return (msw<<16)|(lsw&0xFFFF);
	};
	// Bitwise rotate left a 32-bit integer by 1 bit
	rol32 = function(n)
	{
		return (n>>>31)|(n<<1);
	};

	var len = blen*8;
	// Append padding so length in bits is 448 mod 512
	x[len>>5] |= 0x80 << (24-len%32);
	// Append length
	x[((len+64>>9)<<4)+15] = len;
	var w = Array(80);

	var k1 = 0x5A827999;
	var k2 = 0x6ED9EBA1;
	var k3 = 0x8F1BBCDC;
	var k4 = 0xCA62C1D6;

	var h0 = 0x67452301;
	var h1 = 0xEFCDAB89;
	var h2 = 0x98BADCFE;
	var h3 = 0x10325476;
	var h4 = 0xC3D2E1F0;

	for(var i=0;i<x.length;i+=16) {
		var j,t;
		var a = h0;
		var b = h1;
		var c = h2;
		var d = h3;
		var e = h4;
		for(j = 0;j<16;j++) {
			w[j] = x[i+j];
			t = add32x5(e,(a>>>27)|(a<<5),d^(b&(c^d)),w[j],k1);
			e=d; d=c; c=(b>>>2)|(b<<30); b=a; a = t;
		}
		for(j=16;j<20;j++) {
			w[j] = rol32(w[j-3]^w[j-8]^w[j-14]^w[j-16]);
			t = add32x5(e,(a>>>27)|(a<<5),d^(b&(c^d)),w[j],k1);
			e=d; d=c; c=(b>>>2)|(b<<30); b=a; a = t;
		}
		for(j=20;j<40;j++) {
			w[j] = rol32(w[j-3]^w[j-8]^w[j-14]^w[j-16]);
			t = add32x5(e,(a>>>27)|(a<<5),b^c^d,w[j],k2);
			e=d; d=c; c=(b>>>2)|(b<<30); b=a; a = t;
		}
		for(j=40;j<60;j++) {
			w[j] = rol32(w[j-3]^w[j-8]^w[j-14]^w[j-16]);
			t = add32x5(e,(a>>>27)|(a<<5),(b&c)|(d&(b|c)),w[j],k3);
			e=d; d=c; c=(b>>>2)|(b<<30); b=a; a = t;
		}
		for(j=60;j<80;j++) {
			w[j] = rol32(w[j-3]^w[j-8]^w[j-14]^w[j-16]);
			t = add32x5(e,(a>>>27)|(a<<5),b^c^d,w[j],k4);
			e=d; d=c; c=(b>>>2)|(b<<30); b=a; a = t;
		}

		h0 = add32(h0,a);
		h1 = add32(h1,b);
		h2 = add32(h2,c);
		h3 = add32(h3,d);
		h4 = add32(h4,e);
	}
	return Array(h0,h1,h2,h3,h4);
};


}
//}}}

Runes

/***
|''Name:''|DeprecatedFunctionsPlugin|
|''Description:''|Support for deprecated functions removed from core|
***/
//{{{
if(!version.extensions.DeprecatedFunctionsPlugin) {
version.extensions.DeprecatedFunctionsPlugin = {installed:true};

//--
//-- Deprecated code
//--

// @Deprecated: Use createElementAndWikify and this.termRegExp instead
config.formatterHelpers.charFormatHelper = function(w)
{
	w.subWikify(createTiddlyElement(w.output,this.element),this.terminator);
};

// @Deprecated: Use enclosedTextHelper and this.lookaheadRegExp instead
config.formatterHelpers.monospacedByLineHelper = function(w)
{
	var lookaheadRegExp = new RegExp(this.lookahead,"mg");
	lookaheadRegExp.lastIndex = w.matchStart;
	var lookaheadMatch = lookaheadRegExp.exec(w.source);
	if(lookaheadMatch && lookaheadMatch.index == w.matchStart) {
		var text = lookaheadMatch[1];
		if(config.browser.isIE)
			text = text.replace(/\n/g,"\r");
		createTiddlyElement(w.output,"pre",null,null,text);
		w.nextMatch = lookaheadRegExp.lastIndex;
	}
};

// @Deprecated: Use <br> or <br /> instead of <<br>>
config.macros.br = {};
config.macros.br.handler = function(place)
{
	createTiddlyElement(place,"br");
};

// Find an entry in an array. Returns the array index or null
// @Deprecated: Use indexOf instead
Array.prototype.find = function(item)
{
	var i = this.indexOf(item);
	return i == -1 ? null : i;
};

// Load a tiddler from an HTML DIV. The caller should make sure to later call Tiddler.changed()
// @Deprecated: Use store.getLoader().internalizeTiddler instead
Tiddler.prototype.loadFromDiv = function(divRef,title)
{
	return store.getLoader().internalizeTiddler(store,this,title,divRef);
};

// Format the text for storage in an HTML DIV
// @Deprecated Use store.getSaver().externalizeTiddler instead.
Tiddler.prototype.saveToDiv = function()
{
	return store.getSaver().externalizeTiddler(store,this);
};

// @Deprecated: Use store.allTiddlersAsHtml() instead
function allTiddlersAsHtml()
{
	return store.allTiddlersAsHtml();
}

// @Deprecated: Use refreshPageTemplate instead
function applyPageTemplate(title)
{
	refreshPageTemplate(title);
}

// @Deprecated: Use story.displayTiddlers instead
function displayTiddlers(srcElement,titles,template,unused1,unused2,animate,unused3)
{
	story.displayTiddlers(srcElement,titles,template,animate);
}

// @Deprecated: Use story.displayTiddler instead
function displayTiddler(srcElement,title,template,unused1,unused2,animate,unused3)
{
	story.displayTiddler(srcElement,title,template,animate);
}

// @Deprecated: Use functions on right hand side directly instead
var createTiddlerPopup = Popup.create;
var scrollToTiddlerPopup = Popup.show;
var hideTiddlerPopup = Popup.remove;

// @Deprecated: Use right hand side directly instead
var regexpBackSlashEn = new RegExp("\\\\n","mg");
var regexpBackSlash = new RegExp("\\\\","mg");
var regexpBackSlashEss = new RegExp("\\\\s","mg");
var regexpNewLine = new RegExp("\n","mg");
var regexpCarriageReturn = new RegExp("\r","mg");

}
//}}}

Runes 0.6 is the latest version. Get it from [[sourceforge|http://sourceforge.net/project/showfiles.php?group_id=202922&package_id=241721&release_id=582026]].
The latest development version is also available from the [[subversion repository|http://runes.svn.sourceforge.net/viewvc/runes/]]. Please follow the instructions [[here|http://sourceforge.net/svn/?group_id=202922]] on how to obtain it.

See also the [[Additional notes on how to install Runes]].

I recommend reading the [[Basic Concepts]] section first.

[[Creating your first Rune]]
[[Creating your first plugin Rune]]
[[Creating your first data sharing app]]
[[Accessing data declaratively]]
[[Persisting a Runestone]]
[[Tokenising a text]]
[[Runes NLP - Natural Language Processing Tool]]

/***
|''Name:''|LegacyStrikeThroughPlugin|
|''Description:''|Support for legacy (pre 2.1) strike through formatting|
|''Version:''|1.0.2|
|''Date:''|Jul 21, 2006|
|''Source:''|http://www.tiddlywiki.com/#LegacyStrikeThroughPlugin|
|''Author:''|MartinBudden (mjbudden (at) gmail (dot) com)|
|''License:''|[[BSD open source license]]|
|''CoreVersion:''|2.1.0|
***/

//{{{
// Ensure that the LegacyStrikeThrough Plugin is only installed once.
if(!version.extensions.LegacyStrikeThroughPlugin) {
version.extensions.LegacyStrikeThroughPlugin = {installed:true};

config.formatters.push(
{
	name: "legacyStrikeByChar",
	match: "==",
	termRegExp: /(==)/mg,
	element: "strike",
	handler: config.formatterHelpers.createElementAndWikify
});

} //# end of "install only once"
//}}}

Unless otherwise noted, the following copyright statement applies:
© Copyright 2004, 2005, 2006, 2007, 2008 The University of Sheffield, UK

Runes is distributed under the [[GNU Lesser General Public License (LGPL)|http://www.gnu.org/licenses/lgpl.html]] [>img[LPGL logo|http://www.gnu.org/graphics/lgplv3-88x31.png]]
Runes and its various plugins are built on top of other java libraries which we gratefully acknowledge:

* [[fastutil|http://fastutil.dsi.unimi.it/]]
* [[openNLP|http://opennlp.sourceforge.net/]]
* [[lucene|http://lucene.apache.org/]]
* [[dom4j|http://www.dom4j.org/]]
* [[jena|http://jena.sourceforge.net/]]
* [[matrix toolkits for java|http://ressim.berlios.de/]]
* [[colt|http://dsd.lbl.gov/~hoschek/colt/]]
* [[antlr|http://antlr.org/]]
* [[mysql connector/j|http://dev.mysql.com/downloads/connector/j/5.1.html]]
* [[hsql|http://hsqldb.org/]]

[[Runes]]
[[Getting Started]]
[[Download]]
[[Screenshots]]
[[Javadoc|http://runes.sourceforge.net/javadoc]]
[[HowTo's]]
[[License]]
[[Sourceforge.net|http://sourceforge.net/projects/runes]]
[[X-Media project|http://www.x-media-project.org/]]

<!--{{{-->

<div id='topMenu' refresh='content' tiddler='MainMenu'></div>
<div id='sidebar'>
<div id='sidebarOptions' refresh='content' tiddler='SideBarOptions'></div>
<div id='sidebarTabs' refresh='content' force='true' tiddler='SideBarTabs'></div>
</div>
<div id='displayArea'>
<div id='messageArea'></div>
<div id='tiddlerDisplay'></div>
</div>
<!--}}}-->

TBD

 [<img[Runes|runes_logo.png]]
Runes is a plugin-based framework that reverses the way of thinking about data processing: specify data accesses, and Runes will automatically choose an efficient representation for the data and execute the plugins to integrate it from different sources.

[>img[SourceForge.net Logo|http://sflogo.sourceforge.net/sflogo.php?group_id=207475&amp;type=2][http://sourceforge.net]]
For more information check the [[Sourceforge project page|http://sourceforge.net/projects/runes]].


[img[X-Media project|x-media.jpg][http://www.x-media-project.org/]]
Runes was (partly) funded by the [[X-Media project|http://www.x-media-project.org/]], sponsored by the European Commission as part of the Information Society Technologies (IST) programme under EC grant number IST-FP6-026978.

The following example illustrates how a Rune NLP runes was created, which is essentially extending the simple example presented at [[Creating your first Rune]]:
<html>
<pre>
<font size=-1>
public class RuneTextStemmer implements Rune {
   // every rune needs to be registered by a following static block
   static {
      Runes.registerRune(RuneTextStemmer.class, MessageFormat.format("nlp stemmer v{0}", VERSION));
   }

   // Required - The minimum entity types required to run this rune, in this example, they are 'string' and 'token_has_string'
   public Set&lt;String&gt; analyseRequired(final Runestone stone, final Set&lt;String&gt; model) {
      return UtilCollections.add(new HashSet&lt;String&gt;(),
            "string",
            "token_has_string"
      );
   }

    // Provided - The entity types expected on the stone after running this rune. 
   public Set&lt;String&gt; analyseProvided(final Runestone stone, final Set&lt;String&gt; model) {
      return UtilCollections.add(new HashSet&lt;String&gt;(),
            "stem",
            "token_has_stem"
      );
   }

   // Carve  that attaches/writes entities and their values on stone.  
   public void carve(final Runestone stone) throws RunesExceptionNoSuchStructure, 
                              RunesExceptionNoSuchContent, RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      // A external text processing tool is invoked  
      final Stemmer stemmer = new PorterStemmer();

      final Content&lt;String&gt; string = stone.getContent("string");
      final StructureAndContent&lt;String&gt; stem = stone.getStructureAndContent("stem");
      final Structure tokenHasStem = stone.getStructure("token_has_stem");

      for (final int[] id : stone.getStructure("token_has_string"))
         tokenHasStem.inscribe(id[0], stem.encode(stemmer.stem(string.retrieve(id[1]))));
   }

   public String toString() {
      return "text stemmer";
   }
}
</font>
</pre>
</html>
Basic concepts required to understand the above output: [[Runes.carve]], [[Artisan]], [[Inferred Runes]], [[Inferred Stones]].
See also [[Creating your first Rune]], [[Creating your first plugin Rune]].

Some examples of well-formed walk expressions:
<html>
<pre>
<font size=-1>
"start > document_has_topic"
"start > ((document_has_title > document_title_contains_string) | (document_has_body > document_body_contains_string))"
"start > (token_right >> 8 >> token_next | token_left >> 8 >> token_previous)"
"start > (token_string | token_orth | token_pos)"
</font>
</pre>
</html>

The following example uses runes-nlp plugins and a walk to access output a bag of words representation a text document passed via args[0].
<html>
<pre>
<font size=-1>
public class TestWalk implements Rune {

   private Walk _walk;
   
   public TestWalk(final Walk walk) {
      _walk = walk;
   }

   public Set&lt;String&gt; analyseRequired(final Runestone stone, final Set&lt;String&gt; model) throws 
                                                                    RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      final Set&lt;String&gt; required = new HashSet&lt;String&gt;();
      required.add("document");
      required.add("string");
      return required;
   }

   public Set&lt;String&gt; analyseProvided(final Runestone stone, final Set&lt;String&gt; model) throws 
                                                                    RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      return Collections.emptySet();
   }

   public void carve(final Runestone stone) throws RunesExceptionNoSuchStructure, 
                              RunesExceptionNoSuchContent, RunesExceptionCannotHandle, RunesExceptionRuneExecution {
      final Content&lt;String&gt; strings = stone.getContent("string"); 
      for (final int[] document : stone.getStructure("document")) {
         for (final WalkNode node : _walk.walk(document[0]))
            System.out.println(strings.retrieve(node.getNode()));
      }
   }

   public String toString() {
      return "test walk rune";             // for logging purposes
   }

   public static void main(final String[] args) throws RunesExceptionRuneExecution, 
                              RunesExceptionNoSuchContent, RunesExceptionCannotHandle, RunesExceptionNoSuchStructure {
      final WalkDefault walk = new WalkDefault("start &gt; document_contains_token &gt; token_has_string");
      Runes.carve(
            new RuneFiller&lt;String&gt;("document_directory_path", args[0]),
            new RuneFiller&lt;String&gt;("path_to_openNLP_models", System.getenv("RUNES_LIBS") + "/opennlp-tools/"),
            walk,
            new TestWalk(walk)
      );
   }
</font>
</pre>
</html>

Coming soon.

a plugin-based data representation framework

Runes

/***
|''Name:''|SparklinePlugin|
|''Description:''|Sparklines macro|
***/
//{{{
if(!version.extensions.SparklinePlugin) {
version.extensions.SparklinePlugin = {installed:true};

//--
//-- Sparklines
//--

config.macros.sparkline = {};
config.macros.sparkline.handler = function(place,macroName,params)
{
	var data = [];
	var min = 0;
	var max = 0;
	var v;
	for(var t=0; t<params.length; t++) {
		v = parseInt(params[t]);
		if(v < min)
			min = v;
		if(v > max)
			max = v;
		data.push(v);
	}
	if(data.length < 1)
		return;
	var box = createTiddlyElement(place,"span",null,"sparkline",String.fromCharCode(160));
	box.title = data.join(",");
	var w = box.offsetWidth;
	var h = box.offsetHeight;
	box.style.paddingRight = (data.length * 2 - w) + "px";
	box.style.position = "relative";
	for(var d=0; d<data.length; d++) {
		var tick = document.createElement("img");
		tick.border = 0;
		tick.className = "sparktick";
		tick.style.position = "absolute";
		tick.src = "data:image/gif,GIF89a%01%00%01%00%91%FF%00%FF%FF%FF%00%00%00%C0%C0%C0%00%00%00!%F9%04%01%00%00%02%00%2C%00%00%00%00%01%00%01%00%40%02%02T%01%00%3B";
		tick.style.left = d*2 + "px";
		tick.style.width = "2px";
		v = Math.floor(((data[d] - min)/(max-min)) * h);
		tick.style.top = (h-v) + "px";
		tick.style.height = v + "px";
		box.appendChild(tick);
	}
};


}
//}}}

/*{{{*/
/*Blackicity Theme for TiddlyWiki*/
/*Design and CSS by Saq Imtiaz*/
/*Version 1.0*/
/*}}}*/
/*{{{*/
body{	font-family: "Neue Helvetica", Helvetica, "Lucida Grande", Verdana, sans-serif;
	background-color: #fff;
	color: #333;}

#topMenu {position:relative; background:#282826; padding:10px; color:#fff;font-family:'Lucida Grande', Verdana, Sans-Serif;}
#topMenu br {display:none;}

#topMenu a{			color: #999;
			padding: 0px 8px 0px 8px;
			border-right: 1px solid #444;}
#topMenu a:hover {color:#fff; background:transparent;}

#displayArea {margin-left:1em; margin-bottom:2em; margin-top:0.5em;}


a, a:hover{
color:#333;
text-decoration: none;   background:transparent; 
}

.viewer a, .viewer a:hover {border-bottom:1px dotted #333; font-weight:bold;}


.viewer .button, .editorFooter .button{
color: #333;
border: 1px solid #333;
}

.viewer .button:hover,
.editorFooter .button:hover, .viewer .button:active, .viewer .highlight,.editorFooter .button:active, .editorFooter .highlight{
color: #fff;
background: #333;
border-color: #333;
}

.tiddler .viewer {line-height:1.45em;}
.title {color:#222; border-bottom:1px solid#222; font-family:'Lucida Grande', Verdana, Sans-Serif; font-size:1.5em;}
.subtitle, .subtitle a { color: #999999; font-size: 0.95em;margin:0.2em;}
.shadow .title{color:#999;}

.toolbar {font-size:90%;}
.selected .toolbar a {color:#999999;}
.selected .toolbar a:hover {color:#333; background:transparent;border:1px solid #fff;}

.toolbar .button:hover, .toolbar .highlight, .toolbar .marked, .toolbar a.button:active{color:#333; background:transparent;border:1px solid #fff;}

/***
!Sidebar
***/
#sidebar { margin-bottom:2em !important; margin-bottom:1em; right:0;
}

/***
!SidebarOptions
***/
#sidebarOptions { padding-top:2em;background:#f3f3f3;padding-left:0.5em;}

#sidebarOptions a {
			color:#333;
                        background:#f3f3f3;
                        border:1px solid #f3f3f3;
			text-decoration: none;
}

#sidebarOptions	a:hover, #sidebarOptions a:active {
			color:#222;
			background-color:#fff;border:1px solid #fff;
		}

#sidebarOptions input {border:1px solid #ccc; }

#sidebarOptions .sliderPanel {
	background: #f3f3f3; 	font-size: .9em;
}

#sidebarOptions .sliderPanel input {border:1px solid #999;}
#sidebarOptions .sliderPanel .txtOptionInput {border:1px solid #999;width:9em;}

#sidebarOptions .sliderPanel a {font-weight:normal; color:#555;background-color: #f3f3f3; border-bottom:1px dotted #333;}


#sidebarOptions .sliderPanel a:hover {
color:#111;
background-color: #f3f3f3;
border:none;
border-bottom:1px dotted #111;
}
/***
!SidebarTabs
***/
 .listTitle {color:#222;}
#sidebarTabs {background:#f3f3f3;}

#sidebarTabs .tabContents {background:#cfcfcf;}

#sidebarTabs .tabUnselected:hover {color:#999;}

#sidebarTabs .tabSelected{background:#cfcfcf;}

#sidebarTabs .tabContents .tiddlyLink, #sidebarTabs .tabContents .button{color:#666;}
#sidebarTabs .tabContents .tiddlyLink:hover,#sidebarTabs .tabContents .button:hover{color:#222;background:transparent; text-decoration:none;border:none;}

#sidebarTabs .tabContents .button:hover, #sidebarTabs .tabContents .highlight, #sidebarTabs .tabContents .marked, #sidebarTabs .tabContents a.button:active{color:#222;background:transparent;}

#sidebarTabs .txtMoreTab .tabSelected,
#sidebarTabs .txtMoreTab .tab:hover,
#sidebarTabs .txtMoreTab .tabContents{
 color: #111;
 background: #f3f3f3; border:1px solid #f3f3f3;
}

#sidebarTabs .txtMoreTab .tabUnselected {
 color: #555;
 background: #AFAFAF;
}



/***
!Tabs
***/
.tabSelected{color:#fefefe; background:#999; padding-bottom:1px;}
 .tabSelected, .tabSelected:hover {
 color: #111;
 background: #fefefe;
 border: solid 1px #cfcfcf;
}

 .tabUnselected {
 color: #999;
 background: #eee;
 border: solid 1px #cfcfcf;
 padding-bottom:1px;
}
.tabUnselected:hover {text-decoration:none; border:1px solid #cfcfcf;}
.tabContents {background:#fefefe;}





.tagging, .tagged {
border: 1px solid #eee;
background-color: #F7F7F7;
}

.selected .tagging, .selected .tagged {
background-color: #f3f3f3;
border: 1px solid #ccc;
}

.tagging .listTitle, .tagged .listTitle {
color: #bbb;
}

.selected .tagging .listTitle, .selected .tagged .listTitle {
color: #333;
}

.tagging .button, .tagged .button {
color:#ccc;
}
.selected .tagging .button, .selected .tagged .button {
color:#aaa;
}

.highlight, .marked {background:transparent; color:#111; border:none; text-decoration:underline;}

.tagging .button:hover, .tagged .button:hover, .tagging .button:active, .tagged .button:active {
border: none; background:transparent; text-decoration:underline; color:#333;
}



.popup {
background: #cfcfcf;
border: 1px solid #333;
}

.popup li.disabled {
color: #000;
}

.popup li a, .popup li a:visited {
color: #555;
border: none;
}

.popup li a:hover {
background: #f3f3f3;
color: #555;
border: none;
}



#messageArea {

border: 4px dotted #282826;
background: #F3F3F3;
color: #333;
font-size:90%;
}

#messageArea a:hover { background:#f5f5f5; border:none;}


#messageArea .button{
color: #333;
border: 1px solid #282826;
}

#messageArea .button:hover {
color: #fff;
background: #282826;
border-color: #282826;
}






.tiddler {padding-bottom:10px;}

.viewer blockquote {
border-left: 5px solid #282826;
}

.viewer table, .viewer td {
border: 1px solid #282826;
}

.viewer th, thead td {
background: #282826;
border: 1px solid #282826;
color: #fff;
}
.viewer pre {
border: 1px solid #ccc;
background: #f5f5f5;
}

.viewer code {
color: #111; background:#f5f5f5;
}

.viewer hr {
border-top: dashed 1px #222; margin:0 1em;
}

.editor input {
border: 1px solid #ccc; margin-top:5px;
}

.editor textarea {
border: 1px solid #ccc;
}

h1,h2,h3,h4,h5 { color: #282826; background: transparent; padding-bottom:2px; font-family: Arial, Helvetica, sans-serif; }
h1 {font-size:18px;}
h2 {font-size:16px;}
h3 {font-size: 14px;}
/*}}}*/

TBD

A 'plugin.runes' file is a text file that simply lists which classes implementing the Rune interface may be used by Runes as plugins. The list consists of the fully qualified names of the classes, one per line.
One 'plugin.runes' file may be placed at the root of every classes directory or jar provided in the classpath.

A sample 'plugin.runes' file:
<html>
<pre>
<font size=-1>
uk.ac.shef.wit.runes.rune.nlp.RuneDocumentDirectoryLister
uk.ac.shef.wit.runes.rune.nlp.RunePlainTextFetcher
uk.ac.shef.wit.runes.rune.nlp.RuneTextSentenceSplitter
uk.ac.shef.wit.runes.rune.nlp.RuneTextTokeniser
</font>
</pre>
</html>

Walks are a simple mechanism to declaratively access data in Runes. Walks treat the data in a Runestone as a di-graph, allowing to collect nodes in that graph.
Walks are formally defined via the following grammar:
<html>
<pre>
<font size=-1>
walk_expression: "start" ((AUGMENT^|REPLACE^) walk_andor)?
;

walk_andor: walk_augre ((AND^|OR^) walk_augre)*
;

walk_augre: repeatable_edge ((AUGMENT^|REPLACE^) repeatable_edge)*
;

repeatable_edge: (NUMBER (AUGMENT^|REPLACE^))? (TILDE)? EDGE | (LPAR! walk_andor RPAR!)
;
</font>
</pre>
</html>

See also: [[Sample walks]], [[Sample walks code]]