snowwhite


Lumikki

Picture copyright © Giulia Carrozzino, Norway.
All rights reserved.

Lumikki, Finnish for Snow White, is a tool for statically generating web pages, using Lua as the scripting language. With Lumikki, you can embed complicated HTML, JavaScript or whatever contents within macros, following the <@TAG param1=val1 ...> syntax.
Thus, your code will look like HTML but you can skip many of the tedious nuances of its syntax.
There's an article I wrote about Lumikki recently.

Download


Lumikki is implemented in 100% Lua, and is therefore system independent. You can download it here.
If you are using Fink and OS X, you will be able to simply say (hmm.. type) "sudo fink install lumikki" and get it installed. Use "man lumikki" and "lumikki -h" after that. :)

Documentation


If you like the concept, read more in the manual (do "make manual", or look here).

ImageMagick and Sitecopy integration


Lumikki has built-in integration with the ImageMagick picture processing utility. To see some samples, do "make gallery" with the source (you'll need ImageMagick installed, of course).
Lumikki also works well with the Sitecopy tool, for intelligent site upload (only moves the files that actually changed...) This used to be a plan for Lumikki, itself, but gladly I noticed the existing tool in time.
Lumikki does not directly tie to Sitecopy, but the Gallery Makefile uses it (try "cd gallery && make upload"). You can also use Gallery folder as a template for managing your own complete website.

Roadmap


Future releases of Lumikki are planned to include:
  • automatic file upload (this is my site, these are my IDs, please put it there.. :) -- DONE using Sitecopy, see Lumikki 0.22 sources
  • automatic links check (are all my links actually to valid URLs?) -- TBD
  • smart ImageMagick usage (only updating files that really need to -- ALREADY THERE!)
  • multilingua support (user selectable languages, text in same document -- ALREADY THERE, see "make test")
  • ...
The move to "Lumikki 2 XML" (aka v.0.20) was a complete redo of the tool, and some of the codepage support already there was semi-intentionally left out. Versions prior to 0.20 are no longer being maintained; for the living code, you should use Lumikki 0.20 (anything past Dec-05); it's much clearer by the internal structure, too.

Lumikki 0.22 has been frozen today (14-Jul-2006) and can be found at SourceForge, svn (svn co svn://slugak.dyndns.org/public/lumikki) and hopefully soon, at Fink.