TWiki Implementation Notes
Platform
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.
Required Environment by Platform |
Package(s): |
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 |
Directory Structure
Directory: |
Used for: |
twiki/bin |
TWiki Perl scripts |
twiki/lib/TWiki |
TWiki Perl modules |
twiki/lib/TWiki/Plugins |
Plugins modules |
twiki/pub |
Public files (FileAttachments, images), plus RCS histories |
twiki/data |
source (topic) text, including RCS histories |
twiki/templates |
HTML templates, used by TWiki scripts |
Files in twiki/bin
File: |
Used for: |
.htaccess.txt |
Authentication. Rename to .htaccess and customize if used |
attach |
Script that shows the attach file page (FileAttachment) |
delete |
(not used yet) |
edit |
Script to edit a topic |
geturl |
Script to fetch URL data |
mailnotify |
Script called by cron job to notify users of changes |
oops |
Script that shows an OK or oops dialog |
preview |
Script to preview topic after edit |
rdiff |
Script to see differences of topics |
rename |
Script to rename/move topics and move attachments |
register |
Script to register new users |
save |
Script that saves a topic, called by preview |
search |
Script that displays search results |
statistics |
Script to create statistics topic |
testenv |
Script to test CGI environment variables |
upload |
Script that does file upload (FileAttachment) |
view |
Script to view a topic ( the script ) |
viewfile |
Script to view an file attachment |
Files in twiki/lib
File: |
Used for: |
TWiki.pm |
Main TWiki library |
TWiki.cfg |
For initialization and configuration, used by TWiki.pm |
Files in twiki/lib/TWiki
File: |
Used for: |
Access.pm |
Access control |
Attach.pm |
Attachment handling |
Meta.pm |
Meta data in topics |
Net.pm |
SMTP mail handling |
Plugins.pm |
Plugin handling |
Prefs.pm |
Preferences handling |
Search.pm |
Search engine, used by wiki.pm |
Store.pm |
Back-end storage, *.txt text file and *.txt,v RCS repository file handling |
Files in twiki/lib/TWiki/Plugins
File: |
Used for: |
DefaultPlugin.pm |
Default plugin |
EmptyPlugin.pm |
Empty plugin, use to create your own |
InterwikiPlugin.pm |
Refer to external Wikis and other Web sites |
--
MikeMannix - 26 Aug 2001