ruwiki 0.9.0

data/contrib/enscript-token.rb

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+#--
+# Ruwiki
+#   Copyright � 2002 - 2004, Digikata and HaloStatue
+#   Alan Chen (alan@digikata.com)
+#   Austin Ziegler (ruwiki@halostatue.ca)
+#
+# This token by Javier Fontan <jfontan@pc3d.cesga.es>.
+#
+# Licensed under the same terms as Ruby.
+#
+# $Id: enscript-token.rb,v 1.3 2004/09/27 04:48:27 austin Exp $
+#++
+
+require "open3"
+
+class Ruwiki::Wiki::CodeColor < Ruwiki::Wiki::Token
+  def self.rank
+    0
+  end
+
+  def self.regexp
+    %r<\{\{\{(?::(\w+)\b)?(.*?)\}\}\}>m
+  end
+
+  def replace
+    cap = @match.captures
+
+    if cap[0].nil?
+      language = "ruby"
+    else
+      language = cap[0]
+    end
+
+    text = cap[1]
+
+    i, o, e = Open3.popen3("enscript -B --color=emacs -Whtml -E#{language} -o -")
+    i.print text
+    i.close
+
+    re_script = %r{(<pre>.*?</pre>)}mio
+    c = o.readlines[1..-1].join("\n")
+    re_script.match(c).captures[0]
+  end
+
+  def self.post_replace(content)
+    content.gsub!(%r{<pre>\n}im, '<pre class="rwtk_CodeColor>')
+    content.gsub!(%r{\n</pre>}im, '</pre>')
+    content.gsub!(%r{<font color="(.+?)">}im, '<span style="color: \1">')
+    content.gsub!(%r{</font>}im, '</span>')
+    content.gsub!(%r{<B>}i, '<b>')
+    content.gsub!(%r{</B}i, '</b>')
+    content
+  end
+end

data/contrib/rublog_integrator.rb

