anchor.diff:      <%=h File.read('LICENSE') %>
     <% end %>
   
  -  <% section "Resources" do %>
  -    * "Announcements":<%= feed_url %> !<%= feed_icon_url %>(RSS icon)!
  -      - project news and release announcements.
  -    * "Download area":<%= download_url %>
  -      - place to obtain release packages.
  -    * "Mailing list":<%= mailing_list_url %>
  -      - ask questions, get help, discuss.
  -    * "API reference":api/
  -      - documentation for all Ruby code provided with Gerbil.
  -  <% end %>
  -
  -  <% section "Testimonials" do %>
  -    bq. I actually felt like printing it [the user guide], because it's just so well-thought typographically... Even if it [Gerbil] weren't great by itself, I'd feel good just looking at the manual. --"_Vitor Peres_ in [ruby-talk:283052]":http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/283052
  +  <% section "Reviews" do %>
  +    bq. I actually felt like printing it [this user guide], because it's just so well-thought typographically... Even if it [Gerbil] weren't great by itself, I'd feel good just looking at the manual [this user guide]. --"_Vitor Peres_ in [ruby-talk:283052]":http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/283052
     <% end %>
   <% end %>
   
  
positive.code: <%
    # local variables for this document
    mailing_list_url  = 'http://rubyforge.org/mailman/listinfo/gerbil-talk'
    mailing_list_link = link(mailing_list_url, "project mailing list")
    download_url      = 'http://rubyforge.org/frs/?group_id=4905'
    source_repo_url   = 'http://gerbil.rubyforge.org/src'
    feed_url          = File.join(Gerbil[:website], 'news.xml')
    feed_icon_url     = File.join(Gerbil[:website], 'feed-icon-28x28.png')
  
    # parameters for the HTML format
    $title   = "#{Gerbil} user guide"
    $authors = { 'Suraj N. Kurapati' => 'http://snk.tuxfamily.org' }
    $feeds   = { feed_url => :rss }
    $logo    = '<img src="gerbil.png" alt="Gerbil logo" title="Gerbil logo"/>'
  %>
  
  <% chapter "Introduction" do %>
    Gerbil is an *extensible document generator* based on "eRuby":http://www.ruby-doc.org/docs/ProgrammingRuby/html/web.html#S2 that outputs to any format you want: <%= xref 'html', "HTML (web page)" %>, <%= xref 'latex', "LaTeX" %>, <%= xref "man", "UNIX man page" %>, <%= xref 'text', 'plain text' %>, <%= xref "HelloWorld", "your own custom format" %>, and so on.
  
    Gerbil is *lighter* and more *flexible* than "DocBook":http://www.docbook.org, "Deplate":http://deplate.sourceforge.net, and "SiSU":http://www.jus.uio.no/sisu/SiSU/ because it is small, fast, and lets you <%= xref "HelloWorld", "define your own custom format" %>. Furthermore, Gerbil is *scriptable* unlike raw text generators such as "AsciiDoc":http://www.methods.co.nz/asciidoc/, "txt2tags":http://txt2tags.sourceforge.net, and "Grutatxt":http://www.triptico.com/software/grutatxt.html because it lets you inject Ruby code directly into your documents for dynamic content generation.
  
    Gerbil is *open-source software* (see <%= xref "License" %>) so feel free to contribute your improvements and discuss your ideas in the <%= mailing_list_link %>. You can obtain the source code from the project "Darcs":http://darcs.net repository by running the following command:
  
      darcs get <%= source_repo_url %> gerbil
  
    <% note "See the source of this guide" do %>
      Did you know that this user guide was generated by Gerbil? Here is "the source document":guide.erb to prove it!
  
negative.code: <% part "Formats" do %>
    This section describes the default formats provided along with Gerbil. The format specification files (see <%= xref "SpecFile" %>) for these formats can be found in the <tt>format/</tt> directory of the Gerbil installation directory (see <%= xref "Manifest" %>).
  
    These formats are meant to serve as working examples. If you require more functionality from one of these formats, simply make a copy of the corresponding format specification file and edit the copy to suit your needs. If you would like to contribute or discuss your enhancements to these default formats, you can <%= xref "License", "contact the author" %>.
  
    <% chapter "HTML", 'html' do %>
      This format generates a _monolithic_ HTML (technically, it's XHTML 1.0 transitional, but who's counting?) document. A monolithic HTML document allows users to easily search for a particular topic using nothing more than their web browser's built-in text search mechanism. This facilitates offline reading, where an Internet search engine is not available.
  