From: PeterThoeny Date: Sun, 12 Nov 2000 08:54:34 +0000 (+0000) Subject: none X-Git-Url: https://git.openafs.org/?p=openafs-wiki.git;a=commitdiff_plain;h=76a6517ae1d6a8bf2e3119f69cff93f095b75ed2 none --- diff --git a/TWiki/ManagingWebs.mdwn b/TWiki/ManagingWebs.mdwn index 336d216..062bf69 100644 --- a/TWiki/ManagingWebs.mdwn +++ b/TWiki/ManagingWebs.mdwn @@ -1,29 +1,29 @@ -The current implementation of TWiki is designed to never forget, that means all topic changes are under revision control and you can't delete or rename topics. +The current implementation of %WIKITOOLNAME% is designed to never forget, that means all topic changes are under revision control and you can't delete or rename topics. -Nevertheless there are cases where you wish to delete topics. TWiki requires administrative stuff like that to be done on the shell level, so please ask your TWiki administrator to do that for you. A future version will allow administrators to do that on the browser level. +Nevertheless there are cases where you wish to delete topics. %WIKITOOLNAME% requires administrative stuff like that to be done on the shell level, so please ask your %WIKITOOLNAME% administrator to do that for you. A future version will allow administrators to do that on the browser level. **How to Rename or Delete a Topic** - Go to the topic you want to rename / delete. -- Find out the back-links to this page from _Ref-By_ . Modify other topics if needed. **_Note:_** _Ref-By_ only finds topics in the current web. Search also in other webs if needed. -- Telnet to the TWiki installation. +- Find out the back-links to this page from _Ref-By_ . Modify other topics if needed. +- Telnet to the %WIKITOOLNAME% installation. - cd to `twiki/data` and then to the web where the topic is located. Rename / delete the topic ( `name.txt` ) and repository file ( `name.txt,v` ). **_Hint:_** Instead of deleting a topic you could create a `Trash` web and move topics/repositories to this web. (A future version of TWiki might have a Trash web.) - Edit the `.changes` file and rename / delete all occurrences of the topic. **_Note:_** There might be several lines of the topic. - cd to `twiki/pub` and then to the web where the topic is located. Rename / delete the topic attachment directory if present. **How to add a New Web** -- See [[TWikiImplementationNotes]]. +- See [[TWikiInstallationNotes]]. **How to Rename or Delete a Web** -- It is advisable not to rename the TWiki.Main web. -- Be aware that other webs might link to the web you want to rename / delete. Search each web for links to this web, i.e. in each web search for `Obsolete.` (including the period, this is to find topics like `Obsolete.SomeTopic` ). Take measures if necessary. +- It is advisable not to rename the %WIKITOOLNAME%.Main web. +- Be aware that other webs might link to the web you want to rename / delete. Search each web for links to this web, i.e. search all webs for `Obsolete.` (include the period, this is to find topics like `Obsolete.SomeTopic` ). Take measures if necessary. - Edit the [[TWikiPreferences]] topic and rename / delete the web from the `WIKIWEBLIST` variable. - Edit the [[TWikiWebsTable]] topic and rename / delete the web from the table. -- Telnet to the TWiki installation. +- Telnet to the %WIKITOOLNAME% installation. - cd to `twiki/data` and rename / delete the web directory. -- cd to `twiki/templates` and rename / delete the web directory. +- cd to `twiki/templates` and rename / delete the web directory if present. - cd to `twiki/pub` and rename / delete the web directory if present. --- [[PeterThoeny]] - 01 May 2000
+-- [[PeterThoeny]] - 12 Nov 2000
diff --git a/TWiki/TWikiInstallationGuide.mdwn b/TWiki/TWikiInstallationGuide.mdwn index b464f9c..deaf64c 100644 --- a/TWiki/TWikiInstallationGuide.mdwn +++ b/TWiki/TWikiInstallationGuide.mdwn @@ -1,6 +1,45 @@ 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 ) -**_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. +**_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. + +**_Note:_** Below installation steps assume that you have control over the web server configuraton files. In case you don't (i.e. if you are installing it on a hosted server) follow the steps but use these directories instead: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TWiki dir: What it is: Where to copy: Example:
twiki/bin CGI bin cgi-bin enabled dir /home/smith/public_html/cgi-bin/twiki
twiki/pub public files htdoc enabled dir /home/smith/public_html/pub
twiki/data topic data outside of htdoc tree (for security) /home/smith/twiki/data
twiki/templates web templates outside of htdoc tree (for security) /home/smith/twiki/templates
+ +Read in case you wnat to install TWiki on SourceForge. + +Installation steps: - Request the TWiki distribution (in Unix ZIP format) from . - Create directory `/home/httpd/twiki` and unzip the TWiki distribution into this directory. @@ -32,6 +71,10 @@ These installation steps use the Apache web server on Linux as an example. TWiki - 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. Set `$rcsDir` in `twiki/bin/wikicfg.pm` to mach the location of your RCS binaries. - Point your browser at and start TWiki-ing away! +- Note in case the cgi scripts must have a file extension like `.pl` or `.cgi`: + - Add the extension to all the scripts (except for the `.pm` ones) in `twiki/bin` + - Edit `wikicfg.pm` and set the file extension in the `$scriptSuffix` variable. + - 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:
`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.