diff options
Diffstat (limited to 'TWiki')
-rw-r--r-- | TWiki/TWikiImplementationNotes.mdwn | 122 |
1 files changed, 84 insertions, 38 deletions
diff --git a/TWiki/TWikiImplementationNotes.mdwn b/TWiki/TWikiImplementationNotes.mdwn index 03668108..d3ab11be 100644 --- a/TWiki/TWikiImplementationNotes.mdwn +++ b/TWiki/TWikiImplementationNotes.mdwn @@ -1,8 +1,10 @@ -**_Platform_** +## <a name="TWiki_Implementation_Notes"> TWiki Implementation Notes </a> -TWiki is written in Perl 5, but it uses also many 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. +### <a name="Platform"> Platform </a> -**_Directories_** +TWiki is written in Perl 5 and uses also 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. + +### <a name="Directory_Structure"> Directory Structure </a> <table border="1" cellpadding="1" cellspacing="0"> <tr> @@ -10,24 +12,34 @@ TWiki is written in Perl 5, but it uses also many shell commands. The current im <th bgcolor="#99CCCC"><strong>Used for:</strong></th> </tr> <tr> - <td><code>twiki/bin</code></td> + <td><code><b>twiki/bin</b></code></td> <td> TWiki Perl scripts </td> </tr> <tr> - <td><code>twiki/pub</code></td> + <td><code><b>twiki/bin/TWiki</b></code></td> + <td> TWiki Perl modules </td> + </tr> + <tr> + <td><code><b>twiki/bin/TWiki/Plugins</b></code></td> + <td> Plugins modules </td> + </tr> + <tr> + <td><code><b>twiki/pub</b></code></td> <td> Public files (<span style="background:"><font color="">File Attachments</font></span><a href="http://LOCATION/FileAttachments">?</a>, images) </td> </tr> <tr> - <td><code>twiki/data</code></td> + <td><code><b>twiki/data</b></code></td> <td> source text </td> </tr> <tr> - <td><code>twiki/templates</code></td> + <td><code><b>twiki/templates</b></code></td> <td> HTML templates, used by TWiki scripts </td> </tr> </table> -**_Files in twiki/bin_** +**_Note:_** You could move the <code>**twiki/bin/TWiki**</code> library directory (including <code>**Plugins**</code> ) to <code>**twiki/lib/TWiki**</code>; the scripts look for a <code>**"."**</code> and <code>**"../lib"**</code> relative library path. + +#### <a name="Files_in_twiki_bin"> Files in twiki/bin </a> <table border="1" cellpadding="1" cellspacing="0"> <tr> @@ -35,97 +47,131 @@ TWiki is written in Perl 5, but it uses also many shell commands. The current im <th bgcolor="#99CCCC"><strong>Used for:</strong></th> </tr> <tr> - <td><code>.htaccess.txt</code></td> + <td><code><b>.htaccess.txt</b></code></td> <td> Authentication. Rename to .htaccess and customize if used </td> </tr> <tr> - <td><code>attach</code></td> + <td><code><b>attach</b></code></td> <td> Script that shows the attach file page (<span style="background:"><font color="">File Attachment</font></span><a href="http://LOCATION/FileAttachment">?</a>) </td> </tr> <tr> - <td><code>delete</code></td> + <td><code><b>delete</b></code></td> <td> (not used yet) </td> </tr> <tr> - <td><code>edit</code></td> + <td><code><b>edit</b></code></td> <td> Script to edit a topic </td> </tr> <tr> - <td><code>geturl</code></td> + <td><code><b>geturl</b></code></td> <td> Script to fetch URL data </td> </tr> <tr> - <td><code>mailnotify</code></td> + <td><code><b>mailnotify</b></code></td> <td> Script called by cron job to notify users of changes </td> </tr> <tr> - <td><code>oops</code></td> + <td><code><b>oops</b></code></td> <td> Script that shows an OK or oops dialog </td> </tr> <tr> - <td><code>preview</code></td> + <td><code><b>preview</b></code></td> <td> Script to preview topic after edit </td> </tr> <tr> - <td><code>rdiff</code></td> + <td><code><b>rdiff</b></code></td> <td> Script to see differences of topics </td> </tr> <tr> - <td><code>register</code></td> + <td><code><b>register</b></code></td> <td> Script to register new users </td> </tr> <tr> - <td><code>save</code></td> + <td><code><b>save</b></code></td> <td> Script that saves a topic, called by preview </td> </tr> <tr> - <td><code>search</code></td> + <td><code><b>search</b></code></td> <td> Script that displays search results </td> </tr> <tr> - <td><code>statistics</code></td> + <td><code><b>statistics</b></code></td> <td> Script to create statistics topic </td> </tr> <tr> - <td><code>testenv</code></td> + <td><code><b>testenv</b></code></td> <td> Script to test CGI environment variables </td> </tr> <tr> - <td><code>upload</code></td> + <td><code><b>upload</b></code></td> <td> Script that does file upload (<span style="background:"><font color="">File Attachment</font></span><a href="http://LOCATION/FileAttachment">?</a>) </td> </tr> <tr> - <td><code>view</code></td> + <td><code><b>view</b></code></td> <td> Script to view a topic ( <strong>the</strong> script ) </td> </tr> <tr> - <td><code>viewfile</code></td> + <td><code><b>viewfile</b></code></td> <td> Script to view an file attachment </td> </tr> <tr> - <td><code>wiki.pm</code></td> - <td> main TWiki library </td> + <td><code><b>TWiki.pm</b></code></td> + <td> Main TWiki library </td> + </tr> + <tr> + <td><code><b>TWiki.cfg</b></code></td> + <td> For initialization and configuration, used by <code><b>TWiki.pm</b></code></td> + </tr> +</table> + +#### <a name="Files_in_twiki_bin_TWiki"> Files in twiki/bin/TWiki </a> + +<table border="1" cellpadding="1" cellspacing="0"> + <tr> + <th bgcolor="#99CCCC"><strong>File:</strong></th> + <th bgcolor="#99CCCC"><strong>Used for:</strong></th> + </tr> + <tr> + <td><code><b>Access.pm</b></code></td> + <td> Access control </td> + </tr> + <tr> + <td><code><b>Net.pm</b></code></td> + <td> SMTP mail handling </td> + </tr> + <tr> + <td><code><b>Plugins.pm</b></code></td> + <td> Plugin handling </td> </tr> <tr> - <td><code>wikiaccess.pm</code></td> - <td> access control </td> + <td><code><b>Prefs.pm</b></code></td> + <td> Preferences handling </td> </tr> <tr> - <td><code>wikicfg.pm</code></td> - <td> for initialization and configuration, used by wiki.pm </td> + <td><code><b>Search.pm</b></code></td> + <td> Search engine, used by wiki.pm </td> </tr> <tr> - <td><code>wikiprefs.pm</code></td> - <td> preferences handling </td> + <td><code><b>Store.pm</b></code></td> + <td> Back-end storage, <code>*.txt</code> text file and <code>*.txt,v</code> RCS repository file handling </td> + </tr> +</table> + +#### <a name="Files_in_twiki_bin_TWiki_Plugins"> Files in twiki/bin/TWiki/Plugins </a> + +<table border="1" cellpadding="1" cellspacing="0"> + <tr> + <th bgcolor="#99CCCC"><strong>File:</strong></th> + <th bgcolor="#99CCCC"><strong>Used for:</strong></th> </tr> <tr> - <td><code>wikisearch.pm</code></td> - <td> search engine, used by wiki.pm </td> + <td><code><b>DefaultPlugin.pm</b></code></td> + <td> Default plugin </td> </tr> <tr> - <td><code>wikistore.pm</code></td> - <td> back-end storage, <code>*.txt</code> text file and <code>*.txt,v</code> RCS repository file handling </td> + <td><code><b>EmptyPlugin.pm</b></code></td> + <td> Empty plugin, use to create your own </td> </tr> </table> --- [[Main/PeterThoeny]] - 02 Nov 2000 <br /> +-- [[Main/PeterThoeny]] - 03 Mar 2001 <br /> |