Appendix D: TWiki Development Timeline

• Improved support for internationalisation
• Better topic management screens
• More pre-installed Plugins: CommentPlugin, EditTablePlugin, RenderListPlugin, SlideShowPlugin, SmiliesPlugin, SpreadSheetPlugin, TablePlugin

• Better support for different authentication methods
• Many user interface and usability improvements
• And many, many more enhancements

Appendix D: TWiki Development Timeline

01-Sep-2004 Release (Cairo)

01-Feb-2003 Release (Beijing)

01-Feb-2003 Release (Beijing)

• • Support for /bin/view/Web.TopicName topic view URL (besides the default /bin/view/Web/TopicName URL); useful for InterwikiPlugin links like TWiki:Codev.ReadmeFirst

• • Enhanced Plugin API to manipulate topic data with new functions in TWikiFuncModule? : readTopicText, saveTopicText, setTopicEditLock, checkTopicEditLock

• • New %NOAUTOLINK% setting in the TWikiPreferences to disable the auto-linking of WikiWords

• • New Plugin hooks registrationHandler, beforeEditHandler, afterEditHandler, beforeSaveHandler, writeHeaderHandler, redirectCgiQueryHandler, getSessionValueHandler, setSessionValueHandler

• • Internationalization ('I18N') support for international characters in WikiWords, such as ISO-8859-15, KOI8-R - also supports Chinese, Japanese, etc.

• • Include previous topic revision with %INCLUDE{ "OtherTopic" rev="1.2" }%

• • The Go box understands also URLs, useful for special TWikiSkins handling

• • In WebNotify, if only the WikiName is specified, the e-mail is taken from the user's home page; if the WikiName is a group name, a notification is sent to all members of the group

• • New %NOP{}% variable in TWikiTemplates topic gets removed at topic creation time; useful to write protect template topics

• • The %URLPARAM{}% variable in TWikiTemplates topic gets expanded at topic creation time; useful for dynamic content creation

• • New $logDir introduced in TWiki.cfg to set the log directory

• • Renamed the Test web to Sandbox

• • New setlib.cfg file in the bin directory to set the TWiki library path

• • Support for outbound HTTP proxy when including URLs based on new %PROXYHOST and %PROXYPORT% settings in the TWikiPreferences

• • The page logo is configurable with new %WIKILOGOIMG%, %TWIKILOGOURL% and %WIKILOGOALT% variables in TWikiPreferences; replacing $wikiHomeUrl in TWiki.cfg

• • New %WIKITOOLNAME% variable in TWikiPreferences; replacing $wikiToolName in TWiki.cfg

• • New %EDITBOXSTYLE% preferences variable which sets the edit box width automatically to the window width

• • New %URLENCODE{}% variable to encodes a string for using in a URL parameter, e.g. %URLENCODE{"spaced name"}% returns spaced%20name

• • FormattedSearch can be nested

• • New user home pages are now based on the NewUserTemplate, replacing the /twiki/templates/register.tmpl template file

• • New markup to exclude heading from a %TOC% table of content, e.g. ---+!! This heading is not shown in a TOC

• • Form and script to create new webs, see ManagingWebs

• • New data storage framework that lets you use external RCS commands for revision control, or a new native Perl implementation that does not depend on the external RCS commands

• • Fixed IE5/IE6-specific problem whereby going back from preview sometimes removes all edit changes

• • New AND search; with regular expression enabled, use the semicolon ";" as the AND operator in %SEARCH{}% variable, FormattedSearch and WebSearch

• • Fixed cache issue where the edit page showed outdated content

• • Improved statistics script which uses less memory to process large log files

• • Variables inside <verbatim> tags are no longer expanded

01-Dec-2001 Release (Athens)

• • Added FormattedSearch to %SEARCH{}% variable for database like reporting.

01-Sep-2001 Release

• • Easier install for Windows, including auto detection in TWiki.cfg

• • Ability to move attachments between topics, see FileAttachments

• • Convert to XHTML 1.0 function: first step to XHTML-ifying TWiki

