TWiki Implementation Notes

Platforms and System Requirements

TWiki is written in Perl 5 and also uses some shell commands. The current implementation runs best on a Unix machine, but it is also possible on Microsoft Windows. RCS (for revision control) must be installed on the system. [ MM: Locate elsewhere and/or include one-liner and link for RCS... ]

Required Environment by Platform
Packages: Linux/Unix: Windows:
Perl 5.x 5.x
Non-standard Perl modules   MIME::Base64, Digest::SHA1 (for password generation)
Optional Perl modules Net::SMTP (or sendmail) Net::SMTP
RCS 5.7 5.7 (including diff
Other external programs ls, fgrep, egrep ls, fgrep, egrep
Web server Apache Apache, IIS
OS versions Linux, Unix... every last Win?!

Directory Structure

You can easily rename the root TWiki directory - twiki - to whatever you like by changing a configuration file value. For the simplest installation and future upgrades, you should leave the subdirectory structure exactly as is:

Directory: Files: Used for:
twiki list Start-up info
twiki/bin list Perl scripts
twiki/lib list Configuration file & main library
twiki/lib/TWiki list Perl modules
twiki/lib/TWiki/Plugins list TWikiPlugins Perl modules
twiki/pub list Public support files (ex: FileAttachments, images) and RCS histories)
twiki/data list Topic text (page content) and RCS histories;
twiki/templates list HTML templates, used by TWiki scripts

Note: about the additional directories in data, elsewhere

Files in twiki

to follow

Files in twiki/bin

File: Used for:Sorted descending
viewfile Script to view an file attachment
view Script to view a topic ( the script )
testenv Script to test CGI environment variables
rdiff Script to see differences of topics
rename Script to rename/move topics and move attachments
register Script to register new users
preview Script to preview topic after edit
geturl Script to fetch URL data
edit Script to edit a topic
statistics Script to create statistics topic
attach Script that shows the attach file page (FileAttachment)
oops Script that shows an OK or oops dialog
save Script that saves a topic, called by preview
upload Script that does file upload (FileAttachment)
search Script that displays search results
mailnotify Script called by cron job to notify users of changes
.htaccess.txt Authentication. Rename to .htaccess and customize if used
delete (not used yet)

Files in twiki/lib

File: Used for: Main TWiki library
TWiki.cfg For configuration, used by

Files in twiki/lib/TWiki

File: Used for: Access control Attachment handling Meta data in topics SMTP mail handling Plugin handling Preferences handling Search engine, used by Back-end storage, *.txt text file and *.txt,v RCS repository file handling

Files in twiki/lib/TWiki/Plugins

File: Used for: Default plugin Empty plugin, use to create your own Refer to external Wikis and other Web sites

Files in twiki/pub

to follow

Files in twiki/data

to follow

Files in twiki/templates

to follow

-- MikeMannix - 28 Aug 2001

Edit | Attach | Watch | Print version | History: r44 | r10 < r9 < r8 < r7 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r8 - 2001-08-29 - MikeMannix
  • Edit
  • Attach
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2022 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on at TWiki:TWiki.TWikiSystemRequirements.