webby 0.7.1 → 0.7.2

data/examples/webby/content/css/site.css

@@ -6,19 +6,18 @@ sass_options:
   :style: :expanded
 --- 
 !text        = #000
-!border      = #DDD
-!header      = #333
+!border      = #CCC
+!header      = #111
 !link        = #125AA7
 !link_hover  = #000
 !blockquote  = #666
 !code        = #000
-!box_bg      = #F8F8F8
+!box_bg      = #EEE
 !highlight   = #B2CCFF
 !quiet       = #666
 !alt         = #666
 
 body
-  :margin       1.5em 0
   :color =      !text
   :font-family  Verdana, sans-serif
 
@@ -26,7 +25,10 @@ body
 // ------------------------------------------------------------------------
 h1,h2,h3,h4,h5,h6 
   :color =      !header
-  :font-family  Georgia, serif
+  :font-weight  bold
+
+h2,h3,h4,h5,h6
+  :border-bottom = 2px solid !highlight
 
 // Text Elements
 // ------------------------------------------------------------------------
@@ -34,18 +36,27 @@ a
   :color =   !link
   &:hover
     :color = !link_hover
+
 blockquote
   :color =   !blockquote
 
 pre
+  :margin-left   18px
+  :padding       8px
+  :color =       !code
+  :font-family   monospace, courier
+  :overflow      auto
   :background =  !box_bg
-  :border        none
+  :border =      1px solid !border
   :border-left = 7px solid !border
 
 hr
   :background = !highlight
   :color =      !highlight
 
+code
+  :background-color = !box_bg
+
 // Tables
 // ------------------------------------------------------------------------
 table
@@ -65,65 +76,72 @@ p.quiet
 // My Site Stylings
 // ------------------------------------------------------------------------
 #header
-  :margin-bottom     1.7em
-  h1
-    :margin-bottom   0
-    :padding-bottom  0.2em
-  hr 
-    :height          0.3em
-    :margin-bottom   0.5em
 
 #navigation 
-  :text-align                center
-  :margin-left               0
-  :font-size                 1.5em
-  :list-style-type           none
-  li 
-    :display                 inline
-    :padding-right           0.5em
-    a 
-      :margin-right          0.5em
-      :padding               0 0.2em
-      :text-decoration       none
-      &:hover 
-        :background-color = !highlight
+  ul
+    :margin-left               0
+    :text-align                right
+    :font-size                 16px
+    :list-style-type           none
+    li 
+      a 
+        :display               block
+        :text-decoration       none
+        :padding-right         5px
+        &:hover 
+          :background-color = !highlight
 
 #footer
   hr 
-    :margin-bottom   0.5em
+    :margin-bottom   18px
   p 
     :text-align      right
 
-pre.code
-  :padding            0.5em
-  :margin-bottom      1.3em
-  :color =            !code
-  :font               1.1em 'Courier New', 'Terminal', monospace
-  :overflow           auto
-
 .CodeRay
-  :border             none
+  :margin-left        18px
+  :padding            8px
+  :border =           1px solid !border
   :border-left =      7px solid !border
   :background =       !box_bg
   :color =            !code
   pre
-    :font             1.0em 'Courier New', 'Terminal', monospace
+    :font             12px monospace, courier
 
 div.toc
   :float              right
-  :padding            1.5em
-  :margin-left        1.5em
-  :margin-bottom      1.5em
+  :padding            8px
+  :margin-left        16px
+  :margin-bottom      16px
   :background-color = !highlight
   :border =           1px solid !border
-  ul 
+  ol
+    :margin-bottom    0.5em
+    ol
+      :margin-bottom  0
+  p.title
+    :margin-bottom    0.25em
+    :font-weight      bold
+    :font-size        1.2em
+    :text-align       center
+
+ul
+  ul
     :margin-bottom    0
 
-span.caps
-  :font-weight        normal
+span.heading-num
+  :margin-right  10px
 