• • Category information to forms using the TWikiMetaData format, see TWikiForms

• • New topic templates as topics instead of templates. Customize by editing the topic. Retired notedited.tmpl, notext.tmpl and notwiki.tmpl templates. More in TWikiTemplates.

• • New %TOPICLIST{"format"}% and %WEBLIST{"format"}% variables to get a formatted topic index and web index, respectively. More in TWikiVariables.

• • New %URLPARAM{"name"}% variable to query URL parameters. More in TWikiVariables.

• • API to extend TWiki, see TWikiPluginAPI

• • Forms to change/reset/install passwords, see ChangePassword & ResetPassword

• • The TWikiAdminGroup (or other group) can be enabled as a SuperAdminGroup. Members have browser edit access to all locked topics.

• • Meta information format, see TWikiMetaData

• • Attachment under revision control See FileAttachment

• • Ability to rename/move topics, ManagingTopics

• • The table syntax has been enhanced to (i) render | *bold* | cells as table headers, (ii) render space padded cells |   center aligned   | and |   right aligned |, (iii) span multiple columns using | empty cells |||. More in TextFormattingRules.

• • Security fix Questionable files like PHP scripts (executables) and .htaccess files that are attached to a topic get a .txt suffix appended to the file name. See also TWiki:Codev/FileAttachmentFilterSecurityAlert

• • New Wiki rule for headings, i.e. ---++ My Title; and new %TOC% variable to build a table of content from headings in a topic. More in TWikiVariables.

