none
authorPeterThoeny <PeterThoeny>
Sat, 12 Feb 2000 07:26:51 +0000 (07:26 +0000)
committerPeterThoeny <PeterThoeny>
Sat, 12 Feb 2000 07:26:51 +0000 (07:26 +0000)
TWiki/TWikiDocumentation.mdwn
TWiki/TWikiHistory.mdwn

index bdd78a7..096f41f 100644 (file)
@@ -298,16 +298,19 @@ These installation steps use Apache web server on Linux as an example. TWiki sho
 
 **_Note:_** These installation notes 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.
 
-- Request the TWiki distribution (in Unix ZIP format) from <http://www.mindspring.net/~peterthoeny/twiki/index.html> .
+- Request the TWiki distribution (in Unix ZIP format) from <http://www.mindspring.com/~peterthoeny/twiki/> .
 - Create directory `/home/httpd/twiki` and unzip the TWiki distribution to this directory.
 - The `twiki/bin` directory of TWiki must be set as a cgi-bin directory. Add `/home/httpd/twiki/bin` to `/etc/httpd/conf/access.conf` with only `ExecCGI` option.
 - The `twiki/pub` directory of TWiki must be set so that it is visible as a URL. Add `/home/httpd/twiki/pub` to `/etc/httpd/conf/access.conf` with normal access options (copy from /home/httpd/html).
 - Now add `Alias` for `/twiki/pub` and `ScriptAlias` for `/twiki/bin` to `/etc/httpd/conf/srm-conf` .
 - Restart Apache by `/etc/rc.d/rc5.d/S85httpd restart` .
+- Make sure PERL and the PERL CGI library is installed on your system. Default location of PERL executable is `/usr/bin/perl` . In case PERL is installed in a different location, the first line of all perl scripts in the `twiki/bin` directory need to be changed (alternatively you can create a symbolic link from `/usr/bin/perl` ).
 - Test if the `twiki/bin` directory is cgi-enabled:
   - Enter the URL of that directory into your browser ( `http://your.domain.com/twiki/bin` ). It is not set correctly as cgi-bin in case you get something like `"Index of /twiki/bin"` . It is OK if you get a message like `"Forbidden. You don't have permission to access /twiki/bin/ on this server."`
   - Execute the `testenv` script from your browser ( `http://your.domain.com/twiki/bin/testenv` ). It should show a table of all CGI environment variables.
-- Make sure PERL and the PERL CGI library is installed on your system. Default location of PERL executable is `/usr/bin/perl` . In case PERL is installed in a different location, the first line of all perl scripts in the `twiki/bin` directory need to be changed (alternatively you can create a symbolic link from `/usr/bin/perl` ).
+- On systems where the Perl scripts require a file extension you need to:
+  - Rename all scripts in the `twiki/bin` directory to have a file extension, i.e. rename `view` to `view.cgi` .
+  - Specify this file extension in the `$scriptSuffix` variable in `twiki/bin/wikicfg.pm` .
 - To be able to edit the perl scripts and .tmpl files it is necessary to `chown` and `chgrp -R twiki` so all the files have the owner you want.
 - The scripts execute as `nobody` . Set the file permission of all Perl scripts in the `twiki/bin` directory as executable to `-rw-r-xr-x` .
 - Set the file permission of all files below `twiki/data` to 666 ( `-rw-rw-rw-` ).
@@ -315,7 +318,7 @@ These installation steps use Apache web server on Linux as an example. TWiki sho
 - Set the file permission of the `twiki/pub` directory to 777 ( `drwxrwxrwx` ).
 - Edit the file `twiki/bin/wikicfg.pm` and set the variables at the beginning of the file to your needs.
 - Make sure RCS is installed. In case RCS is not in the `path` environment variable, add it to `path` . Alternatively, add the full path name to the `rcs, ci, co, rlog, rcsdiff` commands in the variables of `twiki/bin/wikicfg.pm` .
-- Point your browser at <http://your.domain.com/twiki/bin/view> and start wiki-ing away!
+- Point your browser at `http://your.domain.com/twiki/bin/view` and start wiki-ing away!
 - Note in case cgi user is **_not_** `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` , or simply delete all the repository files.
 - 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)
 
@@ -499,4 +502,4 @@ directory `twiki/pub/icn/` :
     -rw-r--r-- 1 twiki  t5                             152 Mar 27 03:17 xls.gif
     -rw-r--r-- 1 twiki  t5                             144 Mar 27 03:17 zip.gif
 
--- [[PeterThoeny]] - 22 Oct 1998 <br /> -- [[PeterThoeny]] - 18 Nov 1998 <br /> -- [[PeterThoeny]] - 11 Jan 1999 <br /> -- [[PeterThoeny]] - 20 Jan 1999 <br /> -- [[PeterThoeny]] - 06 Mar 1999 <br /> -- [[PeterThoeny]] - 27 Mar 1999 <br /> -- [[PeterThoeny]] - 02 Jun 1999 <br /> -- [[PeterThoeny]] - 14 Jun 1999 <br /> -- [[PeterThoeny]] - 23 Jun 1999 <br /> -- [[PeterThoeny]] - 01 Sep 1999 <br /> -- [[PeterThoeny]] - 29 Sep 1999 <br /> -- [[PeterThoeny]] - 14 Jan 2000 <br /> -- [[PeterThoeny]] - 02 Feb 2000 <br /> -- [[PeterThoeny]] - 04 Feb 2000 <br />
+-- [[PeterThoeny]] - 11 Feb 2000 <br />
index 8d6ba16..a8abcb2 100644 (file)
@@ -57,6 +57,8 @@
 - [[PeterThoeny]] - 04 Feb 2000: Access statistics. Each web has a [[WebStatistics]] topic that shows monthy statistics with number of topic views and changes, most popular topics, and top contributors. (It needs to be enabled, [[TWikiDocumentation]] has more.)
 - [[PeterThoeny]] - 07 Feb 2000: Inline search. New variable `%SEARCH{"str" ...}%` to show a search result embedded in a topic text. [[TWikiVariables]] has more on the syntax. Inline search combined with the category table feature can be used for example to create a simple bug tracking system.
 - [[PeterThoeny]] - 07 Feb 2000: Changed the syntax for server side include variable from `%INCLUDE:"filename.ext"%` to `%INCLUDE{"filename.ext"}%` . (Previous syntax still supported. Change was done because of inline search syntax)
+- [[PeterThoeny]] - 11 Feb 2000: New variable `%SCRIPTURLPATH%` / $scriptUrlPath containing the script URL without the domain name. Templates have been changed to use this variable instead of `%SCRIPTURL%` . This is for performance reasons.
+- [[PeterThoeny]] - 11 Feb 2000: New variable `%SCRIPTSUFFIX%` / $scriptSuffix containing an optional file extension of the TWiki Perl script. Templates have been changed to use this variable. This allows you to rename the Perl script files to have a file extension like for example ".cgi".
 
 **Related Topics**
 
@@ -64,4 +66,4 @@
 - [[TWikiPlannedFeatures]] has a list of planned features.
 - [[TWikiEnhancementRequests]] is the place where you can add your enhancement requests.
 
--- [[PeterThoeny]] - 07 Feb 2000 <br />
+-- [[PeterThoeny]] - 11 Feb 2000 <br />