-strong
-  span.caps
-    :font-weight      bold
+p.fn
+  :color =       !blockquote
+  :margin-left   1.5em
+
+p.span-2
+  :clear         left
+
+pre.option
+  :float         left
+  :margin-left   80px
+  :width         500px
+  :clear         both
 
 // EOF

data/examples/webby/content/index.txt

@@ -9,7 +9,7 @@ Webby works by combining the contents of a *page* with a *layout* to produce HTM
 
 Install Webby and try it out!
 
-<pre class="code">
+<pre>
 sudo gem install -y webby
 </pre>
 
@@ -28,7 +28,7 @@ h2. But Wait! There's More!
 
 Webby has a great _autobuild_ feature that continuously generates HTML whenever the *pages* or *layouts* change. The HTML is served up via "heel":http://copiousfreetime.rubyforge.org/heel/, a static file webserver based on mongrel. Whenever you change a page, you can immediately see those changes without having to run any commands.
 
-<pre class="code">
+<pre>
 $ rake autobuild
 heel --root output --daemonize
 [10:21:26]  INFO: starting autobuild (Ctrl-C to stop)

data/examples/webby/content/manual.txt

@@ -1,40 +1,391 @@
 --- 
 title:      Manual
 created_at: Wed Aug 29 08:57:00 -0600 2007
-filter:     textile
+filter:
+  - erb
+  - graphviz
+  - coderay
+  - textile
+  - outline
 --- 
-h2. Installation
+<div class="toc push-1">
 
-Webby is an application written using the Ruby programming language. You will need to install a Ruby interpreter on your computer. Download and installation instructions can be found on the "Ruby":http://ruby-lang.org webiste. For the Windows platform, the one-click installer is recommended. Webby is not compatible with the Ruby 1.9.0 release; please use the Ruby 1.8.6 release.
+p(title). Table of Contents
+
+<toc />
+</div>
+
+h2{clear:none}. Getting Started
+
+h3{clear:none}. Requirements
+
+Webby is an application written using the Ruby programming language. To install and run Webby you will need the following applications on your system:
+
+* "Ruby":http://ruby-lang.org
+* "RubyGems":http://rubygems.org/read/chapter/3
+
+h3{clear:none}. Installation
+
+Webby is an application written using the Ruby programming language. You will need to install a Ruby interpreter on your computer. Download and installation instructions can be found on the "Ruby":http://ruby-lang.org website. For the Windows platform, the one-click installer is recommended. Webby is not compatible with the Ruby 1.9.0 release; please use the Ruby 1.8.6 release.
 
 You will also need to install RubyGems. If you used the Windows one-click installer, RubyGems is already present on your system. For everyone else you can find installation instructions on the "RubyGems":http://rubygems.org/read/chapter/3 website.
 
 To install Webby and its dependent gems type the following command. Omit the @sudo@ portion for the Windows platform; you will need to specify the *mswin32* versions of the _mongrel_ and _hpricot_ dependent gems when prompted.
 
-<pre class="code">
+<pre>
 sudo gem install -y webby
 </pre>
 
+To make use of all the features Webby has to offer, the following gems should also be installed. These gems provide different ways to transform text into HTML or CSS.
 
-<pre class="code">
+<pre>
 sudo gem install -y RedcCoth
 sudo gem install -y BlueCloth
 sudo gem install -y haml
 sudo gem install -y coderay
 </pre>
 
