From add48ab3aa9d49010fd257b9139c57ed70ca9d41 Mon Sep 17 00:00:00 2001 From: PeterThoeny Date: Thu, 2 Nov 2000 08:20:55 +0000 Subject: [PATCH 1/1] none --- TWiki/TWikiDocumentation.mdwn | 68 +++++++++++++++++++++++--------------- TWiki/TWikiInstallationGuide.mdwn | 17 ++++++---- TWiki/TWikiSystemRequirements.mdwn | 64 ++++++++++++++++++++--------------- 3 files changed, 90 insertions(+), 59 deletions(-) diff --git a/TWiki/TWikiDocumentation.mdwn b/TWiki/TWikiDocumentation.mdwn index 326cb13..22a3226 100644 --- a/TWiki/TWikiDocumentation.mdwn +++ b/TWiki/TWikiDocumentation.mdwn @@ -1,67 +1,81 @@ ### Documentation of the TWiki Implementation (version TWiki-4.1.2, Sat, 03 Mar 2007, build 13046) -- [(1)](#login) Wiki Username vs. Login Username -- [(2)](#access) TWiki Access Control -- [(3)](#templates) Wiki Templates -- [(4)](#variables) Wiki Variables -- [(5)](#notification) Notification of Changes by Email -- [(6)](#category) TWiki Category Table -- [(7)](#implementation) Implementation Notes -- [(8)](#installation) Installation Notes -- [(9)](#upgrade) Upgrading Earlier Versions of TWiki +- [(1)](#implementation) Implementation Notes +- [(2)](#installation) Installation Notes +- [(3)](#upgrade) Upgrading Earlier Versions of TWiki +- [(4)](#authentication) TWiki Authentication +- [(5)](#login) Wiki Username vs. Login Username +- [(6)](#access) TWiki Access Control +- [(7)](#templates) Wiki Templates +- [(8)](#variables) Wiki Variables +- [(9)](#notification) Notification of Changes by Email +- [(10)](#category) TWiki Category Table +- [(11)](#administration) TWiki Administration Related Topics: [[TWikiWeb]], [[TWikiHistory]], [[TWikiPlannedFeatures]], [[TWikiEnhancementRequests]]. - + ---- -**(1) Wiki Username vs. Login Username** +**(1) Implementation Notes** - + ---- -**(2) TWiki Access Control** +**(2) Installation Notes** - + ---- -**(3) Wiki Templates** +**(3) Upgrading Earlier Versions of TWiki** - + ---- -**(4) Wiki Variables** +**(4) TWiki Authentication** - + ---- -**(5) Notification of Changes by Email** +**(5) Wiki Username vs. Login Username** - + ---- -**(6) TWiki Category Table** +**(6) TWiki Access Control** - + ---- -**(7) Implementation Notes** +**(7) Wiki Templates** - + ---- -**(8) Installation Notes** +**(8) Wiki Variables** - + + +---- + +**(9) Notification of Changes by Email** + + + +---- + +**(10) TWiki Category Table** + + ---- -**(9) Upgrading Earlier Versions of TWiki** +**(11) TWiki Administration** diff --git a/TWiki/TWikiInstallationGuide.mdwn b/TWiki/TWikiInstallationGuide.mdwn index 92e2036..9ebec48 100644 --- a/TWiki/TWikiInstallationGuide.mdwn +++ b/TWiki/TWikiInstallationGuide.mdwn @@ -34,7 +34,7 @@ These installation steps use the Apache web server on Linux as an example. TWiki - Point your browser at and start TWiki-ing away! - Note in case the cgi scripts are **_not_** running as user `nobody`: The `*,v` RCS repository files delivered with the installation package are locked by user `nobody` . In case the user is different (e.g. `www-data` ), it is not possible to check in files, this has the effect that the topic version number does not increase when saving a topic. In this case you need to unlock all repository files and lock them as user `www-data` (check the rcs man pages), or simply delete all the repository files. A simple way to switch the locker of the RCS files is to use sed:
`for f in *,v; do sed 's/nobody/www-data/' $f > x; mv x $f; done` - Security issue: Directories `twiki/data` , `twiki/templates` and all its subdirectories should be set so that they are **not** visible as a URL. (Alternatively, move the directries to a place where they are not visible, and change the variables in `twiki/bin/wikicfg.pm` accordingly) -- Enable email notification of topic changes, [(4)](TWikiDocumentation#notification) has more. +- Enable email notification of topic changes, [Notification of Changes](TWikiDocumentation#notification) has more. - Add the [PoweredByTWikiLogo](http://TWiki.SourceForge.net/cgi-bin/view/Main/PoweredByTWikiLogo) if TWiki is installed on a public web server. - Optional: You can add new rendering rules or new %VARIABLES%. To insure an easy upgrade of TWiki it is recommended to do this customization in `twiki/bin/wikicfg.pm` , not `twiki/bin/wiki.pm` . @@ -67,7 +67,7 @@ These installation steps use the Apache web server on Linux as an example. TWiki - Customize the WEBTOPICLIST variable to contain the web specific links you prefer. - Optional: Set the WEBCOPYRIGHT variable to have a web-specific copyright text (at the bottom of each topic). - If needed, create customized templates in the new templates directory. (Non existing templates are inherited from `twiki/templates` ) - - If you want to use a category table, copy the three files `twikicatitems.tmpl` , `twikicatedit.tmpl` and `twikicatview.tmpl` from the `twiki/templates/Know` directory to the new templates directory, and customize it. More on that in [(5)](TWikiDocumentation#category) TWiki Category Table. + - If you want to use a category table, copy the three files `twikicatitems.tmpl` , `twikicatedit.tmpl` and `twikicatview.tmpl` from the `twiki/templates/Know` directory to the new templates directory, and customize it. More on that in [TWiki Category Table](TWikiDocumentation#category). - In case you want usage statistics for this web: Copy file `WebStatistics.txt` from the `twiki/data/Main` directory to the new data directory. Edit topic WebStatistics in the new web and delete old usage entries. Here are contents of directories showing file permissions. Please note that this is for debugging reasons only and does not exactly reflect the distribution: @@ -93,9 +93,12 @@ Directory `twiki/bin` : -rwxrwxr-x 1 twiki twiki 14543 Jul 20 18:46 upload -rwxrwxr-x 1 twiki twiki 4755 May 22 18:11 view -rwxrwxr-x 1 twiki twiki 1689 Jun 20 20:10 viewfile - -rw-rw-r-- 1 twiki twiki 40103 Aug 18 13:00 wiki.pm - -rw-rw-r-- 1 twiki twiki 11521 Aug 19 18:38 wikicfg.pm - -rw-rw-r-- 1 twiki twiki 13969 Aug 19 00:30 wikisearch.pm + -rw-rw-r-- 1 twiki twiki 34123 Nov 1 15:43 wiki.pm + -rw-rw-r-- 1 twiki twiki 7234 Oct 23 00:34 wikiaccess.pm + -rw-rw-r-- 1 twiki twiki 11719 Oct 28 21:58 wikicfg.pm + -rw-rw-r-- 1 twiki twiki 6441 Nov 1 23:13 wikiprefs.pm + -rw-rw-r-- 1 twiki twiki 13160 Oct 27 14:53 wikisearch.pm + -rw-rw-r-- 1 twiki twiki 10540 Oct 28 21:43 wikistore.pm Directory `twiki/templates/` : @@ -113,6 +116,8 @@ Directory `twiki/templates/` : -rw-rw-r-- 1 twiki twiki 907 Jul 20 16:01 notwiki.tmpl -rw-rw-r-- 1 twiki twiki 341 Mar 8 11:39 noweb.tmpl -rw-rw-r-- 1 twiki twiki 1000 Mar 8 11:40 oops.tmpl + -rw-rw-r-- 1 twiki twiki 1043 Oct 23 19:17 oopsaccesschange.tmpl + -rw-rw-r-- 1 twiki twiki 1036 Oct 23 19:17 oopsaccessview.tmpl -rw-rw-r-- 1 twiki twiki 914 Mar 8 11:40 oopsdel.tmpl -rw-rw-r-- 1 twiki twiki 1423 May 29 01:23 oopslocked.tmpl -rw-rw-r-- 1 twiki twiki 1067 Mar 8 11:41 oopsregexist.tmpl @@ -227,4 +232,4 @@ Directory `twiki/pub/icn/` : -rw-rw-r-- 1 twiki twiki 152 Mar 9 1999 xls.gif -rw-rw-r-- 1 twiki twiki 144 Mar 9 1999 zip.gif --- [[PeterThoeny]] - 23 Sep 2000
+-- [[PeterThoeny]] - 02 Nov 2000
diff --git a/TWiki/TWikiSystemRequirements.mdwn b/TWiki/TWikiSystemRequirements.mdwn index 2e0f4d6..392da8c 100644 --- a/TWiki/TWikiSystemRequirements.mdwn +++ b/TWiki/TWikiSystemRequirements.mdwn @@ -1,6 +1,6 @@ **_Platform_** -TWiki is written in PERL 5, but it uses also many shell command. The current implementation runs only on a Unix machine. RCS for revision control must be installed on the system. +TWiki is written in PERL 5, but it uses also many shell command. The current implementation runs best on a Unix machine; also possible on Windows. RCS for revision control must be installed on the system. **_Directories_** @@ -10,19 +10,19 @@ TWiki is written in PERL 5, but it uses also many shell command. The current imp Used for: - twiki/bin + twiki/bin TWiki PERL scripts - twiki/pub + twiki/pub Public files ([[Main/FileAttachments]], images) - twiki/data + twiki/data source text - twiki/templates + twiki/templates HTML templates, used by TWiki scripts @@ -35,85 +35,97 @@ TWiki is written in PERL 5, but it uses also many shell command. The current imp Used for: - .htaccess.txt + .htaccess.txt Authentication. Rename to .htaccess and customize if used - attach + attach Script that shows the attach file page ([[Main/FileAttachment]]) - delete + delete (not used yet) - edit + edit Script to edit a topic - geturl + geturl Script to fetch URL data - mailnotify + mailnotify Script called by cron job to notify users of changes - oops + oops Script that shows a OK or oops dialog - preview + preview Script to preview topic after edit - rdiff + rdiff Script to see differences of topics - register + register Script to register new users - save + save Script that saves a topic, called by preview - search + search Script that displays search results - statistics + statistics Script to create statistics topic - testenv + testenv Script to test CGI environment variables - upload + upload Script that does file upload ([[Main/FileAttachment]]) - view + view Script to view a topic ( the script ) - viewfile + viewfile Script to view an file attachment - wiki.pm + wiki.pm main TWiki library - wikicfg.pm + wikiaccess.pm + access control + + + wikicfg.pm for initialization and configuration, used by wiki.pm - wikisearch.pm + wikiprefs.pm + preferences handling + + + wikisearch.pm search engine, used by wiki.pm + + wikistore.pm + back-end storage, *.txt text file and *.txt,v RCS repository file handling + --- [[PeterThoeny]] - 19 Aug 2000
+-- [[PeterThoeny]] - 02 Nov 2000
-- 1.9.4