[[ 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
gem install syntax
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