-directory structure
+h3. New Website
+
+h2. Working With Resources
+
+A resource is any file that is found in the _content_ or _layouts_ folders. Resources are either copied to the output folder or they are processed through the Webby filter engine to generate an output file. Resources fall into one of three types:
+
+* Files
+* Pages
+* Layouts
+
+Files are the simplest resource to handle. They are copied, unchanged, from the content folder to the output folder. Files include resources such as images, CSS stylesheets, and so forth. A file will be copied from its location in the content folder to its corresponding location in the output folder -- i.e. a file located at @content/some/folder/image.jpg@ would be copied to @output/some/folder/image.jpg@.
+
+Files will only be found in the _content_ folder. The _layouts_ folder is reserved solely for layouts.
+
+h3(#pages). Pages
+
+Pages are found in the _content_ folder along with regular files. Pages contain *meta-data* at the top of the file; this is what differentiates a page from a regular file. The meta-data is a section of "YAML":http://www.yaml.org/spec/1.1/ formatted text that describes various properties and attributes of the page. These attributes are used by Webby to determine how the page will be processed by the filter engine.
+
+Let's look at an example page.
+
+<pre>
+---
+title:      Lorem Ipsum
+created_at: Wed Aug 29 08:57:00 -0600 2007
+filter:
+  - erb
+  - textile
+---
+h2. <%= @page.title %>
+
+Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Nunc congue ipsum
+vestibulum libero. Aenean vitae justo. Nam eget tellus. Etiam convallis, est eu
+lobortis mattis, lectus tellus tempus felis, a ultricies erat ipsum at metus.
+</pre>
+
+The page meta-data is contained in the first section  --  it is located between the two @---@ lines. The page meta-data will not be present in the generated HTML file. Only the page content (the text below the second @---@ line) will be rendered into the final HTML file. The meta-data defines a collection of attributes that (1) are made available to the various Webby filters and (2) provide instructions to the Webby filter engine itself.
+
+Three attributes are defined in the above example: @title@, @created_at@, and @filter@. The first attribute, @title@, is associated with the value "Lorem Ipsum". This attribute is used in the first line of the page content to render the title using a combination of the ERB and Textile filters (more can be read in the "Filters":#filters section of this manual). The example page above will result in the following snippet of HTML code.
+
+<pre>
+<h2>Lorem Ipsum</h2>
+
+<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Nunc congue ipsum
+vestibulum libero. Aenean vitae justo. Nam eget tellus. Etiam convallis, est eu
+lobortis mattis, lectus tellus tempus felis, a ultricies erat ipsum at metus.</p>
+</pre>
+
+You can see that the value of the @title@ attribute was substituted for the ERB snippet <code><%= @page.title %></code>. All page attributes can be accessed using the <code>@page.attribute</code> syntax within an ERB block. This will be discussed in greater detail in the "ERB Filter":#erbfilter section.
+
+The last attribute in the meta-data section is the @filter@ attribute. The value for this attribute is a list of filters that will be applied to the page contents. The filters will be applied in the order they are specified. For the example page this would be the ERB filter followed by the Textile filter.
+
+h4. Page Attributes
+
+Attribute identifiers cannot contain spaces; they must be separated from their values by a colon. Other than that, you are free to define as many attributes as you like. Aside from defining values that can be rendered into a page, attributes are also used to find other pages in the site. Finding and linking to other pages is discussed in the "ERB Filter":#erbfilter section.
+
+There are a few attributes that control when, where, and how pages are rendered. These are listed below with a brief description of how the attribute affects the system.
+
+* *destination*  --  Defines the path in the output directory where the rendered page should be stored.
+* *dirty*  --  The dirty flag is used to determine whether the page should rendered or not. Normally this is automatically determined by the filter engine, but it can be overridden by setting this attribute. If the dirty flag is set to _true_ then the page will always be rendered. If the dirty flag is set to _false_ then the page will never be rendered.
+* *extension*  --  Defines the extension that will be appended to the filename of the rendered page in the output folder. The extension is determined by looking at the following:
+** the meta-data of the current page for an @extension@ attribute
+** the meta-data of layout file of the current page for an @extension@ attribute
+** the extension of this page file in the _content_ folder
+* *filter*  --  Defines the list of filters that will be applied to the contents of this page. If left blank, then the default filter will be applied to the page contents.
+* *layout*  --  Defines the layout that the page contents will be rendered into. The default layout will be used if this attribute is not defined. The value of @nil@ should be specified if the page should not be rendered into any layout.
+
+The following attributes are defined for each page in the content folder. These attributes cannot be changed in the page's meta-data section. However, they are available to the ERB filter when rendering the contents of a page.
+
+* *path*  --  The full path to the file in the _content_ folder
+* *dir*  --  The relative directory in the output folder where the page will be rendered
+* *filename*  --  The name of the file in the _content_ folder excluding any path information
+* *ext*  --  The extension of the file in the _content_ folder
+* *mtime*  --  The modification time of the file in the _content_ folder
+* *number*  --  Reserved variable used for multi-page content
+* *url*  --  A URL suitable for creating a link to the page
+* *render*  --  Returns the contents of the page as rendered by the Webby filter engine
+
+h4. Page Filters
+
+Filters operate on the content of a page by transforming the text of the content section according to the rules of the individual filter. Some filters transform simplified markup into true HTML syntax; examples of these are the Textile filter and the Markdown filter. Other filters create images from text in the page (Graphviz filter) or apply syntax highlighting to the text (CodeRay filter). All the filters are discussed in detail in the "Filters":#filters section of this document.
+
+h3. Layouts
+
+Layouts provide the basic framework for a page  --  the header, the footer, the navigation. They provide a consistent look and feel across all pages in the website. Individual pages contain just the content for that particular page.
+
+<graphviz path="images" class="push-0" alt="layout diagram">
+digraph layout_graph {
+  rankdir = LR;
+  edge [fontname="Verdana", fontsize=8];
+  node [fontname="Verdana", fontsize=10];
+
+  page -> layout [label="rendered\ninto"];
+  layout -> HTML [label="results\nin"];
+}
+</graphviz>
+
+The diagram to the right shows a typical page rendering process. The content of a page is rendered by the Webby filter engine. The rendered content is inserted into the layout specified by the page; the content insertion occurs as the layout is being rendered. The result is the HTML that is stored in the _output_ folder.
+
+Layouts are treated exactly as pages are treated with one exception  --  the layout has access to the rendered contents of another page in site. The content of the page being rendered is made available to the layout via the @@content@ variable accessible from the ERB filter.
+
+<pre>
+---
+extension: html
+filter:    erb
+---
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en-us">
+<head>
+  <title><%= @page.title %></title>
+</head>
+<body>
+  <%= @content %>
+</body>
+</html>
+</pre>
+
+The example above shows a very simple layout. The content for the current page being rendered will be inserted between the HTML body tags.
+
+Along with the @@content@ variable, all the attributes of the current page being rendered are also accessible in the layout. The page title is inserted into the HTML title tags. But again, any page attribute can be accessed within the layout via the @@page@ variable.
+
+h2(#filters). Filters
+
+Filters are used in Webby to transform the text of pages and layouts. The filters applied to a page are defined in the meta-data of the page. The filters are used to transform different parts of the page contents resulting in HTML syntax, images, highlighted code, etc. Filters apply equally to pages and to layouts  --  that is, pages and layouts are treated in the same manner by filters.
+
+This section will look at the various filters provided by Webby, what those filters do, and how they should be used. Enjoy!
+
+h3(#erbfilter). ERB
+
+"ERB":http://ruby-doc.org/stdlib/libdoc/erb/rdoc/classes/ERB.html provides an easy to use but powerful templating system for Ruby. Using ERB, Ruby code can be added to any plain text document for the purposes of generating document information details and/or flow control. Much of the functionality Webby has to offer is made available through the erb filter. ERB does not place any limitations on the content of the page, so it is recommended to use the erb filter with another filter that simplifies the HTML markup  --  Textile is my favorite, but Markdown and HAML support are provided in Webby, as well. Chose the markup language that suits your style.
+
+Some examples of ERB have already been seen in the "pages":#pages section of this document. Ruby code is placed between ERB delimiters, <code><notextile>&lt;%= ruby code %&gt;</notextile></code> somewhere in the content section of your page or layout. The erb filter executes that code and inserts the results into the page. Webby provides quite a few features that are accessed via ERB. Page attributes are one feature, and "helper methods":#helpermethods are another that are discussed elsewhere in this manual.
+
+<pre><notextile>
+The title of this page is "&lt;%= @page.title" %&gt;".
+</notextile></pre>
+
+<pre>
+The title of this page is "<%= @page.title %>".
+</pre>
+
+p(column span-2). *Usage*:
+
+p(column span-13). Include "erb" in the filter list of the page or layout that contains ERB formatting.
+
+p(column span-2). *Options*:
+
+p(column span-13). none
+
+p(column span-2). *Require*:
+
+p(column span-13). none
+
+h3. Textile
+
+"Textile":http://en.wikipedia.org/wiki/Textile_%28markup_language%29 is a lightweight markup language originally developed by Dean Allen and billed as a "humane Web text generator". The textile filter converts Textile formatted text into valid, well-formed XHTML.
+
+A complete textile reference is beyond the scope of this document. Please refer to the "Textile reference":http://hobix.com/textile/ compiled by _why the luck stiff_ <sup><a href="#fn1">1</a></sup>.
+
+The textile filter will operate on all the contents of a page or layout. Given that fact, it should be one of the last filters applied to the page. You can prevent a section of the page from being processed by the textile filter by surrounding it with <code><notextile>&lt;notextile&gt;...&lt;/notextile&gt;</notextile></code> tags.
+
+p(column span-2). *Usage*:
+
+p(column span-13). Include "textile" in the filter list of the page or layout that contains Textile formatting
+
+p(column span-2). *Options*:
+
+p(column span-13). none
+
+p(column span-2). *Require*:
+
+p(column span-13). The @RedCloth@ gem must be installed on your system in order to use the textile filter.
+
+fn1(fn){clear:both}. Please don't ask. Why is very smart, he wrote the Ruby code that handles Textile markup, and the code is very solid. Enjoy the benefits of his work.
 
-* content
-* output
-* layouts
-* templates
-* lib
-* tasks
+h3. Markdown
+
+"Markdown":http://daringfireball.net/projects/markdown/ is a lightweight markup language created by John Gruber. It allows you to write using an easy-to-read, easy-to-write plain text format. From the Markdown web page:
+
+bq. The overriding design goal for Markdown's formatting syntax is to make it as readable as possible. The idea is that a Markdown-formatted document should be publishable as-is, as plain text, without looking like it's been marked up with tags or formatting instructions. While Markdown's syntax has been influenced by several existing text-to-HTML filters, the single biggest source of inspiration for Markdown's syntax is the format of plain text email.
+
+The markdown filter will operate on all the contents of a page or layout. Given that fact, it should be one of the last filters applied to the page.
+
+p(column span-2). *Usage*:
+
+p(column span-13). Include "markdown" in the filter list of the page or layout that contains Markdown formatting.
+
+p(column span-2). *Options*:
+
+p(column span-13). none
+
+p(column span-2). *Require*:
+
+p(column span-13). The @BlueCloth@ gem must be installed on your system in order to use the markdown filter.
+
+h3. HAML & SASS
+
+"HAML":http://haml.hamptoncatlin.com/ is a markup language created by Hampton Catlin that's used to cleanly and simply describe the XHTML of any web document without the use of inline code. SASS is the equivalent for CSS documents. From the HAML website:
+
+bq. "HAML":http://haml.hamptoncatlin.com/docs/haml and "SASS":http://haml.hamptoncatlin.com/docs/sass are templating engines for the two most common types of documents on the web: HTML and CSS, respectively. They are designed to make it both easier and more pleasant to code HTML and CSS documents, by eliminating redundancy, reflecting the underlying structure that the document represents, and providing elegant, easily understandable, and powerful syntax.
+
+Both the haml and the sass filter will operate on all the contents of a page or layout. Given that fact, these should be one of the last filters applied to the page.
+
+p(column span-2). *Usage*:
+
+p(column span-13). Include "haml" in the filter list of the page or layout that contains HAML  formatting. Include "sass" in the filter list of the page that contains SASS formatting (this should be a CSS page).
+
+p(column span-2). *Options*:
+
+p(column span-13). Options are passed to the haml filter by setting the "haml_options" in the page meta-data  --  the hash of options defined under the "haml_options" attribute will be passed to the haml filter engine when it is run. Please refer to the HAML documentation for the list of available options.
+
+p(column span-13 prepend-2). Options are passed to the sass filter by setting the "sass_options" in the page meta-data  --  the hash of options defined under the "sass_options" attribute will be passed to the sass filter engine when it is run. Please refer to the SASS documentation for the list of available options.
+
+p(column span-2). *Require*:
+
+p(column span-13). The @haml@ gem must be installed on your system in order to use the haml filter or the sass filter.
+
+h3. CodeRay
+
+"CodeRay":http://coderay.rubychan.de/ is a Ruby library that provides syntax highlighting for various types of source code. The coderay filter takes a portion of the page contents and runs it through the CodeRay syntax highlighter, and pretty, colored XHTML is inserted into the page. The end result is that you can embed code into a page, and the coderay filter will convert that code into valid XHTML.
+
+Unlike the filters mentioned thus far, the coderay filter does not operate on the entire contents of a page. Only text between <code><notextile>&lt;coderay&gt;...&lt;/coderay&gt;</notextile></code> tags will be run through the coderay filter. The XHTML inserted into the page is contained in a @div@ element styled with a @CodeRay@ class.
+
+The coderay filter is controlled by setting attributes on the coderay tags in the content of the page. These attributes tell the CodeRay engine the language being parsed, to show line numbers, where to start numbering etc.
+
+<pre>
+<notextile>&lt;coderay lang="ruby" line_numbers="inline"&gt;
+class Object
+  def returning( r )
+    yield r if block_given?
+    r
+  end
+end
+&lt;/coderay&gt;</notextile>
+</pre>
+
+<coderay lang="ruby" line_numbers="inline">
+class Object
+  def returning( r )
+    yield r if block_given?
+    r
+  end
+end
+</coderay>
+
+p(column span-2). *Usage*:
+
+p(column span-13). Include "coderay" in the filter list of the page or layout that contains Markdown formatting. You will also need to link to the coderay stylesheet in any page containing coderay markup.
+
+p(column span-2). *Options*:
+
+p(column span-13). The full list of "coderay options":/rdoc/classes/Webby/Filters/CodeRay.html can be found in the source documentation.
+
+p(column span-2). *Require*:
+
+p(column span-13). The @coderay@ gem must be installed on your system in order to use the coderay filter. Be sure to include the coderay stylesheet in your layout.
+
+h3. Graphviz
+
+"Graphviz":http://www.graphviz.org/ is open source graph visualization software. Graph visualization is a way of representing structural information as diagrams of abstract graphs and networks. The Graphviz layout programs take descriptions of graphs in a simple text language, and make diagrams in several useful formats. The graphviz filter allows you to embed Graphviz scripts into a page and generate an image in the page.
+
+The graphviz filter does not operate on the entire contents of a page. Only text between <code><notextile>&lt;graphviz&gt;...&lt;/graphviz&gt;</notextile></code> tags will be run through the graphviz filter. The resulting image will be inserted into the page using a standard @img@ tag. If the Graphviz script contains references to URLs, then an image map will also be generated and inserted into the page. This results in an image with clickable regions.
+
+The graphviz filter is controlled by setting attributes on the graphviz tags in the content of the page. These attributes tell the Graphviz renderer where to store the generated image, the type of image to create, etc.
+
+<pre>
+<notextile>&lt;graphviz path="images" alt="hello world graph"&gt;
+digraph hello_world {
+  rankdir = LR;
+  Hello -> World;
+}
+&lt;/graphviz&gt;</notextile>
+</pre>
+
+<graphviz path="images" alt="hello world graph">
+digraph hello_world {
+  rankdir = LR;
+  Hello -> World;
+}
+</graphviz>
+
+p(column span-2). *Usage*:
+
+p(column span-13). Include "graphviz" in the filter list of the page or layout that contains Graphviz scripts.
+
+p(column span-2). *Options*:
+
+p(column span-13). The full list of "graphviz options":/rdoc/classes/Webby/Filters/Graphviz.html can be found in the source documentation.
+
+p(column span-2). *Require*:
+
+p(column span-13). The Graphviz application must be installed on your system, and the Graphviz executables must be available on the path.
+
+h3. BasePath
+
+The basepath filter is used to rewrite the base path location for all URLs in a page. This is useful for the times when the publish location of the website is no at the root of the web server  --  @http://your.website.com/path/to/your/site@ for example. This allows pages and resources (images, javascript, stylesheets, etc.) to be referenced from the root of the Webby web server for easy development, but the paths of these resources can easily be changed by the basepath filter when the website is being deployed.
+
+The basepath filter only works on HTML/XHTML text, and therefore, it should be one of the last (if not the last) filter applied to your content. It is recommended to only include the basepath filter in your layout(s). The basepath filter should appear before the tidy filter.
+
+p(column span-2). *Usage*:
+
+p(column span-13){margin-bottom:0}. Include "basepath" in the filter list of your layout(s). Specify the new base path to use either as a command line argument or as an option configured in the _Rakefile_. The base path specified on the command line takes precedence over the base path specified in the Rakefile.
+
+<pre class="option">
+$ rake rebuild BASE='http://your.website.com/path/to/your/site'
+</pre>
+
+p(column span-2). *Options*:
+
+p(column span-13){margin-bottom:0}. Options can be passed to the basepath filter by specifying them in the project _Rakefile_.
+
+<pre class="option">
+SITE.xpaths << '/html/body//img[@usemap]'
+SITE.base = 'http://webby.rubyforge.org'
+</pre>
+
+p(column span-2). *Require*:
+
+p(column span-13). none
+
+h3. Tidy
+
+"Tidy":http://www.w3.org/People/Raggett/tidy/ is a useful application for cleaning up and detecting errors in XHTML text. The tidy filter will run your XHTML code through the tidy program and report any errors in the build log. From the HTML Tidy website:
+
+bq. When editing HTML it's easy to make mistakes. Wouldn't it be nice if there was a simple way to fix these mistakes automatically and tidy up sloppy editing into nicely layed out markup? Well now there is! Dave Raggett's HTML TIDY is a free utility for doing just that. Tidy is able to fix up a wide range of problems and to bring to your attention things that you need to work on yourself. Each item found is listed with the line number and column so that you can see where the problem lies in your markup. Tidy won't generate a cleaned up version when there are problems that it can't be sure of how to handle. These are logged as "errors" rather than "warnings".
+
+The tidy program only works on HTML/XHTML text, and therefore, tidy should be one of the last (if not the last) filter applied to your content. It is recommended to only include the tidy filter in your layout(s).
+
+p(column span-2). *Usage*:
+
+p(column span-13). Include "tidy" as the last item in the filter list of your layout(s).
+
+p(column span-2). *Options*:
+
+p(column span-13){margin-bottom:0}. Options can be passed to the tidy program by specifying them in the project _Rakefile_. These are the command line options that will be passed to the tidy program when it is run.
+
+<pre class="option">
+SITE.tidy_options = '-indent -wrap 80'
+</pre>
 
-resources
+p(column span-2). *Require*:
 
-renderer
+p(column span-13). The HTML Tidy application must be installed on your system, and the @tidy@ executable must be available on the path.
 
-pages database
+h2. Using Rake