[[ Why's (Poignant) Guide to Ruby ]]
                    http://poignantguide.net/ruby/
 
  
  "Quite so," he said.  "I went out to my car yesterday and there was a shoe in the passenger's
  seat.  A very battered oxford.  Looking straight ahead like it needed a lift to the cobbler's.
  I did a cavity search and came up with a crisp note from my deceased ancestor, the same 
  whose property I've looked after, lo, these many years."
 
  "Wow," I said.  And I glared at my shoe, at the things it would do when I'm gone.
 
                                {o}
                                 ^
 
You're pulling down your own master copy of my first book, a book I'm gallantly pursuing,
coding and drawing, tying into a bundle with wax and twine.  This master copy is yours.  You
can do most anything with it, I just ask you abide by the very simple and rather liberal
license for this text.  (See the 'deed' portion of poignant.yml.)
 
=== Building HTML ===
 
You will need to install RedCloth. <http://whytheluckystiff.net/ruby/redcloth/>
 
You will also need Rake. <http://rake.rubyforge.org>
 
If you have RubyGems, both can be installed with:
 
  gem install redcloth
  gem install rake
 
To build the HTML version of this book:
 
  rake [en|fr] [/path/to/output]
 
=== What This Package Includes ===
 
  scripts/poignant.rb: The script which formats output for the book.  Currently, it only outputs
    HTML and CSS.
  
  lang-en/poignant.yml: The YAML text of the entire book.  The entire book has been written using
    Vim as my word processor and YAML as my document format.  I also use Textile liberally
    throughout the content.
 
  lang-en/localization.rb: Localization strings for the English version of the book
 
  lang-fr/poignant.yml: the French version
 
  lang-fr/localization.rb: Localization strings for the French version of the book
 
  Rakefile: a rake file to ease generation 
 
  scripts/layout/index.erb: An ERb template for the table of contents.
 
  scripts/layout/chapter.erb: An ERb template for the chapter pages.
 
  scripts/layout/expansion-pak.erb: An ERb template for expansion pages.
 
  scripts/layout/guide.css: A CSS file with fonts and colors.
 
  scripts/images/: The images folder.  Contains images at no larger than 800px.  These images are
    designed for the website.  Eventually, I will add a folder with 300dpi images.
 
=== Para a versão em Português ===
 
  Antes de executar o "rake pt", conforme explicado acima, primeiro rode este comando:
 
  rake merge_pt
 
  Desta forma, os pequenos trechos serão mesclados num único arquivo "lang-pt/poignant.yml"
  como era na versão original.
 
  * Google Groups: http://groups.google.com/group/whys-poignant-guide-to-ruby---portugues
  * Planilha: https://spreadsheets.google.com/ccc?key=pU_MriAPjg2AHUgj-pIVeRQ&hl=en