X-Git-Url: https://code.citadel.org/?a=blobdiff_plain;f=webcit%2FREADME.txt;h=aa8f6061fddcc2af4e0a05eafd855431d6eb015d;hb=HEAD;hp=c1849eb6f5b365d5d85ebe061417fa478b38c536;hpb=29dc83a8cc10b718f31a92f844086adffcc967fe;p=citadel.git diff --git a/webcit/README.txt b/webcit/README.txt index c1849eb6f..aa8f6061f 100644 --- a/webcit/README.txt +++ b/webcit/README.txt @@ -1,6 +1,6 @@ WEBCIT for the Citadel System - Copyright (C) 1996-2010 by the authors. Portions written by: + Copyright (C) 1996-2012 by the authors. Portions written by: Art Cancro Wilfried Goesgens @@ -13,9 +13,10 @@ Dave Lindquist Matt Pfleger Martin Mouritzen + Stefan Garthe This program is open source software released under the terms of the GNU - General Public License, version 3. Please read COPYING.txt for more + General Public License, version 3. Please read COPYING.txt for more licensing information. WebCit bundles the Prototype JavaScript Framework, writen by Sam @@ -31,6 +32,10 @@ is licensed to you under the terms of the GNU Lesser General Public License. + Most of our Icons are taken from the "Essen" set by the people on + http://pc.de/icons/. We like to thank them for their astonishing work! + Their site explicitly states: "Free for commercial use as well." + One or more icons are from Milosz Wlazlo [http://miloszwl.deviantart.com] whose license explicitly allows inclusion in open source projects on the condition of this attribution. @@ -46,9 +51,9 @@ Citadel is a sophisticated groupware platform which allows multiple users to simultaneously access the system using a variety of user interfaces. -This package (WebCit) is a "middleware" package which presents an HTML/HTTP -user interface to the Citadel system. - +This package (WebCit) is a web based front end and user interface to the +Citadel system. + What this means in practice is that after you've installed WebCit, users can access all functions of your system using any web browser. Since this may be the first Citadel experience for many new users, the screens have been designed @@ -58,7 +63,7 @@ to be attractive and easy to navigate. INSTALLATION ------------ - Unline some web-based packages, WebCit contains its own standalone HTTP + Unlike some web-based packages, WebCit contains its own standalone HTTP engine. As a result, you can get it running quickly without all that tedious mucking about with Apache configuration files and directories. WebCit is not intended to be a general-purpose web server, however -- it *only* provides a @@ -91,7 +96,7 @@ specified, such as: ...and log in. The included "setup" program is basically just an installation helper that -asks a series of questions and then adds the appropriate line to inittab to +asks a series of questions and then adds the appropriate init files to start WebCit. For most installations, this will do just fine. If you have special circumstances, or if you'd prefer to configure WebCit manually, you may skip the setup program. Instead, open /etc/inittab and add an entry @@ -103,12 +108,14 @@ something like this: Several command-line options are also available. Here's the usage for the "webcit" program: - webcit [-i ip_addr] [-p http_port] [-s] [-S cipher_suite] [-t tracefile] + webcit [-i ip_addr] [-p http_port] [-s] [-S cipher_suite] + [-g guest_landing_page] [-c] [-f] [remotehost [remoteport]] *or* - webcit [-i ip_addr] [-p http_port] [-s] [-S cipher_suite] [-t tracefile] + webcit [-i ip_addr] [-p http_port] [-s] [-S cipher_suite] + [-g guest_landing_page] [-c] [-f] uds /your/citadel/directory Explained: @@ -127,8 +134,11 @@ the "webcit" program: different port. If you do not specify a port number, WebCit will attempt to use port 80. - -> tracefile: where you want WebCit to log to. This can be a file, a - virtual console, or /dev/null to suppress logging altogether. + -> The "guest landing page" is a location on your WebCit installation where + unauthenticated guest users are taken when they first enter the root of + your site. If guest mode is not enabled on your Citadel server, they will + be taken to a login page instead. If guest mode is enabled but no landing + page is defined, they will be taken to the Lobby. -> The "-c" option causes WebCit to output an extra cookie containing the identity of the WebCit server. The cookie will look like this: @@ -250,7 +260,7 @@ virtual host through to WebCit. The alternative way, which does work but is not quite as robust, is to "mount" the WebCit paths as directory aliases to your main document root. -Here is how to configure the NameVirtualHost method: +Here is how to configure the NameVirtualHost method (recommended) : #here some of your config stuff like logging, serveradmin... @@ -265,7 +275,7 @@ Here is how to configure the NameVirtualHost method: alias /static /var/lib/citadel/www/static -Here is how to configure the "subdirectory" method: +Here is how to configure the "subdirectory" method (not recommended) : #here some of your config stuff like logging, serveradmin... @@ -291,14 +301,11 @@ Here is how to configure the "subdirectory" method: ProxyPassReverse /groupdav/ http://127.0.0.1:2000/groupdav/ ProxyPass /who_inner_html http://127.0.0.1:2000/who_inner_html ProxyPassReverse /who_inner_html http://127.0.0.1:2000/who_inner_html -# The following line is optional. It allows WebCit's static content -# such as images to be served directly by Apache. - alias /static /var/lib/citadel/www/static - ADVANCED CONFIGURE OPTIONS - -------------------------- + ADVANCED CONFIGURATION OPTIONS + ------------------------------ If you are building packages and prefer not to have WebCit reside entirely in a single directory, there are several compile-time options available. @@ -324,5 +331,5 @@ bin: the binaries. ---------- That's all you need to know to get started. If you have any questions or -comments, please visit UNCENSORED! BBS, the home of Citadel, at -http://uncensored.citadel.org - and go to the "Citadel Support" room. +comments, visit the Citadel Support room on UNCENSORED! BBS, the home of Citadel: +http://uncensored.citadel.org/dotgoto?room=Citadel%20Support