Yaki

Yaki (which stands for “grill” in Japanese) was the provisional name for my NewWikiMigration project, which was finally completed in May 2007.

It is the CMS that runs this site since that date, and can be described as a full-blown, heavily filesystem-oriented Wiki engine.

Since people like lists of features, here are a few:

• 100% pure Python, with extensive UTF-8 support¹
• Entirely self-hosting, running atop a modified (1.51-rcarmo) Snakelets application framework²
• Completely filesystem-based (pages are stored on a directory structure, not a database)
• Heavily optimized HTTP processing:
  • Pages are pre-processed to HTML
  • HTML and other internal info are stored in a single-file cache, a la Haystack
  • Everything is served via sendfile(2) calls whenever possible
  • Uses every HTTP caching trick in the book to minimize actual page hits
• Completely markup-agnostic – all the internal processing relies on Beautiful Soup, and it ships with support for:
  • raw HTML
  • Textile
  • Markdown
• Any markup engine that generates HTML can be added, and markup can be defined on a site-wide or page-per-page basis
• Has all the usual features, like:
  • Aliases
  • InterWiki support
  • Alphabetical Index
  • Recent Changes
  • etc.
• Has a number of unusual Bliki features, like a blog-like home page, linkblog support, and the SeeAlso table at the bottom of each page.
• Supports full-text indexing and search thanks to Whoosh
• The core code is Open Source under the MIT License
  • The source code for the “stable” version is published on Github (this site is running the bleeding-edge stuff, which will eventually be merged back in, even if it takes me another three years)

Similar Projects

There are a number of similar endeavors out there you might find at least as interesting. You can check out OtherWikis for a vastly more comprehensive list I compiled during Yaki’s development, but these are fairly modern:

• Ikiwiki
• Sputnik for LUA
• Jekyll for Ruby
• FlatPress for PHP4 (has a web UI, if you like that sort of thing) or Stacey

—

¹ As much as possible within OS and filesystem constraints ↩

² Forget about massive sprawling toolkits, Snakelets, is stable, small, tweakable and truly platform-agnostic. ↩