@@ -0,0 +1,68 @@
+#--
+# Ruwiki
+#   Copyright � 2002 - 2003, Digikata and HaloStatue
+#   Alan Chen (alan@digikata.com)
+#   Austin Ziegler (ruwiki@halostatue.ca)
+#
+# Licensed under the same terms as Ruby.
+#
+# This integrator based on work by Chad Fowler.
+#
+# $Id: rublog_integrator.rb,v 1.3 2004/09/27 04:48:27 austin Exp $
+#++
+
+# NOTE: This is not currently compatible with Ruwiki 0.8.0
+#
+# require 'ruwiki/wiki/handler'
+
+class Ruwiki::RubLogHandler < Ruwiki::Wiki::Handler
+  def initialize(entries)
+    @entries = entries
+  end
+
+  def page_exists?(page, project)
+#   puts "pP: #{page}, #{project}"
+    matches = @entries.find_entries_with_root_name(page)
+    matches.each { |entry| return true if(entry.dir_name =~ /#{project}/) }
+    false
+  end
+
+  def project_exists?(project)
+    true
+  end
+
+  def script_url
+# request.environment['SCRIPT_NAME']
+# !!SMELL!!
+    ENV['SCRIPT_NAME']
+  end
+end
+
+  # An experimental convertor for Ruwiki
+class RuwikiConvertor < BaseConvertor
+  handles "wiki"
+
+  def get_title(f)
+    title = "---Untitled---"
+    loop do
+      line = f.gets
+      if(line =~ /^topic: (\S+)/) then
+        title = $1
+      elsif(line =~ /^\#EHDR/) then
+        return title
+      end
+    end
+  end
+
+  def convert_html(file_entry, f, all_entries)
+    title = get_title(f)
+    markup = Ruwiki::Wiki.new('Default', Ruwiki::RubLogHandler.new(all_entries))
+    body = markup.parse(f.readlines.join("\n"), file_entry.dir_name)
+    HTMLEntry.new(title, body, self)
+  end
+
+    # FIXME: Need to check this one
+  def convert_plain(file_name, f, all_entries)
+    f.read
+  end
+end

data/data/Default/ProjectIndex.ruwiki

@@ -0,0 +1,49 @@
+page!content:	= Ruwiki
+	Ruwiki is a simple, extensible Wiki written in Ruby. It supports both
+	CGI and \WEBrick interfaces, templates, and CSS formatting.
+	Additionally, it supports project namespaces, so that two pages can be
+	named the same for differing projects without colliding or odd naming
+	conventions. Please see the ::Ruwiki project for more information.
+	
+	Ruwiki is also an internationalised Wiki, although more testing,
+	especially testing with multibyte character encodings and Unicode
+	(UTF-8) is required. There are German and Spanish localisations of the
+	messages included with the Ruwiki distribution.
+	
+	The current version is 0.9.0. Enhancements and changes include:
+	* a deployment system, whereby Ruwiki deployments can be installed from a package manager like that used for RPA (rpa-base) or \RubyGems (see Ruwiki::RuwikiUtilities);
+	* support for Ruwiki as a Windows service on NT, 2000, XP, and 2003 systems;
+	* demotion of YAML and Marshal storage types to formats of the Flatfiles storage type;
+	* external user authentication (currently to \RubyForge only);
+	* antispam efforts including robot and IP exclusion and URL redirection (see Ruwiki::[[Antispam]]); and
+	* protection against cross-site scripting (XSS) attacks with HTML and CSS cleaning.
+	The full list of changes can be found in Ruwiki::ChangeLog, with
+	discussions of various features in Ruwiki::WikiMarkup,
+	Ruwiki::Configuring_Ruwiki, and Ruwiki::Extending_Ruwiki.
+	
+	If you are upgrading from a version of Ruwiki older than 0.8.0, please
+	read Ruwiki::RuwikiUtilities.
+	
+	Certain Ruwiki \APIs are considered stable at this point, others will
+	be changing leading up to 1.0. Some of this is discussed in
+	Ruwiki::To_Do, with further architectural discussions in
+	Ruwiki::[[Roadmap]].
+	
+	%projects()
+	
+	Please review ::Tutorial and ::Ruwiki if you are unfamiliar with the
+	concept of Wikis in general. If you want to play with \WikiFormatting
+	for Ruwiki, use the Ruwiki::SandBox.
+	
+	[http://rubyforge.org/projects/ruwiki Ruwiki development] is hosted at
+	[http://rubyforge.org RubyForge]. The current release of Ruwiki can
+	always be [http://rubyforge.org/frs/?group_id=84 downloaded] from
+	\RubyForge or the development (unstable) version can be obtained from
+	CVS.
+properties!project:	Default
+properties!title:	ProjectIndex
+properties!topic:	ProjectIndex
+properties!version:	1
+ruwiki!content-version:	2
+ruwiki!version:	0.9.0
+properties!editable:	false

data/data/Ruwiki/Antispam.ruwiki

@@ -0,0 +1,65 @@
+page!content:	= Ruwiki 0.9.0 Antispam
+	Wiki-spam, like email spam, is a major problem. Ruwiki is going to have
+	extensive configurable tools for fighting spam. As it is, there are
+	several tools built into Ruwiki to assist in the fight against these
+	pond scum, but the tool development is certainly not complete.
+	
+	== External URI Redirection
+	Although this will not greatly assist in the reduction of wiki spam,
+	all external \URIs are redirected through an URI on Google that is
+	designed specifically to remove \PageRank from links. The mechanism
+	currently works on all manually-specified external \URIs and is not
+	configurable without changing the URI tokenisation code. Thus, links
+	that are generated by \[ruby-talk:12345] will not be redirected through
+	Google, but direct links will be.
+	
+	In future versions of Ruwiki, it will be possible to configure \URIs to
+	be excluded from the redirect code, but it is not possible to do so at
+	this time.
+	
+	As noted, this will not necessarily reduce wiki spam, but it will deny
+	spammers the entire benefit of spamming a wiki implemented with Ruwiki.
+	
+	== Reacting to Spammers and Robots
+	Ruwiki 0.9.0 includes the ability to present alternative versions of
+	itself to certain user agents and/or IP addresses based on a list. In
+	the future, both the lists and the faces presented will be configurable
+	(highly configurable, at that -- watch this space), but in this version
+	of Ruwiki, there are three possible versions to be displayed:
+	# Normal Ruwiki. This is a normally displayable and editable wiki.
+	# Read-only Ruwiki. This is displayed to benign robots and users who have demonstrated that they cannot be trusted with edit access. The primary effect is to make command pages neither indexable, archivable, nor link-followable, and to remove certain links from visibility for these user agents.
+	# Forbidden Ruwiki. The user gets an HTTP response of 403 Forbidden. This is displayed to malign (email-collecting) robots and users who have demonstrated that they are malicious and bent upon defacing the wiki.
+	
+	While Ruwiki provides these lists, and provides an extensive list of
+	both malign and benign robots, it is up to the administrators of the
+	wiki to ensure that they are kept up to date.
+	
+	The lists themselves are “extended” Ruby regular
+	expressions, one optional expression to a line. Spaces are not
+	significant and comments are allowed. If you want to recognise a space
+	in your regular expression, do so either with a character class ([ ]) or
+	the whitespace meta-character (\s). Hash marks must be escaped (\#) or
+	they will be treated as comment markers. Blank or comment-only lines are
+	ignored. All other lines will be joined together.
+	
+	  foo
+	  bar
+	
+	becomes:
+	
+	  %r{foo|bar}x
+	
+	The file are stored in the data directory for the running instance of
+	Ruwiki (e.g., <tt>./data</tt>):
+	
+	  ./data/agents.banned
+	  ./data/agents.readonly
+	  ./data/hostip.banned
+	  ./data/hostip.readonly
+properties!project:	Ruwiki
+properties!title:	Antispam
+properties!topic:	Antispam
+properties!version:	1
+ruwiki!content-version:	2
+ruwiki!version:	0.9.0
+properties!editable:	false

data/data/Ruwiki/BugTracking.ruwiki

@@ -0,0 +1,33 @@
+page!content:	= Ruwiki 0.9.0 Bug Tracking
+	This page is for tracking bugs in Ruwiki. Only bugs from recent
+	distributions are tracked. In addition to this source-based bug
+	tracking, there is the [http://rubyforge.org RubyForge]
+	[http://rubyforge.org/tracker/?atid=407&group_id=84&func=browse bug
+	tracker] for Ruwiki.
+	
+	Those interested in Ruwiki development may also find the Ruwiki::To_Do
+	list and the Ruwiki::[[Roadmap]] useful. The format of the bug list is
+	“version: description”.
+	
+	== Open Bugs
+	The version number is the version in which the bug was first reported.
+	* 0.6.2: Not all formatting is applied consistently. The token rankings may need adjusting. Eivind Eklund has suggested a scheme that may help with this, but it will require architectural adjustment and will probably slow things down.
+	
+	----
+	== Closed Bugs
+	The version number is the version in which the bug was fixed.
+	* 0.9.0: Fixed a problem with old page edits being applied inappropriately.
+	* 0.8.0: [http://rubyforge.org/tracker/index.php?func=detail&aid=707&group_id=84&atid=407 Sub-Numbered bullets don’t increment]. Fixed a list numbering problem. I think that lists are a bit slower now, but they are completely accurate.
+	* 0.7.0: Fixed a link detection problem in \[wikiword] format. Thanks to [mailto:eivind@FreeBSD.org Eivind Eklund] for the patch.
+	* 0.7.0: Fixed a problem with <pre> paragraph detection and generation.
+	* 0.7.0: Fixed a problem with <p> generation.
+	* 0.7.0: [http://rubyforge.org/tracker/index.php?func=detail&aid=197&group_id=84&atid=407 Run-away ruby on some links in default distribution]. This may be related to a runaway header problem that was reported to me on IRC some time back that I believe has been fixed. Please advise.
+	* 0.6.1: Projects aren’t created appropriately.
+	* 0.6.1: Saving without editing (or repost) appears to cause problems. A fix has been applied to attempt to address this. Pages that have not been changed will not be saved.
+properties!project:	Ruwiki
+properties!title:	BugTracking
+properties!topic:	BugTracking
+properties!version:	1
+ruwiki!content-version:	2
+ruwiki!version:	0.9.0
+properties!editable:	false

data/data/Ruwiki/ChangeLog.ruwiki

@@ -0,0 +1,102 @@
+page!content:	= Ruwiki 0.9.0 ChangeLog
+	Uncompleted to-do items can be found in To_Do. Bugs in Ruwiki are
+	tracked in BugTracking.
+	
+	== 0.9.0
+	* Created a Ruwiki deployment system. Various steps were required to accomplish this:
+	** Moved executable files to bin/ for better packaging; moved core servlet code and other utilities to Ruwiki::Utils namespace.
+	** Renamed bin/convert to bin/ruwiki_convert. This will ultimately be moved into the ruwiki command.
+	** Refactored Flatfile format (section!\item:<Tab>value) to Ruwiki::Exportable, loosened the format restrictions to allow for either section!\item:<Tab>value or section!\item:<Space>value.
+	** Incorporated Ruwiki::Exportable into Ruwiki::Config to allow for the saving of configuration files.
+	** Incorporated Ruwiki::Exportable into Ruwiki::\Utils::ServletRunner to allow for the saving of configuration files.
+	** Added Ruwiki manager code for installation and management of Ruwiki deployments.
+	** Added code for running the Ruwiki servlet as a Windows service on Win32. (Currently minimally tested and unworking.)
+	** Added --central to bin/ruwiki_servlet, to run a read-only instance of Ruwiki using the centralised data from RPA or \RubyGems.
+	* Removed YAML and Marshal storage types as separate classes and incorporated them as formats of the Flatfiles storage type. Added the 'format' option to the Flatfiles storage_options hash.
+	* Added draft \APIs for authentication, robot exclusion, IP exclusion, and HTML cleaning.
+	** Implemented initial authentication for \RubyForge. It verifies a user against their current \RubyForge cookie.
+	** Implemented known robot list. It may require further refinement. It contains two classes of robots:
+	*** Read-only: known to be good (like the Googlebot) or neutral (most other crawlers). They are permitted to read, index, and follow links on all non-command pages.
+	*** Banned: known to be bad, essentially spam-crawlers. These robots will uniformly get a 403 Forbidden result.
+	** Implemented IP exclusion list. It may require further refinement. It contains two classes of IPs:
+	*** Read-only: IP addresses that are not permitted to edit the wiki. They will be treated as read-only robot exclusion.
+	*** Banned: known to be bad, essentially spam-crawlers. These IPs will uniformly get a 403 Forbidden result.
+	** HTML cleaning has been implemented.
+	*** HTML entities &amp;, &lt;, and &gt; will be escaped.
+	*** Only HTML tags and attributes from a &ldquo;known good&rdquo; list will be passed through unchanged. 
+	*** CSS properties display and visibility will be silently eliminated from embedded HTML.
+	*** Although (mostly) valid XHTML is generated, Ruwiki does not currently support tags or attributes in namespaces. If and when this is enabled, it will be enabled on a namespace-by-namespace basis.
+	* External URLs are redirected through a single point through the Google PageRank remover URI \http://www.google.com/url?sa=D&q=<em>uri</em>. There is no whitelisting for URIs at this point.
+	* Added a Rakefile for packaging. Currently incomplete.
+	* Modified the default template style to remove the bottom control bar, as it was blocking the last bit of text on some pages in lesser browsers.
+	* Updated more documentation.
+	* Added a message facility so that non-error messages can be communicated to the user.
+	* Fixed a bug with submitting an old version of the code with an expired lock reverting changes. The changed versions are now merged automatically and re-presented to the user. It's a simplistic merge, to be improved in a later version of Ruwiki. A message is displayed to the user.
+	* Modified searching for empty strings so that instead of throwing an error, a message is displayed to the user.
+	
+	== 0.8.0
+	* AC: Added topic list (_topics) and project list (_projects) controls on templates and backend.
+	* AZ: Added %topics() and %projects() tokens. See WikiMarkup for details.
+	* AC: Added simple search on back-end (both project and global); search strings must be validated and cleansed before being sent to the back-end (the back-end must prepare the string for its own search mechanism). The back-end is wholly responsible for the searching of the pages.
+	* AC: Added \RecentChanges list to backend and controls.
+	* AZ: Changed default for Ruwiki::Config#storage_options[:flatfiles][:extension] to <tt>ruwiki</tt>.
+	* AZ: Topic backlink search: searches for mentions of the topic in the other topics of the project.
+	* AZ: New templating engine: The Rdoc templating engine has been greatly enhanced in preparation for some changes that will happen surrounding antispam capabilities.
+	* AZ: Multiple flatfile-based backend support: tagged file (&ldquo;flatfiles&rdquo;), YAML (&ldquo;yaml&rdquo;), and Marshal (&ldquo;marshal&rdquo;).
+	* AZ: A converter utility between backends.
+	* AZ: Defined a canonical, extensible page transport format.
+	* AZ: Defined a canonical, format-independent diff format.
+	* AZ: Fixed list numbering problem. Modified lists to allow for mixed lists. See WikiMarkup for restrictions.
+	* AZ: Removed automatic image conversion for \URIs that look like images. Now, images must be specified with the \[image:uri] format. See WikiMarkup for more details.
+	* AZ: Fixed minor bugs in several tokens.
+	* AZ: New look! Ruwiki now sports a new default look with CSS and template changes.
+	* AZ: New look! Ruwiki has a &ldquo;simple&rdquo; template set.
+	* AZ: New look! Ruwiki has a &ldquo;sidebar&rdquo; template set.
+	* AZ: Fixed a long-standing bug with code tokens.
+	
+	== 0.7.0
+	* Changed the tokenization API so that the #post_replace call is made at the Token class level instead of the instance level.
+	* Improved HTML code generation.
+	* Added servlet runner batch files for Windows. They <strong>will</strong> require modification to run properly.
+	* Added %calendar(...) support. See WikiMarkup for more information.
+	
+	== 0.6.2
+	* Removed dependencies on Ruwiki from a number of classes (Ruwiki::Backend, Ruwiki::Backend::Flatfiles, Ruwiki::Page, Ruwiki::Wiki, Ruwiki::Wiki::Tokens, and various tokens).
+	* Ruwiki now initializes a \Ruwiki::BackendDelegator, which creates the requisite Ruwiki::Backend instance with Ruwiki::Config#storage_options.
+	* Added German (Christian Neukirchen &lt;cneukirchin@yahoo.de&gt;) and Spanish translations (Mauricio Fern�ndez &lt;batsman.geo@yahoo.com&gt;).
+	
+	== 0.6.1
+	* Changed Ruwiki::Config#data_path to Ruwiki::Config#storage_options[:flatfiles][:data_path]. This represents a generalisation of storage type options so that the Ruwiki::Config object is not polluted with storage type options. Ruwiki::Config#storage_options keys should be the same Ruby Symbol as is used in Ruwiki::Config#storage_type.
+	* Added Ruwiki::Config#storage_options[:flatfiles][:extension], based on a request by Chad Fowler. This allows you to have Project/\TopicFile actually stored as Project/\TopicFile.wiki if Ruwiki::Config#storage_options[:flatfiles][:extension] is set to <tt>wiki</tt>. The default for Ruwiki::Config#storage_options[:flatfiles][:extension] is <tt>nil</tt>.
+	* Fixed incorrect references. I had been incorrectly attributing [http://sourceforge.net/projects/rdoc-wiki RDoc Wiki] to Dave Thomas. \RDoc Wiki is by Michael Neumann. However, the project I pulled from <strong>is</strong> by Dave Thomas, but it&rsquo;s [http://sourceforge.net/projects/rublog RubLog]. Apologies to both developers.
+	* Added RuwikiTemplatingLibrary documentation.
+	* Internationalized messages, except for the templating library.
+	* Added configuration API for future work surrounding features. The existing wiki is mostly feature complete. Additional features (such as access controls) will be added through the feature interface.
+	* Fixed project creation.
+	* Fixed problems with \WikiWord links.
+	* Added Wikipedia-style Wiki links (\[[list of words]]).
+	* Fixed a potential problem with re-posted data or saving without editing.
+	* Added the ability to put commands in the URL.
+	
+	== 0.6.0
+	* Added Ruby mailing list reference support (e.g., \[ruby-talk:12345]).
+	* Reorganised the code (again) to better support alternative frontends. Based, in part, on [http://sourceforge.net/projects/rublog RubLog] by Dave Thomas. (Reference corrected in 0.6.1.)
+	* Added a [http://www.webrick.org WEBrick] servlet interface. Based, in part, on the \WEBrick servlet interface provided with \RubLog by Chad Fowler.
+	* Added templates, using the [http://rdoc.sourceforge.net RDoc] template.rb library.
+	* Changed the default topic to be \ProjectIndex instead of \DefaultProject.
+	* Added a new \WikiWord format, \Wiki_Word_with_Spaces.
+	* Completed lots of Ruwiki documentation.
+	* Updated the save page.
+	* Fixed a problem with the linking of project specific pages.
+	
+	== 0.5.0
+	* Reorganized the code significantly to be easier to edit and extend.
+	* Added abbreviation capabilities.
+	* Cleaned up a lot of tokenizing code.
+properties!project:	Ruwiki
+properties!title:	ChangeLog
+properties!topic:	ChangeLog
+properties!version:	1
+ruwiki!content-version:	2
+ruwiki!version:	0.9.0
+properties!editable:	false

data/data/Ruwiki/Configuring_Ruwiki.ruwiki

@@ -0,0 +1,151 @@
+page!content:	= Configuring Ruwiki 0.9.0
+	Ruwiki is configured similarly as both a CGI and a \WEBrick servlet.
+	The biggest distinction is that because the Wiki servlet is created
+	after the \WEBrick server is created (during the dispatch to the
+	servlet), it is necessary to configure the wiki with a global
+	Ruwiki::Config object stored in Ruwiki::Servlet.config. This must be a
+	valid Ruwiki::Config object. In the examples below,
+	<em>wiki.config</em> may be simply considered a random Ruwiki::Config
+	object.
+	
+	> This has changed in Ruwiki 0.9.0 from a global configuration object
+	> named $config.
+	
+	: Additional configuration options will be added from time to time. The
+	: form for specifying configuration may be changed prior to 1.0.
+	
+	If you are looking for discussion on templates, this has been moved to
+	Extending_Ruwiki.
+	
+	== Ruwiki Configuration Options
+	=== wiki.config.title
+	This configuration option names the Wiki; by default this is
+	<tt>Ruwiki</tt>. This affects the display of the home link and the
+	&lt;title&gt; element of pages.
+	
+	=== wiki.config.webmaster
+	The email address for the webmaster. This is used in generating error
+	reports that can be emailed to the wiki&rsquo;s webmaster.
+	
+	=== wiki.config.language
+	This sets the internationalisation mechanism. It must be one of the
+	known two-letter ISO language codes or a module under Ruwiki::Lang
+	matching that description. See Extending_Ruwiki for more information.
+	Ruwiki's default language is English ('en'), but there are translations
+	for Spanish ('es') and German ('de') included. Localization is
+	currently per wiki instance. In a servlet environment, this may mean
+	that only a single language is recognised.
+	
+	=== wiki.config.default_page, wiki.config.default_project
+	These options indicate what will happen when the wiki&rsquo;s URL is
+	specified without any parameters (the default page in the default
+	project is opened), when a topic is specified without a project (the
+	topic is opened in the default project), and when a project is
+	specified without a topic (the default page is opened in the project).
+	
+	=== wiki.config.storage_type, wiki.config.storage_options
+	<tt>wiki.config.storage_type</tt> specifies the back-end storage
+	mechanism as a Ruby Symbol. Currently, <tt>'flatfiles'</tt>,
+	is supported. See Extending_Ruwiki for more information.
+	
+	<tt>wiki.config.storage_options</tt> is a hash of option hashes for
+	each known storage type known to the Wiki. This must use the same
+	Symbol as <tt>wiki.config.storage_type</tt> as the top-level hash key.
+	
+	==== ...storage_options['flatfiles']['data-path']
+	The directory in which the wiki files will be found. By default, this
+	is &ldquo;<tt>./data/</tt>&rdquo;.
+	
+	==== ...storage_options['flatfiles']['format']
+	Specifies the storage format for the flatfiles backend. The default
+	format is 'exportable', but may be set to 'yaml' or 'marshal' as well.
+	The 'yaml' format will not work reliably with versions of Ruby before
+	1.8.2 preview 3.
+	
+	==== ...storage_options['flatfiles']['extension']
+	The extension of the wiki files. By default, this is
+	&ldquo;ruwiki&rdquo;. For those upgrading from a version of Ruwiki
+	before 0.8.0, note that you must explicitly set this value to
+	<tt>nil</tt> if you wish to have no extension.
+	
+	=== wiki.config.template_path
+	This specifies the paths where the Wiki templates will be found. The
+	process running the Wiki must have read access to the template_path.
+	
+	=== wiki.config.template_set, wiki.config.css
+	These two options indicate which template set will be used. Three
+	template sets are provided in the release package:
+	&ldquo;default&rdquo;, &ldquo;simple&rdquo;, and &ldquo;sidebar&rdquo;.
+	The only CSS file used initially is &ldquo;ruwiki.css&rdquo;. Templates
+	work such that they will be found in
+	<em>template_path</em>/<em>template_set</em>. All CSS files are loaded
+	from the template set directory and emitted as part of the output
+	stream.
+	
+	: The bad side of this is that the CSS never caches on the client side
+	: as it would if it were a separate file. However, as templates may not
+	: be in a web-accessible directory, this is necessary.
+	
+	=== wiki.config.time_format, wiki.config.date_format, wiki.config.datetime_format
+	When the wiki displays date or time values, these formats are used.
+	They are not currently accessible by tokens.
+	
+	=== wiki.config.debug
+	Adds additional information to the (rare) error reports. Defaults to
+	<tt>false</tt>.
+	
+	=== wiki.config.logger
+	Sets or returns the logger. The logger, if set, must respond to the
+	same methods as WEBrick::Logger.
+	
+	=== wiki.config.auth_mechanism
+	The authentication mechanism name as a String. Corresponds to a
+	filename that will be found in ruwiki/auth. The authenticator must have
+	a single class method, +authenticate+, which accepts the +request+, the
+	+response+, and the +auth_options+. This API is a draft API and is
+	likely to change in future versions of Ruwiki. In this version of
+	Ruwiki, only one authentication mechanism will be found -- for dealing
+	with authenticating users already logged into RubyForge.
+	
+	=== wiki.config.auth_options
+	Options for the authentication mechanism as a Hash. This will be passed
+	to the authenticator defined in wiki.config.auth_mechanism. The
+	<tt>auth_options</tt> are a single-level hash. They may be stored in
+	the Ruwiki configuration file as:
+	
+	  ruwiki-config!auth-options: default!user: pgsqluser
+	   default!pass: pgsqlpass
+	
+	== Ruwiki Servlet Options
+	Most, if not all, of the configuration above can be achieved through
+	command-line options of the ruwiki servlet. 
+	
+	=== Servlet Command-Line Options
+	; -P, --port <em>PORT</em> : Runs the Ruwiki servlet on the specified port. Default 8808.
+	; -A, --accept <em>ADDRESSES</em> : Restricts the Ruwiki servlet to accepting connections from the specified address or (comma-separated) addresses. May be specified multiple times. Defaults to all addresses.
+	; -L, --local : Restricts the Ruwiki servlet to accepting only local connections (127.0.0.1). Overrides any previous --accept addresses.
+	; -M, --mount <em>MOUNT_POINT</em> : The relative URI from which Ruwiki will be accessible. Defaults to &ldquo;/&rdquo;.
+	; --[no-]log : Log \WEBrick activity. Default is --log.
+	; --logfile <em>LOGFILE</em> : The file to which \WEBrick logs are written. Default is standard error.
+	; -T, --threads <em>THREADS</em> : Sets the \WEBrick threadcount.
+	
+	=== Ruwiki Command-Line Options
+	; --language <em>LANGUAGE</em> : The interface language for Ruwiki. Defaults to &ldquo;en&rdquo;. May be &ldquo;en&rdquo;, &ldquo;de&rdquo;, or &ldquo;es&rdquo;.
+	; --webmaster <em>WEBMASTER</em> : The Ruwiki webmaster email address. Defaults to &ldquo;webmaster@domain.com&rdquo;.
+	; --[no-]debug : Turns on Ruwiki debugging. Defaults to --no-debug.
+	; --title <em>TITLE</em> : Provides the Ruwiki title. Default is &ldquo;Ruwiki&rdquo;.
+	; --default-page <em>PAGENAME</em> : An alternate default page. Default is &ldquo;\ProjectIndex&rdquo;.
+	; --default-project <em>PAGENAME</em> : An alternate default project. Default is &ldquo;Default&rdquo;.
+	; --template-path <em>TEMPLATE_PATH</em> : The location of Ruwiki templates. Default is &ldquo;./templates&rdquo;.
+	; --templates <em>TEMPLATES</em> : The name of the Ruwiki templates. Default is &ldquo;default&rdquo;.
+	; --css <em>CSS_NAME</em> : The name of the <acronym title="Cascading Style Sheets">CSS</acronym> file in the template path. Default is &ldquo;ruwiki.css&rdquo;.
+	; --storage-type <em>TYPE</em> : Select the storage type: flatfiles, yaml, marshal
+	; --flatfiles-data-path <em>PATH</em> : The path where data files are stored. Default is &ldquo;./data&rdquo;. <em>--flatfiles</em> is used even for <em>yaml</em> and <em>marshal</em> because they are all flatfile oriented systems.
+	; --flatfiles-extension <em>EXT</em> : The extension for data files. Default is &ldquo;ruwiki&rdquo;. <em>--flatfiles</em> is used even for <em>yaml</em> and <em>marshal</em> because they are all flatfile oriented systems.
+properties!project:	Ruwiki
+properties!title:	Configuring_Ruwiki
+properties!topic:	Configuring_Ruwiki
+properties!version:	1
+ruwiki!content-version:	2
+ruwiki!version:	0.9.0
+properties!editable:	false