WEBCIT for the Citadel System
- Copyright (C) 1996-2011 by the authors. Portions written by:
+ Copyright (C) 1996-2012 by the authors. Portions written by:
Art Cancro
Wilfried Goesgens
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
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:
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:
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) :
<VirtualHost mydomain.com:443>
#here some of your config stuff like logging, serveradmin...
alias /static /var/lib/citadel/www/static
</VirtualHost>
-Here is how to configure the "subdirectory" method:
+Here is how to configure the "subdirectory" method (not recommended) :
<VirtualHost mydomain.com:443>
#here some of your config stuff like logging, serveradmin...
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
</VirtualHost>
----------
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