From: Tim Pease <tim.pease@...>
Date: 2007-12-05T05:18:04+09:00
Subject: [ANN] Webby 0.6.0 released

Webby is a super fantastic little website management system. It would
be called a content management system if it were a bigger kid. But,
it's just a runt with a special knack for transforming text. And
that's really all it does – manages the legwork of turning text into
something else, an ASCII Alchemist if you will.

Webby works by combining the contents of a page with a layout to
produce HTML. The layout contains everything common to all the pages –
HTML headers, navigation menu, footer, etc. – and the page contains
just the information for that page. You can use your favorite markup
language to write your pages; Webby supports quite a few.

Install Webby and try it out!

$ sudo gem install webby

http://webby.rubyforge.org


= RELEASE NOTES =

New in this version
* tidy support
* graphviz support
* simplified coderay usage when used within a textile page
* streamlined defaults handling


== TIDY SUPPORT ==

You can now format and check your generated content using Tidy. This
is done by specifying Tidy as the final filter in the top-level layout
(or layouts) for you site.  The following example shows how to do this
using the default layout found in the layouts directory.

Example:

---
extension: html
filter:
  - erb
  - tidy
---
<html>
<head>
  ...
</head>

<body>
  <%= @content %>
</body>
</html>


Obviously some markup has been left out of that example, but you get
the idea. Options can be passed to Tidy by setting them in the site
Rakefile.

SITE.tidy_options = "-indent -wrap 80"

Tidy needs to be installed on your system for this to work.


== GRAPHVIZ SUPPORT ==

You can now embed DOT scripts directly into a page, and Webby will
generate the image file and insert an <img /> tag into the HTML
output. If the DOT script contains URL or href references, a
corresponding image map will be generated such that the image in the
webpage is clickable.

Example:

---
title:  Visual Hello World
filter:
  - graphviz
  - textile
---
h2. Visual Hello World

<graphviz path="images" alt="hello world">
digraph G {
  Hello [URL="http://www.ruby-lang.org"]
  World [URL="http://www.rubyforge.org"]
  Hello -> World
}
</graphviz>

Images can be generated using dot, neato, twopi, circo, fdp.  Just
specify which one you want to use as <graphviz cmd="neato" ...>

Graphviz must be installed on your machine for this to work.


== CODERAY ==

When coderay is used within a textile page, the coderay block needed
to be surrounded by <notextile></notextile> tags. This is no longer
the case, and the coderay block can exist all by itself.

Example:

---
title:  Code Sample
filter:
  - coderay
  - textile
---
h2. Ruby Code Sample

This is the infamous "returning" method.

<coderay lang="ruby" line_numbers="inline">
class Object
  def returning( obj )
    yield obj
    return obj
  end
end
</coderay>


== ERRATA ==

With this update, you need to update the rake tasks and setup code in
any of your webby project folders.  Simply type the following ...

$ webby -u my/webby/project/folder



Blessings,
TwP