WikklyText A wikitext server and rendering library


files/feed-icon-14x14.png Recently Edited Valid XHTML 1.0 Strict
Welcome! edit
frank, 10 August 2008 (created 04 February 2008)
What is WikklyText?
  • It provides a lightweight, portable, extensible wiki language, compatible with TiddlyWiki
    (see also: MarkupReference).
  • It is easily used as a WikiOnAStick for keeping a personal wiki.
  • It can be used BehindApache to serve a multiuser wiki.
  • It can be plugged into Drupal allowing you to write in WikklyText markup on your existing Drupal site.
  • It provides "Safe" and "Full" modes: In "Safe" mode, the user is restricted to only calling safe macros, no HTML injection is possible, and the generated text is filtered to preclude XSS issues. In a server setting (e.g. Drupal or Apache) this allows untrusted users to write WikklyText content without endangering system security.
  • It is extensible, allowing both embedded Python code in wikitexts (<?py ... ?>) as well as providing an easy to use plugin API.
  • It is a modular Python library that you can use to build your own wikitext rendering applications. You can render to both HTML and XML for flexibility.
  • It is provided under a free license.

To view some sample content, see the ConversionDemo.
LatestNews edit
frank, 18 December 2009 (created 11 March 2008)
You might be interested in reading the RecentChanges.

December 18, 2009


Version 1.9.3-TEST released. This is prerelease software, meant to let everyone have a preview of the new server frontend code. Please make a backup and test using that. See PreRelease for details and downloads.

October 11, 2009


Version 1.9.2-TEST released. This is prerelease software, meant to let everyone have a preview of the new server frontend code. Please make a backup and test using that. See PreRelease for details and downloads.

September 26, 2009


Version 1.9.1-TEST released. This is prerelease software, meant to let everyone have a preview of the new server frontend code. Please make a backup and test using that. See PreRelease for details and downloads.

September 18, 2009


Version 1.9.0-TEST goes live. Well, it turned out that moving to a new server did not eliminate the random lockups after all — they were just as bad as before. I came to the conclusion that the problem was in WikklyText itself, so I finally undertook a major refactoring of the wiki frontend I've been planning putting off for a long time. The test code is now live here and (crossing fingers) has not locked up once yet. If you run a wiki and are interested in checking out the new code prior to the 2.0 release, I encourage you to follow the MailingList as I'll be making further announcements there.

August 24, 2009


Wikklytext has moved to a new server. Hopefully this will eliminate the twice-daily reboots I was having to do with the old server. The new server seems snappier on first impression, keeping my fingers crossed ...

August 16, 2009


This release adds a new type of macro that takes a WSGI environment as an argument. You can also attach arbitrary WSGI applications to the wiki now.

September 28, 2008


WikklyText 1.5.0 is released. This is somewhat of a cleanup release with reorganization of the caching architecture, parsing cleanups and XHTML compliance fixes.


September 6, 2008


Added GettingPlugins page to collect plugins.

GettingWikklyText edit
frank, 11 August 2008 (created 23 November 2007)
Tags: installation
  • If you want to try it out without installing Python, and you are running Windows, WikExeWin32 is a quick way to get started.
  • Otherwise, install the Python package.
  • To use with Drupal, get the DrupalPlugIn.
WhatNow edit
frank, 04 February 2008 (created 05 October 2007)
Some starting points for using WikklyText.
UsingWik
Use the wik standalone tool to create, manage, render and serve full blown wikis.
Unless you are a programmer, this is probably what you want to use!
MarkupReference
A complete reference to the WikklyText markup language

For programmers

WikklyTextApi
Documents the primary entry points.

Other/older tools

wikkly2html
Renders a single text file at a time.
twextract
Tool for converting a TiddlyWiki to standalone HTML (superceded by wik).

MailingList edit
frank, 11 August 2008 (created 05 March 2008)
Tags: support security
There is a mailing list for WikklyText users and developers. Please post support questions there so everyone may benefit from the answers. Security-related announcements will be posted there as well, so if you are running a public WikklyText site, you may want to subscribe to the list.

The list is hosted at Google Groups: WikklyText Mailing list

You can also post comments on many pages here (for longer questions/issues, though, please use the mailing lists).


AboutTheseDocs edit
frank, 09 March 2008 (created 05 October 2007)
Tags: about
The site you are viewing is a WikklyText wiki. If you are familiar with TiddlyWiki you'll notice that WikklyText wikis use the same naming scheme. This is done so that you can move content freely between a TiddlyWiki and a WikklyText wiki. (See the wik conv command in UsingWik.)

Much of the time, this site will be running a prerelease version of WikklyText. Don't be surprised to see a version number (on the link at the bottom) that is not yet available for download. All features will be included in the next stable release.