THT Wiki-Text

Wiki-text is a meta-markup notation that is much easier to write (and read) than HTML. Wiki-text variants are used by sites such as http://wikipedia.org to allow editing of online content. THT supports a simple subset of the wiki-text used in pmwiki.

Usage

There are 2 ways to embed wiki-text into a .tht file. The first is to start the file with %%. This signifies that an entire file is wikitext. eg.

%%
!!My Topic
* Point1
* Point2

The other way is to output snippets of wiki-text inside Tcl blocks using wiki echo, ie:

<?tht
echo [wiki {
!!My Topic
* Point1
* Point2
}]
?>

Supported Markup

The general wiki-text supported is as follows (see http://pmwiki.org for docs):

 !!HEADING
 ''italics''
 '''bold'''
 ''''bolditalics''''
 @monospace@
 * list unordered
 # list numbered
 [[link]]
 Path:imagename.gif
---- HRULE
 ->INDENT
:title TEXT:
>>STYLE<<
%STYLE%
[@ PREFORMAT @ ]
||border=1
||!Table||!Head||
||Data1||Data2||

Advantages

A significant advantage of THT wiki-text over PmWiki is that it is independant of the wiki directory hierarchy. A .tht file may appear anywhere in the web tree.

Another advantage is that, Tcl applications like Ted can rendering THT wiki directly into a Tk text widget. This means online THT wiki web documentation can be used interchangebly with Tk wiki applications.

© 2008 Peter MacDonald