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 | | |
Optional Perl modules | Net::SMTP (or sendmail) | Net::SMTP |
RCS | 5.7 | 5.7 |
Other external programs | ls, fgrep, egrep | ? |
Web server | Apache | ? |
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) |
twiki/data | source text |
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 |
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 |
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 |
--
MikeMannix? - 26 Aug 2001
to top