• • New Wiki rule to specify arbitrary text for external links (i.e. [[http://TWki.org][TWiki]]) and internal links (i.e [[WikiSyntax][syntax]]). More in TWikiVariables.

• • New Wiki rule for named anchors, e.g. links within a topic. Define a named anchor with #MyAnchor at the beginning of a line, and link to it with [[#MyAnchor]]. More in TWikiVariables.

• • Use Net::SMTP module instead of sendmail if installed.

• • Added <verbatim> ... </verbatim> tags to show source code "as is". Unlike the <pre> ... </pre> tags, it also shows <, >, & characters "as is".

• • Fixed TWiki:Codev/CreateLinkToAttachedFileBug.

• • Added a "Minor change, don't notify" checkbox in preview. More in DontNotify.

• • Added Bold Fixed formatting using double-equal signs, e.g. write ==Bold Fixed== to get Bold Fixed.

• • Format changed of %GMTIME{"..."}% and %SERVERTIME{"..."}% variables. Format is now "$hour:$min" instead of "hour:min". More in TWikiVariables. Attention: Check your existing topics when you upgrade TWiki!

• • WebChanges, WebSearch and e-mail notification indicate also the revision number of a topic (i.e. 18 Jan 2001 16:43 r1.5), or NEW for a new topic (i.e. i.e. 18 Jan 2001 16:43 NEW).

• • New variable %STARTINCLUDE% and %STOPINCLUDE% variables to control what gets included of a topic. More in TWikiVariables.

• • TWiki skins Define a different page layout with a customized header and footer layout, i.e. a print skin for a printable view of a topic. More in TWikiSkins and TWiki:Codev/TWikiSkins.

• • Better error handling when saving a topic.

• • View authorization based on groups. Define who is allowed to see a TWiki web. More in TWikiAccessControl and TWiki:Codev/AuthenticationBasedOnGroups.

• • Improved include handling. Infinite recursion of includes are prevented; new variables %BASEWEB%, %INCLUDINGWEB%, %BASETOPIC% and %INCLUDINGTOPIC% to have more control over include handling. More in TWikiVariables and TWiki:Codev/IncludeHandlingImprovements.

• • New noheader="on" switch in %SEARCH{...}% to suppress table header. More in TWikiVariables.

01-Dec-2000 Release

• • Flag $doHidePasswdInRegistration in wikicfg.pm to hide plain text password in registration email.

• • New variable %VAR{"NAME" web="Web"}% to get web specific preferences. More in TWikiVariables.

• • Added a "Cancel" link in edit that releases the edit lock.

• • Authorization based on groups. Define fine graned control who is allowed to change or create topics. More in TWikiAccessControl and TWiki:Codev/AuthenticationBasedOnGroups.

• • Remember user by IP address so that view "knows" the user once authenticated in edit. More in TWikiUserAuthentication.

• • Fixed TWiki:Codev/UppercaseAttachments bug and added png image support.

• • Allow nesting of variables, i.e. %INCLUDE{"%TWIKIWEB%.TWikiWebsTable"}%. More in TWiki:Codev/BetterTWikiTagTemplateProcessing.

• • New -q switch in mailnotify to suppress all normal output.

• • Fixed TWiki:Codev/AttachedNotificationLinksBug.

• • Added forced internal links. Write [[text formatting FAQ]] to get the link text formatting FAQ that points to topic TextFormattingFAQ.

• • Ref-By link searches all webs (not just the current web.)

• • New TWikiPreferences variables %HTTP_EQUIV_ON_VIEW% , %HTTP_EQUIV_ON_EDIT% and %HTTP_EQUIV_ON_PREVIEW% that define the <meta http-equiv="..."> meta tags for the TWiki templates. This can be used for example to set a document expiration time.

• • New variables %GMTIME{"..."}% and %SERVERTIME{"..."}% . More in TWikiVariables.

• • Changed include syntax from %INCLUDE{"Web/TopicName.txt"}% to %INCLUDE{"Web.TopicName"}% . Legacy syntax still supported.

• • BookView search allows you show a set of topics for easy printing.

• • More forgiving syntax for *bold*, italic, __bold italic__ and fixed , where it is not necessary anymore to have a trailing space before .,;:?! characters.

• • Split the TWiki.Main web into TWiki.Main (users, company data) and TWiki.TWiki (TWiki related documentation, registration)

• • Added an "Release edit lock" checkbox in preview to let other people edit the topic immediately without the one hour lock.

• • Fixed problem of losing carriage returns when editing topics with KDE KFM browser or W3M? browser.

• • Fixed problem that a page redirect on some server environments is not working (host name is needed in URL).

• • Fixed security issue to prevent a server side %INCLUDE% of arbitrary files.

• • New %GMTIME% variable that shows the current GM time.

• • Lock warning shows remaining lock time in minutes.

• • Each topic can have its own template file. TWikiTemplates has more.

• • Advanced search features like search multiple webs; sort by topic name / modified time / author; limit the number of results returned. More in TWikiVariables.

01-May-2000 Release

• • New TWikiVariables %HTTP_HOST% , %REMOTE_ADDR% , %REMOTE_PORT% and %REMOTE_USER% .

• • TWikiRegistration is done separately for Intranet use (depends on remote_user) or Internet use (depends on .htpasswd file).

• • Uploading a file (topic file attachment) will optionally create a link to the uploaded file at the end of the topic. The preference variable %ATTACHLINKBOX% controls the default state of the link check box in the attach file page.

• • Better security with taint checking ( Perl -T option )

• • New preference variables %EDITBOXWIDTH% and %EDITBOXHEIGHT% to specify the edit box size.

• • Edit preferences topics to set TWiki variables. There are three level of preferences Site-level (TWikiPreferences), web-level (WebPreferences in each web) and user-level preferences (for each of the TWikiUsers). With this, discontinue use of server side include of wikiwebs.inc , wikiwebtable.inc , weblist.inc , webcopyright.inc and webcolors.inc files.

• • New variable %SCRIPTSUFFIX% / $scriptSuffix containing an optional file extension of the TWiki Perl script. Templates have been changed to use this variable. This allows you to rename the Perl script files to have a file extension like for example ".cgi".

• • New variable %SCRIPTURLPATH% / $scriptUrlPath containing the script URL without the domain name. Templates have been changed to use this variable instead of %SCRIPTURL% . This is for performance reasons.

• • Changed the syntax for server side include variable from %INCLUDE:"filename.ext"% to %INCLUDE{"filename.ext"}% . (Previous syntax still supported. Change was done because of inline search syntax)

• • Inline search. New variable %SEARCH{"str" ...}% to show a search result embedded in a topic text. TWikiVariables has more on the syntax. Inline search combined with the category table feature can be used for example to create a simple bug tracking system.

• • Access statistics. Each web has a WebStatistics topic that shows monthy statistics with number of topic views and changes, most popular topics, and top contributors. (It needs to be enabled, TWikiDocumentation has more.)

• • Fixed bug where TWiki would not initialize correctly under certain circumstances, i.e. when running it under mod_perl. Sub initialize in wiki.pm did not handle $thePathInfo correctly.

• • Fixed bug where an email address starting with a WikiName was rendered as an internal Wiki link instead of an email address, i.e. SomeWikiName@somewhere.test .

• • No more escaping for '%' percent characters. (Number of consecutive '%' entered and displayed is identical.)

• • Limit the number of revisions shown at the bottom of the topic. Example
    Topic TWikiHistory . { ..... Diffs r1.10 > r1.9 > r1.8 > r1.7 >... }
    Additional revisions can be selected by pressing the >... link.

01-Sep-1999 Release

• • Fixed Y2K? bug. (Date in year 2000 had wrong format.)

• • New text formatting rule for creating tables. Text gets rendered as a table if enclosed in " " vertical bars. Example line as it is written and how it shows up

• • Online registration of new user using web form in TWikiRegistration. Authentication of users.

• • Flags $doLogTopic* in wikicfg.pm to selectively log topic view, edit, save, rdiff, attach, search and changes to monthly log file.

• • Flag $doRemovePortNumber in wikicfg.pm to optionally remove the port number from the TWiki URL. Example www.some.domain:1234/twiki gets www.some.domain/twiki .

• • Search path for include files in %INCLUDE:"file.inc"% variable. Search first in the current web, then in parent data directory. Useful to overload default include text in the data directory by web-specific text, like for example webcopyright.inc text.

• • Link a plural topic to a singular topic in case the plural topic does not exist. Example TestVersion / TestVersions , TestPolicy / TestPolicies , TestAddress / TestAddresses , TestBox / TestBoxes .

01-Jul-1999 Release

• • New TextFormattingRules to write bold italic text by enclosing words with double underline characters.

• • Separate wiki.pm into configuration (wikicfg.pm) and TWiki core (wiki.pm) . This is to ease the upgrade of TWiki installations, it also allows customized extensions to TWiki without affecting the TWiki core.

• • Externalize copyright text at the bottom of every page into a web-specific webcopyright.inc file. This is to easily customize the copyright text.

• • Added meta tag so that robots index only /view/ of topics, not /edit/, /attach/ e.t.c. Tag <META NAME="ROBOTS" CONTENT="NOINDEX">

• • New variables %WIKIHOMEURL% (link when pressing the icon on the upper left corner) and %WIKITOOLNAME% (the name of the wiki tool TWiki ).

• • Topic locking Warn user if a topic has been edited by an other person within one hour. This is to prevent contention, e.g. simultaneous topic updates.

• • File attachments Upload and download any file as a topic attachment by using the browser. FileAttachment has more.

• • New variables %PUBURL% (Public directory URL) and %ATTACHURL% (URL of topic file attachment).

• • New text formatting rule for creating fixed font text . Words get showns in fixed font by enclosing them in "=" equal signs. Example Writing =fixed font= will show up as fixed font .

• • No new topic revision is created if the same person saves a topic again within one hour.

• • Possible to view complete revision history of a topic on one page. Access at the linked date in the Changes page, or the Diffs link at the bottom of each topic, e.g.
    Topic TWikiHistory . { Edit Ref-By Diffs r1.3 > r1.2 > r1.1 }
Revision r1.3 1998/11/10 01:34 by PeterThoeny

• • Fixed bug when viewing differences between topic revisions that include HTML table tags like <table>, <tr>, <td>.

1998 Releases

• • Signature is shown below the text area when editing a topic. Use this to easily copy & paste your signature into the text.

• • Possible to add a category table to a TWiki topic. This permits storing and searching for more structured information. Editing a topic shows a HTML form with the usual text area and a table with selectors, checkboxes, radio buttons and text fields. TWikiDocumentation has more on setup. The TWiki.Know web uses this category table to set classification, platform and OS version.

• • Internal log of topic save actions to the file data/logYYYYMM.txt, where YYYYMM the year and month in numeric format is. Intended for auditing only, not accessible from the web.

• • The email notification and the Changes topic have now a topic date that is linked. Clicking on the link will show the difference between the two most recent topic revisions.

• • Added preview of topic changes before saving the topic. This was necessary to prevent unneeded revisions.

• • Refered-By Find out which topics have a link to the current topic. Each topic has a Ref-By link for that. Note Only references from the current web are shown, not references from other webs.

• • Alphabetical topic index in WebSearch.

• • Corrected templates for automatic email notification so that MS Outlook can display attachment as an HTML file.

• • WikiNotation allows also numbers after the AaA sequence, e.g. AaA1 is a valid WikiTopic? name, but not Aa1.

• • Automatic email notification when something has changed in a TWiki web. Each web has a topic WebNotify where one can subscribe and unsubscribe.

• • Added server side include of files. Syntax is %INCLUDE:"filename.ext"%

• • Signature and date is inserted automatically when creating a new topic.

• • Separate templates for text of non existing topic and default text of new topic. (template file templates/Web/notedited.tmpl)

• • Warn user if new topic name is not a valid Wiki name. (template file templates/Web/notwiki.tmpl)

• • Support for quoted text with a '>' at the beginning of the line.

• • Added TWiki variables, enclosed in % signs %TOPIC% (Topic name), %WEB% (web name), %SCRIPTURL% (script URL), %DATE% (current date), %WIKIWEBMASTER% (Wiki webmaster address), %WIKIVERSION% (Wiki version), %USERNAME% (user name), %WIKIUSERNAME% (Wiki user name).

• • Topic WebChanges shows Wiki username instead of Intranet username, e.g. PeterThoeny instead of thoeny in case the Wiki username exists. Implementation Automatic lookup of Wiki username in topic TWikiUsers.

• • Topic index. (Technically speaking a simple '.*' search on topic names.)

• • Topic WebSearch allows full text search and and topic search with/without regular expressions.

• • Added automatic links to topics in other TWiki webs by specifying <web name>.<topic name>, e.g. Know.WebSeach .

• • Installed initial version, based on the JOS Wiki. See WikiWikiClones for details.

Dev Flow

Appendix B: TWiki Development Timeline

• 29 Dec 2002 - AndreaSterbini? , PeterThoeny, RichardDonkin? , SvenDowideit?
  • New Plugin hooks registrationHandler, beforeEditHandler, afterEditHandler, beforeSaveHandler, writeHeaderHandler, redirectCgiQueryHandler, getSessionValueHandler, setSessionValueHandler
• 30 Nov 2002 - RichardDonkin?

• 25 Nov 2002 - PeterThoeny
  • Include previous topic revision with %INCLUDE{ "OtherTopic" rev="1.2" }%
• 15 Nov 2002 - PeterThoeny

• • Form and script to create new webs, see ManagingWebs
• 01 Apr 2002 - JohnTalintyre?
  • New data storage framework that lets you use external RCS commands for revision control, or a new native Perl implementation that does not depend on the external RCS commands

• • Fixed IE5/IE6-specific problem whereby going back from preview sometimes removes all edit changes
• 23 Mar 2002 - JohnTalintyre?
  • New AND search; with regular expression enabled, use the semicolon ";" as the AND operator in %SEARCH{}% variable, FormattedSearch and WebSearch

• 18 Jan 2003 - PeterThoeny
  • Support for /bin/view/Web.TopicName topic view URL (besides the default /bin/view/Web/TopicName URL); useful for InterwikiPlugin links like TWiki:Codev.ReadmeFirst