A high-level description of how tiddlyisar works
----------------------------------------------

tiddlyisar and isar2html are Mathematical Knowledge Management 
tools for converting IsarMathLib sources to tiddlywiki markup and HTML, 
resp. The inputs to the programs are as follows:

1. A file called ROOT.ML with the list of theories to process.

2. The Isabelle theory files listed in ROOT.ML

3. For tiddlyisar: A file called `tiddlyformalmath_empty.html`. 
This file is a template of the Tiddly Formal Math site that is the output of the tool.
It contains tiddlers titled like the theories listed in ROOT.ML
whose contents are strings of the form "<theory name> placeholder".
The template has a jsMath and NestetSliders plugins installed.
The tool replaces the placeholder strings in the 
`tiddlyformalmath_empty.html` file with the tiddlywiki markup 
text produced from parsed IsarMathLib theories. 
Miraculously, it works - the result is a tiddlyformalmath.html
file which I can upload to the tiddlyspot.com hosting site,
see http://formalmath.tiddlyspot.com/ .

4. For isar2html: A file called isar2html_template.html.
This is a template of a converted theory file. The tool
places the HTML markup generated from a theory file
in a place marked by a special string. The links
to other theory files are created similarly. The result can
be viewed at the formalmath.org site. 

The tool is written in Haskell and can be compiled with GHC.
I use it from GHCi.

Slawomir Kolodynski
