[ANN] Ruwiki 0.8.0

A

Austin Ziegler

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 <http://localhost:8808/> .

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 ([email protected])
Austin Ziegler ([email protected])
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:[email protected] 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:[email protected] 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.
 
A

Austin Ziegler

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.

The main demonstration site for Ruwiki is
http://ruwiki.rubyforge.org/ruwiki.cgi -- until the kind folks who
manage RubyForge have been able to update that on my behalf, you can
see the latest CGI version of Ruwiki on my personal website:

http://www.halostatue.ca/ruwiki/ruwiki.cgi

To get this to work, I had to make one change to the ruwiki.cgi that
is distributed with Ruwiki 0.8.0. This -- or rather, a "correct"
change that does the equivalent -- will be applied to Ruwiki 0.8.1.

--- ruwiki.cgi~ 2004-08-15 16:18:12 Eastern Daylight Time
+++ ruwiki.cgi 2004-08-16 02:02:09 Eastern Daylight Time

@@ -44,6 +44,7 @@
# wiki.config.time_format = "%H:%M:%S"
# wiki.config.date_format = "%Y.%m.%d"
# wiki.config.datetime_format = "%Y.%m.%d %H:%M:%S"
+wiki.config = wiki.config

wiki.run

-austin
 
M

Michael Neumann

Austin said:
The main demonstration site for Ruwiki is
http://ruwiki.rubyforge.org/ruwiki.cgi -- until the kind folks who
manage RubyForge have been able to update that on my behalf, you can
see the latest CGI version of Ruwiki on my personal website:

http://www.halostatue.ca/ruwiki/ruwiki.cgi

First bug found ;-)
When you click on "Search" without any text in the search-textfield, you
get the following:

#<NoMethodError: undefined method `tr' for nil:NilClass>

/home/halostatue/lib/ruby/1.8/cgi.rb:352:in `unescape'
./lib/ruwiki.rb:369:in `render'
./lib/ruwiki.rb:113:in `run'
ruwiki.cgi:49

Maybe something like (@search || "") will help...

Regards,

Michael
 

Ask a Question

Want to reply to this thread or ask your own question?

You'll need to choose a username for the site, which only take a couple of moments. After that, you can post your question and our members will help you out.

Ask a Question

Members online

Forum statistics

Threads
474,044
Messages
2,570,388
Members
47,052
Latest member
ketan

Latest Threads

Top