From: Austin Ziegler Date: 2004-08-16T08:56:08+09:00 Subject: [ANN] Ruwiki 0.8.0 I am pleased to announce the long-awaited release of Ruwiki 0.8.0. This version represents a significant change over prior versions. I mention this several times in the overall documentation, but Ruwiki 0.8.0 is incompatible with data files from earlier versions of Ruwiki. There is a utility, bin/convert, that will convert your existing data files to one of the three new data formats supported by Ruwiki. Following are the Ruwiki 0.8.0 README and the Ruwiki 0.8.0 section of the ChangeLog. Ruwiki 0.8.0 is NOT available through either RubyGems or RPA. Ruwiki 0.8.1 will be following soon with changes to support installation in a RubyGem or RPA environment. There are currently no other planned changes for Ruwiki 0.8.1, but there is an extensive discussion of the Ruwiki roadmap leading up to Ruwiki 0.9.0 and RubyConf 2004 -- and beyond. I encourage people to play with this version, especially users in a CGI environment. I don't have a CGI environment that I completely trust at this point (this will hopefully be fixed for Ruwiki 0.8.1 or 0.9.0), so Ruwiki development is done 100% as a WEBrick servlet. Ruwiki can be downloaded from RubyForge: http://rubyforge.org/frs/?group_id=84 We have also started two mailing lists on RubyForge, ruwiki-discuss and ruwiki-checkin: http://rubyforge.org/mail/?group_id=84 -austin Ruwiki 0.8.0 ------------ Ruwiki is a simple, extensible Wiki-clone written in Ruby. It supports both CGI and WEBrick interfaces, templates, and CSS formatting. This Wiki differs from most other Wikis in that it supports projectt namespaces, so that two topics may be named the same for differing projects without colliding or having to resort to odd naming conventions. Please see the ::Ruwiki project in the running Wiki for more information. Ruwiki 0.8.0 has German and Spanish translations available. Upgrading --------- Ruwiki 0.8.0 has a flatfile format that is incompatible with older versions of Ruwiki. If you are upgrading from one of these versions, you must use the bin/convert. The simple case will be (assuming that your data files are in ./data): % bin/convert ./data Requirements ------------ Ruwiki currently requires Ruby 1.8, Diff::LCS 1.1.0 (portions included). The YAML backend requires Ruby 1.8.2. Quick Start (CGI) ----------------- 1. Place the Ruwiki directory in a place that your webserver can execute CGI programs and ensure that ruwiki.cgi is executable on your webserver. 2. Point your web browser to the appropriate URL. Quick Start (WEBrick) --------------------- 1. Run ruwiki_servlet (ruwiki_servlet.bat under Windows). 2. Point your web browser to . Configuration ------------- There are extensive configuration options available. The Ruwiki WEBrick servlet offers command-line options that simplify the configuration of Ruwiki without editing the servlet; use ruwiki_servlet --help for more information. Copyright --------- Copyright: Copyright � 2002 - 2004, Alan Chen and Austin Ziegler Authors: Alan Chen (alan@digikata.com) Austin Ziegler (ruwiki@halostatue.ca) Licence: Ruby's Credits ------- * This software includes portions of Diff::LCS by Austin Ziegler, available for download from the Ruwiki RubyForge project: [http://rubyforge.org/projects/ruwiki/] * Portions of this software are derived from Dave Thomas's RDoc system, now part of the Ruby distribution. * Translation to German by [mailto:chneukirchen@yahoo.de Christian Neukirchen] on 2003.10.22. Note that the initial template translations (./templates/de/) were done via AltaVista Babelfish and should not be blamed on Christian. * Translation to Spanish by [mailto:batsman.geo@yahoo.com Mauricio Fern�ndez] on 2003.10.22. Note that the initial template translations (./templates/es/) were done via AltaVista Babelfish and should not be blamed on Mauricio. $Id: README,v 1.8 2004/08/15 20:18:12 austin Exp $ Changes: == Version 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 ruwiki. * 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 ("flatfiles"), YAML ("yaml"), and Marshal ("marshal"). * 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 "simple" template set. * AZ: New look! Ruwiki has a "sidebar" template set. * AZ: Fixed a long-standing bug with code tokens.