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
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.
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
projects / citadel.git / blobdiff