none
[openafs-wiki.git] / TWiki / TWikiInstallationGuide.mdwn
index 9300175..756605b 100644 (file)
@@ -1,3 +1,5 @@
+## <a name="TWiki Installation Notes"></a> TWiki Installation Notes
+
 These installation steps use the Apache web server on Linux as an example. TWiki should run on other web servers and Unix systems as well. (TWiki on Windows is possible, but has not been documented well. More on that at <http://TWiki.org/cgi-bin/view/Codev/TWikiOnWindows> )
 
 **_Note:_** Below installation steps assume user `nobody` for all files manupulated by the cgi scripts (executed by the web server), and user `twiki` for all other files. You need to replace user `nobody` with an other user in case the web server executes the script with a different user ( default for Debian is `www-data` ). Also, you can substitute user `twiki` with your own user name.
@@ -39,7 +41,7 @@ These installation steps use the Apache web server on Linux as an example. TWiki
 
 Read <http://TWiki.org/cgi-bin/view/Codev/SourceForgeHowTo> in case you want to install TWiki on SourceForge.
 
-Installation steps:
+### <a name="Installation steps"></a> Installation steps
 
 - Request the TWiki distribution (in Unix ZIP format) from <http://TWiki.org/download.html> .
 - Create directory `/home/httpd/twiki` and unzip the TWiki distribution into this directory.
@@ -78,7 +80,7 @@ Installation steps:
   - If you use `.htaccess`, edit the file and add the file extension to `edit`, `view`, `preview`, etc.
 - 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: <br />`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, [Notification of Changes](TWikiDocumentation#notification) has more. Using your browser, edit also the [[WebNotify]] topic in all webs and set the users you want to notify.
+- Enable email notification of topic changes, [[Notification of Changes|Main/TWikiDocumentation#TWiki_Notification_of_Changes]] has more. Using your browser, edit also the [[WebNotify]] topic in all webs and set the users you want to notify.
 - Add the [TWiki:Main.PoweredByTWikiLogo](http://TWiki.org/cgi-bin/view/Main/PoweredByTWikiLogo) to your [[WebHome]] topic.
 
 - 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` .
@@ -115,6 +117,8 @@ Installation steps:
   - 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.
   - Note that user home topics are only located in the %WIKITOOLNAME%.Main web, so don't try to move them or create them in other webs. From any web you can refer to users located in the %WIKITOOLNAME%.Main web like `Main.UserName` or `%MAINWEB%.UserName`.
 
+### <a name="Contents of Directories"></a> Contents of Directories
+
 Here are contents of directories showing file permissions. Please note that this is for debugging reasons only and does not exactly reflect the distribution:
 
 Directory `twiki/bin` :
@@ -277,4 +281,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]] - 29 Dec 2000 <br />
+-- [[PeterThoeny]] - 16 Mar 2001 <br />