diff options
| author | MikeMannix <MikeMannix> | 2001-08-31 10:55:02 +0000 |
|---|---|---|
| committer | MikeMannix <MikeMannix> | 2001-08-31 10:55:02 +0000 |
| commit | 5638f3a8b639b47fa83669460b86117cc9b75cba (patch) | |
| tree | 0fde29c05c45adb02edd181bf107c60296235b08 /TWiki/TWikiInstallationGuide.mdwn | |
| parent | a80028079082df95c541b5968828b380d515cb43 (diff) | |
none
Diffstat (limited to 'TWiki/TWikiInstallationGuide.mdwn')
| -rw-r--r-- | TWiki/TWikiInstallationGuide.mdwn | 69 |
1 files changed, 9 insertions, 60 deletions
diff --git a/TWiki/TWikiInstallationGuide.mdwn b/TWiki/TWikiInstallationGuide.mdwn index 376d405f..916d566f 100644 --- a/TWiki/TWikiInstallationGuide.mdwn +++ b/TWiki/TWikiInstallationGuide.mdwn @@ -1,6 +1,6 @@ %TOC% %STARTINCLUDE% -## <a name="TWiki_Installation_Notes"> TWiki Installation Notes </a> +## <a name="TWiki_Installation_Guide"> TWiki Installation Guide </a> 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> ) @@ -88,11 +88,11 @@ Read <http://TWiki.org/cgi-bin/view/Codev/SourceForgeHowTo> in case you want to * Enable email notification of topic changes, [[TWikiDocumentation]] 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 %MAINWEB%.WebHome topic. -### <a name="Add_New_Rendering_Rules_amp_Vari"> Add New Rendering Rules & Variables </a> +### <a name="Adding_Variables_amp_Rendering_R"> Adding Variables & Rendering Rules </a> * 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` . -### <a name="Enable_Basic_Authentication_htac"> Enable Basic Authentication (.htaccess) </a> +### <a name="Enabling_Basic_Authentication_ht"> Enabling Basic Authentication (.htaccess) </a> * Optional: If you are on a non authenticated server (i.e. not using SSL) and you would like to authenticate users: * Rename file `.htaccess.txt` in the `twiki/bin` directory to `.htaccess` and change it to your needs. For details consult the HTTP server documentation (for Apache server: [[1]](http://www.apache.org/docs/mod/directives.html), [[2]](http://www.mcs.kent.edu/system/web_help/htaccess/introduction.html)). In particular, the following <font>red</font> part needs to be configured correctly: <br /><code>Redirect <font>/urlpath/to/TWiki/index.html</font> http://<font>your.domain.com/urlpath/to/TWiki/bin/</font>view</code><br /><code>AuthUserFile <font>/filepath/to/TWiki/data/</font>.htpasswd</code><br /><code>ErrorDocument 401 <font>/urlpath/to/TWiki/bin/</font>oops/TWiki/TWikiRegistration?template=oopsauth</code> @@ -101,7 +101,7 @@ Read <http://TWiki.org/cgi-bin/view/Codev/SourceForgeHowTo> in case you want to * **_Note:_** You can customize the registration form if needed, like deleting or adding input tags. The `name=""` parameter of the input tags must start with: `"Twk0..."` (if this is an optional entry), or `"Twk1..."` (if this is a required entry). This will ensure that the fields are processed correctly. * A new line containing user name and encrypted password gets added to the `data/.htpasswd` file when a users registers. The file that comes with the TWiki installation contains a few user accounts of TWiki core team members (needed for testing). You can edit the file and delete those lines. -### <a name="Generate_Site_Usage_Statistics"> Generate Site Usage Statistics </a> +### <a name="Generating_Site_Usage_Statistics"> Generating Site Usage Statistics </a> * Optional: You can automatically generate usage statistics for all webs. To enable this: * Make sure variable `$doLogTopicView, $doLogTopicSave and $doLogTopicUpload` in `wikicfg.pm` are set. This will generate log entries in file `twiki/data/log<date>.txt` . @@ -116,7 +116,7 @@ Read <http://TWiki.org/cgi-bin/view/Codev/SourceForgeHowTo> in case you want to <a name="CreateWeb"></a> -### <a name="Create_a_New_Web"> Create a New Web </a> +### <a name="Creating_a_New_Web"> Creating a New Web </a> * To create a new web: * Use a name for the web consisting of characters `A..Z` , `a..z` but **not** in [[WikiNotation]]. @@ -135,9 +135,9 @@ Read <http://TWiki.org/cgi-bin/view/Codev/SourceForgeHowTo> in case you want to * 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%.%MAINWEB% 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%.%MAINWEB% web like <code>%MAINWEB%.UserName</code> or <code>%MAINWEB%.UserName</code>. -### <a name="Contents_of_Directories"> Contents of Directories </a> +### <a name="TWiki_File_System_Snapshot"> TWiki File System Snapshot </a> -Here are contents of directories showing file permissions. Please note that this is for debugging reasons only and does not exactly reflect the distribution: +Here are partial directory listings showing typical file permissions and ownership. This is provided for general debugging use only and isn't an exact representation of the current distribution. There is also a complete file [[TWiki/TWikiImplementationNotes]], with individual file descriptions, for the current TWiki release. Directory `twiki/bin` : @@ -160,12 +160,6 @@ 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 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/` : @@ -189,18 +183,6 @@ Directory `twiki/templates/` : -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 -rw-rw-r-- 1 twiki twiki 955 Mar 8 11:41 oopsregpasswd.tmpl - -rw-rw-r-- 1 twiki twiki 966 Mar 8 11:41 oopsregrequ.tmpl - -rw-rw-r-- 1 twiki twiki 1244 Apr 28 17:11 oopsregthanks.tmpl - -rw-rw-r-- 1 twiki twiki 1003 Jul 22 12:48 oopsregwiki.tmpl - -rw-rw-r-- 1 twiki twiki 1607 Mar 8 11:42 oopsrev.tmpl - -rw-rw-r-- 1 twiki twiki 949 Mar 8 11:43 oopsupload.tmpl - -rw-rw-r-- 1 twiki twiki 1735 Aug 15 18:14 preview.tmpl - -rw-rw-r-- 1 twiki twiki 1682 Aug 15 18:14 rdiff.tmpl - -rw-rw-r-- 1 twiki twiki 530 Jul 22 12:10 register.tmpl - -rw-rw-r-- 1 twiki twiki 690 Apr 28 16:53 registernotify.tmpl - -rw-rw-r-- 1 twiki twiki 1900 Aug 15 18:15 search.tmpl - -rw-rw-r-- 1 twiki twiki 1785 Aug 15 18:15 searchbookview.tmpl - -rw-rw-r-- 1 twiki twiki 1559 Aug 19 02:53 view.tmpl Directory `twiki/data/` : @@ -213,7 +195,7 @@ Directory `twiki/data/` : -rw-rw-rw- 1 twiki twiki 1 Mar 11 04:19 debug.txt -rw-r--r-- 1 nobody nobody 1516 Aug 20 17:56 log200008.txt -Part of directory `twiki/data/Main` : +Partial file list for `twiki/data/Main` : drwxrwxrwx 2 nobody nobody 4096 Aug 19 04:15 . drwxrwxrwx 6 nobody nobody 4096 Aug 3 01:09 .. @@ -229,16 +211,6 @@ Part of directory `twiki/data/Main` : -r--r--r-- 1 nobody nobody 284 Aug 19 03:06 WebChanges.txt,v -rw-r--r-- 1 nobody nobody 1853 Aug 18 18:08 WebHome.txt -r--r--r-- 1 nobody nobody 6523 Aug 18 18:08 WebHome.txt,v - -rw-r--r-- 1 nobody nobody 56 Aug 18 17:21 WebIndex.txt - -r--r--r-- 1 nobody nobody 245 Aug 18 17:21 WebIndex.txt,v - -rw-r--r-- 1 nobody nobody 495 Aug 18 17:40 WebNotify.txt - -r--r--r-- 1 nobody nobody 1896 Aug 18 17:40 WebNotify.txt,v - -rw-r--r-- 1 nobody nobody 1904 Aug 19 01:01 WebPreferences.txt - -r--r--r-- 1 nobody nobody 3108 Aug 19 01:01 WebPreferences.txt,v - -rw-r--r-- 1 nobody nobody 5553 Aug 19 02:30 WebSearch.txt - -r--r--r-- 1 nobody nobody 8406 Aug 19 02:30 WebSearch.txt,v - -rw-r--r-- 1 nobody nobody 729 Aug 18 17:41 WebStatistics.txt - -r--r--r-- 1 nobody nobody 1129 Aug 18 17:41 WebStatistics.txt,v Directory `twiki/pub/` : @@ -256,7 +228,7 @@ Directory `twiki/pub/` : -rw-rw-r-- 1 twiki twiki 6710 Oct 5 1999 twikilogo4.gif -rw-rw-r-- 1 twiki twiki 2877 Jun 7 1999 wikiHome.gif -Directory `twiki/pub/icn/` : +Partial file list for `twiki/pub/icn/` : drwxrwxr-x 2 twiki twiki 4096 Jun 17 16:35 . drwxrwxrwx 6 nobody nobody 4096 Aug 3 01:21 .. @@ -266,28 +238,5 @@ Directory `twiki/pub/icn/` : -rw-rw-r-- 1 twiki twiki 141 Mar 25 1999 c.gif -rw-rw-r-- 1 twiki twiki 144 Mar 9 1999 dll.gif -rw-rw-r-- 1 twiki twiki 152 Mar 9 1999 doc.gif - -rw-rw-r-- 1 twiki twiki 130 Mar 9 1999 else.gif - -rw-rw-r-- 1 twiki twiki 876 Mar 26 1999 exe.gif - -rw-rw-r-- 1 twiki twiki 147 Mar 9 1999 fon.gif - -rw-rw-r-- 1 twiki twiki 142 Mar 25 1999 h.gif - -rw-rw-r-- 1 twiki twiki 156 Mar 9 1999 hlp.gif - -rw-rw-r-- 1 twiki twiki 186 Mar 9 1999 html.gif - -rw-rw-r-- 1 twiki twiki 144 Mar 25 1999 java.gif - -rw-rw-r-- 1 twiki twiki 148 Mar 9 1999 mov.gif - -rw-rw-r-- 1 twiki twiki 150 Mar 9 1999 pdf.gif - -rw-rw-r-- 1 twiki twiki 146 Mar 25 1999 pl.gif - -rw-rw-r-- 1 twiki twiki 150 Mar 9 1999 ppt.gif - -rw-rw-r-- 1 twiki twiki 148 Mar 25 1999 ps.gif - -rw-rw-r-- 1 twiki twiki 148 Mar 25 1999 py.gif - -rw-rw-r-- 1 twiki twiki 130 Mar 9 1999 ram.gif - -rw-rw-r-- 1 twiki twiki 154 Mar 9 1999 reg.gif - -rw-rw-r-- 1 twiki twiki 147 Mar 25 1999 sh.gif - -rw-rw-r-- 1 twiki twiki 155 Mar 9 1999 sniff.gif - -rw-rw-r-- 1 twiki twiki 149 Mar 9 1999 ttf.gif - -rw-rw-r-- 1 twiki twiki 134 Mar 9 1999 txt.gif - -rw-rw-r-- 1 twiki twiki 154 Mar 9 1999 wav.gif - -rw-rw-r-- 1 twiki twiki 152 Mar 9 1999 wri.gif - -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]] - 16 Mar 2001 <br /> |