@@ -1,74 +1,74 @@ - - [[ 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 + + [[ 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 \ No newline at end of file README Rakefile @@ -1,19 +1,19 @@ -locale: pt-br -version: '0.6' -next_page: próxima -previous_page: anterior -encoding: utf-8 -turn_page: Virar a página -open_the_book: Abrir o livro -written_by: | - Este livro foi carinhosamente escrito e ilustrado por - "why the lucky stiff":http://whytheluckystiff.net/. -header_title: why's (poignant) guide to ruby -sidebar: sidebar! -contents: Conteúdo -expansion_pak: Pacote de Expansão -expansion_pak_no: Pacote de Expansão No. -expansion_paks: Pacotes de Expansão -adverrtissements: Anúnccios -see_also: Veja também -english_version: Versão em Português +locale: pt-br +version: '0.6' +next_page: próxima +previous_page: anterior +encoding: utf-8 +turn_page: Virar a página +open_the_book: Abrir o livro +written_by: | + Este livro foi carinhosamente escrito e ilustrado por + "why the lucky stiff":http://whytheluckystiff.net/. +header_title: why's (poignant) guide to ruby +sidebar: sidebar! +contents: Conteúdo +expansion_pak: Pacote de Expansão +expansion_pak_no: Pacote de Expansão No. +expansion_paks: Pacotes de Expansão +adverrtissements: Anúnccios +see_also: Veja também +english_version: Versão em Português lang-pt/localization.yml @@ -1,37 +1,37 @@ ---- !whytheluckystiff.net,2003/^book -title: why's (poignant) guide to ruby -author: why the lucky stiff - -terms: > - bq(#terms). The text of this book and the encompassing web matter are released under the wholy sympathetic - "Attribution-ShareAlike":http://creativecommons.org/licenses/by-sa/2.5/ - license, part of the brilliant family of licenses produced - by the "Creative Commons":http://creativecommons.org/. - - -deed: | - Attribution-ShareAlike 2.5 - - You are free: - - * to copy, distribute, display, and perform the work - * to make derivative works - * to make commercial use of the work - - Under the following conditions: - - *Attribution*. You must give the original author credit. - - *Share Alike*. If you alter, transform, or build upon this work, you may distribute the - resulting work only under a license identical to this one. - - * For any reuse or distribution, you must make clear to others the license terms of this work. - * Any of these conditions can be waived if you get permission from the author. - - Your fair use and other rights are in no way affected by the above. - - This is a human-readable summary of the Legal Code (the full license). - -image: !^img 2006.cover.jpg -teaser: - +--- !whytheluckystiff.net,2003/^book +title: why's (poignant) guide to ruby +author: why the lucky stiff + +terms: > + bq(#terms). The text of this book and the encompassing web matter are released under the wholy sympathetic + "Attribution-ShareAlike":http://creativecommons.org/licenses/by-sa/2.5/ + license, part of the brilliant family of licenses produced + by the "Creative Commons":http://creativecommons.org/. + + +deed: | + Attribution-ShareAlike 2.5 + + You are free: + + * to copy, distribute, display, and perform the work + * to make derivative works + * to make commercial use of the work + + Under the following conditions: + + *Attribution*. You must give the original author credit. + + *Share Alike*. If you alter, transform, or build upon this work, you may distribute the + resulting work only under a license identical to this one. + + * For any reuse or distribution, you must make clear to others the license terms of this work. + * Any of these conditions can be waived if you get permission from the author. + + Your fair use and other rights are in no way affected by the above. + + This is a human-readable summary of the Legal Code (the full license). + +image: !^img 2006.cover.jpg +teaser: + lang-pt/poignant-01.yml @@ -1,6 +1,6 @@ - - Leia este parágrafo: > - Na livraria perto de casa, existe uma enorme estante cheia de livros de Java só esperando - para tombar e cair em cima de mim algum dia. E um dia isto vai acontecer. Analisando como as coisas estão indo, - um dia esta estante será tão grande que se tombar vai esmagar todos nós. Pode até mesmo dar a volta ao mundo - várias vezes, esmagando as edições anteriores dos mesmos livros de Java, e as novas edições atropelando estas também. - + - Leia este parágrafo: > + Na livraria perto de casa, existe uma enorme estante cheia de livros de Java só esperando + para tombar e cair em cima de mim algum dia. E um dia isto vai acontecer. Analisando como as coisas estão indo, + um dia esta estante será tão grande que se tombar vai esmagar todos nós. Pode até mesmo dar a volta ao mundo + várias vezes, esmagando as edições anteriores dos mesmos livros de Java, e as novas edições atropelando estas também. + lang-pt/poignant-02.yml @@ -1,5 +1,5 @@ - - E este parágrafo também: > - Este é apenas um pequeno livro sobre Ruby. Ele não irá esmagá-lo. É leve como uma - pluma (porque eu ainda não terminei ele-hehe). E existe um motivo para este livro - permanecer leve: Porque Ruby é fácil de aprender. - + - E este parágrafo também: > + Este é apenas um pequeno livro sobre Ruby. Ele não irá esmagá-lo. É leve como uma + pluma (porque eu ainda não terminei ele-hehe). E existe um motivo para este livro + permanecer leve: Porque Ruby é fácil de aprender. + lang-pt/poignant-03.yml @@ -1,9 +1,9 @@ - - Mas não leia este!: > - _Why's (Poignant) Guide to Ruby_ é liberado sob a Licença - "Atribuição-Compartilhamento":http://creativecommons.org/licenses/by-sa/2.5/deed.pt - . Então, sim, você pode distribuir, imprimir e ler na sua casa de - pijama. Aliás, no final do livro faremos um concurso para ver quem tem - o Melhor Pijama. É um prêmio excelente e você - se sentirá honrado em apenas ler sobre ele! (Especialmente se você estiver lendo - isto vestindo seu futuramente-premiado pijama.) - + - Mas não leia este!: > + _Why's (Poignant) Guide to Ruby_ é liberado sob a Licença + "Atribuição-Compartilhamento":http://creativecommons.org/licenses/by-sa/2.5/deed.pt + . Então, sim, você pode distribuir, imprimir e ler na sua casa de + pijama. Aliás, no final do livro faremos um concurso para ver quem tem + o Melhor Pijama. É um prêmio excelente e você + se sentirá honrado em apenas ler sobre ele! (Especialmente se você estiver lendo + isto vestindo seu futuramente-premiado pijama.) + lang-pt/poignant-04.yml @@ -1,46 +1,46 @@ - - Então, Voltando ao Assunto: > - Eu vou tentar não me sentir veementemente rejeitado se este livro não capturar - sua simpatia. Eu posso passar alguns dias intermináveis de depressão, acompanhados - de um tremendo choro, mas fora isso eu vou estar bem. É ao menos - reconfortante saber que os textos a seguir cobrem o assunto e vão, - sem dúvida, cobri-lo de tesão pelo Ruby: - - - * "Aprenda a Programar":http://aprendaaprogramar.rubyonrails.pro.br/ - - ** Um tutorial básico para iniciantes em Ruby, do Chris Pine, traduzido pela comunidade brasileira. - - * "Programming Ruby":http://www.whytheluckystiff.net/ruby/pickaxe/ - - ** A referência completa e original de Ruby. do Dave thomas e Andy Hunt - (também conhecida como _The Pickaxe_) - - * "A Little Ruby, A Lot of Objects":http://www.visibleworkings.com/little-ruby/ - - ** Um tabalho adorável, ainda em progresso, que ensina Ruby com simples exemplos de códico. - Do Brian Marick. - - * "Ruby User's Guide":http://www.ruby-doc.org/docs/UsersGuide/rg/ - - ** Um guia para aprender Ruby (com exemplos de código). Do Matz, o criador do - Ruby. Traduzido para o inglês. - - * "Ruby Book List":http://www.rubygarden.org/ruby?RubyBookList - - ** Uma lista atual de material impresso cobrindo Ruby.. - - * "Ruby-Lang.org":http://www.ruby-lang.org/ - - ** O site oficial da linguagem Ruby. - - - Agora, se você não consegue encontrar o link dos conteúdos do lado esquerdo da página, - então veja este link para a "primeira página":chapter-1.html - do (Comovente) Guia. Se você quiser se aventurar nos meus outros projetos, vá para - "whytheluckystiff.net":http://www.whytheluckystiff.net. - - - Bem-vindo à rádio pirata dos manuais técnicos. - - -chapters: + - Então, Voltando ao Assunto: > + Eu vou tentar não me sentir veementemente rejeitado se este livro não capturar + sua simpatia. Eu posso passar alguns dias intermináveis de depressão, acompanhados + de um tremendo choro, mas fora isso eu vou estar bem. É ao menos + reconfortante saber que os textos a seguir cobrem o assunto e vão, + sem dúvida, cobri-lo de tesão pelo Ruby: + + + * "Aprenda a Programar":http://aprendaaprogramar.rubyonrails.pro.br/ + + ** Um tutorial básico para iniciantes em Ruby, do Chris Pine, traduzido pela comunidade brasileira. + + * "Programming Ruby":http://www.whytheluckystiff.net/ruby/pickaxe/ + + ** A referência completa e original de Ruby. do Dave thomas e Andy Hunt + (também conhecida como _The Pickaxe_) + + * "A Little Ruby, A Lot of Objects":http://www.visibleworkings.com/little-ruby/ + + ** Um tabalho adorável, ainda em progresso, que ensina Ruby com simples exemplos de códico. + Do Brian Marick. + + * "Ruby User's Guide":http://www.ruby-doc.org/docs/UsersGuide/rg/ + + ** Um guia para aprender Ruby (com exemplos de código). Do Matz, o criador do + Ruby. Traduzido para o inglês. + + * "Ruby Book List":http://www.rubygarden.org/ruby?RubyBookList + + ** Uma lista atual de material impresso cobrindo Ruby.. + + * "Ruby-Lang.org":http://www.ruby-lang.org/ + + ** O site oficial da linguagem Ruby. + + + Agora, se você não consegue encontrar o link dos conteúdos do lado esquerdo da página, + então veja este link para a "primeira página":chapter-1.html + do (Comovente) Guia. Se você quiser se aventurar nos meus outros projetos, vá para + "whytheluckystiff.net":http://www.whytheluckystiff.net. + + + Bem-vindo à rádio pirata dos manuais técnicos. + + +chapters: lang-pt/poignant-05.yml @@ -1 +1 @@ - - Sobre este Livro: + - Sobre este Livro: lang-pt/poignant-06.yml @@ -1,13 +1,13 @@ - - > - !i/about.the.poignant.guide-1.gif(Que viagem fantástica!)! - - - !i/about.the.poignant.guide-2.jpg(Crianças pequenas podem usar.)! - - - !i/about.the.poignant.guide-3.gif(O leitor introspectivo.)! - - - !i/about.the.poignant.guide-4.gif(Meep.)! - - + - > + !i/about.the.poignant.guide-1.gif(Que viagem fantástica!)! + + + !i/about.the.poignant.guide-2.jpg(Crianças pequenas podem usar.)! + + + !i/about.the.poignant.guide-3.gif(O leitor introspectivo.)! + + + !i/about.the.poignant.guide-4.gif(Meep.)! + + lang-pt/poignant-07.yml @@ -1 +1 @@ - - Kon'nichi wa, Ruby: + - Kon'nichi wa, Ruby: lang-pt/poignant-08.yml @@ -1,31 +1,31 @@ - - Abrindo este livro: > - Finja que você abriu esse livro (embora você provavelmente _já_ tenha aberto esse livro), - e encontrou uma enorme cebola bem no meio da dobra do livro. - (Eu pedi ao fabricante do livro que incluísse a cebola.) - - - Logo você pensa, "Wow, esse livro vem com uma cebola!" (Mesmo que você não tenha um apreço particular por cebolas, eu tenho certeza que você consegue apreciar - a logística de se enviar - qualquer vegetal discretamente dentro de um suposto manual de programação.) - - - Então você se pergunta, "Espera um pouco. Eu pensei que isso fosse um livro sobre Ruby, a incrível nova - linguagem de programação do Japão. E embora eu consiga apreciar a logística de se enviar qualquer - vegetal discretamente dentro de um suposto manual de programação: Por que uma cebola? O que eu devo - fazer com ela? - - - Não. Por favor não pense sobre isso. Você não precisa fazer nada com a cebola. Deixe a cebola de lado - e deixe _ela_ fazer algo com _você_. - - - Eu vou ser direto com você. Eu quero chorar. Lamentar. Me lamuriar docemente. Esse livro é um guia *comovente* - de Ruby. Isso significa código tão lindo que lágrimas serão derramadas. Isto significa contos nobres e verdades melancólicas - que vão fazer você acordar na manhã seguinte nos braços desse livro. Abraçando-o forte por todo o dia. - Se necessário, improvise uma bolsa para o _Why's (Poignant) Guide to Ruby_, assim você sempre pode ter a tenra - companhia deste livro. - - - Você deve soluçar pelo menos uma vez. Ou no mínimo suspirar. Se não der certo, a cebola vai fazer tudo isso acontecer para você. - - + - Abrindo este livro: > + Finja que você abriu esse livro (embora você provavelmente _já_ tenha aberto esse livro), + e encontrou uma enorme cebola bem no meio da dobra do livro. + (Eu pedi ao fabricante do livro que incluísse a cebola.) + + + Logo você pensa, "Wow, esse livro vem com uma cebola!" (Mesmo que você não tenha um apreço particular por cebolas, eu tenho certeza que você consegue apreciar + a logística de se enviar + qualquer vegetal discretamente dentro de um suposto manual de programação.) + + + Então você se pergunta, "Espera um pouco. Eu pensei que isso fosse um livro sobre Ruby, a incrível nova + linguagem de programação do Japão. E embora eu consiga apreciar a logística de se enviar qualquer + vegetal discretamente dentro de um suposto manual de programação: Por que uma cebola? O que eu devo + fazer com ela? + + + Não. Por favor não pense sobre isso. Você não precisa fazer nada com a cebola. Deixe a cebola de lado + e deixe _ela_ fazer algo com _você_. + + + Eu vou ser direto com você. Eu quero chorar. Lamentar. Me lamuriar docemente. Esse livro é um guia *comovente* + de Ruby. Isso significa código tão lindo que lágrimas serão derramadas. Isto significa contos nobres e verdades melancólicas + que vão fazer você acordar na manhã seguinte nos braços desse livro. Abraçando-o forte por todo o dia. + Se necessário, improvise uma bolsa para o _Why's (Poignant) Guide to Ruby_, assim você sempre pode ter a tenra + companhia deste livro. + + + Você deve soluçar pelo menos uma vez. Ou no mínimo suspirar. Se não der certo, a cebola vai fazer tudo isso acontecer para você. + + lang-pt/poignant-09.yml @@ -1,59 +1,59 @@ - - !^sidebar - O que eu vou fazer com os lucros massivos deste Livro: > - - Qualquer um que já tenha escrito um livro pode lhe dizer como é fácil para um autor se distrair com delírios de grandeza. - Na minha experiência, eu paro duas vezes em cada parágrafo, e quatro vezes em cada tirinha, só para - antever a riqueza e prosperidade que este livro vai propiciar ao meu estilo de vida. Eu temo que a confecção - desse livro possa parar completamente para dar espaço ao exército de utilitários e carros de luxo que estão - passando pela minha cabeça. - - - Em vez de parar meu trabalho neste (Comovente) Guia, Eu reservei este espaço como uma zona de segurança - para despejar meus vazios e inúteis desejos. - - - Hoje eu estava nesse restaurante italiano, Granado's, e estava pagando a conta. Aconteceu de eu notar que - que uma garrafa de vinagre balsâmico estava saindo por $150. Bem pequena. Eu podia escondê-la na minha - mão. Envelhecida vinte e dois anos. - - - Eu gastei muito tempo pensando naquela garrafa. As vezes ela é um acessório em algumas dessas - fantasias obsessivas. Em uma fantasia, eu entro no restaurante, jogo uma pilha de vegetais sobre o balcão - e digo seriamente ao caixa, "Rápido! Eu tenho uma salada importante para fazer!" - - - Em outra fantasia relacionada, eu estou jogando alface fora. Tamanha brutalidade não vai se benefiar do meu novo - vinagre. Não, eu vou chegar ao ponto onde a fama e a aristocracia vão me corromper completamente. - Meu novo alface será dinheiro. Frio, duro dinheiro, Sra. Price. - - - Logo, eu estarei gastando centenas por um bloco de queijo myzithra. - - - Minha imaginação agora foi além das posses. Certamente, eu pensei sobre a minha - aquisição de urnas gregas, carreatas, linhas aéreas, pirâmides, ossos de dinossauro. Ocasionalmente eu verei - cidades devastadas no noticiário e vou anotar na minha lista de compras: _Furacão_. - - - Entretanto, agora eu vejo um objetivo maior. Colocando de forma simples: e se eu acumulasse uma fortuna tão grande que - casa da moeda não conseguisse imprimir o suficiente para atender a minha demanda? Então, todo mundo seria obrigado a usar dinheiro do "Banco Imobiliário" - como moeda. E você teria que ganhar no "Banco Imobiliário" para colocar comida na mesa. Estes seria jogos de - extrema tensão. Quero dizer, você pede hipoteca na Av. Botafogo e as crianças começam a chorar. - Além disso, eu acho que vou ver o início do fim daqueles que usam a regra de Estacionamento Grátis - como "os cofres subterrâneos":http://groups.yahoo.com/group/monopoly/message/37 para os recursos da cidade. - - - Apesar disso, você que dar algum valor ao dinheiro falso. Dinheiro falso detona. Você pode colocar suas mãos nele - tão rápido. Em um momento, parece que você é podre de rico. Quando eu era criança, eu me juntei com algumas crianças - da vizinhança e nós construimos uma pequena Tijuana na nossa rua. Nós fizemos nossos próprios pesos - vestimos sombreros e tudo mais! - - - Um garoto estava vendendo tamales quentes por dois pesos cada. _Dois pesos!_ Esse garoto sabia que o dinheiro era falso? - Ele era louco? Quem convidou esse garoto? Ele não sabia que isso aqui não era Tijuana de verdade? Talvez ele fosse de Tijuana! - Talvez estes fossem pesos _de verdade_! Vamos fazer mais pesos _de verdade_! - - - Eu acho que nós até tínhamos uma taberna onde você podia ficar completamente bêbado de Kool-Aid. Nada como crianças - correndo por aí, resmungando incoerências com os lábios vermelhos como os de um palhaço. - + - !^sidebar + O que eu vou fazer com os lucros massivos deste Livro: > + + Qualquer um que já tenha escrito um livro pode lhe dizer como é fácil para um autor se distrair com delírios de grandeza. + Na minha experiência, eu paro duas vezes em cada parágrafo, e quatro vezes em cada tirinha, só para + antever a riqueza e prosperidade que este livro vai propiciar ao meu estilo de vida. Eu temo que a confecção + desse livro possa parar completamente para dar espaço ao exército de utilitários e carros de luxo que estão + passando pela minha cabeça. + + + Em vez de parar meu trabalho neste (Comovente) Guia, Eu reservei este espaço como uma zona de segurança + para despejar meus vazios e inúteis desejos. + + + Hoje eu estava nesse restaurante italiano, Granado's, e estava pagando a conta. Aconteceu de eu notar que + que uma garrafa de vinagre balsâmico estava saindo por $150. Bem pequena. Eu podia escondê-la na minha + mão. Envelhecida vinte e dois anos. + + + Eu gastei muito tempo pensando naquela garrafa. As vezes ela é um acessório em algumas dessas + fantasias obsessivas. Em uma fantasia, eu entro no restaurante, jogo uma pilha de vegetais sobre o balcão + e digo seriamente ao caixa, "Rápido! Eu tenho uma salada importante para fazer!" + + + Em outra fantasia relacionada, eu estou jogando alface fora. Tamanha brutalidade não vai se benefiar do meu novo + vinagre. Não, eu vou chegar ao ponto onde a fama e a aristocracia vão me corromper completamente. + Meu novo alface será dinheiro. Frio, duro dinheiro, Sra. Price. + + + Logo, eu estarei gastando centenas por um bloco de queijo myzithra. + + + Minha imaginação agora foi além das posses. Certamente, eu pensei sobre a minha + aquisição de urnas gregas, carreatas, linhas aéreas, pirâmides, ossos de dinossauro. Ocasionalmente eu verei + cidades devastadas no noticiário e vou anotar na minha lista de compras: _Furacão_. + + + Entretanto, agora eu vejo um objetivo maior. Colocando de forma simples: e se eu acumulasse uma fortuna tão grande que + casa da moeda não conseguisse imprimir o suficiente para atender a minha demanda? Então, todo mundo seria obrigado a usar dinheiro do "Banco Imobiliário" + como moeda. E você teria que ganhar no "Banco Imobiliário" para colocar comida na mesa. Estes seria jogos de + extrema tensão. Quero dizer, você pede hipoteca na Av. Botafogo e as crianças começam a chorar. + Além disso, eu acho que vou ver o início do fim daqueles que usam a regra de Estacionamento Grátis + como "os cofres subterrâneos":http://groups.yahoo.com/group/monopoly/message/37 para os recursos da cidade. + + + Apesar disso, você que dar algum valor ao dinheiro falso. Dinheiro falso detona. Você pode colocar suas mãos nele + tão rápido. Em um momento, parece que você é podre de rico. Quando eu era criança, eu me juntei com algumas crianças + da vizinhança e nós construimos uma pequena Tijuana na nossa rua. Nós fizemos nossos próprios pesos + vestimos sombreros e tudo mais! + + + Um garoto estava vendendo tamales quentes por dois pesos cada. _Dois pesos!_ Esse garoto sabia que o dinheiro era falso? + Ele era louco? Quem convidou esse garoto? Ele não sabia que isso aqui não era Tijuana de verdade? Talvez ele fosse de Tijuana! + Talvez estes fossem pesos _de verdade_! Vamos fazer mais pesos _de verdade_! + + + Eu acho que nós até tínhamos uma taberna onde você podia ficar completamente bêbado de Kool-Aid. Nada como crianças + correndo por aí, resmungando incoerências com os lábios vermelhos como os de um palhaço. + lang-pt/poignant-10.yml @@ -1,57 +1,57 @@ - - A história do cachorro: > - - Vamos ver se a história a seguir comove você: - - - Um dia eu estava caminhando numa dessas ruas movimentadas cheias de revendas de carros (isso foi logo após meu casamento - ter sido cancelado) e achei um cachorro órfão na rua. Um cachorro preto, peludo, com olhos verde-avermelhados. Eu meio que - me senti órfão também, então eu peguei alguns balões que estavam amarrados a um poste em uma revenda - e amarrei eles na coleira do cachorro. Eu decidi, então, que ele seria meu cachorro. Eu dei a ele o nome de Bigelow. - - - Nós fomos comprar alguns Biscrocks para o Bigelow e, depois, seguimos para minha casa, onde nós poderíamos sentar em - cadeiras reclináveis e ouvir Zygotic Mynci de Gorky. Oh, e nós também teríamos que parar em um bazar para comprar uma cadeira - reclinável para o Bigelow. - - - Mas Bigelow não tinha me aceitado como seu mestre. Então, cinco minutos depois, aquele cachorro estúpido mudou de calçada - e eu o perdi. Logo, considerando que ele já esteve perdido uma vez, com essa eram duas. - Eu diminuí o passo em direção a uma vida de Biscrocks e um cadeira reclinável extra. Eu tive um cachorro por cinco minutos. - - - Estúpido cachorro traidor. Eu me sentei num banco e joguei pinhas em uma estátua de três ovelhas - atravessando uma ponte. Depois disso, eu chorei por horas. As lágrimas simplesmente vieram. Agora existe algo comovente - pra começar. - - - Eu imagino aonde foram parar aqueles balões. Aquele cachorro maluco parecia uma festa com - patas. - - - Não foi muito depois que eu fiz meu próprio Bigelow. Eu imprimi um bando de páginas sobre Ruby. Artigos - achados na Web. Eu dei uma olhada neles no trem indo para casa um dia. Folheei elas por cinco minutos - e desisti. Não me impressionou. - - - Eu sentei, olhando para o mundo através da janela, um liquidificador gigante misturando grafite e - ferro derretido bem na minha frente. _Este mundo é muito grande para uma linguagem tão pequena_, pensei. - _A pobrezinha não tem chance. Não tem pernas para se sustentar. Não tem braços para nadar._ - - - Lá estava eu. Um pequeno homem em um frágil e pequeno trem (e eu ainda tinha - um dente-de-leite naquela época) em meio a bilhões de pessoas vivendo numa bola azul - flutuante. Como eu posso enfrentar Ruby? Quem me garante que eu não vou morrer engasgado - com meu celular mais tarde naquela mesma noite? Why está morto, Ruby ainda vive. - - - A lápide: - - - bq. O que é isso na traquéia dele? - - Oh, olha, um Nokia! - - - É só a minha sorte. Finalmente vou ter um gostoso e duradouro cochilo embaixo da terra, só para ser constantemente - incomodado pela _Canône de Pachelbel_ tocando incessantemente no meu estômago. - + - A história do cachorro: > + + Vamos ver se a história a seguir comove você: + + + Um dia eu estava caminhando numa dessas ruas movimentadas cheias de revendas de carros (isso foi logo após meu casamento + ter sido cancelado) e achei um cachorro órfão na rua. Um cachorro preto, peludo, com olhos verde-avermelhados. Eu meio que + me senti órfão também, então eu peguei alguns balões que estavam amarrados a um poste em uma revenda + e amarrei eles na coleira do cachorro. Eu decidi, então, que ele seria meu cachorro. Eu dei a ele o nome de Bigelow. + + + Nós fomos comprar alguns Biscrocks para o Bigelow e, depois, seguimos para minha casa, onde nós poderíamos sentar em + cadeiras reclináveis e ouvir Zygotic Mynci de Gorky. Oh, e nós também teríamos que parar em um bazar para comprar uma cadeira + reclinável para o Bigelow. + + + Mas Bigelow não tinha me aceitado como seu mestre. Então, cinco minutos depois, aquele cachorro estúpido mudou de calçada + e eu o perdi. Logo, considerando que ele já esteve perdido uma vez, com essa eram duas. + Eu diminuí o passo em direção a uma vida de Biscrocks e um cadeira reclinável extra. Eu tive um cachorro por cinco minutos. + + + Estúpido cachorro traidor. Eu me sentei num banco e joguei pinhas em uma estátua de três ovelhas + atravessando uma ponte. Depois disso, eu chorei por horas. As lágrimas simplesmente vieram. Agora existe algo comovente + pra começar. + + + Eu imagino aonde foram parar aqueles balões. Aquele cachorro maluco parecia uma festa com + patas. + + + Não foi muito depois que eu fiz meu próprio Bigelow. Eu imprimi um bando de páginas sobre Ruby. Artigos + achados na Web. Eu dei uma olhada neles no trem indo para casa um dia. Folheei elas por cinco minutos + e desisti. Não me impressionou. + + + Eu sentei, olhando para o mundo através da janela, um liquidificador gigante misturando grafite e + ferro derretido bem na minha frente. _Este mundo é muito grande para uma linguagem tão pequena_, pensei. + _A pobrezinha não tem chance. Não tem pernas para se sustentar. Não tem braços para nadar._ + + + Lá estava eu. Um pequeno homem em um frágil e pequeno trem (e eu ainda tinha + um dente-de-leite naquela época) em meio a bilhões de pessoas vivendo numa bola azul + flutuante. Como eu posso enfrentar Ruby? Quem me garante que eu não vou morrer engasgado + com meu celular mais tarde naquela mesma noite? Why está morto, Ruby ainda vive. + + + A lápide: + + + bq. O que é isso na traquéia dele? + + Oh, olha, um Nokia! + + + É só a minha sorte. Finalmente vou ter um gostoso e duradouro cochilo embaixo da terra, só para ser constantemente + incomodado pela _Canône de Pachelbel_ tocando incessantemente no meu estômago. + lang-pt/poignant-11.yml @@ -1,55 +1,55 @@ - - Nasce o sol vermelho: > - - Então, agora você está se perguntando porque eu mudei de idéia em relação ao Ruby. A resposta rápida é: - rolou química. - - - Como quando você encontra alguém na faculdade e ela parece com alguém que - costumava bater na sua cara com um pincel quando você era criança. E então, impulsivamente, - você conclui que esse novo alguém é provavelmente hostil. Você faz careta quando vê o cabelo - dela. Você desliga o telefone bruscamente nos momentos cruciais das piadas dela. Você resolve - usar seu pula-pula bem onde ela está querendo caminhar! - - - Seis meses depois, de alguma forma, você e alguém estão sentados a beira de uma fonte tendo - uma conversa perfeitamente normal. A face dela não lembra mais seu nêmesis infantil. Você conheceu - o gêmeo bom. Rolou química. - - - Logo, apesar de que eu provavelmente devesse estar martelando seus dentes com todo o hype sobre Ruby - e todos os acrônimos minuciosamente preparados que a acompanham para todo lugar - (afiando as gargantas dos seus chefes e dos chefes do seus chefes), - em vez disso eu vou te deixar velejar. Vou deixar você - mergulhar no código, me intrometendo ocasionalmente com minhas próprias experiências. - Vai ser bem fácil, bem natural. - - - Eu devia, entretanto, te oferecer alguma espécie de motivação. Então, Smotchkkiss, eu vou lhe dar minhas três - melhores razões para aprender ruby e te deixar em paz. - - - # *Saúde mental.* <p>Vitamina R. Vai direto pra cabeça. Ruby vai te ensinar a - _expressar_ suas idéias através de um computador. Você vai estar escrevendo - estórias para uma máquina.</p> <p>Habilidades criativas, gente. Dedução. Razão. Acenar com a cabeça inteligentemente. - A linguagem vai se tornar uma ferramenta para melhorar a comunicação entre sua mente e o mundo. - Eu notei que muitos usuários experientes de Ruby parecem pensadores mais claros e - objetivos. (Em contraste a: altamente preconceituosos e grosseiros.)</p> - - # *Um homem em uma ilha.* <p>Ruby nasceu no Japão. O que é bizarro. O Japão não é conhecido - por seu software. E como linguagens de programação são largamente escritas em inglês, quem - iria imaginar uma linguagem vinda do Japão?</p> <p>E ainda assim, aqui temos Ruby. Contra todas as adversidades, - Yukihiro Matsumoto criou Ruby em 24 de Fevereiro de 1993. Pelos últimos dez anos, ele tem obstinadamente - trazido Ruby para uma audiência global. É triunfante, nobre e tudo mais. Apóie a diversidade. - Nos ajude a dobrar a Terra, só um pouquinho.</p> - - # *Grátis.* <p>Usar Ruby não custa nada. O código do próprio Ruby está aberto para todo o mundo - inspirar/expirar. Até esse livro é de graça. É tudo parte de uma enorme doação que deveria - ter alguma venda casada junto.</p> <p>Você poderia pensar que nós faríamos você comprar aspiradores-de-pó - ou tempo de uso, ou falsos Monet. Você poderia pensar que haveria uma palestra de 90 minutos onde o dono - da empresa aparece no final e força você a fechar negócio.</p> <p>Não, é grátis.</p> - - - Com isso, é hora do livro começar. Você pode pegar seu marca-texto e começar a arrastá-lo - sobre cada palavra cativante a partir desta sentença. Eu acho que tenho spray de cabelo e dinheiro - de brinquedo o suficiente comigo para me sustentar até a página final. - + - Nasce o sol vermelho: > + + Então, agora você está se perguntando porque eu mudei de idéia em relação ao Ruby. A resposta rápida é: + rolou química. + + + Como quando você encontra alguém na faculdade e ela parece com alguém que + costumava bater na sua cara com um pincel quando você era criança. E então, impulsivamente, + você conclui que esse novo alguém é provavelmente hostil. Você faz careta quando vê o cabelo + dela. Você desliga o telefone bruscamente nos momentos cruciais das piadas dela. Você resolve + usar seu pula-pula bem onde ela está querendo caminhar! + + + Seis meses depois, de alguma forma, você e alguém estão sentados a beira de uma fonte tendo + uma conversa perfeitamente normal. A face dela não lembra mais seu nêmesis infantil. Você conheceu + o gêmeo bom. Rolou química. + + + Logo, apesar de que eu provavelmente devesse estar martelando seus dentes com todo o hype sobre Ruby + e todos os acrônimos minuciosamente preparados que a acompanham para todo lugar + (afiando as gargantas dos seus chefes e dos chefes do seus chefes), + em vez disso eu vou te deixar velejar. Vou deixar você + mergulhar no código, me intrometendo ocasionalmente com minhas próprias experiências. + Vai ser bem fácil, bem natural. + + + Eu devia, entretanto, te oferecer alguma espécie de motivação. Então, Smotchkkiss, eu vou lhe dar minhas três + melhores razões para aprender ruby e te deixar em paz. + + + # *Saúde mental.* <p>Vitamina R. Vai direto pra cabeça. Ruby vai te ensinar a + _expressar_ suas idéias através de um computador. Você vai estar escrevendo + estórias para uma máquina.</p> <p>Habilidades criativas, gente. Dedução. Razão. Acenar com a cabeça inteligentemente. + A linguagem vai se tornar uma ferramenta para melhorar a comunicação entre sua mente e o mundo. + Eu notei que muitos usuários experientes de Ruby parecem pensadores mais claros e + objetivos. (Em contraste a: altamente preconceituosos e grosseiros.)</p> + + # *Um homem em uma ilha.* <p>Ruby nasceu no Japão. O que é bizarro. O Japão não é conhecido + por seu software. E como linguagens de programação são largamente escritas em inglês, quem + iria imaginar uma linguagem vinda do Japão?</p> <p>E ainda assim, aqui temos Ruby. Contra todas as adversidades, + Yukihiro Matsumoto criou Ruby em 24 de Fevereiro de 1993. Pelos últimos dez anos, ele tem obstinadamente + trazido Ruby para uma audiência global. É triunfante, nobre e tudo mais. Apóie a diversidade. + Nos ajude a dobrar a Terra, só um pouquinho.</p> + + # *Grátis.* <p>Usar Ruby não custa nada. O código do próprio Ruby está aberto para todo o mundo + inspirar/expirar. Até esse livro é de graça. É tudo parte de uma enorme doação que deveria + ter alguma venda casada junto.</p> <p>Você poderia pensar que nós faríamos você comprar aspiradores-de-pó + ou tempo de uso, ou falsos Monet. Você poderia pensar que haveria uma palestra de 90 minutos onde o dono + da empresa aparece no final e força você a fechar negócio.</p> <p>Não, é grátis.</p> + + + Com isso, é hora do livro começar. Você pode pegar seu marca-texto e começar a arrastá-lo + sobre cada palavra cativante a partir desta sentença. Eu acho que tenho spray de cabelo e dinheiro + de brinquedo o suficiente comigo para me sustentar até a página final. + lang-pt/poignant-12.yml @@ -1,39 +1,39 @@ - - Como livros começam: > - - Olha, se você algum dia já leu um livro, você sabe que nenhum livro pode começar direito sem uma - quantidade exorbitante de sinergia. Sim, sinergia. Talvez você não soubesse disso. Sinergia que dizer que eu e você - devemos cooperar para fazer desta leitura uma ótima experiência. - - - Começamos o livro nos dando bem na Introdução. - Esse companheirismo, essa *sinergia*, nos impulsiona pelo livro, - comigo guiando você em seu caminho. Acene com a cabeça ou dê uma risadinha para indicar o seu progresso. - - - Eu sou Peter Pan segurando a sua mão. Vamos, Wendy! Segunda estrela à direita e em frente até o amanhecer. - - - Um problema aqui. Eu não me dou bem com gente. Eu não seguro mãos muito bem. - - - Qualquer um da minha equipe vai lhe dizer. Nas Cerimônias de Abertura Deste Livro (um evento com buffet - e arquibancadas), eu descobri que os sanduíches de pepino não eram servidos em guardanapos de tecido. - Como resultado, a manteiga não se ajustou aos pepinos direito... De qualquer forma, Eu fiz uma grande cena - e ateei fogo a alguns caminhões de propaganda do lado de fora. Eu deixei um holofote em pedaços, e coisas - do tipo. Eu dava risadas maníacas extremamente altas até o final daquela noite. Foi uma bagunça e tanto. - - - Entretanto, já que eu não me dou bem com gente. Eu não convidei ninguém além de mim para as - Cerimônias de Abertura Deste Livro. Então não foi tão embaraçoso assim. Eu mantive o caso sob panos quentes - e ninguém jamais ficou sabendo do que aconteceu. - - - Então você tem que saber que *sinergia* não significa exatamente *sinergia* nesse livro. Eu não posso com a *sinergia* - normal. - Não, neste livro, *sinergia* significa *raposas em quadrinhos*. O que eu quero dizer é: este livro vai - começar com uma quantidade exorbitante de *raposas em quadrinhos*. - - - E eu vou contar com você para transformá-las em *sinergia*. - - + - Como livros começam: > + + Olha, se você algum dia já leu um livro, você sabe que nenhum livro pode começar direito sem uma + quantidade exorbitante de sinergia. Sim, sinergia. Talvez você não soubesse disso. Sinergia que dizer que eu e você + devemos cooperar para fazer desta leitura uma ótima experiência. + + + Começamos o livro nos dando bem na Introdução. + Esse companheirismo, essa *sinergia*, nos impulsiona pelo livro, + comigo guiando você em seu caminho. Acene com a cabeça ou dê uma risadinha para indicar o seu progresso. + + + Eu sou Peter Pan segurando a sua mão. Vamos, Wendy! Segunda estrela à direita e em frente até o amanhecer. + + + Um problema aqui. Eu não me dou bem com gente. Eu não seguro mãos muito bem. + + + Qualquer um da minha equipe vai lhe dizer. Nas Cerimônias de Abertura Deste Livro (um evento com buffet + e arquibancadas), eu descobri que os sanduíches de pepino não eram servidos em guardanapos de tecido. + Como resultado, a manteiga não se ajustou aos pepinos direito... De qualquer forma, Eu fiz uma grande cena + e ateei fogo a alguns caminhões de propaganda do lado de fora. Eu deixei um holofote em pedaços, e coisas + do tipo. Eu dava risadas maníacas extremamente altas até o final daquela noite. Foi uma bagunça e tanto. + + + Entretanto, já que eu não me dou bem com gente. Eu não convidei ninguém além de mim para as + Cerimônias de Abertura Deste Livro. Então não foi tão embaraçoso assim. Eu mantive o caso sob panos quentes + e ninguém jamais ficou sabendo do que aconteceu. + + + Então você tem que saber que *sinergia* não significa exatamente *sinergia* nesse livro. Eu não posso com a *sinergia* + normal. + Não, neste livro, *sinergia* significa *raposas em quadrinhos*. O que eu quero dizer é: este livro vai + começar com uma quantidade exorbitante de *raposas em quadrinhos*. + + + E eu vou contar com você para transformá-las em *sinergia*. + + lang-pt/poignant-13.yml @@ -1 +1 @@ - - Um Rápido (e indolor, eu espero) passeio através do Ruby (com quadrinhos da raposa): + - Um Rápido (e indolor, eu espero) passeio através do Ruby (com quadrinhos da raposa): lang-pt/poignant-14.yml @@ -1,19 +1,19 @@ - - > - !i/the.foxes-1.png(As raposas aparecem.)! - - - Isso, essas são as duas. Minha asma está atacada, preciso dar uma respirada num ar - medicinal agora. Já volto. - - - !i/the.foxes-2.png(Raposas em quadrinhos.)! - - - Me disseram que este capítulo combina bem com uma toalha. Algo para você enxugar seu rosto - quando o suor começar a escorrer. - - - De fato, estaremos percorrendo toda a linguagem muito rápido. Será como acender todos os fósforos - de uma caixa do jeito mais rápido. - - + - > + !i/the.foxes-1.png(As raposas aparecem.)! + + + Isso, essas são as duas. Minha asma está atacada, preciso dar uma respirada num ar + medicinal agora. Já volto. + + + !i/the.foxes-2.png(Raposas em quadrinhos.)! + + + Me disseram que este capítulo combina bem com uma toalha. Algo para você enxugar seu rosto + quando o suor começar a escorrer. + + + De fato, estaremos percorrendo toda a linguagem muito rápido. Será como acender todos os fósforos + de uma caixa do jeito mais rápido. + + lang-pt/poignant-15.yml @@ -1,77 +1,77 @@ - - Linguagem e E QUERO DIZER Linguagem: > - !i/the.foxes-3.png(Nossos amigos, aqueles dois raposos indefesos, finalmente deram conta - da gravidade da situação em que se encontram.)! - - - Minha consciência não me deixa chamar o Ruby de uma linguagem de _computador._ Isso implica que - a linguagem funciona primariamente em termos de computador. Que a linguagem é criada para acomodar - o computador, única e exclusivamente. E portanto, nós, os programadores, somos estrangeiros, buscando cidadania n the - no país dos computadores. É a linguagem do computador e nós somos os tradutores para o mundo. - - - Mas como você a chamaria quando seu cérebro começa a pensar nessa linguagem? Quando você - começa a usar as próprias palavras e coloquismos da linguagem para se expressar. Diga, o computador não - consegue fazer aquilo. Como pode então ser a linguagem do computador? Ela é nossa, nós a falamos nativamete! - - - Nós não podemos mais verdadeiramente chamá-la de linguagem de _computador_. - Ela é _papo de programador_. É a linguagem dos nossos pensamentos. - - - *Leia o trecho a seguir em voz alta.* - - - bq. @5.times { print "Odelay!" }@ - - - No inglês, as pontuações (pontos, exclamações, parênteses) são mudas. Pontuação agrega - significado às palavras, dá pistas da intenção do autor na frase. Vamos então ler o trecho - assim: _Cinco vezes imprima "Odelay!"._ - - - Que é exatamente o que este pequeno programa Ruby faz. O "espanhol mutante" do - Beck:http://www.whiskeyclone.net/ghost/L/lordonlyknows.html exclamation irá imprimir - cinco vezes na tela do computador. - - - *Leia o trecho a seguir em voz alta.* - - - bq. @exit unless "restaurante".include? "aura"@ - - - Aqui estamos fazendo um teste básico de realidade. Nosso programa vai *exit (sair)* (o programa vai terminar) *unless (a menos que)* - a palavra *restaurante* contenha (ou *inclua*) a palavra *aura*. Novamente, em Português: _Saia a nao ser que a palavra - restaurante inclua a palavra aura._ - - - Já viu alguma linguagem de programação usar a pontuação tão eficientemente? Ruby usa a pontuação, - como exclamações e interrogações, pra melhorar a legibilidade do código. Nós estamos fazendo uma pergunta - no código acima, então por quê não deixar isso aparente? - - - *Leia o trecho a seguir em voz alta.* - - - bq. @['torrada', 'queijo', 'vinho'].each { |comida| print comida.capitalize }@ - - - Enquanto este pedaço de código é menos legível e parecido com uma frase que o anterior, eu ainda assim - o encorajo a ler em voz alta. Enquanto o Ruby algumas vezes soa como Português noutras soa como Português Curto. - Totalmente traduzido pra Português, você poderia ler desta maneira: _Com as palavras 'torrada', 'queijo', - e 'vinho': pegue cada comida e a imprima com a primeira letra maiúscula._ - - - O computador então responde de forma cortêz: @Torrada@, @Queijo@ e @Vinho@. - - - Neste ponto, você deve estar se perguntando como essas palavras realmente funcionam juntas. O Smotchkkiss está imaginando - o que os pontos e chaves significam. Vou discutir as várias _partes da conversa_ em seguida. - - - Tudo que você precisa saber até agora é que o Ruby é basicamente construído de sentenças. Ela não são English - sentences. Elas são pequenas coleções de palavras e pontuação which encompass a single thought. Estas - sentenças podem formar livros. Elas podem formar páginas. Elas podem formar romances inteiros, quando combinadas. - Romances que modem ser lidos por humanos, mas também por computadores. - - + - Linguagem e E QUERO DIZER Linguagem: > + !i/the.foxes-3.png(Nossos amigos, aqueles dois raposos indefesos, finalmente deram conta + da gravidade da situação em que se encontram.)! + + + Minha consciência não me deixa chamar o Ruby de uma linguagem de _computador._ Isso implica que + a linguagem funciona primariamente em termos de computador. Que a linguagem é criada para acomodar + o computador, única e exclusivamente. E portanto, nós, os programadores, somos estrangeiros, buscando cidadania n the + no país dos computadores. É a linguagem do computador e nós somos os tradutores para o mundo. + + + Mas como você a chamaria quando seu cérebro começa a pensar nessa linguagem? Quando você + começa a usar as próprias palavras e coloquismos da linguagem para se expressar. Diga, o computador não + consegue fazer aquilo. Como pode então ser a linguagem do computador? Ela é nossa, nós a falamos nativamete! + + + Nós não podemos mais verdadeiramente chamá-la de linguagem de _computador_. + Ela é _papo de programador_. É a linguagem dos nossos pensamentos. + + + *Leia o trecho a seguir em voz alta.* + + + bq. @5.times { print "Odelay!" }@ + + + No inglês, as pontuações (pontos, exclamações, parênteses) são mudas. Pontuação agrega + significado às palavras, dá pistas da intenção do autor na frase. Vamos então ler o trecho + assim: _Cinco vezes imprima "Odelay!"._ + + + Que é exatamente o que este pequeno programa Ruby faz. O "espanhol mutante" do + Beck:http://www.whiskeyclone.net/ghost/L/lordonlyknows.html exclamation irá imprimir + cinco vezes na tela do computador. + + + *Leia o trecho a seguir em voz alta.* + + + bq. @exit unless "restaurante".include? "aura"@ + + + Aqui estamos fazendo um teste básico de realidade. Nosso programa vai *exit (sair)* (o programa vai terminar) *unless (a menos que)* + a palavra *restaurante* contenha (ou *inclua*) a palavra *aura*. Novamente, em Português: _Saia a nao ser que a palavra + restaurante inclua a palavra aura._ + + + Já viu alguma linguagem de programação usar a pontuação tão eficientemente? Ruby usa a pontuação, + como exclamações e interrogações, pra melhorar a legibilidade do código. Nós estamos fazendo uma pergunta + no código acima, então por quê não deixar isso aparente? + + + *Leia o trecho a seguir em voz alta.* + + + bq. @['torrada', 'queijo', 'vinho'].each { |comida| print comida.capitalize }@ + + + Enquanto este pedaço de código é menos legível e parecido com uma frase que o anterior, eu ainda assim + o encorajo a ler em voz alta. Enquanto o Ruby algumas vezes soa como Português noutras soa como Português Curto. + Totalmente traduzido pra Português, você poderia ler desta maneira: _Com as palavras 'torrada', 'queijo', + e 'vinho': pegue cada comida e a imprima com a primeira letra maiúscula._ + + + O computador então responde de forma cortêz: @Torrada@, @Queijo@ e @Vinho@. + + + Neste ponto, você deve estar se perguntando como essas palavras realmente funcionam juntas. O Smotchkkiss está imaginando + o que os pontos e chaves significam. Vou discutir as várias _partes da conversa_ em seguida. + + + Tudo que você precisa saber até agora é que o Ruby é basicamente construído de sentenças. Ela não são English + sentences. Elas são pequenas coleções de palavras e pontuação which encompass a single thought. Estas + sentenças podem formar livros. Elas podem formar páginas. Elas podem formar romances inteiros, quando combinadas. + Romances que modem ser lidos por humanos, mas também por computadores. + + lang-pt/poignant-16.yml @@ -1,132 +1,132 @@ - - !^sidebar - A respeito do uso comercial do (Poignant) Guide: > - - Este livro foi lançado sob a licença Creative Commons que permite uso comercial ilimitado - deste texto. Basicamente, isto significa que você pode vender todas cópias piratas do meu livro - e ficar com todo o lucro pra você. Eu confio nos meus leitores (e no mundo ao redor deles) para me passar pra trás. - E colocar uma edição em Xerox com aquele clipart das mãos unidas rezando, que nós conhecemos, na capa. - - - Caras, processar os outros não vale a pena, é muita dor de cabeça. Então eu simplesmente vou apoiar - a pirataria aqui. Qualquer um que quiser ler este livro deveria poder fazê-lo. - Qualquer um que queira comercializar o livro ou criar edições especiais, eu fico lisonjeado. - - - Porque eu iria querer o $$$? IGNORE TODAS AS OUTRAS BARRAS LATERAIS: Eu perdi a vontade de ser um ricaço preguiçoso. - Soa um pouco desumano, mas eu gosto da minha televisão preto-e-branco. E adoro minha luminária florida. - Eu não quero uma carreira de escritor. Dinheiro não vai me inspirar. Não faz sentido. - - - Então, se dinheiro não significa nada ao the lucky stiff, pra que me enganar quando você pode pode optar por - práticas comerciais exclusas para literalmente esmagar minhas psiquê e me deixar chorando com meu pulmão preto? - Oh, e a ironia de usar meu trabalho contra mim! Morra, garoto comovido! - - - Pra te dar uma idéia do que quero dizer, aqui estão alguns conceitos dissimulados que poderiam seriamente - matar minha força de vontade de me forçar a reconsiderar algumas coisas, como a existência. - - - *IDÉIA UM: BIG TOBACCO* - - - Compre uma companhia de cigarros. Use meus cartuns dos raposos pra abastecer uma agressiva campanha publicitária. - Aqui está um anúncio para começar: - - - !i/the.foxes-0a.png(Vicío é igual Pokemon!)! - - - Deixe óbvio que seu público alvo são crianças e asmáticos. Então, logo que você tiver - tudo pronto, faça com que as pessoas da *verdade* façam um dossiê sobre mim e minha fazenda - de raposas de tinta. - - - bq. *Moderninho sensível apoiado na borda da selva urbana*: Ele se entitula the lucky stiff. - - - bq. (Puxa as cortinas para revelar um corpo cinza em uma maca.) - - - bq. *Moderninho*: Alguns stiffs não são tão lucky (sortudo) assim. - - - bq. (Som errático. Raposas em quadrinhos superimpostas para gerar uma viagem subliminar mental Willy Wonka.) - - - Yo. Porque cê tem esses Big Smokies assim, Holmes? - - - *IDÉIA DOIS: HEY, PELOTÃO DE FUZILAMENTO* - - - Como eu disse, comecem a vender cópias do meu livro, mas corrompam o texto. Estas cópias alteradas - conteriam numerosas referências grosseiras (e difamatórias) às agências do governo, como - o exército americano e o pentágono. Você me faria com que eu parecesse um completo traidor. Como se eu tivesse - todos esses planos para, você sabe, matar certos membros menos desejáveis do exército ou - o Pentágono. - - - Não que existam membros menos desejáveis no exército ou no Pentágono. É, - não era isso que eu queria dizer. - - - Oh, merda. - - - Oh, merda. Oh, merda. Oh, merda. - - - Apague as luzes. Se abaixe. - - - *IDÉIA TRÊS: ANÚNCIOS, PART II* - - - Que tal fazer graça de asmáticos diretamente?? - - - !i/the.foxes-0b.png(Chame-o de soprador! ROFL!)! - - - *IDÉIA QUATRO: ALEC BALDWIN* - - - Faça uma adaptação do livro para o cinema. E já que eu, você sabe, sou um personagem no livro - você poderia conseguir alguém como Alec Baldwin para me interpretar. Alguém que esteja num período - muito ruim em sua carreira. - - - Você podia fazer como se eu usasse toneladas de drogas. Como se eu fosse insano de se trabalhar. - Como se eu ficasse demitindo pessoas e trancando elas na sala da scooter e obrigá-las a vestir - roupas feitas de pão. Isso, como se eu pudesse realmente _assar_ as pessoas - nas roupas. - - - Você podia dizer que eu tenho uma forma gigante e que eu prendo as pessoas dentro. Então, - eu derramo toda massa e de fato asso eles até o pão crescer e eles estarem quase mortos. - E quando o pessoal da televisão vier e eu aparecer no Good Morning America, eles vão perguntar, - "Então, quantas pessoas você empregou na produção do seu livro?" E eu - responderia, "Uma dúzia de padeiro!" e eclodir em gargalhadas maníacas tão altas que forcariam - a audiência a tampar os ouvidos. - - - É claro que, no curso da minha insaindade, eu declararia guerra ao mundo. As pessoas - pão aguentariam um bom tempo. Até que o exército americano (ou o Pentágono) - construísse um cérebro de macaco robótico gigante (interpretado por Burt Lancaster) para me perseguir. - - - Aqui você vai me fazer parecer completamente idiota. Eu não sacrificarei apenas todas - as pessoas pão (os Starchtroopers) para me salvar, não apenas me renderei ao - grande cérebro de macaco covardemente, mas quando eu escapar por um triz, eu vou gritar para - a platéia. Gritando incessantemente que aquele é _MEU_ filme e que ninguém deveria mais - assistí-lo, eu rasgarei a tela ao meio e o projetor vai rodar seues rolos em vão. - E este será o final do filme. As pessoas ficarão _tão_ irritadas. - - - Fiquei pensando aqui. De fato Alec Baldwin fez um trabalho decente de dublagem - em _Os Excêntricos Tenembaums_. A carreira dele deve estar indo bem. Você pode não querer usá-lo. - Ele pode não aceitar. - - - Façamos o seguinte. Eu interpreto esse papel. Eu tenho uma carreira de papéis ruims. - + - !^sidebar + A respeito do uso comercial do (Poignant) Guide: > + + Este livro foi lançado sob a licença Creative Commons que permite uso comercial ilimitado + deste texto. Basicamente, isto significa que você pode vender todas cópias piratas do meu livro + e ficar com todo o lucro pra você. Eu confio nos meus leitores (e no mundo ao redor deles) para me passar pra trás. + E colocar uma edição em Xerox com aquele clipart das mãos unidas rezando, que nós conhecemos, na capa. + + + Caras, processar os outros não vale a pena, é muita dor de cabeça. Então eu simplesmente vou apoiar + a pirataria aqui. Qualquer um que quiser ler este livro deveria poder fazê-lo. + Qualquer um que queira comercializar o livro ou criar edições especiais, eu fico lisonjeado. + + + Porque eu iria querer o $$$? IGNORE TODAS AS OUTRAS BARRAS LATERAIS: Eu perdi a vontade de ser um ricaço preguiçoso. + Soa um pouco desumano, mas eu gosto da minha televisão preto-e-branco. E adoro minha luminária florida. + Eu não quero uma carreira de escritor. Dinheiro não vai me inspirar. Não faz sentido. + + + Então, se dinheiro não significa nada ao the lucky stiff, pra que me enganar quando você pode pode optar por + práticas comerciais exclusas para literalmente esmagar minhas psiquê e me deixar chorando com meu pulmão preto? + Oh, e a ironia de usar meu trabalho contra mim! Morra, garoto comovido! + + + Pra te dar uma idéia do que quero dizer, aqui estão alguns conceitos dissimulados que poderiam seriamente + matar minha força de vontade de me forçar a reconsiderar algumas coisas, como a existência. + + + *IDÉIA UM: BIG TOBACCO* + + + Compre uma companhia de cigarros. Use meus cartuns dos raposos pra abastecer uma agressiva campanha publicitária. + Aqui está um anúncio para começar: + + + !i/the.foxes-0a.png(Vicío é igual Pokemon!)! + + + Deixe óbvio que seu público alvo são crianças e asmáticos. Então, logo que você tiver + tudo pronto, faça com que as pessoas da *verdade* façam um dossiê sobre mim e minha fazenda + de raposas de tinta. + + + bq. *Moderninho sensível apoiado na borda da selva urbana*: Ele se entitula the lucky stiff. + + + bq. (Puxa as cortinas para revelar um corpo cinza em uma maca.) + + + bq. *Moderninho*: Alguns stiffs não são tão lucky (sortudo) assim. + + + bq. (Som errático. Raposas em quadrinhos superimpostas para gerar uma viagem subliminar mental Willy Wonka.) + + + Yo. Porque cê tem esses Big Smokies assim, Holmes? + + + *IDÉIA DOIS: HEY, PELOTÃO DE FUZILAMENTO* + + + Como eu disse, comecem a vender cópias do meu livro, mas corrompam o texto. Estas cópias alteradas + conteriam numerosas referências grosseiras (e difamatórias) às agências do governo, como + o exército americano e o pentágono. Você me faria com que eu parecesse um completo traidor. Como se eu tivesse + todos esses planos para, você sabe, matar certos membros menos desejáveis do exército ou + o Pentágono. + + + Não que existam membros menos desejáveis no exército ou no Pentágono. É, + não era isso que eu queria dizer. + + + Oh, merda. + + + Oh, merda. Oh, merda. Oh, merda. + + + Apague as luzes. Se abaixe. + + + *IDÉIA TRÊS: ANÚNCIOS, PART II* + + + Que tal fazer graça de asmáticos diretamente?? + + + !i/the.foxes-0b.png(Chame-o de soprador! ROFL!)! + + + *IDÉIA QUATRO: ALEC BALDWIN* + + + Faça uma adaptação do livro para o cinema. E já que eu, você sabe, sou um personagem no livro + você poderia conseguir alguém como Alec Baldwin para me interpretar. Alguém que esteja num período + muito ruim em sua carreira. + + + Você podia fazer como se eu usasse toneladas de drogas. Como se eu fosse insano de se trabalhar. + Como se eu ficasse demitindo pessoas e trancando elas na sala da scooter e obrigá-las a vestir + roupas feitas de pão. Isso, como se eu pudesse realmente _assar_ as pessoas + nas roupas. + + + Você podia dizer que eu tenho uma forma gigante e que eu prendo as pessoas dentro. Então, + eu derramo toda massa e de fato asso eles até o pão crescer e eles estarem quase mortos. + E quando o pessoal da televisão vier e eu aparecer no Good Morning America, eles vão perguntar, + "Então, quantas pessoas você empregou na produção do seu livro?" E eu + responderia, "Uma dúzia de padeiro!" e eclodir em gargalhadas maníacas tão altas que forcariam + a audiência a tampar os ouvidos. + + + É claro que, no curso da minha insaindade, eu declararia guerra ao mundo. As pessoas + pão aguentariam um bom tempo. Até que o exército americano (ou o Pentágono) + construísse um cérebro de macaco robótico gigante (interpretado por Burt Lancaster) para me perseguir. + + + Aqui você vai me fazer parecer completamente idiota. Eu não sacrificarei apenas todas + as pessoas pão (os Starchtroopers) para me salvar, não apenas me renderei ao + grande cérebro de macaco covardemente, mas quando eu escapar por um triz, eu vou gritar para + a platéia. Gritando incessantemente que aquele é _MEU_ filme e que ninguém deveria mais + assistí-lo, eu rasgarei a tela ao meio e o projetor vai rodar seues rolos em vão. + E este será o final do filme. As pessoas ficarão _tão_ irritadas. + + + Fiquei pensando aqui. De fato Alec Baldwin fez um trabalho decente de dublagem + em _Os Excêntricos Tenembaums_. A carreira dele deve estar indo bem. Você pode não querer usá-lo. + Ele pode não aceitar. + + + Façamos o seguinte. Eu interpreto esse papel. Eu tenho uma carreira de papéis ruims. + lang-pt/poignant-17.yml @@ -1,591 +1,591 @@ - - As Partes da Conversa: > - - Assim como a faixa branca nas costas do gambá e a branca e enrolada grinalda da noiva, várias partes - da conversa têm sinalizações visuais para te ajudar a identificá-las. Pontuação, maiúsculas e minúsculas, - irão ajudar seu cérebro ver pedaços de código e os reconhecê-los intensamente. - Sua mente vai gritar frequentemente _Hey, Eu conheço aquele cara!_ Você vai também poder - contar vantagem em conversas com outros Rubistas. - - - Tente se focar na aparência de cada uma destas partes da conversa. O resto do livro vai - entrar em detalhes. Eu darei pequenas descrições de cada parte da conversa, mas você não precisa - entender a explicação. Ao término deste capítulo, você deve estar apto a reconhecer - cada parte de um programa Ruby. - - - h3. Variáveis - - - Qualquer palavra simples, em minúsculas, é uma variável no ruby. Variáveis podem consistir de - letras, dígitos e travessões. - - - bq. @x@, @y@, @banana2@ or @telefone_pruma_codorna@ são exemplos. - - - Variáveis são como apelidos. Lembra quando todo mundo te chamava de Pete Fedido? - As pessoas diziam, "Vem aqui, Pete Fedido!" E todo mundo milagrosamente sabia que - você era o Pete Fedido. - - - Com variáveis, você dá um apelido a algo que você use frequentemente. Por exemplo, vamos dizer - que você tem um orfanato. É um orfanato maléfico. E quando o Papai Warbucks vem comprar - mais crianças, nós insistimos que ele nos pague *cento e vinte um reais e oito centavos* pelo urso - teddy da criança, o qual ela ficou apegada nos momentos sombrios que passou vivendo neste pesadelo de - custódia. - - - bq. @taxa_de_urso_teddy = 121.08@ - - - Mais tarde, quando você pegar ele no caixa (uma registradora turbinada que roda - Ruby!), você vai precisar juntar as somas em um *total*. - - - bq. @total = taxa_de_orfao + taxa_de_urso_teddy + gorjeta@ - - - Estes apelidos pra variáveis vêm a calhar. E no submundo sedento das vendas infantis, qualquer ajuda - é bem-vinda, tenho certeza. - - - !i/the.foxes-4a.png(They mock my examples.)! - - - - h3. Números - - - O tipo mais básico de número é um _integer_ (número inteiro), uma *série de dígitos* que podem começar - com um *sinal de menos ou de mais*. - - - bq. @1@, @23@, e @-10000@ são exemplos. - - - Vírgulas não são permitidas em números, mas travessões sim. Então se você acha melhor - marcar os milhares para que o número fique mais legível, use um travessão. - - - bq. @habitantes = 12_000_000_000@ - - - Números decimais são chamados de _floats_ (números reais ou ponto flutuante) no Ruby. - Números reais consistem em números com - *casas decimais* ou *em notação científica*. - - - bq. @3.14@, @-808.08@ e @12.043e-04@ são exemplos. - - - - h3. Strings (Conjunto de Caracteres) - - - Strings são quaisquer tipos de caracteres (letras, dígitos, pontuação) cercados por aspas. - *Aspas* simples ou duplas, são usadas para se criar strings. - - - bq. @"laboratoriodomar"@, @'2021'@, or @"Estes quadrinhos são hilários!"@ - são exemplos. - - - Quando você cerca caracteres em aspas, eles ficam guardados juntos como uma string só. - - - Pense num repórter que está anotando as baboseiras de uma celebridade incoerente. "Eu estou - muito mais sábia," disse Avril Lavigne. "Agora eu sei como as coisas são -- o que você tem que fazer - e como trabalhar isso." - - - <pre> - frase_da_avril = "Eu estou muito mais sábia. Agora eu sei - como as coisas são -- o que você tem - que fazer e como trabalhar isso." - </pre> - - - Então, assim como nós guardamos um número na variável *taxa_de_urso_teddy,* agora nós estamos guardando - uma coleção de caracteres (uma string) na variável *frase_da_avril*. O repórter envia esta frase - para impressão, que por acaso usa Ruby para operar as impressoras. - - - <pre> - <setup> - frase_da_oprah = "O" - frase_da_avril = "A" - debate_ashlee_simpson = "D" - </setup> - print frase_da_oprah - print frase_da_avril - print debate_ashlee_simpson - </pre> - - - !i/the.foxes-4b.png(They desire to be in my examples.)! - - - - h3. Symbols (Símbolos) - - - Símbolos são palavras que parecem variáveis. Novamente, elas podem conter letras, - dígitos e travessões. Mas elas *começam com dois pontos*. - - - bq. @:a@, @:b@, ou @:ponce_de_leon@ are examples. - - - Símbolos são strings leves. Geralmente, símbolos são usados em situações em que você precisa de uma string - mas não vai imprimí-la na tela. - - - Você pode dizer que um símbolo é pouco mais digerível pro computador. É como um anti-ácido. Os dois pontos - indicam as bolhas saindo com estômago do computador enquanto ele digere o símbolo. Ah. Doce, doce alívio. - - - !i/the.foxes-4c.png(Bacon Pedaçudo!!)! - - - - h3. Constantes - - - Constantes são palavras como variáveis, mas constantes são *maiúsculas*. Se variáveis são os - substativos do Ruby, então pense nas constantes como substantivos próprios. - - - bq. @Time@, @Array@ or @Bunny_Lake_Desapareceu@ são exemplos. - - - Em inglês, substantivos próprios têm a primeira letra maiúscula. O Edifício Empire State. Você não pode simplesmente - mudar o Edíficio Empire State. Você não pode simplesmente decidir que o Edifício Empire State Building é outra coisa. - Substantivos próprios são assim. Eles se referem a algo muito específico e que usualmente não - muda com o tempo. - - - Do mesmo modo, constantes não podem ser alteradas depois de criadas. - - - bq. @EdificioEmpireState = "350 5th Avenue, NYC, NY"@ - - - Se tentarmos mudar a constante, Ruby vai reclamar com a gente. Coisas assim desagradam ele. - - - !i/the.foxes-4d.png(Come on, chunky bacon.)! - - - - h3. Metódos - - - Se variáveis e constantes são substantivos, então métodos são verbos. - Métodos geralmente estão ligados ao final das variáveis e constantes por um *ponto*. Você já viu - métodos trabalhando. - - - bq. @porta_da_frente.abra@ - - - Acima, *abra* é o método. Nesta ação, o verbo. Em alguns casos, você vai ver ações ligadas juntas. - - - bq. @porta_da_frente.abra.feche@ - - - Instruímos o computador a abrir a porta da frente e depois imediatamente fechá-la. - - - bq. @porta_da_frente.esta_aberta?@ - - - Acima temos uma ação também. Estamos instruído o computador a testar a porta para ver se está aberta. - O método poderia se chamar @Porta.teste_para_ver_se_esta_aberta@, mas o nome @esta_aberta?@ é sucinto e - também correto. Exclamações e interrogações podem ser usadas em nomes de métodos. - - - h3. Argumentos de Método - - - Um método talvez precise de mais informação pra realizar sua ação. Se quisermos que o computador - pinte a porta, devemos prover uma cor também. - - - Argumentos de método vão ligados ao final do método. Os argumentos estão geralmente cercados por - *parênteses* e separados por *vírgulas*. - - - bq. @porta_da_frente.pintar( 3, :vermelho )@ - - - O código acima pinta a porta da frente com 3 demãos de vermelho. - - - Pense nisso como um tubo inteiror que o método arrumou, conténdo suas instruções extras. - Os parênteses formam as redondas e molhadas paredes do tubo. As vírgulas são os pés de cada argumento, - saindo pra fora da beirada. O último argumento tem o pé preso embaixo então eles não mostram. - - - Como um barco de bóias, métodos com argumentos podem ser ligados. - - - bq. @porta_da_frente.pintar( 3, :vermelho ).secar( 30 ).fechar()@ - - - O código acima pinta a porta da frente com 3 demãos de vermelho, seca por 30 minutos, e fecha a porta. Mesmo que - o último método não tenha argumentos, você pode colocar parênteses se quiser. Um cano vazio não tem - muito uso, então os parênteses são geralmente deixados pra lá. - - - Alguns métodos (como @print@) são métodos do kernel. Estes métodos são usados por todo Ruby. Já que elese - são tão comuns, você não usa o ponto. - - - bq. @print "Veja, sem ponto."@ - - - h3. Métodos de Classe - - - Assim como os métodos descritos acima (também chamdos métodos _ de instância_), métodos de classe - são geralmente ligados depois de variáveis e constantes. Invés de ponto, usa-se *dois pontos duplo.* - - - bq. @Porta::new( :carvalho )@ - - - Como foi visto acima, o método de classe @new@ é mais usado para se criar coisas. No exemplo cima, estamos pedindo - ao Ruby para fazer uma porta de carvalho nova pra gente. Claro, o Ruby não tem conhecimento de como fazer uma - porta--assim como um a pilha de madeira, madeireiros, e aquelas longas, wiggily, two-man saws. - - - !i/the.foxes-4e.png(Plenty of chunky bacon to go around.)! - - - - h3. Variáveis Globais - - - Variáveis que começam com um *cifrão* são globais. - - - bq. @$x@, @$1@, @$pedacudo@ and @$BAcOn_PeDAcUDo@ são exemplos. - - - A maioria das váriaveis são temporárias por natureza. Algumas partes do seu programa são como casas. - Você entra e elas tem suas próprias variáveis. Em um casa, voce pode der um @pai@ que representa - Archie, um caixeiro-viajante colecionador de esqueletos. Em outra casa, @pai@ pode representar - Peter, um domador de leões com grande apreço por flanela. Cada casa tem um sentido próprio pra @pai@. - - - Com variáveis globais, você garante que a variável será a mesma em cada casinha. - O sinal de cifrão é bem apropriado. Todo lar Americano respeita o valor do cifrão. Somos - doidos pela coisa. Tente bater em qualquer porta na América e dê a eles dinheiro. Eu posso garantir - que você não verá a mesma reação se bater em uma porta e oferecer Peter, um domador de leões com grande - apreço por flanela. - - - Variáveis globais podem ser usadas em qualquer lugar no seu programa. Elas nunca saem da vista. - - - - h3. Variáveis de Instância - - - Variáveis que começam com uma *arroba* são variáveis de instância. - - - bq. @@x@, @@y@, e @@somente_o_maior_pedaco_de_bacon_que_eu_ja_vi@ são exemplos. - - - Estas variáveis são muito usadas para se definir atributos de alguma coisa. Por exemplo, você pode - prover o Ruby com a largura da @porta_da_frente@ criando a variável @@largura@ dentro daquela - @porta_da_frente@. Variáveis de instância são usadas para se definir características de um objeto - em Ruby. - - - Pense na *arroba (at)* signficando *atributo*. - - - - h3. Variáveis de Classe - - - Variáveis que começam com *duas arrobas* são variáveis de classe. - - - bq. @@@x@, @@@y@, e @@@vou_pegar_seus_bacons_pedacudos_e_ensinar_uma_licao_pra_voces_dois@ são exemplos. - - - Variáveis de classe são usadas, também, para se definir atributos. Mas ao invés de definir um atributo - a apenas um objeto no Ruby, variáveis de classe dão um atributo a vários objetos relacionados no Ruby. - Se as variáveis de instância estipulam atributos para só uma @porta_da_frente@, então variáveis de classe - estipulam atributoes pra tudo que for @Porta@. - - - Pense no prefixo das *duas arrobas* significando *atribua a todos*. Adicionalmente, você pode pensar em uma - manada de *AT-ATs* de _Star Wars_, que são comandados pelo Ruby. Você muda uma variável de classe - e não apenas uma muda, todas elas mudam. - - - !i/the.foxes-4f.png(Woohoo! Chunky bacon accomplished!)! - - - - h3. Blocos - - - Qualquer código cercado por *colchetes* é um bloco. - - - bq. @2.times { print "Sim, Tenho usado bacon pedaçudo nos meus exemplos, mas não farei de novo!" }@ is an example. - - - Com blocos, você pode agrupar pedaços de instruções juntas, assim elas pode ser passadas - pelo seu programa. - Os colchetes dão a aparência de garras de caranguejo que pegaram o código e o estão - segurando. Quando você ver estas duas garras, lembre-se que o código dentro - foi prensado em uma só unidade. - - - É como uma daquelas caixas da Hello Kitty que eles vendem no shopping - que vêm lotadas de pequenos lápis e papel microscópico, espremidos numa bolsa - transparente e brilhante que pode ser escondida na palma da mão para operações clandestinas - estacionárias. Exceto que, blocos não ofuscam sua visão. - - - As chaves pode ser substituídas pelas palavras *do* e *end*, o que é bacana se seu bloco for - maior que uma linha. - - - <pre> - loop do - print "Bem melhor." - print "Ah. Mais espaço!" - print "Minhas costas estavam me matando dentro daquelas garras de caranguejo." - end - <stdout>Bem melhor.Ah. Mais espaço!Minhas costas estavam me matando dentro daquelas garras de caranguejo.</stdout> - </pre> - - - - h3. Argumentos de Bloco - - - Argumentos de bloco são uma série de variáveis cercadas por símbolos *tal que* - e separadas por *vírgulas*. - - - bq. @|en||x|@, @|x,y|@, e @|cima, baixo, todo_lado|@ são exemplo. - - - Argumentos de bloco são usando no início do bloco. - - - bq. @{ |x,y| x + y }@ - - - No código acima, @|x,y|@ são os argumentos. Depois dos argumentos, temos um pedaço de código. - A expressão @x + y@ soma os argumentos. - - - Eu gosto de pensar nos símbolos tal que representando um túnel. Ele dão a aparência de uma - calha na qual as váriaveis estão descendo. (O @x@ desce com as pernas abertas, enquanto o @y@ - harmoniosamente cruza as pernas.) Essa calha age como uma passagem entre os blocos e o mundo lá fora. - - - Variáveis são passadas por essa calha (ou túnel) pra dentro do bloco. - - - !i/the.foxes-4g.png(And then, the dismal truth.)! - - - - h3. Ranges (Períodos) - - - Range são dois valores cercados por *parênteses* e separados por *uma elípse* (na forma de - dois ou três pontos). - - - bq. @(1..3)@ é um range, representando os números de 1 até 3. - - - bq. @('a'..'z')@ é um range, representando o alfabeto em minúsculas. - - - Pense neles como um acordeão que fora fechado para se carregar. (Você pode construir muito amor próprio - levando consigo um acordeão aberto... mas, as vezes uma pessoa tem q mergulhar em dúvidas e esconder - cuidadosamente a sanfona) Os parênteses são os lados deste pequeno acordeão de mão. - Os pontos são a fole, mantendo as partes bem unidas. - - - Normalmente, apenas dois pontos são usados. Se um terceiro ponto for usado, o último valor no range será - excluído. - - - bq. @(0...5)@ representa os números de 0 até 4. - - - Quando você vê o terceiro ponto, imagine abrir o acordeão um pouco menos. O necessário para uma nota - apenas de seu fole. A nota é este último valor. Nós vamos deixar que o céu a coma. - - - h3. Arrays (Conjuntos, Vetores) - - - Um array é uma lista cercada por *chaves* e separada por *vírgulas*. - - - bq. @[1, 2, 3]@ é um array de números. - - - bq. @['casaco', 'luvas', 'snowboard']@ é um array de strings. - - - Pense nele como uma centopéia que foi grampeada no nosso código. As duas chaves - são grampos que não deixam a centopéira se movimentar, então você consegue distinguir onde é cabeça e - onde é a cauda. As vírgulas são as pernas da centopéia, balançando entre cada seção do seu corpo. - - - Era uma vez uma centopéia que tinha vírgulas ao invés de pernas. O que significa que ela tinha que - dar uma pausa literária a cada passo. As outra centopéias a respeitavam muito por isso e ela veio a ter - uma bela presença no comando. Oh, e que filantropo! Ela ficou famosa por - dar folhas frescas aos menos afortunados. - - - Sim, um array é uma coleção de coisas, mas ele também mantém estas coisas em uma ordem específica. - - - - h3. Hashes (Bolo, Mistura) - - - Um hash é um dicionário cercado por *colchetes*. Dicionários servem para encontrar definições - das palavras. O Ruby faz isso com *setas* feitas de sinais de igual, seguida por um sinal de - maior que. - - - bq. @{'a' => 'aardvark', 'b' => 'texugo'}@ são um exemplo. - - - Desta vez, os colchetes representam livrinhos. Veja como eles se parecem com - pequenos, livros abertos com dobras no meio? Eles represntam abrir e fechar - nosso dicionário. - - - Imagine que nosso dicionário tem um definição em cada página. As vírgulas representam - os cantos de cada página, que nós viramos pra ver a próxima definição. E em cada página: - uma palavra seguida por uma seta apontando a definição. - - - <pre> - { - 'nome' => 'Peter', - 'profissao' => 'domador de leões', - 'grande apreco' => 'flanela' - } - </pre> - - - Não estou compararando hashes a dicionários por que você pode guardar só definições - na hash. No exemplo acima, eu guardei informação pessoal de Peter, o domador - de leões com grande apreço por flanela. Hashes são como dicionários porque elas são - muito fáceis de se procurar algo. - - - Diferentemente dos arrays, os itens na hash não são mantidos em ordem específica. - - - !i/the.foxes-5.png(The foxes think silence will kill the comic.)! - - - - h3. Expressões Regulares - - - Uma expressão regular (ou _regexp_) é uma série de caracteres cercados por *barras*. - - - bq. @/ruby/@, @/[0-9]+/@ e @/^\d{3}-\d{3}-\d{4}/@ são exemplos. - - - Expressões regulares são usadas para se achar palavras ou padrões - no texto. As barras dos lados da expressão são alfinetes. - - - Imagine se você tivesse uma palavrinha com alfinetes de cada lado e você - a segurasse por cima de um livro. Você passa a palavra pelo livro e quando ela chega - chega perto de uma palavra que coincida, ela começa a piscar. Você espeta a expressão regular no livro, - bem em cima da palavra que bate e ela brilha com as letras da palavra encontrada. - - - Oh, e quando você espeta os alfinetes no livro, o papel espirra, _reg-exp!_ - - - Expressões regulares são muito mais rápidas que folhear um livro. O Ruby - pode usar uma expressão regular pra procurar volumes de livros muito rapidamente. - - - h3. Operadores - - - Você vai usar a seguinte lista de operadores pra matemática ou pra comparar coisas no Ruby. - Analise a lista, reconheça alguns. Você conhece, adição @+@ e subtração @-@ - e por aí vai. - - - <pre class="text"> - ** ! ~ * / % + - & - << >> | ^ > >= < <= <=> - || != =~ !~ && += -= == === - .. ... not and or - </pre> - - - h3. Keywords (Palavras-Chave, Palavras-Reservadas) - - - O Ruby tem um número de palavra embutidas, imbuídas em significado. Estas palavras não podem - ser usadas como variáveis ou modificadas às suas necessidades. Algumas delas nós já - discutimos. Elas estão na caixa forte, meu amigo. É só relar nelas and você terá - um erro oficial de sintaxe. - - - <pre class="text"> - alias and BEGIN begin break case class def defined - do else elsif END end ensure false for if - in module next nil not or redo rescue retry - return self super then true undef unless until when - while yield - </pre> - - - Muito bom. Estes são os ilustres membros da linguagem Ruby. Teremos um belo - banquete nós proximos três capítulos, grudando estas partes em manhosos pedaços - de (comovente) código. - - - E recomendo que você dê mais um olhadela pelas partes da conversa. Dê uma olhada ampla - nelas. Eu estarei testando seu metal na próxima seção. - - - !i/the.foxes-6.png(Out in the pickup truck.)! - - -# h3. You and Your Dictionary -# -# You are out in a public park with your dictionary, enjoying a nice afternoon in the park. -# A light breeze ruffles lexicon's pages carelessly in your lap. A bird is gently beating -# its head against a tree. A tatterdemalion careens by on his unicycle. All is well. -# -# Hold up. Your brain wonders about that word. Tatterdemalion. Does it really mean -# "a shabbily clothed street urchin" like you think it means? You look at your dictionary. -# -# Now, here is the question. How will you answer this question with your dictionary? Where -# will you start? Will you go page-by-page, scanning for "a shabbily clothed street urchin," -# the definition? Or will you use the dictionary's tabs to jump straight to the T section, -# narrowing down the pages toward "tatterdemalion," the word itself? -# - + - As Partes da Conversa: > + + Assim como a faixa branca nas costas do gambá e a branca e enrolada grinalda da noiva, várias partes + da conversa têm sinalizações visuais para te ajudar a identificá-las. Pontuação, maiúsculas e minúsculas, + irão ajudar seu cérebro ver pedaços de código e os reconhecê-los intensamente. + Sua mente vai gritar frequentemente _Hey, Eu conheço aquele cara!_ Você vai também poder + contar vantagem em conversas com outros Rubistas. + + + Tente se focar na aparência de cada uma destas partes da conversa. O resto do livro vai + entrar em detalhes. Eu darei pequenas descrições de cada parte da conversa, mas você não precisa + entender a explicação. Ao término deste capítulo, você deve estar apto a reconhecer + cada parte de um programa Ruby. + + + h3. Variáveis + + + Qualquer palavra simples, em minúsculas, é uma variável no ruby. Variáveis podem consistir de + letras, dígitos e travessões. + + + bq. @x@, @y@, @banana2@ or @telefone_pruma_codorna@ são exemplos. + + + Variáveis são como apelidos. Lembra quando todo mundo te chamava de Pete Fedido? + As pessoas diziam, "Vem aqui, Pete Fedido!" E todo mundo milagrosamente sabia que + você era o Pete Fedido. + + + Com variáveis, você dá um apelido a algo que você use frequentemente. Por exemplo, vamos dizer + que você tem um orfanato. É um orfanato maléfico. E quando o Papai Warbucks vem comprar + mais crianças, nós insistimos que ele nos pague *cento e vinte um reais e oito centavos* pelo urso + teddy da criança, o qual ela ficou apegada nos momentos sombrios que passou vivendo neste pesadelo de + custódia. + + + bq. @taxa_de_urso_teddy = 121.08@ + + + Mais tarde, quando você pegar ele no caixa (uma registradora turbinada que roda + Ruby!), você vai precisar juntar as somas em um *total*. + + + bq. @total = taxa_de_orfao + taxa_de_urso_teddy + gorjeta@ + + + Estes apelidos pra variáveis vêm a calhar. E no submundo sedento das vendas infantis, qualquer ajuda + é bem-vinda, tenho certeza. + + + !i/the.foxes-4a.png(They mock my examples.)! + + + + h3. Números + + + O tipo mais básico de número é um _integer_ (número inteiro), uma *série de dígitos* que podem começar + com um *sinal de menos ou de mais*. + + + bq. @1@, @23@, e @-10000@ são exemplos. + + + Vírgulas não são permitidas em números, mas travessões sim. Então se você acha melhor + marcar os milhares para que o número fique mais legível, use um travessão. + + + bq. @habitantes = 12_000_000_000@ + + + Números decimais são chamados de _floats_ (números reais ou ponto flutuante) no Ruby. + Números reais consistem em números com + *casas decimais* ou *em notação científica*. + + + bq. @3.14@, @-808.08@ e @12.043e-04@ são exemplos. + + + + h3. Strings (Conjunto de Caracteres) + + + Strings são quaisquer tipos de caracteres (letras, dígitos, pontuação) cercados por aspas. + *Aspas* simples ou duplas, são usadas para se criar strings. + + + bq. @"laboratoriodomar"@, @'2021'@, or @"Estes quadrinhos são hilários!"@ + são exemplos. + + + Quando você cerca caracteres em aspas, eles ficam guardados juntos como uma string só. + + + Pense num repórter que está anotando as baboseiras de uma celebridade incoerente. "Eu estou + muito mais sábia," disse Avril Lavigne. "Agora eu sei como as coisas são -- o que você tem que fazer + e como trabalhar isso." + + + <pre> + frase_da_avril = "Eu estou muito mais sábia. Agora eu sei + como as coisas são -- o que você tem + que fazer e como trabalhar isso." + </pre> + + + Então, assim como nós guardamos um número na variável *taxa_de_urso_teddy,* agora nós estamos guardando + uma coleção de caracteres (uma string) na variável *frase_da_avril*. O repórter envia esta frase + para impressão, que por acaso usa Ruby para operar as impressoras. + + + <pre> + <setup> + frase_da_oprah = "O" + frase_da_avril = "A" + debate_ashlee_simpson = "D" + </setup> + print frase_da_oprah + print frase_da_avril + print debate_ashlee_simpson + </pre> + + + !i/the.foxes-4b.png(They desire to be in my examples.)! + + + + h3. Symbols (Símbolos) + + + Símbolos são palavras que parecem variáveis. Novamente, elas podem conter letras, + dígitos e travessões. Mas elas *começam com dois pontos*. + + + bq. @:a@, @:b@, ou @:ponce_de_leon@ are examples. + + + Símbolos são strings leves. Geralmente, símbolos são usados em situações em que você precisa de uma string + mas não vai imprimí-la na tela. + + + Você pode dizer que um símbolo é pouco mais digerível pro computador. É como um anti-ácido. Os dois pontos + indicam as bolhas saindo com estômago do computador enquanto ele digere o símbolo. Ah. Doce, doce alívio. + + + !i/the.foxes-4c.png(Bacon Pedaçudo!!)! + + + + h3. Constantes + + + Constantes são palavras como variáveis, mas constantes são *maiúsculas*. Se variáveis são os + substativos do Ruby, então pense nas constantes como substantivos próprios. + + + bq. @Time@, @Array@ or @Bunny_Lake_Desapareceu@ são exemplos. + + + Em inglês, substantivos próprios têm a primeira letra maiúscula. O Edifício Empire State. Você não pode simplesmente + mudar o Edíficio Empire State. Você não pode simplesmente decidir que o Edifício Empire State Building é outra coisa. + Substantivos próprios são assim. Eles se referem a algo muito específico e que usualmente não + muda com o tempo. + + + Do mesmo modo, constantes não podem ser alteradas depois de criadas. + + + bq. @EdificioEmpireState = "350 5th Avenue, NYC, NY"@ + + + Se tentarmos mudar a constante, Ruby vai reclamar com a gente. Coisas assim desagradam ele. + + + !i/the.foxes-4d.png(Come on, chunky bacon.)! + + + + h3. Metódos + + + Se variáveis e constantes são substantivos, então métodos são verbos. + Métodos geralmente estão ligados ao final das variáveis e constantes por um *ponto*. Você já viu + métodos trabalhando. + + + bq. @porta_da_frente.abra@ + + + Acima, *abra* é o método. Nesta ação, o verbo. Em alguns casos, você vai ver ações ligadas juntas. + + + bq. @porta_da_frente.abra.feche@ + + + Instruímos o computador a abrir a porta da frente e depois imediatamente fechá-la. + + + bq. @porta_da_frente.esta_aberta?@ + + + Acima temos uma ação também. Estamos instruído o computador a testar a porta para ver se está aberta. + O método poderia se chamar @Porta.teste_para_ver_se_esta_aberta@, mas o nome @esta_aberta?@ é sucinto e + também correto. Exclamações e interrogações podem ser usadas em nomes de métodos. + + + h3. Argumentos de Método + + + Um método talvez precise de mais informação pra realizar sua ação. Se quisermos que o computador + pinte a porta, devemos prover uma cor também. + + + Argumentos de método vão ligados ao final do método. Os argumentos estão geralmente cercados por + *parênteses* e separados por *vírgulas*. + + + bq. @porta_da_frente.pintar( 3, :vermelho )@ + + + O código acima pinta a porta da frente com 3 demãos de vermelho. + + + Pense nisso como um tubo inteiror que o método arrumou, conténdo suas instruções extras. + Os parênteses formam as redondas e molhadas paredes do tubo. As vírgulas são os pés de cada argumento, + saindo pra fora da beirada. O último argumento tem o pé preso embaixo então eles não mostram. + + + Como um barco de bóias, métodos com argumentos podem ser ligados. + + + bq. @porta_da_frente.pintar( 3, :vermelho ).secar( 30 ).fechar()@ + + + O código acima pinta a porta da frente com 3 demãos de vermelho, seca por 30 minutos, e fecha a porta. Mesmo que + o último método não tenha argumentos, você pode colocar parênteses se quiser. Um cano vazio não tem + muito uso, então os parênteses são geralmente deixados pra lá. + + + Alguns métodos (como @print@) são métodos do kernel. Estes métodos são usados por todo Ruby. Já que elese + são tão comuns, você não usa o ponto. + + + bq. @print "Veja, sem ponto."@ + + + h3. Métodos de Classe + + + Assim como os métodos descritos acima (também chamdos métodos _ de instância_), métodos de classe + são geralmente ligados depois de variáveis e constantes. Invés de ponto, usa-se *dois pontos duplo.* + + + bq. @Porta::new( :carvalho )@ + + + Como foi visto acima, o método de classe @new@ é mais usado para se criar coisas. No exemplo cima, estamos pedindo + ao Ruby para fazer uma porta de carvalho nova pra gente. Claro, o Ruby não tem conhecimento de como fazer uma + porta--assim como um a pilha de madeira, madeireiros, e aquelas longas, wiggily, two-man saws. + + + !i/the.foxes-4e.png(Plenty of chunky bacon to go around.)! + + + + h3. Variáveis Globais + + + Variáveis que começam com um *cifrão* são globais. + + + bq. @$x@, @$1@, @$pedacudo@ and @$BAcOn_PeDAcUDo@ são exemplos. + + + A maioria das váriaveis são temporárias por natureza. Algumas partes do seu programa são como casas. + Você entra e elas tem suas próprias variáveis. Em um casa, voce pode der um @pai@ que representa + Archie, um caixeiro-viajante colecionador de esqueletos. Em outra casa, @pai@ pode representar + Peter, um domador de leões com grande apreço por flanela. Cada casa tem um sentido próprio pra @pai@. + + + Com variáveis globais, você garante que a variável será a mesma em cada casinha. + O sinal de cifrão é bem apropriado. Todo lar Americano respeita o valor do cifrão. Somos + doidos pela coisa. Tente bater em qualquer porta na América e dê a eles dinheiro. Eu posso garantir + que você não verá a mesma reação se bater em uma porta e oferecer Peter, um domador de leões com grande + apreço por flanela. + + + Variáveis globais podem ser usadas em qualquer lugar no seu programa. Elas nunca saem da vista. + + + + h3. Variáveis de Instância + + + Variáveis que começam com uma *arroba* são variáveis de instância. + + + bq. @@x@, @@y@, e @@somente_o_maior_pedaco_de_bacon_que_eu_ja_vi@ são exemplos. + + + Estas variáveis são muito usadas para se definir atributos de alguma coisa. Por exemplo, você pode + prover o Ruby com a largura da @porta_da_frente@ criando a variável @@largura@ dentro daquela + @porta_da_frente@. Variáveis de instância são usadas para se definir características de um objeto + em Ruby. + + + Pense na *arroba (at)* signficando *atributo*. + + + + h3. Variáveis de Classe + + + Variáveis que começam com *duas arrobas* são variáveis de classe. + + + bq. @@@x@, @@@y@, e @@@vou_pegar_seus_bacons_pedacudos_e_ensinar_uma_licao_pra_voces_dois@ são exemplos. + + + Variáveis de classe são usadas, também, para se definir atributos. Mas ao invés de definir um atributo + a apenas um objeto no Ruby, variáveis de classe dão um atributo a vários objetos relacionados no Ruby. + Se as variáveis de instância estipulam atributos para só uma @porta_da_frente@, então variáveis de classe + estipulam atributoes pra tudo que for @Porta@. + + + Pense no prefixo das *duas arrobas* significando *atribua a todos*. Adicionalmente, você pode pensar em uma + manada de *AT-ATs* de _Star Wars_, que são comandados pelo Ruby. Você muda uma variável de classe + e não apenas uma muda, todas elas mudam. + + + !i/the.foxes-4f.png(Woohoo! Chunky bacon accomplished!)! + + + + h3. Blocos + + + Qualquer código cercado por *colchetes* é um bloco. + + + bq. @2.times { print "Sim, Tenho usado bacon pedaçudo nos meus exemplos, mas não farei de novo!" }@ is an example. + + + Com blocos, você pode agrupar pedaços de instruções juntas, assim elas pode ser passadas + pelo seu programa. + Os colchetes dão a aparência de garras de caranguejo que pegaram o código e o estão + segurando. Quando você ver estas duas garras, lembre-se que o código dentro + foi prensado em uma só unidade. + + + É como uma daquelas caixas da Hello Kitty que eles vendem no shopping + que vêm lotadas de pequenos lápis e papel microscópico, espremidos numa bolsa + transparente e brilhante que pode ser escondida na palma da mão para operações clandestinas + estacionárias. Exceto que, blocos não ofuscam sua visão. + + + As chaves pode ser substituídas pelas palavras *do* e *end*, o que é bacana se seu bloco for + maior que uma linha. + + + <pre> + loop do + print "Bem melhor." + print "Ah. Mais espaço!" + print "Minhas costas estavam me matando dentro daquelas garras de caranguejo." + end + <stdout>Bem melhor.Ah. Mais espaço!Minhas costas estavam me matando dentro daquelas garras de caranguejo.</stdout> + </pre> + + + + h3. Argumentos de Bloco + + + Argumentos de bloco são uma série de variáveis cercadas por símbolos *tal que* + e separadas por *vírgulas*. + + + bq. @|en||x|@, @|x,y|@, e @|cima, baixo, todo_lado|@ são exemplo. + + + Argumentos de bloco são usando no início do bloco. + + + bq. @{ |x,y| x + y }@ + + + No código acima, @|x,y|@ são os argumentos. Depois dos argumentos, temos um pedaço de código. + A expressão @x + y@ soma os argumentos. + + + Eu gosto de pensar nos símbolos tal que representando um túnel. Ele dão a aparência de uma + calha na qual as váriaveis estão descendo. (O @x@ desce com as pernas abertas, enquanto o @y@ + harmoniosamente cruza as pernas.) Essa calha age como uma passagem entre os blocos e o mundo lá fora. + + + Variáveis são passadas por essa calha (ou túnel) pra dentro do bloco. + + + !i/the.foxes-4g.png(And then, the dismal truth.)! + + + + h3. Ranges (Períodos) + + + Range são dois valores cercados por *parênteses* e separados por *uma elípse* (na forma de + dois ou três pontos). + + + bq. @(1..3)@ é um range, representando os números de 1 até 3. + + + bq. @('a'..'z')@ é um range, representando o alfabeto em minúsculas. + + + Pense neles como um acordeão que fora fechado para se carregar. (Você pode construir muito amor próprio + levando consigo um acordeão aberto... mas, as vezes uma pessoa tem q mergulhar em dúvidas e esconder + cuidadosamente a sanfona) Os parênteses são os lados deste pequeno acordeão de mão. + Os pontos são a fole, mantendo as partes bem unidas. + + + Normalmente, apenas dois pontos são usados. Se um terceiro ponto for usado, o último valor no range será + excluído. + + + bq. @(0...5)@ representa os números de 0 até 4. + + + Quando você vê o terceiro ponto, imagine abrir o acordeão um pouco menos. O necessário para uma nota + apenas de seu fole. A nota é este último valor. Nós vamos deixar que o céu a coma. + + + h3. Arrays (Conjuntos, Vetores) + + + Um array é uma lista cercada por *chaves* e separada por *vírgulas*. + + + bq. @[1, 2, 3]@ é um array de números. + + + bq. @['casaco', 'luvas', 'snowboard']@ é um array de strings. + + + Pense nele como uma centopéia que foi grampeada no nosso código. As duas chaves + são grampos que não deixam a centopéira se movimentar, então você consegue distinguir onde é cabeça e + onde é a cauda. As vírgulas são as pernas da centopéia, balançando entre cada seção do seu corpo. + + + Era uma vez uma centopéia que tinha vírgulas ao invés de pernas. O que significa que ela tinha que + dar uma pausa literária a cada passo. As outra centopéias a respeitavam muito por isso e ela veio a ter + uma bela presença no comando. Oh, e que filantropo! Ela ficou famosa por + dar folhas frescas aos menos afortunados. + + + Sim, um array é uma coleção de coisas, mas ele também mantém estas coisas em uma ordem específica. + + + + h3. Hashes (Bolo, Mistura) + + + Um hash é um dicionário cercado por *colchetes*. Dicionários servem para encontrar definições + das palavras. O Ruby faz isso com *setas* feitas de sinais de igual, seguida por um sinal de + maior que. + + + bq. @{'a' => 'aardvark', 'b' => 'texugo'}@ são um exemplo. + + + Desta vez, os colchetes representam livrinhos. Veja como eles se parecem com + pequenos, livros abertos com dobras no meio? Eles represntam abrir e fechar + nosso dicionário. + + + Imagine que nosso dicionário tem um definição em cada página. As vírgulas representam + os cantos de cada página, que nós viramos pra ver a próxima definição. E em cada página: + uma palavra seguida por uma seta apontando a definição. + + + <pre> + { + 'nome' => 'Peter', + 'profissao' => 'domador de leões', + 'grande apreco' => 'flanela' + } + </pre> + + + Não estou compararando hashes a dicionários por que você pode guardar só definições + na hash. No exemplo acima, eu guardei informação pessoal de Peter, o domador + de leões com grande apreço por flanela. Hashes são como dicionários porque elas são + muito fáceis de se procurar algo. + + + Diferentemente dos arrays, os itens na hash não são mantidos em ordem específica. + + + !i/the.foxes-5.png(The foxes think silence will kill the comic.)! + + + + h3. Expressões Regulares + + + Uma expressão regular (ou _regexp_) é uma série de caracteres cercados por *barras*. + + + bq. @/ruby/@, @/[0-9]+/@ e @/^\d{3}-\d{3}-\d{4}/@ são exemplos. + + + Expressões regulares são usadas para se achar palavras ou padrões + no texto. As barras dos lados da expressão são alfinetes. + + + Imagine se você tivesse uma palavrinha com alfinetes de cada lado e você + a segurasse por cima de um livro. Você passa a palavra pelo livro e quando ela chega + chega perto de uma palavra que coincida, ela começa a piscar. Você espeta a expressão regular no livro, + bem em cima da palavra que bate e ela brilha com as letras da palavra encontrada. + + + Oh, e quando você espeta os alfinetes no livro, o papel espirra, _reg-exp!_ + + + Expressões regulares são muito mais rápidas que folhear um livro. O Ruby + pode usar uma expressão regular pra procurar volumes de livros muito rapidamente. + + + h3. Operadores + + + Você vai usar a seguinte lista de operadores pra matemática ou pra comparar coisas no Ruby. + Analise a lista, reconheça alguns. Você conhece, adição @+@ e subtração @-@ + e por aí vai. + + + <pre class="text"> + ** ! ~ * / % + - & + << >> | ^ > >= < <= <=> + || != =~ !~ && += -= == === + .. ... not and or + </pre> + + + h3. Keywords (Palavras-Chave, Palavras-Reservadas) + + + O Ruby tem um número de palavra embutidas, imbuídas em significado. Estas palavras não podem + ser usadas como variáveis ou modificadas às suas necessidades. Algumas delas nós já + discutimos. Elas estão na caixa forte, meu amigo. É só relar nelas and você terá + um erro oficial de sintaxe. + + + <pre class="text"> + alias and BEGIN begin break case class def defined + do else elsif END end ensure false for if + in module next nil not or redo rescue retry + return self super then true undef unless until when + while yield + </pre> + + + Muito bom. Estes são os ilustres membros da linguagem Ruby. Teremos um belo + banquete nós proximos três capítulos, grudando estas partes em manhosos pedaços + de (comovente) código. + + + E recomendo que você dê mais um olhadela pelas partes da conversa. Dê uma olhada ampla + nelas. Eu estarei testando seu metal na próxima seção. + + + !i/the.foxes-6.png(Out in the pickup truck.)! + + +# h3. You and Your Dictionary +# +# You are out in a public park with your dictionary, enjoying a nice afternoon in the park. +# A light breeze ruffles lexicon's pages carelessly in your lap. A bird is gently beating +# its head against a tree. A tatterdemalion careens by on his unicycle. All is well. +# +# Hold up. Your brain wonders about that word. Tatterdemalion. Does it really mean +# "a shabbily clothed street urchin" like you think it means? You look at your dictionary. +# +# Now, here is the question. How will you answer this question with your dictionary? Where +# will you start? Will you go page-by-page, scanning for "a shabbily clothed street urchin," +# the definition? Or will you use the dictionary's tabs to jump straight to the T section, +# narrowing down the pages toward "tatterdemalion," the word itself? +# + lang-pt/poignant-18.yml @@ -1,35 +1,35 @@ - - !^sidebar - Sete momentos Zen da minha vida: > - - # 8 anos de idade. Apenas deitado na cama, pensando. E eu percebo. - _Não há nada que me impeça de virar um odontopediatra._ - - # 21. Achei um lápis na praia. Gravado nele estava: _Eu amo serenidade._ Enfiei ele no - bolso do meu paletó. Assisi as ondas indo e voltando. - - # 22. Encontrei um besouro no meu banheiro que estava prestes a cair na saída do aquecedor. - Peguei ele. Fiz uma pequena mochila com uma folha e linha. - Dentro da mochila: um pino e uma pilha AAA. Isso deve ser suficiente para ele. Libertei ele - pelo portão da frente. - - # Três anos de idade. Puxei a cortina para o lado. Luz do sol. - - # 14. Andando de bicicleta no píer com meu treinador correndo logo atrás de mim - enquanto o sol se põe logo depois que eu nocauteei Piston Honda na versão original - para Nintendo de Mike Tyson's Punch-Out. - - # 11. Doente. Assistindo Heathcliff na televisão. Por horas, era só Heathcliff. - E ele era capaz de vir bem perto do meu rosto. A cabeça dele crescia em minha direção. - Seu rosto pulsava, bem perto, e depois milhões de milhas distante. - O som havia sumido. Em frações de segundo, Heathcliff preencheu o universo, então - se foi para o fim da eternidade. Eu ouvi a voz da minha mãe tentando falar mais alto - que o desenho. Heathperto, Heathlonge, Heathperto, Heathlonge. - Era um delírio religioso com um gato, um estroboscópio e o grave abafado da voz da minha mãe. - (Eu tive 40,5 de febre aquele dia.) - - # 18. Comprei um gigapet. Um pato. Alimentei ele por um tempo. Dei banho nele. - Esqueci dele por quase dois meses. Um dia, enquanto estava limpando, encontrei uma corrente - e ele estava preso a ela. Hey, patinho. Louco psicótico, pulando com seu cabelo pra fora, - gritando linhas diagonais. De smoking. - - + - !^sidebar + Sete momentos Zen da minha vida: > + + # 8 anos de idade. Apenas deitado na cama, pensando. E eu percebo. + _Não há nada que me impeça de virar um odontopediatra._ + + # 21. Achei um lápis na praia. Gravado nele estava: _Eu amo serenidade._ Enfiei ele no + bolso do meu paletó. Assisi as ondas indo e voltando. + + # 22. Encontrei um besouro no meu banheiro que estava prestes a cair na saída do aquecedor. + Peguei ele. Fiz uma pequena mochila com uma folha e linha. + Dentro da mochila: um pino e uma pilha AAA. Isso deve ser suficiente para ele. Libertei ele + pelo portão da frente. + + # Três anos de idade. Puxei a cortina para o lado. Luz do sol. + + # 14. Andando de bicicleta no píer com meu treinador correndo logo atrás de mim + enquanto o sol se põe logo depois que eu nocauteei Piston Honda na versão original + para Nintendo de Mike Tyson's Punch-Out. + + # 11. Doente. Assistindo Heathcliff na televisão. Por horas, era só Heathcliff. + E ele era capaz de vir bem perto do meu rosto. A cabeça dele crescia em minha direção. + Seu rosto pulsava, bem perto, e depois milhões de milhas distante. + O som havia sumido. Em frações de segundo, Heathcliff preencheu o universo, então + se foi para o fim da eternidade. Eu ouvi a voz da minha mãe tentando falar mais alto + que o desenho. Heathperto, Heathlonge, Heathperto, Heathlonge. + Era um delírio religioso com um gato, um estroboscópio e o grave abafado da voz da minha mãe. + (Eu tive 40,5 de febre aquele dia.) + + # 18. Comprei um gigapet. Um pato. Alimentei ele por um tempo. Dei banho nele. + Esqueci dele por quase dois meses. Um dia, enquanto estava limpando, encontrei uma corrente + e ele estava preso a ela. Hey, patinho. Louco psicótico, pulando com seu cabelo pra fora, + gritando linhas diagonais. De smoking. + + lang-pt/poignant-19.yml @@ -1,64 +1,64 @@ - - If I Haven't Treated You Like a Child Enough Already: > - - Estou orgulhoso de você. Anyone will tell you how much I brag about you. How I go on and on about - this great anonymous person out there who scrolls and reads and scrolls and reads. "These - kids," I tell them. "Man, these kids got heart. I never..." And I can't even finish a sentence - because I'm absolutely blubbering. - - - E meu coração irradia um vermelho intenso sob minha pele translúcida e eles tiveram que me administrar - 10cc de Javascript para me fazer voltar. (Eu respondo bem a toxinas no sangue.) Man, that stuff will - kick the peaches right out your gills! - - - So, yes. Você tá indo bem. Mas agora eu devo começar a ser um be a brutal schoolmaster. - I need to start seeing good marks from you. Até agora, você não fez nada mais do que olhar pra cima - e pra baixo. Okay, claro, você fez excepcionais leituras em voz alta mais cedo. Agora nós precisamos - de habilidade de compreensão aqui, Smotchkkiss. - - - *Diga em voz alta cada parte do discurso usada abaixo.* - - - bq. @5.times { print "Odelay!" }@ - - - You might want to even cover this paragraph up while you read, because your eyes might want - to sneak to the answer. Nós tempos um _número_ @5@, seguido por um _método_ @.times@. Depois, a primeira - garra de caranguejo de um _bloco_. O _método_ do kernel @print@ não tem ponto e é seguido por uma _string_ - @"Odelay!"@. A garra de canguejo final fecha nosso _bloco_. - - - *Say aloud each of the parts of speech used below.* - - - bq. @exit unless "restaurante".include? "aura"@ - - - Assim como o método @print@, @exit@ é um _método_ do Kernel. Se você prestou atenção na grande lista de - palavras reservadas, você saberá que @unless@ é uma dessas _palavras reservadas_. A _string_ @"restaurante"@ - is clung to by the _method_ @include?@. E finalmente, a string @"aura"@. - - - *Say aloud each of the parts of speech used below.* - - - bq. @['torrada', 'queijo', 'vinho'].@ - - @each { |alimento| print( alimento.capitalize ) }@ - - - Esta centopéia partakes of finer delicacies. Um _array_ inicia o exemplo. No array, três - _strings_ @'torrada'@, @'queijo'@, e @'vinho'@. Todo o array é seguido por um _método_ @each@. - - - Dentro de um _bloco_, o _argumento do bloco_ @alimento@, descendo seu toboágua dentro do bloco. - O _método_ @capitalize@ então passa pra maíuscula a primeira letra do argumento do bloco, a qual - éas become _variable_ @food@. This capitalized _string_ is passed to kernel _method_ @print@. - - - Olhe os exemplos mais uma vez. Tenha certeza de que você reconhece todas as partes do discurso usadas. - Elas são bem distintas, não? Respire profundamente, press firmly on your temples. Now, let's - dissect a cow's eye worth of code. - - + - If I Haven't Treated You Like a Child Enough Already: > + + Estou orgulhoso de você. Anyone will tell you how much I brag about you. How I go on and on about + this great anonymous person out there who scrolls and reads and scrolls and reads. "These + kids," I tell them. "Man, these kids got heart. I never..." And I can't even finish a sentence + because I'm absolutely blubbering. + + + E meu coração irradia um vermelho intenso sob minha pele translúcida e eles tiveram que me administrar + 10cc de Javascript para me fazer voltar. (Eu respondo bem a toxinas no sangue.) Man, that stuff will + kick the peaches right out your gills! + + + So, yes. Você tá indo bem. Mas agora eu devo começar a ser um be a brutal schoolmaster. + I need to start seeing good marks from you. Até agora, você não fez nada mais do que olhar pra cima + e pra baixo. Okay, claro, você fez excepcionais leituras em voz alta mais cedo. Agora nós precisamos + de habilidade de compreensão aqui, Smotchkkiss. + + + *Diga em voz alta cada parte do discurso usada abaixo.* + + + bq. @5.times { print "Odelay!" }@ + + + You might want to even cover this paragraph up while you read, because your eyes might want + to sneak to the answer. Nós tempos um _número_ @5@, seguido por um _método_ @.times@. Depois, a primeira + garra de caranguejo de um _bloco_. O _método_ do kernel @print@ não tem ponto e é seguido por uma _string_ + @"Odelay!"@. A garra de canguejo final fecha nosso _bloco_. + + + *Say aloud each of the parts of speech used below.* + + + bq. @exit unless "restaurante".include? "aura"@ + + + Assim como o método @print@, @exit@ é um _método_ do Kernel. Se você prestou atenção na grande lista de + palavras reservadas, você saberá que @unless@ é uma dessas _palavras reservadas_. A _string_ @"restaurante"@ + is clung to by the _method_ @include?@. E finalmente, a string @"aura"@. + + + *Say aloud each of the parts of speech used below.* + + + bq. @['torrada', 'queijo', 'vinho'].@ + + @each { |alimento| print( alimento.capitalize ) }@ + + + Esta centopéia partakes of finer delicacies. Um _array_ inicia o exemplo. No array, três + _strings_ @'torrada'@, @'queijo'@, e @'vinho'@. Todo o array é seguido por um _método_ @each@. + + + Dentro de um _bloco_, o _argumento do bloco_ @alimento@, descendo seu toboágua dentro do bloco. + O _método_ @capitalize@ então passa pra maíuscula a primeira letra do argumento do bloco, a qual + éas become _variable_ @food@. This capitalized _string_ is passed to kernel _method_ @print@. + + + Olhe os exemplos mais uma vez. Tenha certeza de que você reconhece todas as partes do discurso usadas. + Elas são bem distintas, não? Respire profundamente, press firmly on your temples. Now, let's + dissect a cow's eye worth of code. + + lang-pt/poignant-20.yml @@ -1,90 +1,90 @@ - - Um Exemplo Para Te Ajudar a Crescer: > - - !i/the.foxes-7.png(Gettin' cabin fever.)! - - - *Diga em voz alta cada uma das partes da conversa usadas abaixo.* - - - <pre> - require 'net/http' - Net::HTTP.start( 'www.ruby-lang.org', 80 ) do |http| - print( http.get( '/en/LICENSE.txt' ).body ) - end - </pre> - - - A primeira linha chama um método. O _método_ chamado @require@ é usado. Uma _string_ é passada ao - método contendo @'net/http'@. Pense nesta primeira linha de código como uma sentença. Nós dissemos - ao Ruby para carregar um código auxiliar, a biblioteca @Net::HTTP.@ - - - As próximas três linhas vão todas juntas. A _constante_ @Net::HTTP@ refere à biblioteca que carregamos acima. - Nós estamos usando o _método_ @start@ da biblioteca. Dentro do método, estamos enviando uma _string_ - @'www.ruby-lang.org'@ e o _número_ @80@. - - - A palvra @do@ abre um _block_. O block tem _uma váriavel de bloco_ @http@. Dentro do block, o _método_ - @print@ é chamado. O que está sendo imprimido? - - - A partir da _variável_ @http@, o _método_ @get@ é chamado. Dentro do @get@, nós passamos uma _string_ contendo - o caminho @'/en/LICENSE.txt'@. Agora, repare que outro método está ligado no @get@. O _método_ - @body (corpo)@. Então, o bloco se fecha com @end@. - - - Tá indo bem? Só por curiosidade, você consegue advinhar o que este exemplo faz? Espero eu, que você já esteja - vendo alguns padrões no Ruby. Se não, balance sua cabeça vigorosamente enquanto você põe estes exemplos - na sua mente. O código deve se quebrar em pedaços gerenciáveis. - - - Por exemplo, este padrão é usando um monte de vezes: - - - bq. _variavel_ . _metodo_ ( _argumentos do metodo_ ) - - - Você vê isso dentro do: - - - bq. @http.get( '/en/LICENSE.txt' )@ - - - Estamos usando o Ruby para pegar uma página da web. Você provavelmente já usou HTTP com o seu navegador. HTTP é - o Hypertext Transfer Protocol. HTTP é usado para se transferir páginas pela internet. Conceitualize - um motorista de ônibus que pode dirigir por toda a internet e trazer de volta páginas pra gente. No quepe dele - estão estampadas as letras HTTP. - - - A variável @http@ é aquele motorista. O -método_ é uma mensagem para o motorista. Vá @get (pegar)@ - a página da web chamada @/en/LICENSE.txt@. - - - Então quando você vê esta cadeia de métodos: - - - bq. @http.get( '/en/LICENSE.txt' ).body@ - - - Já que estaremos recebendo a página de volta pelo motorista @http@, você pode ler isto na sua cabeça - assim: - - - bq. _página web_ .body - - - E neste pedaço de código: - - - bq. @print( http.get( '/en/LICENSE.txt' ).body )@ - - - Este código pega a página. Nós mandamos uma mensagem: @body@ para a página, que por sua vez nos dá - HTML em uma _string_. Nós então @imprimimos@ esta string. Veja como o básico padrão ponto-método acontece - em cadeia. No próximo capítulo vamos explorar todos estes tipos de padrões no Ruby. Vai ser boa diversão. - - - Então, o que este código faz? Ele imprime o HTML dá página web do Ruby na tela. Usando - um motorista de ônibus habilitado pra web. - - + - Um Exemplo Para Te Ajudar a Crescer: > + + !i/the.foxes-7.png(Gettin' cabin fever.)! + + + *Diga em voz alta cada uma das partes da conversa usadas abaixo.* + + + <pre> + require 'net/http' + Net::HTTP.start( 'www.ruby-lang.org', 80 ) do |http| + print( http.get( '/en/LICENSE.txt' ).body ) + end + </pre> + + + A primeira linha chama um método. O _método_ chamado @require@ é usado. Uma _string_ é passada ao + método contendo @'net/http'@. Pense nesta primeira linha de código como uma sentença. Nós dissemos + ao Ruby para carregar um código auxiliar, a biblioteca @Net::HTTP.@ + + + As próximas três linhas vão todas juntas. A _constante_ @Net::HTTP@ refere à biblioteca que carregamos acima. + Nós estamos usando o _método_ @start@ da biblioteca. Dentro do método, estamos enviando uma _string_ + @'www.ruby-lang.org'@ e o _número_ @80@. + + + A palvra @do@ abre um _block_. O block tem _uma váriavel de bloco_ @http@. Dentro do block, o _método_ + @print@ é chamado. O que está sendo imprimido? + + + A partir da _variável_ @http@, o _método_ @get@ é chamado. Dentro do @get@, nós passamos uma _string_ contendo + o caminho @'/en/LICENSE.txt'@. Agora, repare que outro método está ligado no @get@. O _método_ + @body (corpo)@. Então, o bloco se fecha com @end@. + + + Tá indo bem? Só por curiosidade, você consegue advinhar o que este exemplo faz? Espero eu, que você já esteja + vendo alguns padrões no Ruby. Se não, balance sua cabeça vigorosamente enquanto você põe estes exemplos + na sua mente. O código deve se quebrar em pedaços gerenciáveis. + + + Por exemplo, este padrão é usando um monte de vezes: + + + bq. _variavel_ . _metodo_ ( _argumentos do metodo_ ) + + + Você vê isso dentro do: + + + bq. @http.get( '/en/LICENSE.txt' )@ + + + Estamos usando o Ruby para pegar uma página da web. Você provavelmente já usou HTTP com o seu navegador. HTTP é + o Hypertext Transfer Protocol. HTTP é usado para se transferir páginas pela internet. Conceitualize + um motorista de ônibus que pode dirigir por toda a internet e trazer de volta páginas pra gente. No quepe dele + estão estampadas as letras HTTP. + + + A variável @http@ é aquele motorista. O -método_ é uma mensagem para o motorista. Vá @get (pegar)@ + a página da web chamada @/en/LICENSE.txt@. + + + Então quando você vê esta cadeia de métodos: + + + bq. @http.get( '/en/LICENSE.txt' ).body@ + + + Já que estaremos recebendo a página de volta pelo motorista @http@, você pode ler isto na sua cabeça + assim: + + + bq. _página web_ .body + + + E neste pedaço de código: + + + bq. @print( http.get( '/en/LICENSE.txt' ).body )@ + + + Este código pega a página. Nós mandamos uma mensagem: @body@ para a página, que por sua vez nos dá + HTML em uma _string_. Nós então @imprimimos@ esta string. Veja como o básico padrão ponto-método acontece + em cadeia. No próximo capítulo vamos explorar todos estes tipos de padrões no Ruby. Vai ser boa diversão. + + + Então, o que este código faz? Ele imprime o HTML dá página web do Ruby na tela. Usando + um motorista de ônibus habilitado pra web. + + lang-pt/poignant-21.yml @@ -1,49 +1,49 @@ - - And So, The Quick Trip Came To An Eased, Cushioned Halt: > - - !i/the.foxes-8.png(Running after the truck.)! - - - So now we have a problem. I get the feeling that you are enjoying this way too much. - And you haven't even hit the chapter where I use jump-roping songs to help you learn - how to parse XML! - - - If you're already enjoying this, then things are really going bad. Two chapters from - now you'll be writing your own Ruby programs. In fact, it's right about there that I'll - have you start writing your own role-playing game, your own file-sharing network (a la BitTorrent), - as well as a program that will pull genuine random numbers from the Internet. - - - !>i/graph-1.gif(Proof has been extracted from the pudding.)! - - - And you know (you've got to know!) that this is going to turn into an obsession. First, you'll - completely forget to take the dog out. It'll be standing by the screen door, darting its head - about, as your eyes devour the code, as your fingers slip messages to the computer. - - - Thanks to your neglect, things will start to break. Your mounds of printed - sheets of code will cover up your air vents. Your furnace - will choke. The trash will pile-up: take-out boxes you hurriedly ordered in, junk mail you couldn't - care to dispose of. Your own uncleanliness will pollute the air. Moss will infest the rafters, the water - will clog, animals will let themselves in, trees will come up through the foundations. - - - But your computer will be well-cared for. And you, Smotchkkiss, will have nourished it with your knowledge. - In the eons you will have spent with your machine, you will have become part-CPU. And it will - have become part-flesh. Your arms will flow directly into its ports. Your eyes will accept - the video directly from DVI-24 pin. Your lungs will sit just above the processor, cooling it. - - - And just as the room is ready to force itself shut upon you, just as all the overgrowth swallows you - and your machine, you will finish your script. You and the machine together will run this latest Ruby - script, the product of your obsession. And the script will fire up chainsaws to trim the trees, hearths - to warm and regulate the house. Builder nanites will rush from your script, reconstructing your quarters, - retiling, renovating, chroming, polishing, disinfecting. Mighty androids will force your crumbling house into - firm, rigid architecture. Great pillars will rise, statues chiseled. You will have dominion over this - palatial estate and over the encompassing mountains and islands of your stronghold. - - - So I guess you're going to be okay. Whatdya say? Let's get moving on this script of yours? - - + - And So, The Quick Trip Came To An Eased, Cushioned Halt: > + + !i/the.foxes-8.png(Running after the truck.)! + + + So now we have a problem. I get the feeling that you are enjoying this way too much. + And you haven't even hit the chapter where I use jump-roping songs to help you learn + how to parse XML! + + + If you're already enjoying this, then things are really going bad. Two chapters from + now you'll be writing your own Ruby programs. In fact, it's right about there that I'll + have you start writing your own role-playing game, your own file-sharing network (a la BitTorrent), + as well as a program that will pull genuine random numbers from the Internet. + + + !>i/graph-1.gif(Proof has been extracted from the pudding.)! + + + And you know (you've got to know!) that this is going to turn into an obsession. First, you'll + completely forget to take the dog out. It'll be standing by the screen door, darting its head + about, as your eyes devour the code, as your fingers slip messages to the computer. + + + Thanks to your neglect, things will start to break. Your mounds of printed + sheets of code will cover up your air vents. Your furnace + will choke. The trash will pile-up: take-out boxes you hurriedly ordered in, junk mail you couldn't + care to dispose of. Your own uncleanliness will pollute the air. Moss will infest the rafters, the water + will clog, animals will let themselves in, trees will come up through the foundations. + + + But your computer will be well-cared for. And you, Smotchkkiss, will have nourished it with your knowledge. + In the eons you will have spent with your machine, you will have become part-CPU. And it will + have become part-flesh. Your arms will flow directly into its ports. Your eyes will accept + the video directly from DVI-24 pin. Your lungs will sit just above the processor, cooling it. + + + And just as the room is ready to force itself shut upon you, just as all the overgrowth swallows you + and your machine, you will finish your script. You and the machine together will run this latest Ruby + script, the product of your obsession. And the script will fire up chainsaws to trim the trees, hearths + to warm and regulate the house. Builder nanites will rush from your script, reconstructing your quarters, + retiling, renovating, chroming, polishing, disinfecting. Mighty androids will force your crumbling house into + firm, rigid architecture. Great pillars will rise, statues chiseled. You will have dominion over this + palatial estate and over the encompassing mountains and islands of your stronghold. + + + So I guess you're going to be okay. Whatdya say? Let's get moving on this script of yours? + + lang-pt/poignant-22.yml @@ -1 +1 @@ - - Pequenas Folhas de Código Flutuando: + - Pequenas Folhas de Código Flutuando: lang-pt/poignant-23.yml @@ -1,19 +1,19 @@ - - > - !i/the.elf-1.gif(Impossívelmente fundo, nas cavernas de Ambrose... o Gnomo com um presunto de estimação!)! - - !i/the.elf-2.gif(...e o gato Trady Blix.)! - - - Eu nunca vi o presunto fazer coisa alguma, a não ser urinar. Hoje, nosso negócio nas - Cavernas Ambrose é com o gnomo. Ele é uma parte crucial das próximas lições. - Vamos todos fazer com que ele se sinta bem-vindo. Comece a esquentar os neurônios! - (E por favor, troque essa ridícula calça de cowboy.) - - - Atenção: esta lição é mais vagarosa. Acompanhe-a. Isto será uma longa e profunda respiração. - A fase mais crucial de sua instrução. Pode parecer que você não está aprendendo muito - código a princípio. Você estará aprendendo conceitos. Ao final deste capítulo, você - saberá a beleza do Ruby. O conforto do código irá se tornar um saco de dormir para o seu - próprio alívio. - - + - > + !i/the.elf-1.gif(Impossívelmente fundo, nas cavernas de Ambrose... o Gnomo com um presunto de estimação!)! + + !i/the.elf-2.gif(...e o gato Trady Blix.)! + + + Eu nunca vi o presunto fazer coisa alguma, a não ser urinar. Hoje, nosso negócio nas + Cavernas Ambrose é com o gnomo. Ele é uma parte crucial das próximas lições. + Vamos todos fazer com que ele se sinta bem-vindo. Comece a esquentar os neurônios! + (E por favor, troque essa ridícula calça de cowboy.) + + + Atenção: esta lição é mais vagarosa. Acompanhe-a. Isto será uma longa e profunda respiração. + A fase mais crucial de sua instrução. Pode parecer que você não está aprendendo muito + código a princípio. Você estará aprendendo conceitos. Ao final deste capítulo, você + saberá a beleza do Ruby. O conforto do código irá se tornar um saco de dormir para o seu + próprio alívio. + + lang-pt/poignant-24.yml @@ -1,42 +1,42 @@ - - A Folha como um Símbolo de Status na Ambrose: > - - Tudo certo, Gnomo. Dê-nos um rápido resumo dos problemas financeiros que você enfrentou em seu reino. - - - !i/the.elf-3.gif(Cristais Azuis foram maltratados.)! - - - Realmente, não é o caminho que eu me lembro. Esse Gnomo estava me bipando constantemente. Quando me - recusei a chamá-lo de volta, ele deixou uma mensagem no meu pager. Significado: ele bipou duas vezes e - então exibiu uma pequena mensagem. A mensagem disse alguma coisa sobre, "Desça aqui, rápido!" e também, - "Nós temos que livrar a terra destas pestes de lagartas empreendedoras, estes insetos insanos vikings - estão sufocando meus cristais azuis!" - - - Ultimamente, a taxa de câmbio já se estabelece entre as folhas e cristais. Uma nota de árvore velha vale - cinco cristais. Então a situação monetária básica é semelhante a isto: - - - <pre> - cristal_azul = 1 - folha_macia = 5 - </pre> - - - Este exemplo é _tão_ último capítulo. Ainda assim. Ele é um início. Nós estamos definindo - duas _variáveis_. O *sinal de igual* é usado para _atribuição_. - - - Agora @folha_macia@ representa o número @5@ (tal como em: cinco cristais azuis.) Este conceito, até - aqui, é *metade de Ruby*. Nós estamos _definindo_. Nós estamos _criando_. Isto é a metade do trabalho. - Atribuição é a forma mais básica de definição. - - - Você não pode se queixar, pode Gnomo? Você construiu um império investindo seus cristais azuis no - novo mercado livre entre as criaturas da floresta. (E apesar de ele é ser um gnomo para nós, ele é um - monstro grande para eles.) - - - !i/the.elf-4.jpg(Animal Perfeito, LLC)! - - + - A Folha como um Símbolo de Status na Ambrose: > + + Tudo certo, Gnomo. Dê-nos um rápido resumo dos problemas financeiros que você enfrentou em seu reino. + + + !i/the.elf-3.gif(Cristais Azuis foram maltratados.)! + + + Realmente, não é o caminho que eu me lembro. Esse Gnomo estava me bipando constantemente. Quando me + recusei a chamá-lo de volta, ele deixou uma mensagem no meu pager. Significado: ele bipou duas vezes e + então exibiu uma pequena mensagem. A mensagem disse alguma coisa sobre, "Desça aqui, rápido!" e também, + "Nós temos que livrar a terra destas pestes de lagartas empreendedoras, estes insetos insanos vikings + estão sufocando meus cristais azuis!" + + + Ultimamente, a taxa de câmbio já se estabelece entre as folhas e cristais. Uma nota de árvore velha vale + cinco cristais. Então a situação monetária básica é semelhante a isto: + + + <pre> + cristal_azul = 1 + folha_macia = 5 + </pre> + + + Este exemplo é _tão_ último capítulo. Ainda assim. Ele é um início. Nós estamos definindo + duas _variáveis_. O *sinal de igual* é usado para _atribuição_. + + + Agora @folha_macia@ representa o número @5@ (tal como em: cinco cristais azuis.) Este conceito, até + aqui, é *metade de Ruby*. Nós estamos _definindo_. Nós estamos _criando_. Isto é a metade do trabalho. + Atribuição é a forma mais básica de definição. + + + Você não pode se queixar, pode Gnomo? Você construiu um império investindo seus cristais azuis no + novo mercado livre entre as criaturas da floresta. (E apesar de ele é ser um gnomo para nós, ele é um + monstro grande para eles.) + + + !i/the.elf-4.jpg(Animal Perfeito, LLC)! + + lang-pt/poignant-25.yml @@ -1,31 +1,31 @@ - - !^sidebar - Os comedores de cachecóis: > - - Eu odeio me intrometer no seu aprendizado, mas eu já fiz isso tanto que eu não - me importo mais. Posso mostrar meu próximo projeto para você? - - - Eu prometi escrever outro livro. (_Trombones_.) A boa notícia é que na realidade - eu não vou escrever nada. Você não vai ter que aguentar ainda mais dessas tolices idiotas. - - - Está tudo acabado entre eu e as palavras. Eu adoraria ficar e explorar cada uma, uma após - a outra, mas está tudo ficando muito previsível, você não acha? Eventualmente, elas todas - serão usadas e eu terei de inventar palavras falsas e isso seria muito bizelegarro. - - - Agora. Ainda não é nada certo, mas já estou em negociações com a Anna Quindlen para escrever no meu lugar. - Nós estamos juntando esforços em um livro que vai arrancar o (Comovente) Guia das suas mãos. - Simplificando, o Guia será inútil. You won't be able to pile enough - pomegranates on top of the thing. - - - Esse novo livro. Os comedores de cachecóis. É um romance maduro. Mas também é um guia para iniciantes - de Macromedia Flash. É como se Judy Blume encontrasse Praystation. Ou como 0sil8 estrelando - Hillary Duff. - - - Eu não quero entregar nada sobre a história, mas para provocar o seu apetite eu posso dizer isso: - um garoto fala com o seu irmão morto em ActionScript. Mais por vir. - - + - !^sidebar + Os comedores de cachecóis: > + + Eu odeio me intrometer no seu aprendizado, mas eu já fiz isso tanto que eu não + me importo mais. Posso mostrar meu próximo projeto para você? + + + Eu prometi escrever outro livro. (_Trombones_.) A boa notícia é que na realidade + eu não vou escrever nada. Você não vai ter que aguentar ainda mais dessas tolices idiotas. + + + Está tudo acabado entre eu e as palavras. Eu adoraria ficar e explorar cada uma, uma após + a outra, mas está tudo ficando muito previsível, você não acha? Eventualmente, elas todas + serão usadas e eu terei de inventar palavras falsas e isso seria muito bizelegarro. + + + Agora. Ainda não é nada certo, mas já estou em negociações com a Anna Quindlen para escrever no meu lugar. + Nós estamos juntando esforços em um livro que vai arrancar o (Comovente) Guia das suas mãos. + Simplificando, o Guia será inútil. You won't be able to pile enough + pomegranates on top of the thing. + + + Esse novo livro. Os comedores de cachecóis. É um romance maduro. Mas também é um guia para iniciantes + de Macromedia Flash. É como se Judy Blume encontrasse Praystation. Ou como 0sil8 estrelando + Hillary Duff. + + + Eu não quero entregar nada sobre a história, mas para provocar o seu apetite eu posso dizer isso: + um garoto fala com o seu irmão morto em ActionScript. Mais por vir. + + lang-pt/poignant-26.yml @@ -1,116 +1,116 @@ - - > - Nãnãnã. Pera um segundo. You're not ready for what the Elf here is doing in his caves. - You'll think it's all positively inhumane, naughty, sick, tweeested, yada yada. - - - h3. Now You're Going to Hear the Animal Perfect Mission Statement Because This Is A - Book And We Have Time And No Rush, Right? - - - Back, back, way back before speedboats, I owned a prize race horse who took a stumble on - the track. She did ten front flips and crashed into a guy who was carrying a full jar - of mayonnaisse. We had blood and mayonnaisse up and down the track. Needless to say, - she was a disaster. - - - The vet took one look at her and swore she'd never walk again. Her legs were gone and - the vet wouldn't allow a legless horse to just sit around. We'd need to put her down. - He swore his life and career on it, insisting we divide into two parallel lines. The people - who could not refute the doctor's claims on one side; those too stubborn to accept his - infallable medical reasoning on the other. The Elf, his pet ham, and I were the only - ones in that second line. - - - So while the others heaped up trophies and great wreaths around the horse, bidding it a - fond farewell before the bullet came to take him home, the Elf and I frantically pawed the Internet for - answers. We took matter into our own hands, cauterizing her leg wounds with live crawdads. - It worked great! We now had a horse again. Or at least: a horse body with a crustaceous abdominal - frosting. - - - She scurried everywhere after that and lived for years in pleasantly moist underground cavities. - - - Animal Perfect is now the future of animal enhancement. They build new animals and salvage - old-style animals for parts. Of course, they've come a long ways. - When Animal Perfect started, you'd see a full-grown bear walk into Animal Perfect and you'd - see a full-grown bear with sunglasses walk out. Completely cheesy. - - - Stick around and you'll see a crab with _his own jet pack_. That's a new 2004 model jetcrab. - - - But now, the whole operation is up and running. And the cleanliness of the place is astonishing. - All the equipment is so shiny. Everything is in chrome. Oh, and all the staff have concealed - weapons. They're trained to kill anyone who enters unannounced. Or, if they run out of bullets, - they're trained to pistol whip anyone who enters unannounced. - - - Elfo, me faça um macacoestrela. - - - !i/the.elf-5a.jpg(Primeiro, a estrela é capturada.)! - - - Um pouco de Ruby imaginário pra você: - - - bq. @tubo.pegue_uma_estrela@ - - - Variável @tubo@. Método @pegue_uma_estrela@. Muitos Rubistas gostam de pensar em métodos como mensagem. - A quem vier antes do método é dada a mensagem. O código acima diz ao @tubo@ que - @pegue_uma_estrela@. - - - Esta é a *segunda metade* do Ruby. Colocar as coisas em movimento. Estas coisas que você define e cria - na primeira metade começam a _agir_ na segunda metade. - - - # Defining things. - - # Putting those things into action. - - - Então e se o código de pegar estrelas funcionar? Pra onde a estrela vai? - - - bq. @estrela_presa = pipe.pegue_uma_estrela@ - - - Veja, você que deve coletar a miserável, estrelinha. Se você nao o fizer, ela vai simplesmente desaparecer. - Toa vez que você usa um método, você recebe algo de volta. Você pode ignorá-lo ou usá-lo. - - - _Se você conseguir aprender a usar as respostas que os métodos de dão, então você irá *dominar*._ - - - !i/the.elf-5b.jpg(Star is ratcheted to the monkey's face.)! - - - Rapidamente então. - - - bq. @macacoestrela = ratchet.attach( macaco_preso, estrela_presa )@ - - - The @ratchet@ gets an @attach@ message. What needs to be attached? The _method arguments_: the - @macaco_preso@ e a @estrela_presa@. É nos dada de volta um @macacoestrela@, which we have - decided to hang on to. - - - !i/the.elf-5c.gif(Frog on the hand.)! - - - This is turning out to be such a short, little proggie that I'm just going to put it - all together as one statement. - - - bq. @starmonkey = ratchet.attach( captive_monkey, pipe.pegue_uma_estrela ) + deco_hand_frog@ - - - See how @pipe.pegue_uma_estrela@ is right in the arguments for the method? The caught - star will get passed right to the ratchet. No need to find a place to put it. Just - let it go. - - + - > + Nãnãnã. Pera um segundo. You're not ready for what the Elf here is doing in his caves. + You'll think it's all positively inhumane, naughty, sick, tweeested, yada yada. + + + h3. Now You're Going to Hear the Animal Perfect Mission Statement Because This Is A + Book And We Have Time And No Rush, Right? + + + Back, back, way back before speedboats, I owned a prize race horse who took a stumble on + the track. She did ten front flips and crashed into a guy who was carrying a full jar + of mayonnaisse. We had blood and mayonnaisse up and down the track. Needless to say, + she was a disaster. + + + The vet took one look at her and swore she'd never walk again. Her legs were gone and + the vet wouldn't allow a legless horse to just sit around. We'd need to put her down. + He swore his life and career on it, insisting we divide into two parallel lines. The people + who could not refute the doctor's claims on one side; those too stubborn to accept his + infallable medical reasoning on the other. The Elf, his pet ham, and I were the only + ones in that second line. + + + So while the others heaped up trophies and great wreaths around the horse, bidding it a + fond farewell before the bullet came to take him home, the Elf and I frantically pawed the Internet for + answers. We took matter into our own hands, cauterizing her leg wounds with live crawdads. + It worked great! We now had a horse again. Or at least: a horse body with a crustaceous abdominal + frosting. + + + She scurried everywhere after that and lived for years in pleasantly moist underground cavities. + + + Animal Perfect is now the future of animal enhancement. They build new animals and salvage + old-style animals for parts. Of course, they've come a long ways. + When Animal Perfect started, you'd see a full-grown bear walk into Animal Perfect and you'd + see a full-grown bear with sunglasses walk out. Completely cheesy. + + + Stick around and you'll see a crab with _his own jet pack_. That's a new 2004 model jetcrab. + + + But now, the whole operation is up and running. And the cleanliness of the place is astonishing. + All the equipment is so shiny. Everything is in chrome. Oh, and all the staff have concealed + weapons. They're trained to kill anyone who enters unannounced. Or, if they run out of bullets, + they're trained to pistol whip anyone who enters unannounced. + + + Elfo, me faça um macacoestrela. + + + !i/the.elf-5a.jpg(Primeiro, a estrela é capturada.)! + + + Um pouco de Ruby imaginário pra você: + + + bq. @tubo.pegue_uma_estrela@ + + + Variável @tubo@. Método @pegue_uma_estrela@. Muitos Rubistas gostam de pensar em métodos como mensagem. + A quem vier antes do método é dada a mensagem. O código acima diz ao @tubo@ que + @pegue_uma_estrela@. + + + Esta é a *segunda metade* do Ruby. Colocar as coisas em movimento. Estas coisas que você define e cria + na primeira metade começam a _agir_ na segunda metade. + + + # Defining things. + + # Putting those things into action. + + + Então e se o código de pegar estrelas funcionar? Pra onde a estrela vai? + + + bq. @estrela_presa = pipe.pegue_uma_estrela@ + + + Veja, você que deve coletar a miserável, estrelinha. Se você nao o fizer, ela vai simplesmente desaparecer. + Toa vez que você usa um método, você recebe algo de volta. Você pode ignorá-lo ou usá-lo. + + + _Se você conseguir aprender a usar as respostas que os métodos de dão, então você irá *dominar*._ + + + !i/the.elf-5b.jpg(Star is ratcheted to the monkey's face.)! + + + Rapidamente então. + + + bq. @macacoestrela = ratchet.attach( macaco_preso, estrela_presa )@ + + + The @ratchet@ gets an @attach@ message. What needs to be attached? The _method arguments_: the + @macaco_preso@ e a @estrela_presa@. É nos dada de volta um @macacoestrela@, which we have + decided to hang on to. + + + !i/the.elf-5c.gif(Frog on the hand.)! + + + This is turning out to be such a short, little proggie that I'm just going to put it + all together as one statement. + + + bq. @starmonkey = ratchet.attach( captive_monkey, pipe.pegue_uma_estrela ) + deco_hand_frog@ + + + See how @pipe.pegue_uma_estrela@ is right in the arguments for the method? The caught + star will get passed right to the ratchet. No need to find a place to put it. Just + let it go. + + lang-pt/poignant-27.yml @@ -1,126 +1,126 @@ - - Pequeno e Quase Sem Valor: > - - !i/blix-1.gif(Law-va.)! - - - O hotel aqui em Ambrose não é nem um pouco bom. As camas são todas tortas. - O elevador é minúsculo. Um cara pôs toda sua bagagem no elevador e não sobrou - mais lugar pra ele. Ele apertou o botão e as perseguiu pelas escadas. - Mas as escadas eram muito estreitas e ele ficou entalado tentando subir. - - - Os mini-sabonetes que eles te dão são de tamanho gnomo, então é impossível - fazer uma espuma. Eu odeio isso. Toda hora eu confundo eles com lentes de contato. - - - Eu abri a torneira e nada saiu. O caso é o seguinte: Ambrose é um - lugar com propriedades mágicas, então eu me arrisquei. Coloquei minha mão embaixo - torneira. Invisible, warm wetness. Eu senti a sensação de água corrente, - passando pelos meus dedos. Quando tirei minha mão de lá, - elas estavam secas e limpas. - - - Foi um incrível experiência de vazio total. Foi como @nil@. - - - h3. Nil (Nada) - - - No Ruby, o @nil@ representa o vazio. Ele representa *falta de valor*. Ele não é zero. - Zero é um número. - - - É um morto-vivo do Ruby, uma palavra chave falecida. Você não pode adicionar à ele, - ele não evolui. Mas ele é terrivelmente popular. É este esqueleto sorrindo nas fotos. - - - bq. @copo_plastico = nil@ - - - No código acima @copo_plastico@ está *vazio*. Você pode argumentar que o @copo_plastico@ - contém algo, um @nil@. O @nil@ representa vazio, logo, então, - adiante-se e chame-o de vazio. - - - Alguns de vocês que já programaram antes estarão tentados a dizer que @copo_plastico@ está - *indefinido* (undefined). Que tal não. Quando você diz que uma variável está indefinida, - você está dizendo que o Ruby simplesmente não tem lembrança da variável, ele não a conhece, - ela absolutamente não existe. - - - Mas o Ruby está sabendo do @copo_plastico@. Ruby pode facilmente olhar dentro do @copo_plastico@. - Está *vazio*, mas não está *indefinido*. - - - h3. False (Falso) - - - !<i/blix-neg.gif(Forma de um gato.)! - - - _The cat Trady Blix. Frozen in emptiness. Immaculate whiskers rigid. Placid - eyes of lake. Tail of warm icicle. Sponsored by a Very Powerful Pause Button._ - - - A escuridão que circunda o Blix pode ser chamada de *espaço negativo*. Atente-se nessa frase. - Deixe ela sugerir que o vazio tem conotação negativa. De um jeito similar, - @nil@ tem a slightly sour note that it whistles. - - - Generalizando, *tudo no Ruby tem uma carga positiva*. Esta fagulha - corre por strings, números, regexps, todos eles. Somente duas palavras reservadas vestem uma - capa sombria: @nil@ e @false@ nos trazendo pra baixo. - - - Você pode *testar essa carga* com a palavra chave @if@. Ela se parece muito como - o bloco @do@ que vimos no último capítulo, no qual ambas terminal com um @end@. - - - <pre> - if copo_plastico - print "O copo de plástico tá até transbordando!" - end - </pre> - - - Se @copo_plastico@ conter @nil@ ou @false@, você não vai ver nada impresso - na tela. Eles não estão na lista de convidados do @if@. Então o @if@ não vai rodar - nada do código que ele está protegendo. - - - Mas @nil@ e @false@ não precisam ir embora constrangidos. O caráter deles pode ser meio - questionável, mas o @unless@ gerencia uma estabelecimento que preza ser fuleiro. - A palavra chave @unless@ tem por regra *só deixar aqueles com carga negativa entrar*. - Aqueles são: @nil@ e @false@. - - - <pre> - unless copo_plastico - print "Tá na hora de abastecer o copo plástico." - end - </pre> - - - Você também pode usar @if@ e @unless@ no *fim de uma linha de código*, se apenas - aquela linha estiver sendo protegida. - - - <pre> - print "Yeah, o copo tá cheio de novo!" if copo_plastico - print "Dificilmente. Ele tá vazio." unless copo_plastico - </pre> - - - E mais uma manha: empilhar o @if@ e @unless@. - - - <pre> - print "Estamos usando copos de plástico pois não temos de vidro." if copo_plastico unless copo_vidro - </pre> - - - Esta manha é um lindo jeito de expressar: _Faça isso só se *a* for true e *b* não for true_. - - - Agora que você já conheceu o @false@, Tenho certeza que você pode ver o que vem em seguida. - + - Pequeno e Quase Sem Valor: > + + !i/blix-1.gif(Law-va.)! + + + O hotel aqui em Ambrose não é nem um pouco bom. As camas são todas tortas. + O elevador é minúsculo. Um cara pôs toda sua bagagem no elevador e não sobrou + mais lugar pra ele. Ele apertou o botão e as perseguiu pelas escadas. + Mas as escadas eram muito estreitas e ele ficou entalado tentando subir. + + + Os mini-sabonetes que eles te dão são de tamanho gnomo, então é impossível + fazer uma espuma. Eu odeio isso. Toda hora eu confundo eles com lentes de contato. + + + Eu abri a torneira e nada saiu. O caso é o seguinte: Ambrose é um + lugar com propriedades mágicas, então eu me arrisquei. Coloquei minha mão embaixo + torneira. Invisible, warm wetness. Eu senti a sensação de água corrente, + passando pelos meus dedos. Quando tirei minha mão de lá, + elas estavam secas e limpas. + + + Foi um incrível experiência de vazio total. Foi como @nil@. + + + h3. Nil (Nada) + + + No Ruby, o @nil@ representa o vazio. Ele representa *falta de valor*. Ele não é zero. + Zero é um número. + + + É um morto-vivo do Ruby, uma palavra chave falecida. Você não pode adicionar à ele, + ele não evolui. Mas ele é terrivelmente popular. É este esqueleto sorrindo nas fotos. + + + bq. @copo_plastico = nil@ + + + No código acima @copo_plastico@ está *vazio*. Você pode argumentar que o @copo_plastico@ + contém algo, um @nil@. O @nil@ representa vazio, logo, então, + adiante-se e chame-o de vazio. + + + Alguns de vocês que já programaram antes estarão tentados a dizer que @copo_plastico@ está + *indefinido* (undefined). Que tal não. Quando você diz que uma variável está indefinida, + você está dizendo que o Ruby simplesmente não tem lembrança da variável, ele não a conhece, + ela absolutamente não existe. + + + Mas o Ruby está sabendo do @copo_plastico@. Ruby pode facilmente olhar dentro do @copo_plastico@. + Está *vazio*, mas não está *indefinido*. + + + h3. False (Falso) + + + !<i/blix-neg.gif(Forma de um gato.)! + + + _The cat Trady Blix. Frozen in emptiness. Immaculate whiskers rigid. Placid + eyes of lake. Tail of warm icicle. Sponsored by a Very Powerful Pause Button._ + + + A escuridão que circunda o Blix pode ser chamada de *espaço negativo*. Atente-se nessa frase. + Deixe ela sugerir que o vazio tem conotação negativa. De um jeito similar, + @nil@ tem a slightly sour note that it whistles. + + + Generalizando, *tudo no Ruby tem uma carga positiva*. Esta fagulha + corre por strings, números, regexps, todos eles. Somente duas palavras reservadas vestem uma + capa sombria: @nil@ e @false@ nos trazendo pra baixo. + + + Você pode *testar essa carga* com a palavra chave @if@. Ela se parece muito como + o bloco @do@ que vimos no último capítulo, no qual ambas terminal com um @end@. + + + <pre> + if copo_plastico + print "O copo de plástico tá até transbordando!" + end + </pre> + + + Se @copo_plastico@ conter @nil@ ou @false@, você não vai ver nada impresso + na tela. Eles não estão na lista de convidados do @if@. Então o @if@ não vai rodar + nada do código que ele está protegendo. + + + Mas @nil@ e @false@ não precisam ir embora constrangidos. O caráter deles pode ser meio + questionável, mas o @unless@ gerencia uma estabelecimento que preza ser fuleiro. + A palavra chave @unless@ tem por regra *só deixar aqueles com carga negativa entrar*. + Aqueles são: @nil@ e @false@. + + + <pre> + unless copo_plastico + print "Tá na hora de abastecer o copo plástico." + end + </pre> + + + Você também pode usar @if@ e @unless@ no *fim de uma linha de código*, se apenas + aquela linha estiver sendo protegida. + + + <pre> + print "Yeah, o copo tá cheio de novo!" if copo_plastico + print "Dificilmente. Ele tá vazio." unless copo_plastico + </pre> + + + E mais uma manha: empilhar o @if@ e @unless@. + + + <pre> + print "Estamos usando copos de plástico pois não temos de vidro." if copo_plastico unless copo_vidro + </pre> + + + Esta manha é um lindo jeito de expressar: _Faça isso só se *a* for true e *b* não for true_. + + + Agora que você já conheceu o @false@, Tenho certeza que você pode ver o que vem em seguida. + lang-pt/poignant-28.yml @@ -1,33 +1,33 @@ - - !^sidebar - Faça Seu Próprio Macacoestrela!: > - - 1. Vire uma xícara de cabeça pra baixo. - - !i/starmonkeycrafts-1.jpg! - - 2. Adicione uma maçã com a ajuda de um elástico. - - !i/starmonkeycrafts-2.jpg! - - 3. Enfie as chaves de carro dos lados da maçã. - - !i/starmonkeycrafts-3.jpg! - - 4. Cole a face de estrela. - - !i/starmonkeycrafts-4.jpg! - - - Você tem mais duas faces de estrela complementares - esperando na sua conta. - - - p=. !i/starmonkeycrafts-5.gif! - - Comum, calma. - - - p=. !i/starmonkeycrafts-6.gif! - - Comendo giz. - + - !^sidebar + Faça Seu Próprio Macacoestrela!: > + + 1. Vire uma xícara de cabeça pra baixo. + + !i/starmonkeycrafts-1.jpg! + + 2. Adicione uma maçã com a ajuda de um elástico. + + !i/starmonkeycrafts-2.jpg! + + 3. Enfie as chaves de carro dos lados da maçã. + + !i/starmonkeycrafts-3.jpg! + + 4. Cole a face de estrela. + + !i/starmonkeycrafts-4.jpg! + + + Você tem mais duas faces de estrela complementares + esperando na sua conta. + + + p=. !i/starmonkeycrafts-5.gif! + + Comum, calma. + + + p=. !i/starmonkeycrafts-6.gif! + + Comendo giz. + lang-pt/poignant-29.yml @@ -1,167 +1,167 @@ - - > - h3. True (Verdadeiro) - - - bq. @sujeito_aproximando = true@ - - - Eu vi o @true@ na buffet do hotel hoje. Eu não suporto aquele cara. - Ele aparece demais. And you've never met anyone who planted his - feet so hard in the ground. Ele usa esse colar brega feito de - conchas. Sua face exibe uma confiança insolente. (You can tell he's exerting - all of his restraint just to keep from bursting into Neo flight.) - - - Pra ser honesto, não consigo ficar do lado de alguém que sempre tem de estar certo. - Esse @true@ está sempre dizendo, "A-OK." Flashing hang ten. E é sério, - ele ama aquele colar. Ele o usa constantemente. - - - Assim como você suspeitou, ele é condição sine qua non em tudo que o @if@ agende. - - - bq. @print "Hugo Boss" if true@ se comporta como @print "Hugo Boss"@. - - - Ocasionalmente, o @if@ vai puxar as cordas vermelhas pra exercer algum controle de multidão. - Os *dois iguais* dão a aparência de uma passagem, como cordas dos lados - de um carpete vermelho onde só @true@ é aceito. - - - <pre> - if sujeito_aproximando == true - print "Esse colar é clássico." - end - </pre> - - - Os dois iguais são simplesmente *uma checagem de identificação*. Os cavalheiros dos lados desta corda - parecem ser iguais? - - - Deste jeito, você controle quem o @if@ deixa entrar. Se você não suporta o @true@ assim como eu, - receba de peito aberto o @false@ (falso). - - - <pre> - if sujeito_aproximando == false - print "Chega mais, seu diabo conivente." - end - </pre> - - - Mesma coisa pra @unless@. O portão é seu. Tome o controle dele. - - - h3. Novamente, Eu Quero Que Você Domine - - - Agora, tá afim de uma viagem mental? *O sinal de dois iguais é um método.* Você consegue adivinhar - como ele funciona? Aqui, dê uma olhada nele com ponto e parentêses: - - - bq. @sujeito_aproximando.==( true )@ - - - Ruby permite o atalho, sem problemas. Jogue o ponto e vá pra trás, devagar. - - - Agora, você se lembra o que deve fazer pra *dominar* no Ruby? _Use as respostas que - os métodos te dão._ - - - <pre> - if nil.==( true ) - print "Isto nunca vai acontecer." - end - </pre> - - - No exemplo acima, como a resposta do método esta sendo usada? - - - Pegue a afirmação @nil == true@. Isso vai falhar toda hora. Não são iguais. - Quando não há igualdade, o método dos dois iguais responde com @false@. Uma balançada de cabeça. - Esta resposta é dada ao @if@, que não pode aceitar um @false@. O @print@ nunca acontecerá. - - - <pre> - no_hotel = true - email = if no_hotel - "why@hotelambrose.com" - else - "why@drnhowardcham.com" - end - </pre> - - - Mesmo que @if@ não seja um método, o @if@ retorna uma resposta. Observe o exemplo acima - e imagine o que acontece quando @no_hotel@ é @true@. - - - O @if@ retornará a resposta dada pelo código que ele decidir rodar. No caso de - @no_hotel@ ser true, a primeira string, meu endereço de e-mail no Hotel Ambrose, será - retornado. A palavra reservada @else@ marca o código a ser rodado, uma vez que o @if@ falhe. Se @no_hotel@ - é false, o @if@ responderá com meu endereço de e-mail do escritório do Dr. N. Howard Cham, - onde eu recebo meu aprendizado. - - - Você deve ter várias linhas de código dentro de um @if@ ou @unless@, *mas somente a resposta oriunda - da última afirmacão completa será usada*. - - - <pre> - email = if no_hotel - endereco = "why" - endereco << "@hotelambrose" - endereco << ".com" - end - </pre> - - - Três linhas de código dentro do @if@. A primeira linha atribui uma string com meu nome dentro a uma variável. - A segunda e terceira linha adicionam o resto do meu endereço de e-mail no fim. O *menor que duplo @<<@ - é o operador da concatenação*. Concatenar é o mesmo que *apender*, or *adicionar no fim*. - - - Assim como vimos com o checador de igualdade @==@, o concatenador é um método. Após adicionar no fim - da string, o concatenador ainda *responde com aquela mesma stringt*. Então, a terceira linha, que pode ser - lida como as @endereco.<<( ".com" )@, retorna @endereco@, que o @if@ então devolve pra a atribuição @email@. - - - Uma pergunta: E se o @if@ falhar? E se @no_hotel@ for false no exemplo acimoa? - Alguma coisa será retornada? Nada é atribuído a @email@, certo? - - - Sim, nada é retornado. Que significa que: @nil@ foi retornado. E @nil@ é muitas vezes uma - resposta muito útil. - - - <pre> - print( if no_hotel.nil? - "Se pistas se ele está no hotel." - elsif no_hotel == true - "Definitivamente sim." - elsif no_hotel == false - "Ele saiu." - else - "O sistema está traaaaavad-iz" - end ) - </pre> - - - Você pode usar o método @nil?@ em qualquer valor no Ruby. Novamente, pense nele com uma mensagem. - Para o valor: "Você é nil? Você está vazio?" - - - Se @no_hotel@ estiver vazia, o Ruby não tem idéia se eu estou no hotel ou não. Então o @if@ - responde com a string "Sem pistas". Para manejar as possibilidades de @true@ ou @false@, - a palavra reservada @elsif@ é usada. Enquanto você pode ter apenas um @if@ e um @else@, você pode encher - as entranhas com um exorbitante número de palavras chave @elsif@. Cada @elsif@ age como *um outro teste @if@*. - Checando por uma carga positiva. - - - Se você está indo bem até este ponto, então você está em boa forma para o resto do - livro. Você viu um código bem parrudo nos últimos exemplos. Você é um forte companheiro. - - + - > + h3. True (Verdadeiro) + + + bq. @sujeito_aproximando = true@ + + + Eu vi o @true@ na buffet do hotel hoje. Eu não suporto aquele cara. + Ele aparece demais. And you've never met anyone who planted his + feet so hard in the ground. Ele usa esse colar brega feito de + conchas. Sua face exibe uma confiança insolente. (You can tell he's exerting + all of his restraint just to keep from bursting into Neo flight.) + + + Pra ser honesto, não consigo ficar do lado de alguém que sempre tem de estar certo. + Esse @true@ está sempre dizendo, "A-OK." Flashing hang ten. E é sério, + ele ama aquele colar. Ele o usa constantemente. + + + Assim como você suspeitou, ele é condição sine qua non em tudo que o @if@ agende. + + + bq. @print "Hugo Boss" if true@ se comporta como @print "Hugo Boss"@. + + + Ocasionalmente, o @if@ vai puxar as cordas vermelhas pra exercer algum controle de multidão. + Os *dois iguais* dão a aparência de uma passagem, como cordas dos lados + de um carpete vermelho onde só @true@ é aceito. + + + <pre> + if sujeito_aproximando == true + print "Esse colar é clássico." + end + </pre> + + + Os dois iguais são simplesmente *uma checagem de identificação*. Os cavalheiros dos lados desta corda + parecem ser iguais? + + + Deste jeito, você controle quem o @if@ deixa entrar. Se você não suporta o @true@ assim como eu, + receba de peito aberto o @false@ (falso). + + + <pre> + if sujeito_aproximando == false + print "Chega mais, seu diabo conivente." + end + </pre> + + + Mesma coisa pra @unless@. O portão é seu. Tome o controle dele. + + + h3. Novamente, Eu Quero Que Você Domine + + + Agora, tá afim de uma viagem mental? *O sinal de dois iguais é um método.* Você consegue adivinhar + como ele funciona? Aqui, dê uma olhada nele com ponto e parentêses: + + + bq. @sujeito_aproximando.==( true )@ + + + Ruby permite o atalho, sem problemas. Jogue o ponto e vá pra trás, devagar. + + + Agora, você se lembra o que deve fazer pra *dominar* no Ruby? _Use as respostas que + os métodos te dão._ + + + <pre> + if nil.==( true ) + print "Isto nunca vai acontecer." + end + </pre> + + + No exemplo acima, como a resposta do método esta sendo usada? + + + Pegue a afirmação @nil == true@. Isso vai falhar toda hora. Não são iguais. + Quando não há igualdade, o método dos dois iguais responde com @false@. Uma balançada de cabeça. + Esta resposta é dada ao @if@, que não pode aceitar um @false@. O @print@ nunca acontecerá. + + + <pre> + no_hotel = true + email = if no_hotel + "why@hotelambrose.com" + else + "why@drnhowardcham.com" + end + </pre> + + + Mesmo que @if@ não seja um método, o @if@ retorna uma resposta. Observe o exemplo acima + e imagine o que acontece quando @no_hotel@ é @true@. + + + O @if@ retornará a resposta dada pelo código que ele decidir rodar. No caso de + @no_hotel@ ser true, a primeira string, meu endereço de e-mail no Hotel Ambrose, será + retornado. A palavra reservada @else@ marca o código a ser rodado, uma vez que o @if@ falhe. Se @no_hotel@ + é false, o @if@ responderá com meu endereço de e-mail do escritório do Dr. N. Howard Cham, + onde eu recebo meu aprendizado. + + + Você deve ter várias linhas de código dentro de um @if@ ou @unless@, *mas somente a resposta oriunda + da última afirmacão completa será usada*. + + + <pre> + email = if no_hotel + endereco = "why" + endereco << "@hotelambrose" + endereco << ".com" + end + </pre> + + + Três linhas de código dentro do @if@. A primeira linha atribui uma string com meu nome dentro a uma variável. + A segunda e terceira linha adicionam o resto do meu endereço de e-mail no fim. O *menor que duplo @<<@ + é o operador da concatenação*. Concatenar é o mesmo que *apender*, or *adicionar no fim*. + + + Assim como vimos com o checador de igualdade @==@, o concatenador é um método. Após adicionar no fim + da string, o concatenador ainda *responde com aquela mesma stringt*. Então, a terceira linha, que pode ser + lida como as @endereco.<<( ".com" )@, retorna @endereco@, que o @if@ então devolve pra a atribuição @email@. + + + Uma pergunta: E se o @if@ falhar? E se @no_hotel@ for false no exemplo acimoa? + Alguma coisa será retornada? Nada é atribuído a @email@, certo? + + + Sim, nada é retornado. Que significa que: @nil@ foi retornado. E @nil@ é muitas vezes uma + resposta muito útil. + + + <pre> + print( if no_hotel.nil? + "Se pistas se ele está no hotel." + elsif no_hotel == true + "Definitivamente sim." + elsif no_hotel == false + "Ele saiu." + else + "O sistema está traaaaavad-iz" + end ) + </pre> + + + Você pode usar o método @nil?@ em qualquer valor no Ruby. Novamente, pense nele com uma mensagem. + Para o valor: "Você é nil? Você está vazio?" + + + Se @no_hotel@ estiver vazia, o Ruby não tem idéia se eu estou no hotel ou não. Então o @if@ + responde com a string "Sem pistas". Para manejar as possibilidades de @true@ ou @false@, + a palavra reservada @elsif@ é usada. Enquanto você pode ter apenas um @if@ e um @else@, você pode encher + as entranhas com um exorbitante número de palavras chave @elsif@. Cada @elsif@ age como *um outro teste @if@*. + Checando por uma carga positiva. + + + Se você está indo bem até este ponto, então você está em boa forma para o resto do + livro. Você viu um código bem parrudo nos últimos exemplos. Você é um forte companheiro. + + lang-pt/poignant-30.yml @@ -1,83 +1,83 @@ - - Chaining Delusions Together: > - - !i/the.elf-6.jpg(55,000 starmonkeys and one spirited Olympic hopeful.)! - - - You finish reading the above comic and retire to your daybed for reflection. It's one of - those canopy affairs which is always logjammed with pillows. You sit atop the pile, - gazing out upon the world. You see the tall smokestacks belching wide spools of fume and - haze. The tangled concourses of freeways smattered with swift, shimmering traffic is but - a gently pulsing eye muscle from your vantage point. - - - It is all so fantastic. How the colors of the horizon spread across the landscape as a great - mix of butter and grease with a tablespoon of vanilla extract. - - - Yet, for all of the beauty which beckons for your attention, the images of the Elf and - his Olympic Hopeful return. And more especially, that order for *55,000* starmonkeys. - _55,000 starmonkeys_, you think. _Fifty-five Thousand_. - - - You think of just the number itself. _55,000_. It's walking down a road. It might be in - a forest, you don't know for sure as your eyes are fixed right on the number itself. It's stopping - and talking to people. To tennis players, to a men's choral group. There is merriment and good - feeling. When it laughs, its lower zeros quiver with glee. - - - You want to talk to it. You want to skip along that forest trail with it. You want to climb - aboard a jet bound to Brazil with it. And after five days and four nights at the leisureful - Costa do Sauipe Marriott Resort & Spa, to marry it, to bear a family of 55,000 starmonkeys with it. - To take possession of Nigeria with it. - - - With a flying leap, you dismount your pillow tower of isolation. Scrambling with the key, - you unlock your roll top desk and pull out a sheet of paper, holding it firmly upon the - desk. You begin scribbling. - - - bq. _Take possession of Nigeria with my new 55,000 starmonkeys_... - - _Over it, build Nigeria-sized *vegetarians only* casino and go-cart arena_... - - _Wings... we could have our own special sauce on the wings that's different_... - - _Mustard + codeine = Smotchkkiss' Starry Starmonkey Glow Sauce_... - - _Franchise, franchise... logos_... - - _Employee instructional videos_... - - _When you give the customer change, - let them reach inside the frog on your hand to get it_... - - _If they have no change, at least put their - reciept some place where they have to touch the frog_... - - _We're leveling the playing field here_... - - _Advertise cheap pizza, let's make our money off soda_... - - _Collect all 4 frosted glasses_... - - - Wow, the ideas are really coming out. You literally had to smack yourself to stop. We need to put these - in a safe place. Actually, we should store them on your computer and mangle the words. You look out the - window and watch for FBI. I'm going to start this script. - - - h3. The Flipping Script - - - <pre> - print "Type and be diabolical: " - idea_backwards = gets.reverse - </pre> - - - Let this script be your confidante. It will ask for evil plans and turn their letters backwards. - The @gets@ method is *built into Ruby*. It's a *kernel method* like @print@. This method @gets@ - will pause Ruby to let you type. When you hit _Enter_, @gets@ will then stop paying attention - to your keyboard punchings and answer back to Ruby with a string that contains everything you typed. - - + - Chaining Delusions Together: > + + !i/the.elf-6.jpg(55,000 starmonkeys and one spirited Olympic hopeful.)! + + + You finish reading the above comic and retire to your daybed for reflection. It's one of + those canopy affairs which is always logjammed with pillows. You sit atop the pile, + gazing out upon the world. You see the tall smokestacks belching wide spools of fume and + haze. The tangled concourses of freeways smattered with swift, shimmering traffic is but + a gently pulsing eye muscle from your vantage point. + + + It is all so fantastic. How the colors of the horizon spread across the landscape as a great + mix of butter and grease with a tablespoon of vanilla extract. + + + Yet, for all of the beauty which beckons for your attention, the images of the Elf and + his Olympic Hopeful return. And more especially, that order for *55,000* starmonkeys. + _55,000 starmonkeys_, you think. _Fifty-five Thousand_. + + + You think of just the number itself. _55,000_. It's walking down a road. It might be in + a forest, you don't know for sure as your eyes are fixed right on the number itself. It's stopping + and talking to people. To tennis players, to a men's choral group. There is merriment and good + feeling. When it laughs, its lower zeros quiver with glee. + + + You want to talk to it. You want to skip along that forest trail with it. You want to climb + aboard a jet bound to Brazil with it. And after five days and four nights at the leisureful + Costa do Sauipe Marriott Resort & Spa, to marry it, to bear a family of 55,000 starmonkeys with it. + To take possession of Nigeria with it. + + + With a flying leap, you dismount your pillow tower of isolation. Scrambling with the key, + you unlock your roll top desk and pull out a sheet of paper, holding it firmly upon the + desk. You begin scribbling. + + + bq. _Take possession of Nigeria with my new 55,000 starmonkeys_... + + _Over it, build Nigeria-sized *vegetarians only* casino and go-cart arena_... + + _Wings... we could have our own special sauce on the wings that's different_... + + _Mustard + codeine = Smotchkkiss' Starry Starmonkey Glow Sauce_... + + _Franchise, franchise... logos_... + + _Employee instructional videos_... + + _When you give the customer change, + let them reach inside the frog on your hand to get it_... + + _If they have no change, at least put their + reciept some place where they have to touch the frog_... + + _We're leveling the playing field here_... + + _Advertise cheap pizza, let's make our money off soda_... + + _Collect all 4 frosted glasses_... + + + Wow, the ideas are really coming out. You literally had to smack yourself to stop. We need to put these + in a safe place. Actually, we should store them on your computer and mangle the words. You look out the + window and watch for FBI. I'm going to start this script. + + + h3. The Flipping Script + + + <pre> + print "Type and be diabolical: " + idea_backwards = gets.reverse + </pre> + + + Let this script be your confidante. It will ask for evil plans and turn their letters backwards. + The @gets@ method is *built into Ruby*. It's a *kernel method* like @print@. This method @gets@ + will pause Ruby to let you type. When you hit _Enter_, @gets@ will then stop paying attention + to your keyboard punchings and answer back to Ruby with a string that contains everything you typed. + + lang-pt/poignant-31.yml @@ -1,12 +1,12 @@ - - !^sidebar - Saia na frente com A Roupa do Tigre: > - - !i/ad-tiger.gif!:expansion-pak-1.html - - - Quer começar a usar o Ruby junto com a leitura? Divida sua atenção e veja o - "Pacote de Expansão I: A Roupa do Tigre":expansion-pak-1.html, um mini-capítulo usual - que vai te ajudar a instalar o Ruby. E ainda, aprender como usar Irb e Ri, dois - modos de ajuda que vêm com o Ruby e irão agilizar seu aprendizado. - - + - !^sidebar + Saia na frente com A Roupa do Tigre: > + + !i/ad-tiger.gif!:expansion-pak-1.html + + + Quer começar a usar o Ruby junto com a leitura? Divida sua atenção e veja o + "Pacote de Expansão I: A Roupa do Tigre":expansion-pak-1.html, um mini-capítulo usual + que vai te ajudar a instalar o Ruby. E ainda, aprender como usar Irb e Ri, dois + modos de ajuda que vêm com o Ruby e irão agilizar seu aprendizado. + + lang-pt/poignant-32.yml @@ -1,326 +1,326 @@ - - > - O método @reverse@ é então usado na String que o @gets@ está devolvendo. O método @reverse@ - é parte da classe @String@. O que significa que *tudo que for uma string tem o método @reverse@ - disponível*. Mais sobre classes no próximo capítulo, por enquanto só saiba que *alguns métodos - só estão disponíveis para certos tipos de valores*. - - - Eu não acho que o @reverse@ vai dar muito certo. As autoridades só precisam por um espelho na frente - de "airégiN ad elortnoc o emoT." Prenderão a gente quando as starmonkeys começarem a pousar em Lagos. - - - As letras maiúsculas estão entregando o ouro. Talvez se nós passássemos todas as letras na string - para maiúsculas antes de inverter. - - - <pre> - ideia_ao_contrario = gets.upcase.reverse - </pre> - - - h3. Sua Repetitividade Compensa - - - Você me entrega um bloco de notas, cheio de garranchos ilegíveis. Analisando ele, eu começo a notar - padrões. Notar que você parece usar as mesmas palavras repetidamente in your musings. - Palavras como _macacoestrela_, _Nigéria_, _bomba_. Algumas frases até. _Put the kabosh on._ - Que são ditas toda hora. - - - Vamos disfarçar estes termos bobos, meu irmão. Vamos ofuscá-los de olhos comichantes que - choram para saber nossos delicados planos e para nos impedir de ter grande prazer e muitos karts. - Vamos trocá-los por linguagem inocente. Novas palavras com significado secreto. - - - Eu comecei uma lista de palavras, uma @Hash@ do Ruby, que contém estas suas palavras tão freqüentes e perigosas. - Na Hash, cada palavra perigosa é comparada contra uma palavra código (ou frase). A palavra código então - será trocada pela palavra real. - - - <pre> - palavras_codigo = { - 'macacosestrela' => 'Phil e Pete, those prickly chancellors of the New Reich', - 'catapulta' => 'chucky go-go', 'bomba' => 'Heat-Assisted Living', - 'Nigeria' => "Ny e Jerry's Lavagem a Seco (com Donuts)", - 'Put the kabosh on' => 'Put the cable box on' - } - </pre> - - - As palavras que são colocadas antes da seta são chamadas *chaves*. As palavras depois - das setas, as definições, geralmente são chamadas de *valores* simplesmente. - - - Note as aspas duplas em volta de @Ny e Jerry's Lavagem a Seco (com Donuts)@. Já que nas - aspas está sendo usado um apóstrofo, nós não podemos usar aspas simples em torno - da string. (Todavia, você pode usar aspas simples se você colocar uma barra invertida antes - do apóstrofo como em: @'Ny e Jerry\'s Lavagem a Seco (com Donuts)'@.) - - - Se você precisar procurar por uma palavra em específico, você pode usar o método das *chaves*. - - - bq. @palavras_codigo['catapulta']@ irá responder com a string @'chucky go-go'@. - - - Olhe as chaves como se elas fossem paletes de madeira nas quais as palavras estão em cima. - Uma empilhadeira poderia usar suas pás em cada lado da palete e a trazer da prateleira - de volta ao depósito. A palavra na palete é chamada de _indexador_. - Estamos pedido para a empilhadeira achar o indexador pra gente e nos trazer de volta - o valor correspondente. - - - Se você nunca esteve num depósito, você pode ver as chaves como alças. - Imagine um trabalhador industrial colocando suas luvas e levando o index de volta à - sua custódia. Se você nunca usou uma alça, ou te dar cerca de - trinta segundo pra achar uma e usar antes que eu fique nervoso. - - - Assim como os vários operadores que você viu recentemente, as chaves indexadoras são - simplesmente um atalho para um método. - - - bq. @palavras_codigo.[]( 'catapulta' )@ irá responder com a string @'chucky go-go'@. - - - h3. Fazendo a Troca - - - Eu me adiantei e salvei a Hash de código em um arquivo chamado *listadepalavras.rb*. - - - <pre> - require 'listadepalavras' - - # Pegar a idéia do mal e converter em palavra código - print "Entre com sua nova idéia: " - ideia = gets - palavras_codigo.each do |real, codigo| - ideia.gsub!( real, codigo ) - end - - # Salva o papo-furado num novo arquivo - print "Arquivo codificado. Favor entrar com um nome para esta idéia: " - nome_ideia = gets.strip - File::open( "ideia-" + nome_ideia + ".txt", "w" ) do |f| - f << ideia - end - </pre> - - - O Script começa puxando nossa lista de palavras. Assim como @gets@ e @print@, o método @require@ - é um método do kernel, você pode usá-lo em qualquer lugar. Eu dei a ele a string @'listadepalavras'@ - e ele vai procurar um arquivo chamado *listadepalavras.rb*. - - - Depois disso, há duas seções. Estou marcando estas seções com comentários, as linhas que começam - com o símbolo *cerquilha #*. Comentários são *notas úteis* que acompanham seu código. Colegas que - vierem ver seu código vão apreciar tal ajuda. Você mesmo, quando vier no seu código novamente - depois de algum tempo, comentários vão te ajudar a retomar o fio da meada. E ainda existe - softwares por aí que pegam seus comentários e fazem documentação à partir deles. (RDoc e Ri -- - veja o Pacote de Expansão #1!) - - - Eu gosto de comentários porque posso passar os olhos por uma grande pilha de código e identificar pontos importantes. - - - Como os comentários nos dizem, a primeira seção de pergunta uma idéia maléfica e a troca por uma - palavra código. A segunda seção salva a idéia codificada num novo arquivo de texto. - - - <pre> - palavras_codigo.each do |real, codigo| - ideia.gsub!( real, codigo ) - end - </pre> - - - Você viu o método @each@? O método @each@ está em todo lugar no Ruby. - Está disponível para Arrays, Hashes, até Strings. - Aqui, nosso dicionário @palavras_chave@ é mantido numa Hash. Este método @each@ corre entre - *todos os pares da Hash*, cada palavra perigosa é comparada com sua palavra código, mandando cada par para - o méotodo @gsub!@ para a troca atual. - - - No Ruby, @gsub@ é abreviação de _global substitution_ (substituição global). O método é usado para procurar - e substituir. Aqui, queremos achar todas as ocôrrencias de palavras perigosas e substituí-las com a segura - palavra código. Com @gsub@, você provê a *palavra a ser achada como primeiro argunmento*, depois a *palavra - que tomará o lugar como segundo argumento*. - - - Por que nós não estamos we hanging on to the answer from @gsub@? Doesn't @gsub@ give us an answer back that - we should keep? You'd think the line would read: - - - <pre> - ideia_segura = ideia.gsub( real, codigo ) - </pre> - - - Sim, com @gsub@ nós temos que ficar com a resposta. Estamos usando uma variação do @gsub@ que é - totalmente hyper. Notou a *exclamação* no @gsub!@ usada dentro de cada bloco @each@? A - exclamação é um sinal de que @gsub!@ é meio radical. Veja, @gsub!@ vai mais longe e - *troca as palavras em @ideia@ diretamente*. Quando ele termina @ideia@ vai conter a nova string - alterada e você não vai mais achar a string velha. - - - Pode chamar @gsub!@ de *método destrutivo*. Ele faz suas modificações no valor diretamente. Enquanto @gsub@ - deixa o valor intacto, apenas respondendo com uma nova string que contém as alterações. - (Why must @gsub!@ scream when he descends upon his prey? Merciless assailant!) - - - h3. Arquivo de Texto de um Homem Louco - - - Vamos salvar a idéia codificada em um arquivo. - - - <pre> - # Salva as palavras sem sentido em um novo arquivo - print "Arquivo codificado. Favor entrar com um nome para esta idéia: " - nome_ideia = gets.strip - File::open( 'ideia-' + nome_ideia + '.txt', 'w' ) do |f| - f << ideia - end - </pre> - - - Esta seção começa perguntando por um nome pelo qual a idéia possa ser chamada. Este nome será usado - para se fazer o nome do arquivo quando salvarmos a idéia. - - - O método @strip@ serve pra todas strings. Este método *corta espaços e linhas vazias* do *começo - e fim* de uma string. Isto irá remover o _Enter_ no fim da string que você digitou. - E também irá remover espaços caso você tenha acidentalmente deixado algum. - - - Depois que temos o nome da idéia, vamos abrir um novo arquivo de texto em branco. O nome do arquivo é - contruído adicionando-se strings. Se você digitou @'mostarda-mais-codeine'@, nossa matemática será: @'ideia-' + - 'mostarda-mais-codeine' + '.txt'@. O Ruby pressiona isso em uma única string. - @'ideia-mostarda-mais-codeine.txt'@ é o arquivo. - - - Estamos usando o método de classe @File::open@ para criar um novo arquivo. Até agora, nós usamos - vários métodos do kernel para fazer nosso serviço. Nós damos uma string pro método @print@ e ele a - imprime na nossa tela. Um segredo sobre método do kernel como @print@: eles são na verdade - *métodos de classe*. - - - bq. @Kernel::print( "55,000 Macacosestrela o Saúdam!" )@ - - - O que isto significa? Por que isto importa? Isto significa que o @Kernel@ é o centro do universo Ruby. - Sempre que você está no seu código, o @Kernel@ estará do seu lado. Você nem precisa dizer - @Kernel@ pro Ruby. O Ruby sabe checar o @Kernel@. - - - A maioria dos métodos são mais especializados que @print@ ou @gets@. Pegue @File::open@ por - exemplo. O criador do Ruby, Matz, nos deu vários métodos diferentes que lêem, - renomeiam, ou deletam arquivos. Eles estão todos organizados dentro da classe @File@. - - - bq. @File::read( "ideia-mostarda-mais-codeine.txt" )@ vai responder uma com uma string - contendo todo o texto do seu arquivo de idéias. (Read significa ler.) - - - bq. @File::rename( "aquivd_antigo.txt", "aquivo_novo.txt" )@ irá renomear o @aquivo_antigo.txt@. - - - bq. @File::delete( "aquivo_novo.txt" )@ irá explodir o novo arquivo. - - - Estes métodos File estão todos *dentro do Ruby*. Estão apenas armazenados num - contêiner chamado Classe @File@. Então, enquanto você pode seguramente chamar os métodos do kernel - sem precisar digitar @Kernel@, o Ruby não checa automaticamente a classe @File@. - Você precisa dizer o nome do método completo. - - - <pre> - File::open( 'ideia-' + nome_ideia + '.txt', 'w' ) do |f| - f << ideia - end - </pre> - - - Nós passamos dois argumentos dentro de @File::open@. O primeiro é o *nome do arquivo para abrir*. - O segundo é uma string contendo o *modo do arquivo*. Usamos @'w'@, que significa escrever em um novo - arquivo. (Outras opções são: @'r'@ para ler o arquivo ou @'a'@ para adicionar no fim do arquivo.) - - - O arquivo está aberto para escrita e nos é dado na forma de variável @f@, que pode ser vista - *descendo a calha pra dentro do nosso block*. Dentro do bloco, nós escrevemos no arquivo. Quando - o bloco se fecha com @end@, nosso arquivo é fechado também. - - - Note que nós usamos o *concatenador* @<<@ para escrever no arquivo. Podemos fazer isto porque arquivos - têm um método chamado @<<@, assim como as Strings. - - - h3. Acalme-se, Suas Idéias Não Estão Presas - - - Aqui, vamos pegar nossas idéia de volta em seus verbos originais, - para que você possa ruminar sobre o brilhantismo delas. - - - <pre> - require 'listadepalavras' - - # Imprima cada idéia com as palavras corretas - Dir['ideia-*.txt'].each do |nome_arquivo| - ideia = File.read( nome_arquivo ) - palavras_codigo.each do |real, codigo| - ideia.gsub!( codigo, real ) - end - puts ideia - end - </pre> - - - Nessa altura, você já deve estar sabendo o que este exemplo faz. Não vou te incomodar com - detalhes mundanos. Veja se você consegue entender sozinho como isso funciona. - - - Contudo, temos um método de classe interessante aqui. O método @Dir::[]@ procura num diretório (alguns - de vocês podem chamá-los de "pastas"). Assim como você viu com as Hashes, os colchetes indexadores - pode ser métodos de Classe. (Começando a ver a brilhante, glinting gorgeousness of Ruby?) - - - Então nós estamos usando a empilhadeira para pegar os arquivos no diretório que coincidem @'ideia-*.txt'@. The - @Dir::[]@ irá usar o asterisco como um coringa. Estamos basicamente dizendo, "Encontre tudo que - comece com _ideia-_ e termine com _.txt_." A empilhadeira vai para o diretório e volta - com uma lista de arquivos encontrados. - - - Esta *lista de arquivos* vem na forma de @Array@ a Centopéia, com uma @String@ para cada - arquivo. Se você está curioso e que brincar com @Dir::[]@, tente isso: - - - bq. @p Dir['ideia-*.txt']@ irá imprimir: - - - bq. @['ideia-mostarda-mais-codeine.txt']@ (_um Array de nomes de arquivos!_) - - - Sim, o método @p@ funciona igual @print@. Mas @print@ é para se imprimir strings, - enquanto @p@ irá imprimir _qualquer coisa_. Veja isso. - - - bq. @p File::methods@ irá imprimir: - - - bq. @["send", "display", "name", "exist?", "split",@ ... _a lista completa dos nomes dos métodos!_ @]@ - - -# h3. Extra Credit: PStore -# -# -# <pre> -# require 'pstore' -# journal = PStore.new( 'journal.p' ) -# journal.transaction do -# journal. -# end -# </pre> - - + - > + O método @reverse@ é então usado na String que o @gets@ está devolvendo. O método @reverse@ + é parte da classe @String@. O que significa que *tudo que for uma string tem o método @reverse@ + disponível*. Mais sobre classes no próximo capítulo, por enquanto só saiba que *alguns métodos + só estão disponíveis para certos tipos de valores*. + + + Eu não acho que o @reverse@ vai dar muito certo. As autoridades só precisam por um espelho na frente + de "airégiN ad elortnoc o emoT." Prenderão a gente quando as starmonkeys começarem a pousar em Lagos. + + + As letras maiúsculas estão entregando o ouro. Talvez se nós passássemos todas as letras na string + para maiúsculas antes de inverter. + + + <pre> + ideia_ao_contrario = gets.upcase.reverse + </pre> + + + h3. Sua Repetitividade Compensa + + + Você me entrega um bloco de notas, cheio de garranchos ilegíveis. Analisando ele, eu começo a notar + padrões. Notar que você parece usar as mesmas palavras repetidamente in your musings. + Palavras como _macacoestrela_, _Nigéria_, _bomba_. Algumas frases até. _Put the kabosh on._ + Que são ditas toda hora. + + + Vamos disfarçar estes termos bobos, meu irmão. Vamos ofuscá-los de olhos comichantes que + choram para saber nossos delicados planos e para nos impedir de ter grande prazer e muitos karts. + Vamos trocá-los por linguagem inocente. Novas palavras com significado secreto. + + + Eu comecei uma lista de palavras, uma @Hash@ do Ruby, que contém estas suas palavras tão freqüentes e perigosas. + Na Hash, cada palavra perigosa é comparada contra uma palavra código (ou frase). A palavra código então + será trocada pela palavra real. + + + <pre> + palavras_codigo = { + 'macacosestrela' => 'Phil e Pete, those prickly chancellors of the New Reich', + 'catapulta' => 'chucky go-go', 'bomba' => 'Heat-Assisted Living', + 'Nigeria' => "Ny e Jerry's Lavagem a Seco (com Donuts)", + 'Put the kabosh on' => 'Put the cable box on' + } + </pre> + + + As palavras que são colocadas antes da seta são chamadas *chaves*. As palavras depois + das setas, as definições, geralmente são chamadas de *valores* simplesmente. + + + Note as aspas duplas em volta de @Ny e Jerry's Lavagem a Seco (com Donuts)@. Já que nas + aspas está sendo usado um apóstrofo, nós não podemos usar aspas simples em torno + da string. (Todavia, você pode usar aspas simples se você colocar uma barra invertida antes + do apóstrofo como em: @'Ny e Jerry\'s Lavagem a Seco (com Donuts)'@.) + + + Se você precisar procurar por uma palavra em específico, você pode usar o método das *chaves*. + + + bq. @palavras_codigo['catapulta']@ irá responder com a string @'chucky go-go'@. + + + Olhe as chaves como se elas fossem paletes de madeira nas quais as palavras estão em cima. + Uma empilhadeira poderia usar suas pás em cada lado da palete e a trazer da prateleira + de volta ao depósito. A palavra na palete é chamada de _indexador_. + Estamos pedido para a empilhadeira achar o indexador pra gente e nos trazer de volta + o valor correspondente. + + + Se você nunca esteve num depósito, você pode ver as chaves como alças. + Imagine um trabalhador industrial colocando suas luvas e levando o index de volta à + sua custódia. Se você nunca usou uma alça, ou te dar cerca de + trinta segundo pra achar uma e usar antes que eu fique nervoso. + + + Assim como os vários operadores que você viu recentemente, as chaves indexadoras são + simplesmente um atalho para um método. + + + bq. @palavras_codigo.[]( 'catapulta' )@ irá responder com a string @'chucky go-go'@. + + + h3. Fazendo a Troca + + + Eu me adiantei e salvei a Hash de código em um arquivo chamado *listadepalavras.rb*. + + + <pre> + require 'listadepalavras' + + # Pegar a idéia do mal e converter em palavra código + print "Entre com sua nova idéia: " + ideia = gets + palavras_codigo.each do |real, codigo| + ideia.gsub!( real, codigo ) + end + + # Salva o papo-furado num novo arquivo + print "Arquivo codificado. Favor entrar com um nome para esta idéia: " + nome_ideia = gets.strip + File::open( "ideia-" + nome_ideia + ".txt", "w" ) do |f| + f << ideia + end + </pre> + + + O Script começa puxando nossa lista de palavras. Assim como @gets@ e @print@, o método @require@ + é um método do kernel, você pode usá-lo em qualquer lugar. Eu dei a ele a string @'listadepalavras'@ + e ele vai procurar um arquivo chamado *listadepalavras.rb*. + + + Depois disso, há duas seções. Estou marcando estas seções com comentários, as linhas que começam + com o símbolo *cerquilha #*. Comentários são *notas úteis* que acompanham seu código. Colegas que + vierem ver seu código vão apreciar tal ajuda. Você mesmo, quando vier no seu código novamente + depois de algum tempo, comentários vão te ajudar a retomar o fio da meada. E ainda existe + softwares por aí que pegam seus comentários e fazem documentação à partir deles. (RDoc e Ri -- + veja o Pacote de Expansão #1!) + + + Eu gosto de comentários porque posso passar os olhos por uma grande pilha de código e identificar pontos importantes. + + + Como os comentários nos dizem, a primeira seção de pergunta uma idéia maléfica e a troca por uma + palavra código. A segunda seção salva a idéia codificada num novo arquivo de texto. + + + <pre> + palavras_codigo.each do |real, codigo| + ideia.gsub!( real, codigo ) + end + </pre> + + + Você viu o método @each@? O método @each@ está em todo lugar no Ruby. + Está disponível para Arrays, Hashes, até Strings. + Aqui, nosso dicionário @palavras_chave@ é mantido numa Hash. Este método @each@ corre entre + *todos os pares da Hash*, cada palavra perigosa é comparada com sua palavra código, mandando cada par para + o méotodo @gsub!@ para a troca atual. + + + No Ruby, @gsub@ é abreviação de _global substitution_ (substituição global). O método é usado para procurar + e substituir. Aqui, queremos achar todas as ocôrrencias de palavras perigosas e substituí-las com a segura + palavra código. Com @gsub@, você provê a *palavra a ser achada como primeiro argunmento*, depois a *palavra + que tomará o lugar como segundo argumento*. + + + Por que nós não estamos we hanging on to the answer from @gsub@? Doesn't @gsub@ give us an answer back that + we should keep? You'd think the line would read: + + + <pre> + ideia_segura = ideia.gsub( real, codigo ) + </pre> + + + Sim, com @gsub@ nós temos que ficar com a resposta. Estamos usando uma variação do @gsub@ que é + totalmente hyper. Notou a *exclamação* no @gsub!@ usada dentro de cada bloco @each@? A + exclamação é um sinal de que @gsub!@ é meio radical. Veja, @gsub!@ vai mais longe e + *troca as palavras em @ideia@ diretamente*. Quando ele termina @ideia@ vai conter a nova string + alterada e você não vai mais achar a string velha. + + + Pode chamar @gsub!@ de *método destrutivo*. Ele faz suas modificações no valor diretamente. Enquanto @gsub@ + deixa o valor intacto, apenas respondendo com uma nova string que contém as alterações. + (Why must @gsub!@ scream when he descends upon his prey? Merciless assailant!) + + + h3. Arquivo de Texto de um Homem Louco + + + Vamos salvar a idéia codificada em um arquivo. + + + <pre> + # Salva as palavras sem sentido em um novo arquivo + print "Arquivo codificado. Favor entrar com um nome para esta idéia: " + nome_ideia = gets.strip + File::open( 'ideia-' + nome_ideia + '.txt', 'w' ) do |f| + f << ideia + end + </pre> + + + Esta seção começa perguntando por um nome pelo qual a idéia possa ser chamada. Este nome será usado + para se fazer o nome do arquivo quando salvarmos a idéia. + + + O método @strip@ serve pra todas strings. Este método *corta espaços e linhas vazias* do *começo + e fim* de uma string. Isto irá remover o _Enter_ no fim da string que você digitou. + E também irá remover espaços caso você tenha acidentalmente deixado algum. + + + Depois que temos o nome da idéia, vamos abrir um novo arquivo de texto em branco. O nome do arquivo é + contruído adicionando-se strings. Se você digitou @'mostarda-mais-codeine'@, nossa matemática será: @'ideia-' + + 'mostarda-mais-codeine' + '.txt'@. O Ruby pressiona isso em uma única string. + @'ideia-mostarda-mais-codeine.txt'@ é o arquivo. + + + Estamos usando o método de classe @File::open@ para criar um novo arquivo. Até agora, nós usamos + vários métodos do kernel para fazer nosso serviço. Nós damos uma string pro método @print@ e ele a + imprime na nossa tela. Um segredo sobre método do kernel como @print@: eles são na verdade + *métodos de classe*. + + + bq. @Kernel::print( "55,000 Macacosestrela o Saúdam!" )@ + + + O que isto significa? Por que isto importa? Isto significa que o @Kernel@ é o centro do universo Ruby. + Sempre que você está no seu código, o @Kernel@ estará do seu lado. Você nem precisa dizer + @Kernel@ pro Ruby. O Ruby sabe checar o @Kernel@. + + + A maioria dos métodos são mais especializados que @print@ ou @gets@. Pegue @File::open@ por + exemplo. O criador do Ruby, Matz, nos deu vários métodos diferentes que lêem, + renomeiam, ou deletam arquivos. Eles estão todos organizados dentro da classe @File@. + + + bq. @File::read( "ideia-mostarda-mais-codeine.txt" )@ vai responder uma com uma string + contendo todo o texto do seu arquivo de idéias. (Read significa ler.) + + + bq. @File::rename( "aquivd_antigo.txt", "aquivo_novo.txt" )@ irá renomear o @aquivo_antigo.txt@. + + + bq. @File::delete( "aquivo_novo.txt" )@ irá explodir o novo arquivo. + + + Estes métodos File estão todos *dentro do Ruby*. Estão apenas armazenados num + contêiner chamado Classe @File@. Então, enquanto você pode seguramente chamar os métodos do kernel + sem precisar digitar @Kernel@, o Ruby não checa automaticamente a classe @File@. + Você precisa dizer o nome do método completo. + + + <pre> + File::open( 'ideia-' + nome_ideia + '.txt', 'w' ) do |f| + f << ideia + end + </pre> + + + Nós passamos dois argumentos dentro de @File::open@. O primeiro é o *nome do arquivo para abrir*. + O segundo é uma string contendo o *modo do arquivo*. Usamos @'w'@, que significa escrever em um novo + arquivo. (Outras opções são: @'r'@ para ler o arquivo ou @'a'@ para adicionar no fim do arquivo.) + + + O arquivo está aberto para escrita e nos é dado na forma de variável @f@, que pode ser vista + *descendo a calha pra dentro do nosso block*. Dentro do bloco, nós escrevemos no arquivo. Quando + o bloco se fecha com @end@, nosso arquivo é fechado também. + + + Note que nós usamos o *concatenador* @<<@ para escrever no arquivo. Podemos fazer isto porque arquivos + têm um método chamado @<<@, assim como as Strings. + + + h3. Acalme-se, Suas Idéias Não Estão Presas + + + Aqui, vamos pegar nossas idéia de volta em seus verbos originais, + para que você possa ruminar sobre o brilhantismo delas. + + + <pre> + require 'listadepalavras' + + # Imprima cada idéia com as palavras corretas + Dir['ideia-*.txt'].each do |nome_arquivo| + ideia = File.read( nome_arquivo ) + palavras_codigo.each do |real, codigo| + ideia.gsub!( codigo, real ) + end + puts ideia + end + </pre> + + + Nessa altura, você já deve estar sabendo o que este exemplo faz. Não vou te incomodar com + detalhes mundanos. Veja se você consegue entender sozinho como isso funciona. + + + Contudo, temos um método de classe interessante aqui. O método @Dir::[]@ procura num diretório (alguns + de vocês podem chamá-los de "pastas"). Assim como você viu com as Hashes, os colchetes indexadores + pode ser métodos de Classe. (Começando a ver a brilhante, glinting gorgeousness of Ruby?) + + + Então nós estamos usando a empilhadeira para pegar os arquivos no diretório que coincidem @'ideia-*.txt'@. The + @Dir::[]@ irá usar o asterisco como um coringa. Estamos basicamente dizendo, "Encontre tudo que + comece com _ideia-_ e termine com _.txt_." A empilhadeira vai para o diretório e volta + com uma lista de arquivos encontrados. + + + Esta *lista de arquivos* vem na forma de @Array@ a Centopéia, com uma @String@ para cada + arquivo. Se você está curioso e que brincar com @Dir::[]@, tente isso: + + + bq. @p Dir['ideia-*.txt']@ irá imprimir: + + + bq. @['ideia-mostarda-mais-codeine.txt']@ (_um Array de nomes de arquivos!_) + + + Sim, o método @p@ funciona igual @print@. Mas @print@ é para se imprimir strings, + enquanto @p@ irá imprimir _qualquer coisa_. Veja isso. + + + bq. @p File::methods@ irá imprimir: + + + bq. @["send", "display", "name", "exist?", "split",@ ... _a lista completa dos nomes dos métodos!_ @]@ + + +# h3. Extra Credit: PStore +# +# +# <pre> +# require 'pstore' +# journal = PStore.new( 'journal.p' ) +# journal.transaction do +# journal. +# end +# </pre> + + lang-pt/poignant-33.yml @@ -1,4 +1,4 @@ - - O Milagre dos Blocos (Blocks): > - - !i/blix-2.gif(Entregadores de flores? Já ouvi essa antes.)! - + - O Milagre dos Blocos (Blocks): > + + !i/blix-2.gif(Entregadores de flores? Já ouvi essa antes.)! + lang-pt/poignant-34.yml @@ -1,58 +1,58 @@ - - !^sidebar - Extraído de Os Comedores de Cachecóis: > - - (_do Capítulo V: Um Homem de Uniforme_.) - - - Em Abril, os lírios verdes voltaram. Eles abriram suas asinhas de anjo, - saindo para o mundo. Gentilmente, seus rebentos acariciaram os - tristes postes da cerca até que eles cantassem alegremente. - - - Da janela do seu quarto, Lara olhava os lírios exibirem sua feminilidade sólida. - Ela colocou a franja de um cachecol carpatiano, bordado, novo, em sua boca e comeu - vagarosamente. A malha longa desceu por sua garganta provocando cócegas enquanto serpenteava pelo - esôfago. Ela riu e arrotou. - - - Oh, como a flora a atraía. Olhar para flores combinava tanto com ser uma garota adolescente. - Ela queria pintá-las, então ela abriu um novo modelo no Flash. Um filme vazio dessa vez. - - - Ela deixou seu cursor passear pelos jardins da área visível do filme. Linhas vetoriais brancas - sob linhas vetoriais amarelas mais curtas. Ela selecionou as linhas brancas e as agrupou. - Ela até moveu as linhas para uma nova camada chamada "Chora, Anjinho, Chora." Então ela - as converteu em um objeto gráfico e o moveu para a biblioteca. - - - Ela sentiu um calafrio morno enquanto movia as longas, pétalas brancas para a biblioteca do filme. - Aquilo parecia tão oficial. _Eu escolho você. Eu nomeio você. Façam do conforto do meu palácio sua morada eterna._ - - - Heh. Ela riu. Colorado Springs não era nenhum "palácio". - - - Desde que eles se mudaram, papai só esteve em casa uma vez. Ele entrou violentamente pela porta da frente - vestindo seu uniforme completo e já começou a passar um sermão em Lara e sua mãe. Sua mãe até deixou cair - um pé de alface -- que ela havia acabado de lavar -- em um pote de Lick-M-Aid. - - - O alface mal coube no pote, mas ele se alojou lá direitinho. - Papai veio e sacou o pé de alface, fitando-o por algum tempo, até declará-lo PT (Perda Total), em - uma voz ao mesmo tempo confusa e desapontada. E jogou aquele vegetal sujo na lata do lixo. - - - Foi só mais tarde aquele dia que a mãe de Lara concluiu que ela poderia simplesmente ter cortado o alface - ao meio com uma faca elétrica. Papai sorriu e estapeou a própria testa. Ele, então, foi até Lara - e também lhe deu um tapa na testa, e em sua mãe também, afetuosamente. - - - "Nós não estávamos pensando, não é mesmo?" ele disse. "E quem pode nos culpar? Nós somos - uma família de verdade hoje. E nós não deveríamos ter que fazer mais nada no dia em que - reunimos nossa família de novo." - - - O sorriso de Lara refletiu no vidro do monitor. Ela escolheu o programa de texto - e em fonte serif tamanho 42 escreveu: "Pai." Ela criou um caminho para ele e deixou que uma - animação o levasse para fora da tela. Ela chorou por algum tempo depois que aquilo se fora. - + - !^sidebar + Extraído de Os Comedores de Cachecóis: > + + (_do Capítulo V: Um Homem de Uniforme_.) + + + Em Abril, os lírios verdes voltaram. Eles abriram suas asinhas de anjo, + saindo para o mundo. Gentilmente, seus rebentos acariciaram os + tristes postes da cerca até que eles cantassem alegremente. + + + Da janela do seu quarto, Lara olhava os lírios exibirem sua feminilidade sólida. + Ela colocou a franja de um cachecol carpatiano, bordado, novo, em sua boca e comeu + vagarosamente. A malha longa desceu por sua garganta provocando cócegas enquanto serpenteava pelo + esôfago. Ela riu e arrotou. + + + Oh, como a flora a atraía. Olhar para flores combinava tanto com ser uma garota adolescente. + Ela queria pintá-las, então ela abriu um novo modelo no Flash. Um filme vazio dessa vez. + + + Ela deixou seu cursor passear pelos jardins da área visível do filme. Linhas vetoriais brancas + sob linhas vetoriais amarelas mais curtas. Ela selecionou as linhas brancas e as agrupou. + Ela até moveu as linhas para uma nova camada chamada "Chora, Anjinho, Chora." Então ela + as converteu em um objeto gráfico e o moveu para a biblioteca. + + + Ela sentiu um calafrio morno enquanto movia as longas, pétalas brancas para a biblioteca do filme. + Aquilo parecia tão oficial. _Eu escolho você. Eu nomeio você. Façam do conforto do meu palácio sua morada eterna._ + + + Heh. Ela riu. Colorado Springs não era nenhum "palácio". + + + Desde que eles se mudaram, papai só esteve em casa uma vez. Ele entrou violentamente pela porta da frente + vestindo seu uniforme completo e já começou a passar um sermão em Lara e sua mãe. Sua mãe até deixou cair + um pé de alface -- que ela havia acabado de lavar -- em um pote de Lick-M-Aid. + + + O alface mal coube no pote, mas ele se alojou lá direitinho. + Papai veio e sacou o pé de alface, fitando-o por algum tempo, até declará-lo PT (Perda Total), em + uma voz ao mesmo tempo confusa e desapontada. E jogou aquele vegetal sujo na lata do lixo. + + + Foi só mais tarde aquele dia que a mãe de Lara concluiu que ela poderia simplesmente ter cortado o alface + ao meio com uma faca elétrica. Papai sorriu e estapeou a própria testa. Ele, então, foi até Lara + e também lhe deu um tapa na testa, e em sua mãe também, afetuosamente. + + + "Nós não estávamos pensando, não é mesmo?" ele disse. "E quem pode nos culpar? Nós somos + uma família de verdade hoje. E nós não deveríamos ter que fazer mais nada no dia em que + reunimos nossa família de novo." + + + O sorriso de Lara refletiu no vidro do monitor. Ela escolheu o programa de texto + e em fonte serif tamanho 42 escreveu: "Pai." Ela criou um caminho para ele e deixou que uma + animação o levasse para fora da tela. Ela chorou por algum tempo depois que aquilo se fora. + lang-pt/poignant-35.yml @@ -1,303 +1,303 @@ - - > - Já que estamos ficando íntimos enquanto compartilhamos este tempo juntos, eu - provavelmente deveria te falar um pouco mais sobre a minha história. É uma boa hora pruma pausa, - eu diria. - - - Primeiramente, você deve saber que o Blix é meu gato. Meu segundo animal de estimação é o Bigelow. - E digo, nós raramente nos vemos. Ele é totalmente auto-suficiente. - Eu não sei exatamente onde ele mora hoje em dia, ele não mora mais na ante-sala - do meu quarto. Ele esvaziou a conta bancária há cerca de sete meses. - - - Ele tem uma cópia da chave de casa e uma do (Cadillac) Seville. Se algum dia ele quiser - voltar, eu alegremente deixarei de lado nossas diferenças e entreterei and entertain his - antics around the house again. - - - Mas não se engane. Eu sinto falta dele por perto. Não sei se ele sente falta da minha companhia, mas - eu sinto a dele. - - - h3. Uma Sirene e Uma Oração - - - Eu vi o Blix a primeira vez pela televisão quando eu era um garoto. Ele estrelava um drama policial empoeirado - chamado _Uma Sirene e Uma Oração_. O seriado era sobre um esquadrão policial religioso que fazia - seu serviço, e o fazia bem, e tinham suas cotas de milagres nas ruas. Quero dizer, - os oficiais no show eram _ótimas_ pessoas, muito religiosos, praticamente clérgicos. Mas, - você sabe, até clérgicos não tem o bom senso de matar um cara que tenha ido longe demais. - Esses caras sabiam disso. E o faziam todo dia. - - - Então, aquilo era um seriado bem sangrento, mas eles sempre tinham uma boa lição de moral no final. Na maioria - das vezes algo como, "Nossa, escapamos dessa bem rápido." Há uma séria camaradagem numa declaração como essa. - - - O show basicamente girava em torno deste policial. Dick Robinson "O Doidão". As Pessoas o - chamavam de "O Doidão" porque basicamente ele era insano. Não me lembro se isso foi diagnosticado - clinicamente, mas as pessoas sempre questionavam suas decisões. O Doidão regularmente estourava e - mordia alguns policiais, a maioria deles personagens de moral inquestionável. Mas todos - sabemos que esse é um mundo cão, as apostas são altas, e todos que assistiam ao seriado - tinham O Doião com grande estima. Eu penso que todos no esquadrão cresceram bastante como pessoas, - graças à determinação do Doidão. - - - Todavia, os policiais não conseguiam dar conta do serviço por si mesmos. Em cada um dos episódios eles - imploravam por uma ajuda maior. E, em cada um dos episódios, eles conseguiam ajuda de um gato - chamdo Terry (encenado pelo meu gato Blix). Ele era apenas um gatinho na época, e como um garoto novo - ávido por _Uma Sirene e Uma Oração_, me encontrei na busca do meu próprio gato-solucionador-de-crimes. - Terry levava aqueles caras por túneis subterrâneos, marinas abandonadas, imensos galpões industriais. - - - Algumas vezes ele aparecia o episódio inteiro, indo e vindo, fazendo armadilhas e controlando o trânsito. - Mas outras vezes você quase não o via no episódio. Então você rebobinava e assistia e assistia - e assistia. Você desistia. Ele não estava naquele episódio. - - - Ainda assim, você nao desistia, você ia quadro por quadro com o jog do controle, analisando cada cena. - E esteva lá. No alto atrás do holofote que foi acionado com muita força. O que deixou - o Doidão com danos permanentes nos olhos. Por quê? Por quê queimar as retinas do seu companheiro, - Terry? - - - Mas a pergunta nunca foi respondida pois a série foi cancelada. Eles começaram a fazer efeitos especiais - com o gato e tudo foi por água abaixo. No último episódio, houve um momento em que - Terry estava preso em cima de um guindaste, preste a cair na fornalha de uma fundição de ferro. - Ele olha pra trás. Não dá pra voltar. Ele olha pra baixo. Tapa os olhos com as patas (_sério!_), ele puta - do guindates e, no meio do vôo, agarra uma corda e se salva, coming down on a soft antelope - hide that one of the workers had presumably been tanning that afternoon. - - - As pessoas desligavam a televisão na hora que o seriado ia ao ar. Tentaram mudar o nome. - Primeiro foi _Deus nos Deu um Esquadrão_. _Beijo de Dor_. Então, _Beijo de Dor em Maine_, já que o - distrito inteiro acabou se mudando pra lá. Mas a mágica se fora. Eu voltei pra escola no verão daquele ano - pra algumas aulas e as crianças todas já estavam na onda dos lápis de futebol. - - - h3. Blocos - - - Há alguns anos, eu comecei a ensinar o Blix sobre Ruby. Quando nós chegamos nesta parte, - a parte que cobre blocos, ele me disse, "Blocos me lembram o Dick Robinson Doidão." - - - "Mesmo?" Eu não ouvia esse nome faz tempo. "Não sei como você se lembrou disso." - - - "Bem, você disse que blocos são difíceis de entender." - - - "Eles não são difíceis", eu disse. "Um *bloco* é apenas *código agrupado*." - - - "E o Doidão era apenas um policial, que jurou cumprir seu dever," ele disse. "Mas ele era um verdadeiro - milagre ambulante. E agora, este primeiro exemplo que você me mostrou..." Ele aponta um exemplo - que eu havia escrito. - - - <pre> - brinquedos_do_gatinho = - [:formato => 'meia', :material => 'caximira'] + - [:formato => 'mouse', :material => 'calico'] + - [:formato => 'bolinho-primavera', :material => 'chenille'] - brinquedos_do_gatinho.sort_by { |brinquedo| brinquedo[:material] } - </pre> - - - "Isto é um pequeno milagre", ele disse. "Não posso negar sua beleza. Olhe, lá estão meus brinquedos, junto - com suas características. Abaixo deles, o bloco, ordenando eles por material." - - - "Peço desculpas se a sua lista de brinquedos parece um pouco complicada," eu disse. Assim como você, ele já - havia aprendido sobre Array, a centopéia caida no código, colchetes de cada lado - e cada item separado por vírgulas. (Ah, aqui está uma: @['meia', 'rato', 'bolinho-primavera']@.) - Ele também sabia sobre a Hash, que é como um dicionário, com chaves de cada lado - que parecem livrinhos abertos. Vírgulas na Hash entre cada par. Cada palavra - no dicionário encontra seu par por uma seta. (Estupefa-se: @{'blix' => 'gato', - 'why' => 'humano'}@.) - - - "Sim, pertubante," ele disse. "Isso tem colchetes como se fosse Array, mas com as setas é uma Hash. - Você vai ter que explicar isso." - - - "Subversivo ele, não?" Eu disse, cutucando ele com uma colher. "Eu fiz sua lista de brinquedos - misturando os dois. Estou usando um atalho. Que é: *Se você usar a seta (=>) dentro de um Array, - você terá uma Hash invés de um Array.*" - - - "Ah, entendi," ele disse. "Você cruzou eles. Que bacana!" - - - "Sim, sim, você tá entendendo," eu disse. Ele era muito bom com um transferidor também. "Eu tenho três Arrays, - cada contém uma Hash. Notou o sinal de mais? Eu os estou adicionando num Array maior. Aqui - está outro jeito de escrever isto..." Eu rabisquei. - - - <pre> - brinquedos_do_gatinho = [ - {:formato => 'meia', :material => 'caximira'}, - {:formato => 'rato', :material => 'calico'}, - {:formato => 'bolinho-primavera', :material => 'chenille'} - ] - </pre> - - - Um Array, que age como uma lista de brinquedos de mastigar. Três Hashes estão no Array descrevendo - cada brinquedo. - - - h3. Ordenando e Iterando Para Salvar Vidas - - - "Vamos ordenar seus brinquedos por forma agora," Eu disse. "E depois, imprimi-los nesta ordem." - - - <pre> - brinquedos_do_gatinho.sort_by { |brinquedo| brinquedo[:formato] }.each do |brinquedo| - puts "Blixy tem um #{ brinquedo[:formato] } feito de #{ brinquedo[:material] }" - end - </pre> - - - "Como @sort_by@ funciona?" perguntou Blix. "Eu sei que é um método que você pode usar com Arrays. Pois - @brinquedos_do_gatinho@ é um Array. Mas e quanto a @brinquedo@?" - - - "Okay, @brinquedo@ is a *argumento do bloco*," Eu disse. "Lembre-se: os corrimãos magrelos de cada lado do @brinquedo@ fazem dele - uma *calha*." - - - "Claro, mas parece que você o está usando como Hash. Dentro do bloco vc tem @brinquedo[:formato]@. - Isto se parece com uma Hash." - - - "O método @sort_by@ é um *iterador*, Blix. Ele *iterage*, ou *faz o ciclo*, com a *lista de coisas*. Você - se lembra daquele episódio quando o Doidão..." - - - "Episódio?" ele disse. Sim, ele não consegue entender o conceito de seriados de TV. - Sim, eu tentei explicar. - - - "Ou, sim, lembra daquele _O caso da testemunha ocular_ que nós assistimos que o Doidão estava tentando conversar - com aquele concorrente do soletrando que queria pular da biblioteca do colégio?" - - - "Eu me lembro melhor do que você porque eu estava voando num avião de controle remoto." Sim, foi um - daqueles episódios. - - - "Você se lembra como o Doidão fez pro cara descer?" Eu indaguei. - - - "Pessoas que concorrem ao soletrando adoram cartas," disse Blix. "Então o Doidão teve uma idéia de gênio. - Ele começou uma carta com a letra A e deu razões, para cada letra do alfabeto, de por que o cara devia - sair do beiral do prédio e voltar a salvo pro chão." - - - "'A' é para Arquitetura de prédios como esse,'" eu disse, com a voz rude do Doidão. - "'Que nos dá esperança num mundo a ruir.'" - - - "'B' é para Brutamontes, assim como seu amigo O Policial Doidão,'" disse Blix. "'Caras que ajudam pessoas todo o tempo - e não sabem escrever muito bem, mas mesmo assim ajudam caras que escrevem muito bem.'" - - - "Viu, ele passou por todas as letras, uma a uma. Ele estava _iterando_ por elas." _It Err Ate Ing._ (Iterando) - - - "Mas o cara desistiu, Why. Ele desistiu na letra Q eu acho." - - - "'Q' é para momentos Quietos que nos ajudam a relaxar e pensar sobre todos os pequenos prazeres da vida, assim - nós nao ficamos tensos e começamos a fazer besteira andando na ponta do pé na beira de algum edifício alto e maligno.'" - - - "Aí ele pulou," disse Blix. Ele balançou a cabeça. "Você não pode culpar o Doidão. Ele fez o melhor q pode." - - - "Ele tinha um coração grande, isso é verdade," eu disse, dando um tapinha no ombro do Blix. - - - <pre> - brinquedos_do_gatinho.sort_by { |brinquedo| brinquedo[:formato] }.each do |brinquedo| - puts "Blixy tem um #{ brinquedo[:formato] } feito de #{ brinquedo[:material] }" - end - </pre> - - - "Quanto ao seu @sort_by@, ele *começa no topo* da lista e vai *descendo até o ultimo ítem*, um de cada vez. - Então @brinquedo@ é um destes items. Em cada item, o @sort_by@ para e *joga aquele item pela calha*, - sob o nome de @brinquedo@, e deixa você decidir o que fazer com ele." - - - "Ok, então @brinquedo@ será, cada hora, um dos brinquedos que eu tenho." - - - "Correto," eu disse. "Você sabe como eu tenho batido na mesma tecla _usando as respostas que os método te - dão_? Aqui, nós estamos apenas olhando a forma do brinquedo dentro do bloco. O bloco então responde para o @sort_by@ - uma frase contendo o formato, algo como @"rato"@ ou @"meia"@. Uma vez que ele passe por toda a lista, o @sort_by@ - terá comparado alfabéticamente o texto de cada forma e vai retornar um novo Array, agora ordenado." - - - h3. Uma Lição Inacabada - - - "Tá bom por hoje," disse o Blix. "Que tal um pires de leite fresco, por favor?" - - - Eu enchi o pires dele até a borda e ele se esbaldou daquilo por algum tempo enquanto eu jogava poker e - jabbed at coals in the fireplace. Minha mente vagou e eu não pude não pensar mais sobre blocos. - Eu pensei no que ensinar pro Blix em seguida. - - - Eu provavelmente o teria ensinado sobre @next@. Quando você está interando uma lista, você - pode usar @next@ para *pular para o próximo item*. Aqui estamos contando brinquedos que não tenham - forma de bolinho-primavera, pulando eles com @next@. - - - <pre> - nao_bolinho_primavera = 0 - brinquedos_do_gatinho.each do |brinquedo| - next if brinquedo[:formato] == 'bolinho-primavera' - nao_bolinho_primavera = nao_bolinho_primavera + 1 - end - </pre> - - - Eu poderia também tê-lo ensinado sobre @break@, que *te joga pra fora de um loop*. - No código abaixo, vamo imprimir (usando @p@) cada brinquedo até encontrarmos - o brinquedo cujo material seja chenille. O @break@ fará com que o @each@ termine abruptamente. - - - <pre> - brinquedos_do_gatinho.each do |brinquedo| - break if brinquedo[:material] == 'chenille' - p brinquedo - end - </pre> - - - Eu nunca cheguei a ensinar a ele essas coisas. Eu continuei viajando num pedaço de lenha em particular - que acabou preso na proteção da lareira e quase que cai no meu tapete de pele de antílope. - - - Assim que me esquivei ferozmente daquela pedra negra, Blix sumiu, presumo que pro - ônibus para Wixl, a capital econômica dos animais. Quem sabe, ele pode ter parado - em Ambrose ou Riathna ou qualquer outra vila pelo caminho. Meu instinto me diz - que Wixl era definitivamente sua última parada. - - - Sem nenhum estudante para instruir ou prosear, me encontrei sozinho, enfurnado em casa. - Na quietude dos corredores mortos, eu comecei a rascunhar uma bioagrafia na - forma deste guia. - - - Eu trabalhei nisso sempre que me sentia entendiado. E quando não estava entendiado, eu ia assistir - _The Phantom Menace_ (Guerra nas Estrelas - A Ameaça Fantasma) pra ficar no clima. - - - !i/the.elf-7.jpg(Someone let them all out.)! - + - > + Já que estamos ficando íntimos enquanto compartilhamos este tempo juntos, eu + provavelmente deveria te falar um pouco mais sobre a minha história. É uma boa hora pruma pausa, + eu diria. + + + Primeiramente, você deve saber que o Blix é meu gato. Meu segundo animal de estimação é o Bigelow. + E digo, nós raramente nos vemos. Ele é totalmente auto-suficiente. + Eu não sei exatamente onde ele mora hoje em dia, ele não mora mais na ante-sala + do meu quarto. Ele esvaziou a conta bancária há cerca de sete meses. + + + Ele tem uma cópia da chave de casa e uma do (Cadillac) Seville. Se algum dia ele quiser + voltar, eu alegremente deixarei de lado nossas diferenças e entreterei and entertain his + antics around the house again. + + + Mas não se engane. Eu sinto falta dele por perto. Não sei se ele sente falta da minha companhia, mas + eu sinto a dele. + + + h3. Uma Sirene e Uma Oração + + + Eu vi o Blix a primeira vez pela televisão quando eu era um garoto. Ele estrelava um drama policial empoeirado + chamado _Uma Sirene e Uma Oração_. O seriado era sobre um esquadrão policial religioso que fazia + seu serviço, e o fazia bem, e tinham suas cotas de milagres nas ruas. Quero dizer, + os oficiais no show eram _ótimas_ pessoas, muito religiosos, praticamente clérgicos. Mas, + você sabe, até clérgicos não tem o bom senso de matar um cara que tenha ido longe demais. + Esses caras sabiam disso. E o faziam todo dia. + + + Então, aquilo era um seriado bem sangrento, mas eles sempre tinham uma boa lição de moral no final. Na maioria + das vezes algo como, "Nossa, escapamos dessa bem rápido." Há uma séria camaradagem numa declaração como essa. + + + O show basicamente girava em torno deste policial. Dick Robinson "O Doidão". As Pessoas o + chamavam de "O Doidão" porque basicamente ele era insano. Não me lembro se isso foi diagnosticado + clinicamente, mas as pessoas sempre questionavam suas decisões. O Doidão regularmente estourava e + mordia alguns policiais, a maioria deles personagens de moral inquestionável. Mas todos + sabemos que esse é um mundo cão, as apostas são altas, e todos que assistiam ao seriado + tinham O Doião com grande estima. Eu penso que todos no esquadrão cresceram bastante como pessoas, + graças à determinação do Doidão. + + + Todavia, os policiais não conseguiam dar conta do serviço por si mesmos. Em cada um dos episódios eles + imploravam por uma ajuda maior. E, em cada um dos episódios, eles conseguiam ajuda de um gato + chamdo Terry (encenado pelo meu gato Blix). Ele era apenas um gatinho na época, e como um garoto novo + ávido por _Uma Sirene e Uma Oração_, me encontrei na busca do meu próprio gato-solucionador-de-crimes. + Terry levava aqueles caras por túneis subterrâneos, marinas abandonadas, imensos galpões industriais. + + + Algumas vezes ele aparecia o episódio inteiro, indo e vindo, fazendo armadilhas e controlando o trânsito. + Mas outras vezes você quase não o via no episódio. Então você rebobinava e assistia e assistia + e assistia. Você desistia. Ele não estava naquele episódio. + + + Ainda assim, você nao desistia, você ia quadro por quadro com o jog do controle, analisando cada cena. + E esteva lá. No alto atrás do holofote que foi acionado com muita força. O que deixou + o Doidão com danos permanentes nos olhos. Por quê? Por quê queimar as retinas do seu companheiro, + Terry? + + + Mas a pergunta nunca foi respondida pois a série foi cancelada. Eles começaram a fazer efeitos especiais + com o gato e tudo foi por água abaixo. No último episódio, houve um momento em que + Terry estava preso em cima de um guindaste, preste a cair na fornalha de uma fundição de ferro. + Ele olha pra trás. Não dá pra voltar. Ele olha pra baixo. Tapa os olhos com as patas (_sério!_), ele puta + do guindates e, no meio do vôo, agarra uma corda e se salva, coming down on a soft antelope + hide that one of the workers had presumably been tanning that afternoon. + + + As pessoas desligavam a televisão na hora que o seriado ia ao ar. Tentaram mudar o nome. + Primeiro foi _Deus nos Deu um Esquadrão_. _Beijo de Dor_. Então, _Beijo de Dor em Maine_, já que o + distrito inteiro acabou se mudando pra lá. Mas a mágica se fora. Eu voltei pra escola no verão daquele ano + pra algumas aulas e as crianças todas já estavam na onda dos lápis de futebol. + + + h3. Blocos + + + Há alguns anos, eu comecei a ensinar o Blix sobre Ruby. Quando nós chegamos nesta parte, + a parte que cobre blocos, ele me disse, "Blocos me lembram o Dick Robinson Doidão." + + + "Mesmo?" Eu não ouvia esse nome faz tempo. "Não sei como você se lembrou disso." + + + "Bem, você disse que blocos são difíceis de entender." + + + "Eles não são difíceis", eu disse. "Um *bloco* é apenas *código agrupado*." + + + "E o Doidão era apenas um policial, que jurou cumprir seu dever," ele disse. "Mas ele era um verdadeiro + milagre ambulante. E agora, este primeiro exemplo que você me mostrou..." Ele aponta um exemplo + que eu havia escrito. + + + <pre> + brinquedos_do_gatinho = + [:formato => 'meia', :material => 'caximira'] + + [:formato => 'mouse', :material => 'calico'] + + [:formato => 'bolinho-primavera', :material => 'chenille'] + brinquedos_do_gatinho.sort_by { |brinquedo| brinquedo[:material] } + </pre> + + + "Isto é um pequeno milagre", ele disse. "Não posso negar sua beleza. Olhe, lá estão meus brinquedos, junto + com suas características. Abaixo deles, o bloco, ordenando eles por material." + + + "Peço desculpas se a sua lista de brinquedos parece um pouco complicada," eu disse. Assim como você, ele já + havia aprendido sobre Array, a centopéia caida no código, colchetes de cada lado + e cada item separado por vírgulas. (Ah, aqui está uma: @['meia', 'rato', 'bolinho-primavera']@.) + Ele também sabia sobre a Hash, que é como um dicionário, com chaves de cada lado + que parecem livrinhos abertos. Vírgulas na Hash entre cada par. Cada palavra + no dicionário encontra seu par por uma seta. (Estupefa-se: @{'blix' => 'gato', + 'why' => 'humano'}@.) + + + "Sim, pertubante," ele disse. "Isso tem colchetes como se fosse Array, mas com as setas é uma Hash. + Você vai ter que explicar isso." + + + "Subversivo ele, não?" Eu disse, cutucando ele com uma colher. "Eu fiz sua lista de brinquedos + misturando os dois. Estou usando um atalho. Que é: *Se você usar a seta (=>) dentro de um Array, + você terá uma Hash invés de um Array.*" + + + "Ah, entendi," ele disse. "Você cruzou eles. Que bacana!" + + + "Sim, sim, você tá entendendo," eu disse. Ele era muito bom com um transferidor também. "Eu tenho três Arrays, + cada contém uma Hash. Notou o sinal de mais? Eu os estou adicionando num Array maior. Aqui + está outro jeito de escrever isto..." Eu rabisquei. + + + <pre> + brinquedos_do_gatinho = [ + {:formato => 'meia', :material => 'caximira'}, + {:formato => 'rato', :material => 'calico'}, + {:formato => 'bolinho-primavera', :material => 'chenille'} + ] + </pre> + + + Um Array, que age como uma lista de brinquedos de mastigar. Três Hashes estão no Array descrevendo + cada brinquedo. + + + h3. Ordenando e Iterando Para Salvar Vidas + + + "Vamos ordenar seus brinquedos por forma agora," Eu disse. "E depois, imprimi-los nesta ordem." + + + <pre> + brinquedos_do_gatinho.sort_by { |brinquedo| brinquedo[:formato] }.each do |brinquedo| + puts "Blixy tem um #{ brinquedo[:formato] } feito de #{ brinquedo[:material] }" + end + </pre> + + + "Como @sort_by@ funciona?" perguntou Blix. "Eu sei que é um método que você pode usar com Arrays. Pois + @brinquedos_do_gatinho@ é um Array. Mas e quanto a @brinquedo@?" + + + "Okay, @brinquedo@ is a *argumento do bloco*," Eu disse. "Lembre-se: os corrimãos magrelos de cada lado do @brinquedo@ fazem dele + uma *calha*." + + + "Claro, mas parece que você o está usando como Hash. Dentro do bloco vc tem @brinquedo[:formato]@. + Isto se parece com uma Hash." + + + "O método @sort_by@ é um *iterador*, Blix. Ele *iterage*, ou *faz o ciclo*, com a *lista de coisas*. Você + se lembra daquele episódio quando o Doidão..." + + + "Episódio?" ele disse. Sim, ele não consegue entender o conceito de seriados de TV. + Sim, eu tentei explicar. + + + "Ou, sim, lembra daquele _O caso da testemunha ocular_ que nós assistimos que o Doidão estava tentando conversar + com aquele concorrente do soletrando que queria pular da biblioteca do colégio?" + + + "Eu me lembro melhor do que você porque eu estava voando num avião de controle remoto." Sim, foi um + daqueles episódios. + + + "Você se lembra como o Doidão fez pro cara descer?" Eu indaguei. + + + "Pessoas que concorrem ao soletrando adoram cartas," disse Blix. "Então o Doidão teve uma idéia de gênio. + Ele começou uma carta com a letra A e deu razões, para cada letra do alfabeto, de por que o cara devia + sair do beiral do prédio e voltar a salvo pro chão." + + + "'A' é para Arquitetura de prédios como esse,'" eu disse, com a voz rude do Doidão. + "'Que nos dá esperança num mundo a ruir.'" + + + "'B' é para Brutamontes, assim como seu amigo O Policial Doidão,'" disse Blix. "'Caras que ajudam pessoas todo o tempo + e não sabem escrever muito bem, mas mesmo assim ajudam caras que escrevem muito bem.'" + + + "Viu, ele passou por todas as letras, uma a uma. Ele estava _iterando_ por elas." _It Err Ate Ing._ (Iterando) + + + "Mas o cara desistiu, Why. Ele desistiu na letra Q eu acho." + + + "'Q' é para momentos Quietos que nos ajudam a relaxar e pensar sobre todos os pequenos prazeres da vida, assim + nós nao ficamos tensos e começamos a fazer besteira andando na ponta do pé na beira de algum edifício alto e maligno.'" + + + "Aí ele pulou," disse Blix. Ele balançou a cabeça. "Você não pode culpar o Doidão. Ele fez o melhor q pode." + + + "Ele tinha um coração grande, isso é verdade," eu disse, dando um tapinha no ombro do Blix. + + + <pre> + brinquedos_do_gatinho.sort_by { |brinquedo| brinquedo[:formato] }.each do |brinquedo| + puts "Blixy tem um #{ brinquedo[:formato] } feito de #{ brinquedo[:material] }" + end + </pre> + + + "Quanto ao seu @sort_by@, ele *começa no topo* da lista e vai *descendo até o ultimo ítem*, um de cada vez. + Então @brinquedo@ é um destes items. Em cada item, o @sort_by@ para e *joga aquele item pela calha*, + sob o nome de @brinquedo@, e deixa você decidir o que fazer com ele." + + + "Ok, então @brinquedo@ será, cada hora, um dos brinquedos que eu tenho." + + + "Correto," eu disse. "Você sabe como eu tenho batido na mesma tecla _usando as respostas que os método te + dão_? Aqui, nós estamos apenas olhando a forma do brinquedo dentro do bloco. O bloco então responde para o @sort_by@ + uma frase contendo o formato, algo como @"rato"@ ou @"meia"@. Uma vez que ele passe por toda a lista, o @sort_by@ + terá comparado alfabéticamente o texto de cada forma e vai retornar um novo Array, agora ordenado." + + + h3. Uma Lição Inacabada + + + "Tá bom por hoje," disse o Blix. "Que tal um pires de leite fresco, por favor?" + + + Eu enchi o pires dele até a borda e ele se esbaldou daquilo por algum tempo enquanto eu jogava poker e + jabbed at coals in the fireplace. Minha mente vagou e eu não pude não pensar mais sobre blocos. + Eu pensei no que ensinar pro Blix em seguida. + + + Eu provavelmente o teria ensinado sobre @next@. Quando você está interando uma lista, você + pode usar @next@ para *pular para o próximo item*. Aqui estamos contando brinquedos que não tenham + forma de bolinho-primavera, pulando eles com @next@. + + + <pre> + nao_bolinho_primavera = 0 + brinquedos_do_gatinho.each do |brinquedo| + next if brinquedo[:formato] == 'bolinho-primavera' + nao_bolinho_primavera = nao_bolinho_primavera + 1 + end + </pre> + + + Eu poderia também tê-lo ensinado sobre @break@, que *te joga pra fora de um loop*. + No código abaixo, vamo imprimir (usando @p@) cada brinquedo até encontrarmos + o brinquedo cujo material seja chenille. O @break@ fará com que o @each@ termine abruptamente. + + + <pre> + brinquedos_do_gatinho.each do |brinquedo| + break if brinquedo[:material] == 'chenille' + p brinquedo + end + </pre> + + + Eu nunca cheguei a ensinar a ele essas coisas. Eu continuei viajando num pedaço de lenha em particular + que acabou preso na proteção da lareira e quase que cai no meu tapete de pele de antílope. + + + Assim que me esquivei ferozmente daquela pedra negra, Blix sumiu, presumo que pro + ônibus para Wixl, a capital econômica dos animais. Quem sabe, ele pode ter parado + em Ambrose ou Riathna ou qualquer outra vila pelo caminho. Meu instinto me diz + que Wixl era definitivamente sua última parada. + + + Sem nenhum estudante para instruir ou prosear, me encontrei sozinho, enfurnado em casa. + Na quietude dos corredores mortos, eu comecei a rascunhar uma bioagrafia na + forma deste guia. + + + Eu trabalhei nisso sempre que me sentia entendiado. E quando não estava entendiado, eu ia assistir + _The Phantom Menace_ (Guerra nas Estrelas - A Ameaça Fantasma) pra ficar no clima. + + + !i/the.elf-7.jpg(Someone let them all out.)! + lang-pt/poignant-36.yml @@ -1,2 +1,2 @@ - - Aqueles Que Fazem as Regras e Aqueles Que Vivem o Sonho: - + - Aqueles Que Fazem as Regras e Aqueles Que Vivem o Sonho: + lang-pt/poignant-37.yml @@ -1,22 +1,22 @@ - - > - !i/dr.cham-1.gif(Pelo espaço e tempo... na sua jarra de sino... numa missão para se encontrar...)! - - - Francamente, estou cansado de ouvir que o Dr. Cham é louco. Sim, ele tentou se enterrar - vivo. Sim, ele eletrocutou sua sobrinha. Sim, é fato, ele explodiu um asilo. - Mas tudo isso foi por uma boa causa e, em cada caso, eu acredito que ele tenha - tomado a decisão correta. - - - Tenho certeza que você gostaria de ficar do lado da opinião popular, mas você está prestes - a sentir um pequeno comichão de admiração por ele, uma vez que ele te ensine tudo - sobre as definições de classe do Ruby. - E ainda mais quando você aprender sobre mixins. Talvez até, no final do capítulo, nós todos - comecemos a olhar além do passado obscuro do Doutor, e não mais o chamaremos de louco. - - - Então, se você quer chamá-lo de louco, eu começaria indo na estação de trem - quebrar umas lâmpadas fluorescentes grandes. Tire-o do seu sistema agora, - antes de irmos mais fundo. - - + - > + !i/dr.cham-1.gif(Pelo espaço e tempo... na sua jarra de sino... numa missão para se encontrar...)! + + + Francamente, estou cansado de ouvir que o Dr. Cham é louco. Sim, ele tentou se enterrar + vivo. Sim, ele eletrocutou sua sobrinha. Sim, é fato, ele explodiu um asilo. + Mas tudo isso foi por uma boa causa e, em cada caso, eu acredito que ele tenha + tomado a decisão correta. + + + Tenho certeza que você gostaria de ficar do lado da opinião popular, mas você está prestes + a sentir um pequeno comichão de admiração por ele, uma vez que ele te ensine tudo + sobre as definições de classe do Ruby. + E ainda mais quando você aprender sobre mixins. Talvez até, no final do capítulo, nós todos + comecemos a olhar além do passado obscuro do Doutor, e não mais o chamaremos de louco. + + + Então, se você quer chamá-lo de louco, eu começaria indo na estação de trem + quebrar umas lâmpadas fluorescentes grandes. Tire-o do seu sistema agora, + antes de irmos mais fundo. + + lang-pt/poignant-38.yml @@ -1,119 +1,119 @@ - - Esta é para os desprivilegiados: > - - !i/elderly-1.gif(Algumas pessoas ainda nao conseguem acreditar no que fizemos.)! - - - Se você me der um número, seja ele um período da vida do Dr. Cham, lhe darei uma sinopse daquele - período. E eu farei isso com um método Ruby, isso será uma peça independente, um pedaço de código - isolado que pode ser ligado à voz de um vulcão robótico, quando essas coisas forem o ápice - das vozes talentosas não autoritárias. - - - Ok, eu preciso que você preste atenção nos comandos @def@ , @case@ e @when@. Você já viu Ranges (Períodos), os - acordiões fechados @1895..1913@, no capítulo 3. Eles contém as pontas e todos os números entre. E as barras - no fim de cada linha simplesmente ignoram o _Enter_, assegurando ao Ruby que _há mais linhas por vir_. - - - - Então, por favor: @def@, @case@ e @when@. - - - <pre> - def biografia_do_dr_cham( ano ) - case ano - when 1894 - "Nasceu." - when 1895..1913 - "Infância em Lousville, Winston Co., Mississippi." - when 1914..1919 - "Trabalhou numa enfermaria de Pecãs; socou um protestante." - when 1920..1928 - "Navegou na companhia do Rio Wisdomming, que se juntou \ - ao Rio Mississippi e se engajou em reflexão e auto-aprimoramento, \ - onde ele concluiu 140 horas de crédito para sua Remoniversidade" - when 1929 - "Voltou à Louisville para escrever um romance sobre camponeses caçadores que viajam no tempo." - when 1930..1933 - "Ergueu uma respeitável carreira medicando pecãs. Financeiramente estável, ele \ - passou algum tempo no Brasil e Novo México, comprando raras árvores de pecã de casca fina. Assim \ - que sua notoriedade chegou a um alto patamar: caramba, ele tentou se enterrar vivo." - when 1934 - "Voltou a escrever seu romance. Mudou de caçadores para funcionários de seguradora e \ - de camponeses para protestantes." - when 1935..1940 - "Recebeu Arthur Cone, o chefe da Irmandade do Rio Wisdomming, em sua residência \ - como convidado. Juntos por cinco anos, planejaram e inventaram." - when 1941 - "Aqui as coisas começam a ficar interessantes." - end - end - </pre> - - - O comando @def@. Aqui esta nossa primeira *definição de método*. Um método simples, que pode - ser usado em qualquer lugar no Ruby. E como rodamos ele? - - - <pre> - puts biografia_do_dr_cham( 1941 ) - </pre> - - - Que por sua vez responde "Aqui as coisas começam a ficar interessantes." É sempre a mesma história: - _use suas respostas._ Eu fiz as coisas ali de tal modo que o @case@ sempre responderá com uma String. - E já que o case é o último (e único) comando no método, então o método - responderá aquela String. Trickling water spilling down from ledge to ledge. - - - Deixe me ser mais claro sobre a condição @case@. Na verdade, eu deveria chamá-la de @case..when@, - já que elas não pode ser usadas separadamente. O comando @case@ é serguido de um valor, que é comparado contra - cada valor que segue o comando @when@. O primeiro valor a coincidir é usado pelo @case@, - o resto é ignorado. Você pode fazer a mesma coisa com um monte de @if..elsif@, - mas isso é muito palavreado. - - - <pre> - case ano - when 1894 - "Nasceu." - when 1895..1913 - "Infância em Lousville, Winston Co., Mississippi." - else - "Sem informações sobre este ano." - end - </pre> - - - É a mesma coisa que: - - - <pre> - if 1894 === ano - "Nasceu." - elsif 1895..1913 === ano - "Infância em Lousville, Winston Co., Mississippi." - else - "Sem informações para este ano." - end - </pre> - - - Os *três iguais (===)* são o comprimento da corda de veludo, checando valores como assim como dois iguais (==). - Resumindo: os três iguais são uma corda maior e ela folga um pouco no meio. Não é tão tensionada, é um pouco mais - maleável. - - - Veja os períodos assim: @(1895..1913)@ não é nem um pouco *igual* a @1905@. Não, o período @(1895..1913)@ só é - realmente *igual* a qualquer outro período @(1895..1913)@. Os três iguais, no caso de um período, dão uma folga - e deixam o número inteiro @1905@ entrar, pois mesmo ele não sendo *igual* ao período, ele está *incluído* na lista - de número inteiros representados pelo perído. O que é suficiente em alguns casos, como o da biografia que - eu fiz anteriormente. - - - A qual realmente se parece com uma biografia, não? Quero dizer, claro, o método @biografia_do_dr_cham@ é código, mas - ele se parece com uma biografia, limpa e afável. - - - !i/elderly-2.gif(O que a pesquisa revelou.)! - - + - Esta é para os desprivilegiados: > + + !i/elderly-1.gif(Algumas pessoas ainda nao conseguem acreditar no que fizemos.)! + + + Se você me der um número, seja ele um período da vida do Dr. Cham, lhe darei uma sinopse daquele + período. E eu farei isso com um método Ruby, isso será uma peça independente, um pedaço de código + isolado que pode ser ligado à voz de um vulcão robótico, quando essas coisas forem o ápice + das vozes talentosas não autoritárias. + + + Ok, eu preciso que você preste atenção nos comandos @def@ , @case@ e @when@. Você já viu Ranges (Períodos), os + acordiões fechados @1895..1913@, no capítulo 3. Eles contém as pontas e todos os números entre. E as barras + no fim de cada linha simplesmente ignoram o _Enter_, assegurando ao Ruby que _há mais linhas por vir_. + + + + Então, por favor: @def@, @case@ e @when@. + + + <pre> + def biografia_do_dr_cham( ano ) + case ano + when 1894 + "Nasceu." + when 1895..1913 + "Infância em Lousville, Winston Co., Mississippi." + when 1914..1919 + "Trabalhou numa enfermaria de Pecãs; socou um protestante." + when 1920..1928 + "Navegou na companhia do Rio Wisdomming, que se juntou \ + ao Rio Mississippi e se engajou em reflexão e auto-aprimoramento, \ + onde ele concluiu 140 horas de crédito para sua Remoniversidade" + when 1929 + "Voltou à Louisville para escrever um romance sobre camponeses caçadores que viajam no tempo." + when 1930..1933 + "Ergueu uma respeitável carreira medicando pecãs. Financeiramente estável, ele \ + passou algum tempo no Brasil e Novo México, comprando raras árvores de pecã de casca fina. Assim \ + que sua notoriedade chegou a um alto patamar: caramba, ele tentou se enterrar vivo." + when 1934 + "Voltou a escrever seu romance. Mudou de caçadores para funcionários de seguradora e \ + de camponeses para protestantes." + when 1935..1940 + "Recebeu Arthur Cone, o chefe da Irmandade do Rio Wisdomming, em sua residência \ + como convidado. Juntos por cinco anos, planejaram e inventaram." + when 1941 + "Aqui as coisas começam a ficar interessantes." + end + end + </pre> + + + O comando @def@. Aqui esta nossa primeira *definição de método*. Um método simples, que pode + ser usado em qualquer lugar no Ruby. E como rodamos ele? + + + <pre> + puts biografia_do_dr_cham( 1941 ) + </pre> + + + Que por sua vez responde "Aqui as coisas começam a ficar interessantes." É sempre a mesma história: + _use suas respostas._ Eu fiz as coisas ali de tal modo que o @case@ sempre responderá com uma String. + E já que o case é o último (e único) comando no método, então o método + responderá aquela String. Trickling water spilling down from ledge to ledge. + + + Deixe me ser mais claro sobre a condição @case@. Na verdade, eu deveria chamá-la de @case..when@, + já que elas não pode ser usadas separadamente. O comando @case@ é serguido de um valor, que é comparado contra + cada valor que segue o comando @when@. O primeiro valor a coincidir é usado pelo @case@, + o resto é ignorado. Você pode fazer a mesma coisa com um monte de @if..elsif@, + mas isso é muito palavreado. + + + <pre> + case ano + when 1894 + "Nasceu." + when 1895..1913 + "Infância em Lousville, Winston Co., Mississippi." + else + "Sem informações sobre este ano." + end + </pre> + + + É a mesma coisa que: + + + <pre> + if 1894 === ano + "Nasceu." + elsif 1895..1913 === ano + "Infância em Lousville, Winston Co., Mississippi." + else + "Sem informações para este ano." + end + </pre> + + + Os *três iguais (===)* são o comprimento da corda de veludo, checando valores como assim como dois iguais (==). + Resumindo: os três iguais são uma corda maior e ela folga um pouco no meio. Não é tão tensionada, é um pouco mais + maleável. + + + Veja os períodos assim: @(1895..1913)@ não é nem um pouco *igual* a @1905@. Não, o período @(1895..1913)@ só é + realmente *igual* a qualquer outro período @(1895..1913)@. Os três iguais, no caso de um período, dão uma folga + e deixam o número inteiro @1905@ entrar, pois mesmo ele não sendo *igual* ao período, ele está *incluído* na lista + de número inteiros representados pelo perído. O que é suficiente em alguns casos, como o da biografia que + eu fiz anteriormente. + + + A qual realmente se parece com uma biografia, não? Quero dizer, claro, o método @biografia_do_dr_cham@ é código, mas + ele se parece com uma biografia, limpa e afável. + + + !i/elderly-2.gif(O que a pesquisa revelou.)! + + lang-pt/poignant-39.yml @@ -1,75 +1,75 @@ - - !^sidebar - Pensando em você. E em seu bem-estar.: > - - Eu preciso que você esteja num bom estado mental para o resto do livro. - Agora é hora de começar a te condicionar. - - - Vamos começar respirando profundamente. Inspire profundamente - e conte até quatro comigo. - - - Vamos lá. 1. 2. 3. 4. Agora expire. Você pode - sentir seus olhos. Bom, é isso mesmo. - - - Agora vamos inspirar profundamente e, na sua mente, desenhe um hipopótamo - o mais rápido que puder. Rápido rápido. Suas pernas, sua forma, seus dentes - de marshmallow. Ok, feito. Agora expire. - - - Dê mais uma boa inspirada e segure. Enquanto você segura o ar firme - no seu peito, imagine que a pressão o está reduzindo ao tamanho de um inseto. - Você segurou seu fôlego tão forte que agora você é um inseto. E todos os - outros insetos viram você diminuir e adoraram a façanha. Eles estão batendo - palmas e roçando as anteninhas frenéticamente. Mas você tinha uma maçã na - mão quando você era grande, e ela te pegou agora, esmagou - toda a multidão. Você está morto, também. Agora expire. - - - Agora dê uma uma boa respirada e imagine que você vive em uma cidade - em que tudo é feito de fios de telefone. As casas são todas de fios - de telefone, as paredes, o telhado. As portas são um massa densa - de fios de telefone que você simplesmente atravessa. Quando você vai - pra cama, a cama é de fios de telefone. E o colchão e as molas - da cama são fios de telefone, também. Como eu disse, tudo é feito de - fios de telefone. O próprio telefone é feito de fios de telefone. - Mas o fio de telefone que vai pro telefone é feito de pão - e palitos. Agora expire. - - - Inspire. 1. 2. 3. 4. Expire. - - - Inspire. 1. 2. Inspire mais um pouco. 3. 4. Imagine suas mãos - saindo dos pulsos, voando atá a tela do computador - e programando ele de dentro. Expire. - - - Respire fundo, fundo. Abaixo the você tem um submarino. - Ele tem uma língua. Expire. - - - Respire pelo nariz. Respire fundo. Filtre o ar pelo - seu nariz. Respirar pelo nariz te dá ar de qualidade. - Seu nariz se abre, você recebe o ar da natureza, do jeito - que Deus planejou. Imagine um leitor de disquetes lotado de órfãos. - Enquanto ele se engasga com os órfãos, você tem o ótimo, o maravilhoso ar de Deus - em seus pulmões. Mas este ar prazeiroso e cheio de vida - vira uma poderosa toxina se você segurar por muito tempo. _Rápido, exale - o ar de Deus e da natureza!_ - - - Agora, você vai acordar, desamassando as dobras desta página - no seu navegador. Você relembrará toda sua vida - e não se esquecerá de nenhuma das várias aventuras - que você teve nela. Você se sentirá - rico, renovado e mais experiente. Você não terá lembranças - desde curto exercício, na verdade você vai lembrar de estar ensinando a distância - um coelho a usar tesouras. - - - Já que você vai acordar e ver este exercício de novo, você - vai fazê-lo novamente. Mas desta vez, tente imaginar - que até _sua sombra_ é um fio de telefone. - + - !^sidebar + Pensando em você. E em seu bem-estar.: > + + Eu preciso que você esteja num bom estado mental para o resto do livro. + Agora é hora de começar a te condicionar. + + + Vamos começar respirando profundamente. Inspire profundamente + e conte até quatro comigo. + + + Vamos lá. 1. 2. 3. 4. Agora expire. Você pode + sentir seus olhos. Bom, é isso mesmo. + + + Agora vamos inspirar profundamente e, na sua mente, desenhe um hipopótamo + o mais rápido que puder. Rápido rápido. Suas pernas, sua forma, seus dentes + de marshmallow. Ok, feito. Agora expire. + + + Dê mais uma boa inspirada e segure. Enquanto você segura o ar firme + no seu peito, imagine que a pressão o está reduzindo ao tamanho de um inseto. + Você segurou seu fôlego tão forte que agora você é um inseto. E todos os + outros insetos viram você diminuir e adoraram a façanha. Eles estão batendo + palmas e roçando as anteninhas frenéticamente. Mas você tinha uma maçã na + mão quando você era grande, e ela te pegou agora, esmagou + toda a multidão. Você está morto, também. Agora expire. + + + Agora dê uma uma boa respirada e imagine que você vive em uma cidade + em que tudo é feito de fios de telefone. As casas são todas de fios + de telefone, as paredes, o telhado. As portas são um massa densa + de fios de telefone que você simplesmente atravessa. Quando você vai + pra cama, a cama é de fios de telefone. E o colchão e as molas + da cama são fios de telefone, também. Como eu disse, tudo é feito de + fios de telefone. O próprio telefone é feito de fios de telefone. + Mas o fio de telefone que vai pro telefone é feito de pão + e palitos. Agora expire. + + + Inspire. 1. 2. 3. 4. Expire. + + + Inspire. 1. 2. Inspire mais um pouco. 3. 4. Imagine suas mãos + saindo dos pulsos, voando atá a tela do computador + e programando ele de dentro. Expire. + + + Respire fundo, fundo. Abaixo the você tem um submarino. + Ele tem uma língua. Expire. + + + Respire pelo nariz. Respire fundo. Filtre o ar pelo + seu nariz. Respirar pelo nariz te dá ar de qualidade. + Seu nariz se abre, você recebe o ar da natureza, do jeito + que Deus planejou. Imagine um leitor de disquetes lotado de órfãos. + Enquanto ele se engasga com os órfãos, você tem o ótimo, o maravilhoso ar de Deus + em seus pulmões. Mas este ar prazeiroso e cheio de vida + vira uma poderosa toxina se você segurar por muito tempo. _Rápido, exale + o ar de Deus e da natureza!_ + + + Agora, você vai acordar, desamassando as dobras desta página + no seu navegador. Você relembrará toda sua vida + e não se esquecerá de nenhuma das várias aventuras + que você teve nela. Você se sentirá + rico, renovado e mais experiente. Você não terá lembranças + desde curto exercício, na verdade você vai lembrar de estar ensinando a distância + um coelho a usar tesouras. + + + Já que você vai acordar e ver este exercício de novo, você + vai fazê-lo novamente. Mas desta vez, tente imaginar + que até _sua sombra_ é um fio de telefone. + lang-pt/poignant-40.yml @@ -1,167 +1,167 @@ - - > - h3. Mas Ele Era Doente?? - - - Você sabe, ele não dava muita sorte. Era um desastre como novelista, mas suas empreitadas na alquimia - eram muito promissoras. Ele tinha um elixir de leite de cabra e sal marinho que melhorava dores nas pernas. - Um cara até regenerou um pedaço do dedo que havia perdido. Ele tinha um fumo medicinal orgânico que cheirava - chulé mas te dava visão noturna. Ele estava trabalhando em algo chamado Escada Líquida, mas nunca vi - ou li nada a respeito. Não pode ser pra subir. Quem sabe. - - - Um jornal local uma vez visitou o Dr. Cham. A crítica literária deles deu a ele quatro estrelas. - Sério. Ela fez um artigo sobre ele. Ela deu uma nota. - - - Mas saiba que o Dr. N. Harold Cham se sentia muito mal com relação à sua sobrinha. Ele acreditou que o tratamento - de choque funcionaria. A pólio a teria matado de qualquer jeito, mas ele tentou. - - - Em 9 de Setembro de 1941, depois de sedá-la como uma dose de phenacetin na sua sala de operações, ele colocou - os clips condutores no nariz, língua, dedos e ombros de Hannah. Com a ajuda de seu aprendiz, um estudante - perspicaz chamado Marvin Holyoake, eles polvilharam a garota com flocos de uma substância que o doutor - chamou de _opus magnum_. Um pó de ouro branco que levaria a corrente e evidentemente energizaria a menina, - forçando seu sangue a aflorar e lutar e vencer. - - - Mas aquilo não deu muito certo, quando a alavanca foi puxada, ela se debateu e chutou -- e - *KABLAM!* -- e *BLOY-OY-OY-KKPOY!* Anéis de cabelo e uma parede de luz, e o sino - da morte tocou. A experiência sucumbiu em uma estreita pluma de fumaça - e a inocência dela (_durante semanas, todo mundo só falava: "Ela nunca vai ter - a chance de..."_) foi um rombo no chão e nos pulmões deles. - - - Para Hannah, eu programo. - - - <pre> - opus_magnum = true - def salve_hannah - sucesso = opus_magnum - end - </pre> - - - Um método na sua ilha. E o que vai dentro não é afetado por simples váriaveis externas. - O Dr. Cham não podia penetrar na doença da sua sobrinha assim como uma variável @opus_magnum@ - não pode penetrar o fechado método. - - - Se rodarmos o método @salve_hannah@, o Ruby vai gritar com a gente, alegando que não sabe de @opus_magnum@ nenhuma. - - - Eu tô falando de *foco, escopo*. Microscópios restringem e magnificam sua visão. Telescópios extendem - seu campo de visão. No Ruby, *escopo* referecia o campo de visão dentro de métodos e blocos. - - - A declaração @def@ do método abre sua visão. Nomes de variáveis introduzidos ali serão vistos - pelo método e continuarão valendo até que o @end@ feche seus olhos. Você pode passar dados para um - método usando argumentos e dados podem ser resgatados de método, mas os nomes usados dentro - do método só valem no escopo dele. - - - Algumas váriveis tem um escopo mais amplo. Variáveis globais, como @$LOAD_PATH@, que começam com um *cifrão* - estão disponíveis sob qualquer escopo. Variáveis de instância como @@nomes@, que começam com uma *arroba* - estão disponíveis em todo lugar dentro do escopo da classe. A mesma coisa serve para variáveis de classe como @@@ingressos@. - Variáveis de classe e de instância serão exploradas em breve. - - - Blocos têm escopo, mas um escopo mais difuso. Mais flexível. - - - <pre> - verbo = 'resgatou' - ['sedou', 'polvilhou', 'eletrocutou']. - each do |verbo| - puts "O Dr. Cham " + verbo + " sua sobrinha Hannah." - end - puts "Sim, o Dr. Cham " + verbo + " sua sobrinha Hannah." - </pre> - - - O bloco _iterage_ (circunda, revolve) pelas ações do Doutor. A variável @verbo@ - muda a cada passagem. Em uma passagem, ele a está sedando. Na próxima, ele a está queimando. - E aí, eletrocutando. - - - Então, a questão é: após o término do bloco, terá ele resgatado a Hannah? - - - <pre class="result"> - O Dr. Cham sedou sua sobrinha Hannah. - O Dr. Cham polvilhou sua sobrinha Hannah. - O Dr. Cham eletrocutou sua sobrinha Hannah. - Sim, o Dr. Cham eletrocutou sua sobrinha Hannah. - </pre> - - - Os blocos podem ver variáveis da vizinhança. O bloco viu que a variável @verbo@ existia, - ele reescreveu o que ela continha e continuou. Quando o bloco acabou e sua pequena vida - se esvaiu, a variável @verbo@ saiu de lá uma outra criatura. - - - Se o bloco usar uma variável que ainda não tenha sido usada previamente, essa variável desaparece após - o término do bloco. O *escopo* do bloco se fecha e a variável vai junto. Aqui um exemplo em que @verbo@ - não foi usado antes do bloco: - - - <pre> - ['sedou', 'queimou', 'eletrocutou']. - each do |verbo| - puts "O Dr. Cham " + verbo + " sua sobrinha Hannah." - end - puts "Sim, O Dr. Cham " + verbo + " sua sobrinha Hannah." - </pre> - - - Dá um erro: @undefined local variable or method 'verbo'@. Poof. - (Método ou variável local 'verbo' não definido.) - - - Deve ser difícil, mesmo para um grande cientista, sumir com o corpo de uma garotinha - cujo vestido ainda está passado e bordado, mas cuja boca está roxa nos cantos. - No jornal do Dr. Cham, ele relata que fora atormentado pelo fantasma dela, que reluzia ouro and scorched - lace. Suas desilusões aumentaram e ele fugiu de cães do inferno e massivas, vingativas mãos angelicais. - - - Somente semanas mais tarde, ele foi embora, impulsionado desses arrependimentos, sumindo na - explosão que o levaria pra fora do planeta. - - - Até que enquanto você lê isso agora, em algum momento, a jarra em formato de sino do nosso - solitário Dr. Cham pousou num distante planeta depois de viajar sessenta anos. - Assim que o novo mundo apareceu, assim que a curvatura do planeta se mostrou, - assim que a jarra em formato de sino varreu os céus tempestuosos, rasgando folhas de aurora e - vento solar, os olhos do Dr. Chams se abriram. - - - !i/dr.cham-2.gif(Pouso seguro. Espanto.)! - - - O que você esta testemunhando é o pouso do Dr. Cham no planeta Endertromb. Do que eu pude - perceber, ele pousou no meio de uma estação desolada, quando não tem muita coisa acontecendo - no planeta. A maioria dos habitantes têm susas mentes presas a um zumbido desanimador - que faz com que eles se desintegrem em fantasmas fúteis uma-parte-conhecimento e três-partes-vapor - por um tempo. - - - Meu modesto conhecimento sobre a história e clima de Endertromb foi adquirido convivendo - com o professor de piano da minha filha, que nasceu lá. - - - !i/elderly-3.gif(Dead husbands could destroy the Doctor.)! - - - Eu frequentemente treino o professor de piano da minha filha para assegurar que ele mantenha - seus compromissos. Que ele atenda chamadas em horas estranhas e responda chamadas de - emergência prontamente. Quando ele finalmente me contou que era um alien cujo dia consistia em - quinhentas e quarenta horas acordado, eu estava incrivelmente favorável a um relacionamento - contratual com ele que durará até 2060. - - - Por três dias (de acordo com seu relógio de bolso), o Dr. Cham viajou nas escuras passagens de ar, - respirando o vento empoeirado daquele planeta inóspito. - Mas no terceiro dia, a Estação Desolada acabara e ele acordou para uma vista magnífica, - decorada com recém-floridas árvores de maçã e dewy castle tiers. - - + - > + h3. Mas Ele Era Doente?? + + + Você sabe, ele não dava muita sorte. Era um desastre como novelista, mas suas empreitadas na alquimia + eram muito promissoras. Ele tinha um elixir de leite de cabra e sal marinho que melhorava dores nas pernas. + Um cara até regenerou um pedaço do dedo que havia perdido. Ele tinha um fumo medicinal orgânico que cheirava + chulé mas te dava visão noturna. Ele estava trabalhando em algo chamado Escada Líquida, mas nunca vi + ou li nada a respeito. Não pode ser pra subir. Quem sabe. + + + Um jornal local uma vez visitou o Dr. Cham. A crítica literária deles deu a ele quatro estrelas. + Sério. Ela fez um artigo sobre ele. Ela deu uma nota. + + + Mas saiba que o Dr. N. Harold Cham se sentia muito mal com relação à sua sobrinha. Ele acreditou que o tratamento + de choque funcionaria. A pólio a teria matado de qualquer jeito, mas ele tentou. + + + Em 9 de Setembro de 1941, depois de sedá-la como uma dose de phenacetin na sua sala de operações, ele colocou + os clips condutores no nariz, língua, dedos e ombros de Hannah. Com a ajuda de seu aprendiz, um estudante + perspicaz chamado Marvin Holyoake, eles polvilharam a garota com flocos de uma substância que o doutor + chamou de _opus magnum_. Um pó de ouro branco que levaria a corrente e evidentemente energizaria a menina, + forçando seu sangue a aflorar e lutar e vencer. + + + Mas aquilo não deu muito certo, quando a alavanca foi puxada, ela se debateu e chutou -- e + *KABLAM!* -- e *BLOY-OY-OY-KKPOY!* Anéis de cabelo e uma parede de luz, e o sino + da morte tocou. A experiência sucumbiu em uma estreita pluma de fumaça + e a inocência dela (_durante semanas, todo mundo só falava: "Ela nunca vai ter + a chance de..."_) foi um rombo no chão e nos pulmões deles. + + + Para Hannah, eu programo. + + + <pre> + opus_magnum = true + def salve_hannah + sucesso = opus_magnum + end + </pre> + + + Um método na sua ilha. E o que vai dentro não é afetado por simples váriaveis externas. + O Dr. Cham não podia penetrar na doença da sua sobrinha assim como uma variável @opus_magnum@ + não pode penetrar o fechado método. + + + Se rodarmos o método @salve_hannah@, o Ruby vai gritar com a gente, alegando que não sabe de @opus_magnum@ nenhuma. + + + Eu tô falando de *foco, escopo*. Microscópios restringem e magnificam sua visão. Telescópios extendem + seu campo de visão. No Ruby, *escopo* referecia o campo de visão dentro de métodos e blocos. + + + A declaração @def@ do método abre sua visão. Nomes de variáveis introduzidos ali serão vistos + pelo método e continuarão valendo até que o @end@ feche seus olhos. Você pode passar dados para um + método usando argumentos e dados podem ser resgatados de método, mas os nomes usados dentro + do método só valem no escopo dele. + + + Algumas váriveis tem um escopo mais amplo. Variáveis globais, como @$LOAD_PATH@, que começam com um *cifrão* + estão disponíveis sob qualquer escopo. Variáveis de instância como @@nomes@, que começam com uma *arroba* + estão disponíveis em todo lugar dentro do escopo da classe. A mesma coisa serve para variáveis de classe como @@@ingressos@. + Variáveis de classe e de instância serão exploradas em breve. + + + Blocos têm escopo, mas um escopo mais difuso. Mais flexível. + + + <pre> + verbo = 'resgatou' + ['sedou', 'polvilhou', 'eletrocutou']. + each do |verbo| + puts "O Dr. Cham " + verbo + " sua sobrinha Hannah." + end + puts "Sim, o Dr. Cham " + verbo + " sua sobrinha Hannah." + </pre> + + + O bloco _iterage_ (circunda, revolve) pelas ações do Doutor. A variável @verbo@ + muda a cada passagem. Em uma passagem, ele a está sedando. Na próxima, ele a está queimando. + E aí, eletrocutando. + + + Então, a questão é: após o término do bloco, terá ele resgatado a Hannah? + + + <pre class="result"> + O Dr. Cham sedou sua sobrinha Hannah. + O Dr. Cham polvilhou sua sobrinha Hannah. + O Dr. Cham eletrocutou sua sobrinha Hannah. + Sim, o Dr. Cham eletrocutou sua sobrinha Hannah. + </pre> + + + Os blocos podem ver variáveis da vizinhança. O bloco viu que a variável @verbo@ existia, + ele reescreveu o que ela continha e continuou. Quando o bloco acabou e sua pequena vida + se esvaiu, a variável @verbo@ saiu de lá uma outra criatura. + + + Se o bloco usar uma variável que ainda não tenha sido usada previamente, essa variável desaparece após + o término do bloco. O *escopo* do bloco se fecha e a variável vai junto. Aqui um exemplo em que @verbo@ + não foi usado antes do bloco: + + + <pre> + ['sedou', 'queimou', 'eletrocutou']. + each do |verbo| + puts "O Dr. Cham " + verbo + " sua sobrinha Hannah." + end + puts "Sim, O Dr. Cham " + verbo + " sua sobrinha Hannah." + </pre> + + + Dá um erro: @undefined local variable or method 'verbo'@. Poof. + (Método ou variável local 'verbo' não definido.) + + + Deve ser difícil, mesmo para um grande cientista, sumir com o corpo de uma garotinha + cujo vestido ainda está passado e bordado, mas cuja boca está roxa nos cantos. + No jornal do Dr. Cham, ele relata que fora atormentado pelo fantasma dela, que reluzia ouro and scorched + lace. Suas desilusões aumentaram e ele fugiu de cães do inferno e massivas, vingativas mãos angelicais. + + + Somente semanas mais tarde, ele foi embora, impulsionado desses arrependimentos, sumindo na + explosão que o levaria pra fora do planeta. + + + Até que enquanto você lê isso agora, em algum momento, a jarra em formato de sino do nosso + solitário Dr. Cham pousou num distante planeta depois de viajar sessenta anos. + Assim que o novo mundo apareceu, assim que a curvatura do planeta se mostrou, + assim que a jarra em formato de sino varreu os céus tempestuosos, rasgando folhas de aurora e + vento solar, os olhos do Dr. Chams se abriram. + + + !i/dr.cham-2.gif(Pouso seguro. Espanto.)! + + + O que você esta testemunhando é o pouso do Dr. Cham no planeta Endertromb. Do que eu pude + perceber, ele pousou no meio de uma estação desolada, quando não tem muita coisa acontecendo + no planeta. A maioria dos habitantes têm susas mentes presas a um zumbido desanimador + que faz com que eles se desintegrem em fantasmas fúteis uma-parte-conhecimento e três-partes-vapor + por um tempo. + + + Meu modesto conhecimento sobre a história e clima de Endertromb foi adquirido convivendo + com o professor de piano da minha filha, que nasceu lá. + + + !i/elderly-3.gif(Dead husbands could destroy the Doctor.)! + + + Eu frequentemente treino o professor de piano da minha filha para assegurar que ele mantenha + seus compromissos. Que ele atenda chamadas em horas estranhas e responda chamadas de + emergência prontamente. Quando ele finalmente me contou que era um alien cujo dia consistia em + quinhentas e quarenta horas acordado, eu estava incrivelmente favorável a um relacionamento + contratual com ele que durará até 2060. + + + Por três dias (de acordo com seu relógio de bolso), o Dr. Cham viajou nas escuras passagens de ar, + respirando o vento empoeirado daquele planeta inóspito. + Mas no terceiro dia, a Estação Desolada acabara e ele acordou para uma vista magnífica, + decorada com recém-floridas árvores de maçã e dewy castle tiers. + + lang-pt/poignant-41.yml @@ -1,518 +1,518 @@ - - Um Castelo Tem Seus Computadores: > - - !i/dr.cham-3.jpg(The panoramic vales of Sedna on Endertromb.)! - - - Nosso intrépido Doutor partiu para o castelo alienígena, lançando-se sobre as flores. The ground belted - past his heels. The castle inched up the horizon. Ele gostaria de um cavalo, mas nenhum cavalo - apareceu. E foi assim que ele descobriu que o planeta não leria sua mente e não responderia seus - pedidos. - - - Porém, como o instrutor de órgão da minha filha havia me explicado, o planeta *podia ler mentes* e *podia - realizar desejos*. Só que não os dois ao mesmo tempo. - - - Um dia questionando o maestro de órgão, ele rascunhou o seguinte código Ruby numa folha - de papel cor-de-queijo. (E cheiros estranhos de queijo estão vindo de algum lugar, - eu não posso dizer onde.) - - - <pre> - require 'endertromb' - class FazedorPedidos - def initialize - @energia = rand( 6 ) - end - def realize( pedido ) - if pedido.length > 10 or pedido.include? ' ' - raise ArgumentError, "Pedido ruim." - end - if @energia.zero? - raise Exception, "Sem energia." - end - @energia -= 1 - Endertromb::realize( pedido ) - end - end - </pre> - - - Este é o fazedor de pedidos. - - - Na verdade, não, esta é a *definição de um fazedor de pedidos.* Para o Ruby, é uma *definição de classe*. - O código descreve como um certo *objeto* vai funcionar. - - - Cada manhã, o fazedor de pedidos arts out with up to five wishes available for granting. - Um novo @FazedorPedidos@ é criado quando o sol levanta. - - - <pre> - pedidos_do_dia = FazedorPedidos.new - </pre> - - - O método @new@ é um método de classe que um novo, objeto em branco. Ele também o chama o método - @initialize@ do objeto automaticamente. Na definição do @FazedorPedidos,@ você vai ver o método - @initialize@, que contém uma única linha de código: @@energia = rand( 6 )@. - - - O @rand( 6 )@ sorteia um número entre 0 e 5. Este número vai representar quantos pedidos - ainda restam no dia. Então, occasionalmente não haverão pedidos disponíveis do fazedor de - pedidos. - - - O número aleatório é dado à uma *variável de instância* de nome @@energia@. - Esta variável instância vai estar disponível a qualquer por entre a classe. A variável - não pode ser usada fora do *escopo* da classe. - - - No capítulo três, demos uma breve olhada em variáveis de instância e decidimos respeitá-las - como *atributos*. (O símbolo *arroba* poderia significar *atributo*.) Variáveis de instância podem - ser usadas para guardar qualquer tipo de informação, mas elas são mais usadas para se guardar pedaços - de informação sobre o objeto representado pela classe. - - - No caso acima, cada fazendor de pedidos para o dia tem seu próprio nível de energia. Se o fazendor de pedidos - fosse uma máquina, você talvez veria um medidor nele que marca a energia restante. - A variável de instância @@energia@ age como esse medidor. - - - <pre> - pedidos_do_dia = FazedorPedidos.new - pedidos_do_dia.realize( "galhada" ) - </pre> - - - Okay, volte um pouco e tenha certeza de entender o exemplo aqui. A classe @FazedorPedidos@ é a planta - que elaboramos para como toda a mágica dos pedidos funciona. Não é o _realmente_ o gênio na lâmpada, - é a papelada por trás das cenas. São as regras e obrigações em que o gênio vive. - - - O @pedidos_do_dia@ é o gênio da lâmpada. E aqui estamos dando um pedido pra a ser realizado. - Nos dê uma galhada, gênio. (Se você realmente arranjar uma galhada neste exemplo, eu nem quero saber. - Vá saltitar em campinas verdes com seus amigos.) - - - No capítulo anterior, o treinamento era: Ruby tem duas metades. - - - # Definindo coisas. - - # Colocando estas coisas em ação. - - - O que são as ações no Ruby? Métodos. E agora, você está provando a linguagem de definição - interna do Ruby. Definições de métodos usando @def@. Definições de classe usando @class@. - - - Neste ponto da sua instrução, é mais fácil entender que *tudo no Ruby é um objeto.* - - - <pre> - numero = 5 - print numero.next # imprime '6' - - frase = 'desejando uma galhada' - print frase.length # imprime '19' - - pedidos_do_dia = FazedorPedidos.new - pedidos_do_dia.grant( "galhada" ) - </pre> - - - E, consequentemente, cada objeto tem uma classe atrás da cortina. - - - <pre> - print 5.class # imprime 'Integer' - print 'desejando uma galhada'.class # imprime 'String' - print FazedorPedidos.new.class # imprime 'FazedorPedidos' - </pre> - - - Dr. Cham nunca viu o fazendor de pedidos enquanto desbravava a paisagem. - It lay far beyond his landing in the valley of Sedna. Down sheer cliffs - stuffed with layers of thicket, where you might toss your wish (written - on a small 1" x 6" slip), down into the gaping void. Hopefully it will - land on a lizard's back, sticking to its spindly little horn. - - - E digamos que seu pedido chegue lá. Well, then, _down the twisted wood_ goes - the skinny salamander, scurrying through the decaying churches which had been - *pushed* over that steep canyon ledge once and for all. And the expired priest inside, _who - weathered the fall_ as well, will kill the little amphibian -- strangle it - to death with a blessed gold chain -- and save it for the annual _Getting To - Know You_ breakfast. He'll step on your precious little wish and, when the - *thieves come*, that slip will still be there, stuck on his sole. Of course, - the thieves' *preferred method of torture* is to cut a priest in thin deli-shaved slices _from - top to bottom_. Who can cull evidence from that? And when they chop that last thin - slice of shoe sole, they'll have that *rubber scalp* in hand for _good luck_ and _good times_. - But they *canoe* much too hard, these thieves. They slap their paddles swiftly in the current - to get that great _outboard motor mist_ going. But the shoe sole is _on a weak chain_, tied - to one man s belt. And a *hairy old carp* _leaps, latches_ on to that minute fraction of - footwear. And the thieves _can try_, but they don't see _underwater_. If they could, they'd - see that *mighty cable*, packed with millions of _needly_ fiber optics. Indeed, *that fish is - a peripheral plugged* right into the _core workings_ of the planet Endertromb. *All it takes - is one swallow* from that fish *and your wish is home free!* - - - E é assim que os pedidos das crianças se realizam neste lugar. - - - Depois que o instrutor de órgão da minha filha ter desenhado a classe para o fazendor de pedidos, - ele continuou com uma classe para o leito de mentes do planeta. - - - <pre> - require 'endertromb' - class LeitorMental - def initialize - @mentes = Endertromb::procurar_por_consciencia - end - def read - @mentes.collect do |mente| - mente.read - end - end - end - </pre> - - - Como você já viu antes, o @initalize@ acontece quando um novo (new) objeto @LeitorMental@ é criado. - Este @initialize@ gathers scans the planet for mindshare. Parece que as mentes - estão guardadas em um array, já que há uma iteração nelas no final usando o método @collect.@ - - - Ambos o fazedor de pedidos e o leitor mental referem-se a uma classe chamada @Endertromb@. Esta classe está - guardada em um arquivo @endertromb.rb@, que é carregado com o código: @require 'endertromb'@. - Você vai, muitas vezes, usar outras classes para realizar parte da sua tarefa. Most of the latter half of this - book will explore the a grande variedade de classes úteis que podem ser carregadas no Ruby. - - - h3. Dr. Cham Arrisca Entrar - - - Mas assim que o Dr. Cham se aproximava do castelo, although the planet was aware of his thoughts, sensing his - wonderment and anticipation, all Dr. Cham felt was deadness. He tromped up the steps of its - open gate and through the entrance of the most beautiful architecture and was almost certain it - was deserted. - - - For a while he knocked. Which paid off. - - - !i/castle-1.jpg(Blocky whale greeting.)! - - - He watched the baby whale rise like a determined balloon. He marvelled at his first alien introduction - and felt some concern that it had passed so quickly. Well, he would wait inside. - - - Assim que ele entrou pela porta do castelo, se sentiu com sorte pela porta não ter sido atendida por - uma águia gigante com garras afiadas, ávida pra brincar. Ou um cabeça de rato gigante. Ou até mesmo um - furacão Or even a man-sized hurricane. Somente uma pequena baleia rechonchuda choo-choo. - - - "Not a place to sit down in this castle," he said. - - - À primeira vista, ele pensou ter entrado em um saguão escuro, mas assim que seus olhos se ajustaram, ele viu - que a entrada se extendia em um túnel. A porta do castelo seu abriu bem em uma passagem feita de pedaços - longos, e planos de rocha. Algumas partes eram congruentes e lembravam um corredor. Outras partes - eram estreitas, e até se inclinadas, o fim sumia de vista. - - - A passagem era iluminada por pequenas geladeiras sem portas, big enough to hold an armful of cabbage, - down by his feet. He peered inside one, which was hollow, illuminated along all sides, and - turning out ice shards methodically. - - - He pawed the ice chips, which clung dryly to his fingertips, and he scrubbed his hands in the - ice. Which left some muddy streaks on his hands, mas satisfez um pouco sua saudade de um banho. - Quanto tempo já fazia? Dez anos? Trinta? - - - Pela passagem, longos tubos de tecido lotavam algumas seções. Mais tarde, matéria brilhante feita de pixels em - vertedouros de porcelana e baldes. - - - Ele caiu em uma sala que havia sido escavada ao lado do túnel e nela haviam alguns cascos de tartaruga vazios - no chão e uma grande parede iluminada. He examinou a sala, perplexo. O que seria isso? - Por um instante, ele pensou em sentar em um casco. Isto poderia ser a entrada finalmente, algum - tipo de receiving room. Por outro lado, aranhas poderiam sair dos buracos dos cascos quando ele sentasse. - Ele seguiu viagem. - - - h3. Refeição no Bolso do Castelo - - - As he journeyed along the passageways (for the central tunnel forked and joined larger, vacuous caverns), he picked up - themes in some locations. Groups of rooms infested with pumping machinery. Cloth and vats of glue - dominated another area. He followed voices down a plush, pillowed cavity, which led him to a - dead end: a curved wall with a small room carved at eye-level. - - - Ele se aproximou da parede e, dentro do buraco quadrado, estavam dois porcos-da-terra comendendo à mesa. - - - Eles o encaram serenamente, ambos degustando um pouco de besouros escavados, que davam dois deles, abertos ao meio - e parados com as costas na mesa. - - - "Olá, bonequinhos," ele disse, e eles terminaram suas mordidas e ficaram olhando com seus garfos - held aloof. - - - "Eu queria que minha sobrinha Hannah estive aqui para conhecê-los," disse ele aos atenciosos porcos-da-terra. - "She'd think you were an intricate puppet show." He peered in at the dining area, shelves with sets of - plates, hand towels. Half of a tiny rabbit was jutting out from the top a machine, - creamy red noodles were spilling out underneath it. A door at the back of the room hung ajar. Dr. Cham could - see a flickering room with chairs and whirring motors through the door. - - - "Toda criança gostaria desta casa de bonecas," ele disse. "Hannah, minha sobrinha, como mencionei, she has - a wind-up doll that sits at a spindle and spins yarn. It's an illusion, of course. - The doll produces no yarn at all." - - - Um dos porcos-da-terra abriu um alçapão no chão e pressionou um botão ali, que se iluminou. - Então, um pequeno projetor de filme veio lentamente em rod. O outro porco-da-terra sentou e olhou o Dr. Cham. - - - "But Hannah still reaches down into the dollhouse and collects all the imaginary yarn into a - bundle. Which she takes to her mother, my sister, who is very good at humoring Hannah. - Ela costura um vestido no tamanho da boneca, o qual Hannah leva até a boneca. - - - "E ela diz à boneca, - 'Aqui, olhe, seu trabalho duro e perseverança resultaram neste lindo vestido. - Agora você pode aceitar o convite e acompanhar o Chefe de Polícia hoje à noite na Mansão - do Governador.' E ela tem uma boneca vestida de pocial que faz o papel do Chefe. - Ele é muito raquítico pra ser o Chefe de verdade, isso precisaria de um bom pedaço de plástico." - - - O porco-da-terra responsável pelo projetor o carregou com um rolo e o mirou na parede do - fundo. O filme começou e os porcos-da-terra se sentaram. Um quadrado verde apareceu na - parede. O atencioso porco-da-terra encarou o Dr. Cham parado. - - - "Seus filmes são coloridos," disse o Dr. Cham. "What a lovely, little life." - - - O filme exibido foi: um quadrado azul. Aí, um círculo vermelho. Aí, um quadrado laranja. Os atenciosos - porcos-da-terra se viraram, assistiram a tela virar um triângulo rosa, e ambos porcos-da-terra voltaram a comer. - - - Uma estrela roxa. Um quadrado vermelho. With quietness settling, Dr. Cham could hear notes droning - from the projector. Like a slow, plodding music box trying to roll its gears along the train - tracks. - - - "Sim, aproveitem o jantar," disse o Dr. Cham e educadamente se virou, marchando - de volta no caminho que ele tomara. - - - h3. Outra Rua Sem Saída Onde as Coisas Começam - - - Ele se encontrou perdido nos túneis do castelo. Nada parecia familiar. Todavia, ele não estava muito preocupado. - Ele estava noutro planeta. Ele estava perdido de qualquer maneira. - - - Ele se contorceu pelos túneis, tentando lembrar o caminho, mas muito mais interessado - em explorar para lembrar seus passos. Ele seguiu um único túnel profundamente, descendo, descendo, - ficou tão inclinado que ele tinha que pular entre as beiradas e cuidadosamente achar apoio para os pés. - A gravidade aqui não parecia ser diferente da Terra. Ele escorregava com a mesma facilidade. - - - Mesmo sem ter absolutamente nenhuma maneira de saber onde ele estava, ele tinha certeza de ter saído - dos limites do castelo. Esta profundidade, este tanto de caminhada. Já fazia uma hora desde que ele - adentrara a porta. E, as the tunnel wound back up, he was sure that he would - emerge into a new dwelling, perhaps even a manhole which he could peek out from and see - the castle. Talvez ele não devesse ter ido tão longe nessa rota. Ele espera que nada esteja - hibernando aqui emabaixo. - - - O túnel chegou ao fim. Um escuro, fim sem saída. - - - !i/dr.cham-4.gif(No fim dos túneis: um computador e um livro.)! - - - Ele tinha tempo. Então ele leu o livro. Ele leu sobre os raposos e sua perseguição ao porco-espinho que roubou - a caminhonete deles. Ele leu sobre o elfo e o presunto. Ele He saw the pictographs of himself and found he - could really relate to his own struggles. Ele até aprendeu Ruby. Ele viu como isso tudo termina. - - - Eu não teria estômago pra isso, no lugar dele. Mas ele teve. And he pledged in his bosom to see - things out just as they happened. - - - No monitor do computador, o Dr. Cham viu o prompt do @irb@ piscando. Assim como o Dr. Cham, você deve - reconhecer o prompt do @irb@ prompt do "A Roupa Do Tigre":expansion-pak-1.html - (o primeiro pacote de expansão deste livro, que inclui uma introdução básica ao IRB - Interactive Ruby.) - - - Assim como ele acabou de explorar os túneis a pé, agora ele explora as configurações da máquina com - a prompt. Ele colocou o livro onde o encontrou. Ele não precisava mais dele. This was - all going to happen whether he used it or not. - - - Ele começou com: - - - <pre> - irb> Object::constants - => ["Marshal", "String", "Dir", "LoadError", "Float", ... e por aí vai ] - </pre> - - - Este comando lista as constantes de nível mais alto. Classes são listadas como constantes também, - então esta lista é ótima pra ver o que está carregado no ruby a qualquer momento. - - - Ele examinou a lista procurando algo não familiar. Qualquer classe que não vem com o Ruby. - @Marshal@, @String@, @Dir@, @LoadError@, @Float@. Cada uma dessas vêm com o Ruby. - - - Mas um pouco pra baixo na lista: - - - <pre> - ... "Struct", "Values", "Time", "Elevador", "Range" ... - </pre> - - - _Elevador?_ Exatamente o tipo de classe a se bisbilhotar. He had a go. - - - <pre> - irb> Elevador::methods - => ["method", "freeze", "allocate", ... outra lista grande ... ] - irb> Elevador::class_variables - => ['@@relatorio_diagnostico', '@@circuito_eletrico_ativo', '@@senha_manutencao'] - irb> Elevador::constants - => [] - </pre> - - - Parece que a classe @Elevator@ tem um monte de métodos. A maioria deles parece - ser os mesmo métodos que todo objeto tem no Ruby. Por exemplo, - @method@, @freeze@ e @allocate@ vêm com toda classe no Ruby. (@Elevador::freeze@ - não deixaria que a classe @Elevator@ seja alterada. @Elevador::allocate@ criaria - um novo objeto @Elevator@ sem chamar o método @initialize.@) - - - As @class_variables@ foram interessantes pro Dr. Cham. Este elevador parece genuíno. - Mas sem @constantes@ disponíveis. Isso nos diz que não há classes aninhadas dentro - da classe @Elevator.@ - - - Ele tentou criar um objeto @Elevator.@ - - - <pre> - irb> e = Elevador::new - ArgumentError: wrong number of arguments (0 for 1), requires a password - from (irb):2:in `initialize' - from (irb):2:in `new' - from (irb):2 - from :0 - </pre> - - - Ele tentou algumas senhas. - - - <pre> - irb> e = Elevador::new( "pra cima" ) - AccessDeniedError: bad password - irb> e = Elevador::new( "subindo" ) - AccessDeniedError: bad password - irb> e = Elevador::new( "escadas_sao_terriveis" ) - AccessDeniedError: bad password - irb> e = Elevador::new( "EscadasSaoTerriveis" ) - AccessDeniedError: bad password - </pre> - - - Aqui foi inútil. _Oh, espere!_ A senha de manutenção. Listada nas @class_variables@. - - - <pre> - irb> Elevador::senha_manutencao - NoMethodError: undefined method `senha_manutencao' for Elevador:Class - from (irb):1 - from :0 - </pre> - - - Hmm. Variáveis de intância só estão disponíveis dentro de um objeto. E variáveis de classe só estão - disponíveis dentro de uma classe. Como conseguir aquela senha? - - - <pre> - irb> class Elevator - irb> def Elevador.senha_manutencao - irb> @@senha_manutencao - irb> end - irb> end - => nil - irb> Elevador::senha_manutencao - => "escadas_sao_passado!" - </pre> - - - Agora sim! Conseguimos a senha. Você viu aquilo? - - - Ele adicionou um método de classe à classe @Elevator.@ Não é ótimo como você pode começar a definir - uma nova classe @Elevador@ e o Ruby simplesmente adiciona susas modificações na definição de classe já existente? - - - Métodos de classe são geralmente chamadaos com os *dois pontos duplos*. Mas, um ponto também serve. - Já que @Elevador@ é uma classe por si só, Ruby vai entender que se você chama @Elevador.senha_manutencao@, - você está chamando um método de classe. Os dois pontos duplo simplesmente ajudam a tornar métodos de classe óbvios - para o leitor. - - - And justly so. Métodos de classe são um pouco comuns. Normalmente você não quer guardar informação - diretamente dentro de uma classe. Contudo, se você tem um pedaço de informação que você precisa - compartilhar com todos os objetos de uma classe, ento você tem um bom motivo pra usar a classe como armazenamento. - É compreensível que a @@@senha_manutencao@ tenha sido armazenada na classe, invés de - cada objeto separado. Deste modo, O objeto pode simplismente alcançar a classe e ver a senha - compartilhada. - - - Provavelmente é assim que a proteção por senha funciona. - - - <pre> - class Elevador - def initialize( senha ) - raise AccessDeniedError, "senha incorreta" \ - unless senha.equals? @@senha_manutencao - end - end - </pre> - - - Proteger uma classe assim não faz sentido, já que tudo no Ruby pode ser alterado e - reescrito e remoldado. O Dr. Cham tinha a senha e agora o elevador era dele. - - - <pre> - irb> e = Elevador.new( "escadas_sao_passado!" ) - #<Elevador:0x81f12f4 @level=4> - irb> e.andar = 1 - </pre> - - - Dr. Cham estava parado lá quando as portas do elevador, atrás do terminal do computador, - se abriram pra ele. With an exasperated sense of accomplishment and a good deal of excitement - surrounding all of the events that lie ahead, ele entrou no elevador e apertou o 4. - - + - Um Castelo Tem Seus Computadores: > + + !i/dr.cham-3.jpg(The panoramic vales of Sedna on Endertromb.)! + + + Nosso intrépido Doutor partiu para o castelo alienígena, lançando-se sobre as flores. The ground belted + past his heels. The castle inched up the horizon. Ele gostaria de um cavalo, mas nenhum cavalo + apareceu. E foi assim que ele descobriu que o planeta não leria sua mente e não responderia seus + pedidos. + + + Porém, como o instrutor de órgão da minha filha havia me explicado, o planeta *podia ler mentes* e *podia + realizar desejos*. Só que não os dois ao mesmo tempo. + + + Um dia questionando o maestro de órgão, ele rascunhou o seguinte código Ruby numa folha + de papel cor-de-queijo. (E cheiros estranhos de queijo estão vindo de algum lugar, + eu não posso dizer onde.) + + + <pre> + require 'endertromb' + class FazedorPedidos + def initialize + @energia = rand( 6 ) + end + def realize( pedido ) + if pedido.length > 10 or pedido.include? ' ' + raise ArgumentError, "Pedido ruim." + end + if @energia.zero? + raise Exception, "Sem energia." + end + @energia -= 1 + Endertromb::realize( pedido ) + end + end + </pre> + + + Este é o fazedor de pedidos. + + + Na verdade, não, esta é a *definição de um fazedor de pedidos.* Para o Ruby, é uma *definição de classe*. + O código descreve como um certo *objeto* vai funcionar. + + + Cada manhã, o fazedor de pedidos arts out with up to five wishes available for granting. + Um novo @FazedorPedidos@ é criado quando o sol levanta. + + + <pre> + pedidos_do_dia = FazedorPedidos.new + </pre> + + + O método @new@ é um método de classe que um novo, objeto em branco. Ele também o chama o método + @initialize@ do objeto automaticamente. Na definição do @FazedorPedidos,@ você vai ver o método + @initialize@, que contém uma única linha de código: @@energia = rand( 6 )@. + + + O @rand( 6 )@ sorteia um número entre 0 e 5. Este número vai representar quantos pedidos + ainda restam no dia. Então, occasionalmente não haverão pedidos disponíveis do fazedor de + pedidos. + + + O número aleatório é dado à uma *variável de instância* de nome @@energia@. + Esta variável instância vai estar disponível a qualquer por entre a classe. A variável + não pode ser usada fora do *escopo* da classe. + + + No capítulo três, demos uma breve olhada em variáveis de instância e decidimos respeitá-las + como *atributos*. (O símbolo *arroba* poderia significar *atributo*.) Variáveis de instância podem + ser usadas para guardar qualquer tipo de informação, mas elas são mais usadas para se guardar pedaços + de informação sobre o objeto representado pela classe. + + + No caso acima, cada fazendor de pedidos para o dia tem seu próprio nível de energia. Se o fazendor de pedidos + fosse uma máquina, você talvez veria um medidor nele que marca a energia restante. + A variável de instância @@energia@ age como esse medidor. + + + <pre> + pedidos_do_dia = FazedorPedidos.new + pedidos_do_dia.realize( "galhada" ) + </pre> + + + Okay, volte um pouco e tenha certeza de entender o exemplo aqui. A classe @FazedorPedidos@ é a planta + que elaboramos para como toda a mágica dos pedidos funciona. Não é o _realmente_ o gênio na lâmpada, + é a papelada por trás das cenas. São as regras e obrigações em que o gênio vive. + + + O @pedidos_do_dia@ é o gênio da lâmpada. E aqui estamos dando um pedido pra a ser realizado. + Nos dê uma galhada, gênio. (Se você realmente arranjar uma galhada neste exemplo, eu nem quero saber. + Vá saltitar em campinas verdes com seus amigos.) + + + No capítulo anterior, o treinamento era: Ruby tem duas metades. + + + # Definindo coisas. + + # Colocando estas coisas em ação. + + + O que são as ações no Ruby? Métodos. E agora, você está provando a linguagem de definição + interna do Ruby. Definições de métodos usando @def@. Definições de classe usando @class@. + + + Neste ponto da sua instrução, é mais fácil entender que *tudo no Ruby é um objeto.* + + + <pre> + numero = 5 + print numero.next # imprime '6' + + frase = 'desejando uma galhada' + print frase.length # imprime '19' + + pedidos_do_dia = FazedorPedidos.new + pedidos_do_dia.grant( "galhada" ) + </pre> + + + E, consequentemente, cada objeto tem uma classe atrás da cortina. + + + <pre> + print 5.class # imprime 'Integer' + print 'desejando uma galhada'.class # imprime 'String' + print FazedorPedidos.new.class # imprime 'FazedorPedidos' + </pre> + + + Dr. Cham nunca viu o fazendor de pedidos enquanto desbravava a paisagem. + It lay far beyond his landing in the valley of Sedna. Down sheer cliffs + stuffed with layers of thicket, where you might toss your wish (written + on a small 1" x 6" slip), down into the gaping void. Hopefully it will + land on a lizard's back, sticking to its spindly little horn. + + + E digamos que seu pedido chegue lá. Well, then, _down the twisted wood_ goes + the skinny salamander, scurrying through the decaying churches which had been + *pushed* over that steep canyon ledge once and for all. And the expired priest inside, _who + weathered the fall_ as well, will kill the little amphibian -- strangle it + to death with a blessed gold chain -- and save it for the annual _Getting To + Know You_ breakfast. He'll step on your precious little wish and, when the + *thieves come*, that slip will still be there, stuck on his sole. Of course, + the thieves' *preferred method of torture* is to cut a priest in thin deli-shaved slices _from + top to bottom_. Who can cull evidence from that? And when they chop that last thin + slice of shoe sole, they'll have that *rubber scalp* in hand for _good luck_ and _good times_. + But they *canoe* much too hard, these thieves. They slap their paddles swiftly in the current + to get that great _outboard motor mist_ going. But the shoe sole is _on a weak chain_, tied + to one man s belt. And a *hairy old carp* _leaps, latches_ on to that minute fraction of + footwear. And the thieves _can try_, but they don't see _underwater_. If they could, they'd + see that *mighty cable*, packed with millions of _needly_ fiber optics. Indeed, *that fish is + a peripheral plugged* right into the _core workings_ of the planet Endertromb. *All it takes + is one swallow* from that fish *and your wish is home free!* + + + E é assim que os pedidos das crianças se realizam neste lugar. + + + Depois que o instrutor de órgão da minha filha ter desenhado a classe para o fazendor de pedidos, + ele continuou com uma classe para o leito de mentes do planeta. + + + <pre> + require 'endertromb' + class LeitorMental + def initialize + @mentes = Endertromb::procurar_por_consciencia + end + def read + @mentes.collect do |mente| + mente.read + end + end + end + </pre> + + + Como você já viu antes, o @initalize@ acontece quando um novo (new) objeto @LeitorMental@ é criado. + Este @initialize@ gathers scans the planet for mindshare. Parece que as mentes + estão guardadas em um array, já que há uma iteração nelas no final usando o método @collect.@ + + + Ambos o fazedor de pedidos e o leitor mental referem-se a uma classe chamada @Endertromb@. Esta classe está + guardada em um arquivo @endertromb.rb@, que é carregado com o código: @require 'endertromb'@. + Você vai, muitas vezes, usar outras classes para realizar parte da sua tarefa. Most of the latter half of this + book will explore the a grande variedade de classes úteis que podem ser carregadas no Ruby. + + + h3. Dr. Cham Arrisca Entrar + + + Mas assim que o Dr. Cham se aproximava do castelo, although the planet was aware of his thoughts, sensing his + wonderment and anticipation, all Dr. Cham felt was deadness. He tromped up the steps of its + open gate and through the entrance of the most beautiful architecture and was almost certain it + was deserted. + + + For a while he knocked. Which paid off. + + + !i/castle-1.jpg(Blocky whale greeting.)! + + + He watched the baby whale rise like a determined balloon. He marvelled at his first alien introduction + and felt some concern that it had passed so quickly. Well, he would wait inside. + + + Assim que ele entrou pela porta do castelo, se sentiu com sorte pela porta não ter sido atendida por + uma águia gigante com garras afiadas, ávida pra brincar. Ou um cabeça de rato gigante. Ou até mesmo um + furacão Or even a man-sized hurricane. Somente uma pequena baleia rechonchuda choo-choo. + + + "Not a place to sit down in this castle," he said. + + + À primeira vista, ele pensou ter entrado em um saguão escuro, mas assim que seus olhos se ajustaram, ele viu + que a entrada se extendia em um túnel. A porta do castelo seu abriu bem em uma passagem feita de pedaços + longos, e planos de rocha. Algumas partes eram congruentes e lembravam um corredor. Outras partes + eram estreitas, e até se inclinadas, o fim sumia de vista. + + + A passagem era iluminada por pequenas geladeiras sem portas, big enough to hold an armful of cabbage, + down by his feet. He peered inside one, which was hollow, illuminated along all sides, and + turning out ice shards methodically. + + + He pawed the ice chips, which clung dryly to his fingertips, and he scrubbed his hands in the + ice. Which left some muddy streaks on his hands, mas satisfez um pouco sua saudade de um banho. + Quanto tempo já fazia? Dez anos? Trinta? + + + Pela passagem, longos tubos de tecido lotavam algumas seções. Mais tarde, matéria brilhante feita de pixels em + vertedouros de porcelana e baldes. + + + Ele caiu em uma sala que havia sido escavada ao lado do túnel e nela haviam alguns cascos de tartaruga vazios + no chão e uma grande parede iluminada. He examinou a sala, perplexo. O que seria isso? + Por um instante, ele pensou em sentar em um casco. Isto poderia ser a entrada finalmente, algum + tipo de receiving room. Por outro lado, aranhas poderiam sair dos buracos dos cascos quando ele sentasse. + Ele seguiu viagem. + + + h3. Refeição no Bolso do Castelo + + + As he journeyed along the passageways (for the central tunnel forked and joined larger, vacuous caverns), he picked up + themes in some locations. Groups of rooms infested with pumping machinery. Cloth and vats of glue + dominated another area. He followed voices down a plush, pillowed cavity, which led him to a + dead end: a curved wall with a small room carved at eye-level. + + + Ele se aproximou da parede e, dentro do buraco quadrado, estavam dois porcos-da-terra comendendo à mesa. + + + Eles o encaram serenamente, ambos degustando um pouco de besouros escavados, que davam dois deles, abertos ao meio + e parados com as costas na mesa. + + + "Olá, bonequinhos," ele disse, e eles terminaram suas mordidas e ficaram olhando com seus garfos + held aloof. + + + "Eu queria que minha sobrinha Hannah estive aqui para conhecê-los," disse ele aos atenciosos porcos-da-terra. + "She'd think you were an intricate puppet show." He peered in at the dining area, shelves with sets of + plates, hand towels. Half of a tiny rabbit was jutting out from the top a machine, + creamy red noodles were spilling out underneath it. A door at the back of the room hung ajar. Dr. Cham could + see a flickering room with chairs and whirring motors through the door. + + + "Toda criança gostaria desta casa de bonecas," ele disse. "Hannah, minha sobrinha, como mencionei, she has + a wind-up doll that sits at a spindle and spins yarn. It's an illusion, of course. + The doll produces no yarn at all." + + + Um dos porcos-da-terra abriu um alçapão no chão e pressionou um botão ali, que se iluminou. + Então, um pequeno projetor de filme veio lentamente em rod. O outro porco-da-terra sentou e olhou o Dr. Cham. + + + "But Hannah still reaches down into the dollhouse and collects all the imaginary yarn into a + bundle. Which she takes to her mother, my sister, who is very good at humoring Hannah. + Ela costura um vestido no tamanho da boneca, o qual Hannah leva até a boneca. + + + "E ela diz à boneca, + 'Aqui, olhe, seu trabalho duro e perseverança resultaram neste lindo vestido. + Agora você pode aceitar o convite e acompanhar o Chefe de Polícia hoje à noite na Mansão + do Governador.' E ela tem uma boneca vestida de pocial que faz o papel do Chefe. + Ele é muito raquítico pra ser o Chefe de verdade, isso precisaria de um bom pedaço de plástico." + + + O porco-da-terra responsável pelo projetor o carregou com um rolo e o mirou na parede do + fundo. O filme começou e os porcos-da-terra se sentaram. Um quadrado verde apareceu na + parede. O atencioso porco-da-terra encarou o Dr. Cham parado. + + + "Seus filmes são coloridos," disse o Dr. Cham. "What a lovely, little life." + + + O filme exibido foi: um quadrado azul. Aí, um círculo vermelho. Aí, um quadrado laranja. Os atenciosos + porcos-da-terra se viraram, assistiram a tela virar um triângulo rosa, e ambos porcos-da-terra voltaram a comer. + + + Uma estrela roxa. Um quadrado vermelho. With quietness settling, Dr. Cham could hear notes droning + from the projector. Like a slow, plodding music box trying to roll its gears along the train + tracks. + + + "Sim, aproveitem o jantar," disse o Dr. Cham e educadamente se virou, marchando + de volta no caminho que ele tomara. + + + h3. Outra Rua Sem Saída Onde as Coisas Começam + + + Ele se encontrou perdido nos túneis do castelo. Nada parecia familiar. Todavia, ele não estava muito preocupado. + Ele estava noutro planeta. Ele estava perdido de qualquer maneira. + + + Ele se contorceu pelos túneis, tentando lembrar o caminho, mas muito mais interessado + em explorar para lembrar seus passos. Ele seguiu um único túnel profundamente, descendo, descendo, + ficou tão inclinado que ele tinha que pular entre as beiradas e cuidadosamente achar apoio para os pés. + A gravidade aqui não parecia ser diferente da Terra. Ele escorregava com a mesma facilidade. + + + Mesmo sem ter absolutamente nenhuma maneira de saber onde ele estava, ele tinha certeza de ter saído + dos limites do castelo. Esta profundidade, este tanto de caminhada. Já fazia uma hora desde que ele + adentrara a porta. E, as the tunnel wound back up, he was sure that he would + emerge into a new dwelling, perhaps even a manhole which he could peek out from and see + the castle. Talvez ele não devesse ter ido tão longe nessa rota. Ele espera que nada esteja + hibernando aqui emabaixo. + + + O túnel chegou ao fim. Um escuro, fim sem saída. + + + !i/dr.cham-4.gif(No fim dos túneis: um computador e um livro.)! + + + Ele tinha tempo. Então ele leu o livro. Ele leu sobre os raposos e sua perseguição ao porco-espinho que roubou + a caminhonete deles. Ele leu sobre o elfo e o presunto. Ele He saw the pictographs of himself and found he + could really relate to his own struggles. Ele até aprendeu Ruby. Ele viu como isso tudo termina. + + + Eu não teria estômago pra isso, no lugar dele. Mas ele teve. And he pledged in his bosom to see + things out just as they happened. + + + No monitor do computador, o Dr. Cham viu o prompt do @irb@ piscando. Assim como o Dr. Cham, você deve + reconhecer o prompt do @irb@ prompt do "A Roupa Do Tigre":expansion-pak-1.html + (o primeiro pacote de expansão deste livro, que inclui uma introdução básica ao IRB - Interactive Ruby.) + + + Assim como ele acabou de explorar os túneis a pé, agora ele explora as configurações da máquina com + a prompt. Ele colocou o livro onde o encontrou. Ele não precisava mais dele. This was + all going to happen whether he used it or not. + + + Ele começou com: + + + <pre> + irb> Object::constants + => ["Marshal", "String", "Dir", "LoadError", "Float", ... e por aí vai ] + </pre> + + + Este comando lista as constantes de nível mais alto. Classes são listadas como constantes também, + então esta lista é ótima pra ver o que está carregado no ruby a qualquer momento. + + + Ele examinou a lista procurando algo não familiar. Qualquer classe que não vem com o Ruby. + @Marshal@, @String@, @Dir@, @LoadError@, @Float@. Cada uma dessas vêm com o Ruby. + + + Mas um pouco pra baixo na lista: + + + <pre> + ... "Struct", "Values", "Time", "Elevador", "Range" ... + </pre> + + + _Elevador?_ Exatamente o tipo de classe a se bisbilhotar. He had a go. + + + <pre> + irb> Elevador::methods + => ["method", "freeze", "allocate", ... outra lista grande ... ] + irb> Elevador::class_variables + => ['@@relatorio_diagnostico', '@@circuito_eletrico_ativo', '@@senha_manutencao'] + irb> Elevador::constants + => [] + </pre> + + + Parece que a classe @Elevator@ tem um monte de métodos. A maioria deles parece + ser os mesmo métodos que todo objeto tem no Ruby. Por exemplo, + @method@, @freeze@ e @allocate@ vêm com toda classe no Ruby. (@Elevador::freeze@ + não deixaria que a classe @Elevator@ seja alterada. @Elevador::allocate@ criaria + um novo objeto @Elevator@ sem chamar o método @initialize.@) + + + As @class_variables@ foram interessantes pro Dr. Cham. Este elevador parece genuíno. + Mas sem @constantes@ disponíveis. Isso nos diz que não há classes aninhadas dentro + da classe @Elevator.@ + + + Ele tentou criar um objeto @Elevator.@ + + + <pre> + irb> e = Elevador::new + ArgumentError: wrong number of arguments (0 for 1), requires a password + from (irb):2:in `initialize' + from (irb):2:in `new' + from (irb):2 + from :0 + </pre> + + + Ele tentou algumas senhas. + + + <pre> + irb> e = Elevador::new( "pra cima" ) + AccessDeniedError: bad password + irb> e = Elevador::new( "subindo" ) + AccessDeniedError: bad password + irb> e = Elevador::new( "escadas_sao_terriveis" ) + AccessDeniedError: bad password + irb> e = Elevador::new( "EscadasSaoTerriveis" ) + AccessDeniedError: bad password + </pre> + + + Aqui foi inútil. _Oh, espere!_ A senha de manutenção. Listada nas @class_variables@. + + + <pre> + irb> Elevador::senha_manutencao + NoMethodError: undefined method `senha_manutencao' for Elevador:Class + from (irb):1 + from :0 + </pre> + + + Hmm. Variáveis de intância só estão disponíveis dentro de um objeto. E variáveis de classe só estão + disponíveis dentro de uma classe. Como conseguir aquela senha? + + + <pre> + irb> class Elevator + irb> def Elevador.senha_manutencao + irb> @@senha_manutencao + irb> end + irb> end + => nil + irb> Elevador::senha_manutencao + => "escadas_sao_passado!" + </pre> + + + Agora sim! Conseguimos a senha. Você viu aquilo? + + + Ele adicionou um método de classe à classe @Elevator.@ Não é ótimo como você pode começar a definir + uma nova classe @Elevador@ e o Ruby simplesmente adiciona susas modificações na definição de classe já existente? + + + Métodos de classe são geralmente chamadaos com os *dois pontos duplos*. Mas, um ponto também serve. + Já que @Elevador@ é uma classe por si só, Ruby vai entender que se você chama @Elevador.senha_manutencao@, + você está chamando um método de classe. Os dois pontos duplo simplesmente ajudam a tornar métodos de classe óbvios + para o leitor. + + + And justly so. Métodos de classe são um pouco comuns. Normalmente você não quer guardar informação + diretamente dentro de uma classe. Contudo, se você tem um pedaço de informação que você precisa + compartilhar com todos os objetos de uma classe, ento você tem um bom motivo pra usar a classe como armazenamento. + É compreensível que a @@@senha_manutencao@ tenha sido armazenada na classe, invés de + cada objeto separado. Deste modo, O objeto pode simplismente alcançar a classe e ver a senha + compartilhada. + + + Provavelmente é assim que a proteção por senha funciona. + + + <pre> + class Elevador + def initialize( senha ) + raise AccessDeniedError, "senha incorreta" \ + unless senha.equals? @@senha_manutencao + end + end + </pre> + + + Proteger uma classe assim não faz sentido, já que tudo no Ruby pode ser alterado e + reescrito e remoldado. O Dr. Cham tinha a senha e agora o elevador era dele. + + + <pre> + irb> e = Elevador.new( "escadas_sao_passado!" ) + #<Elevador:0x81f12f4 @level=4> + irb> e.andar = 1 + </pre> + + + Dr. Cham estava parado lá quando as portas do elevador, atrás do terminal do computador, + se abriram pra ele. With an exasperated sense of accomplishment and a good deal of excitement + surrounding all of the events that lie ahead, ele entrou no elevador e apertou o 4. + + lang-pt/poignant-42.yml @@ -1,49 +1,49 @@ - - !^sidebar - Uma noite de voltagem desobstruída: > - - Eu desenterrei esse artigo do _The Consistent Reminder_, um jornal de Connecticut - que deu quatro estrelas na resenha do Dr. Cham. Midgie Dare, a resenhista do livro - que subitamente extendeu seu olhar crítico a qualquer coisa tangível, elogiou ou Doutor por suas - maneiras e inovações na mesma edição diária em que ela difamou melão e diminuiu - Manitoba por ter um péssimo serviço telefônico. - - - Eu consegui um pedaço do final do artigo dela. Aqui vai. - - - bq. Ele desmontou do cavalo com um cuidado inquestionável por qualquer um - que estivesse nas redondezas. Cortês de todos os lados, ele desceu da sela - gentilmente, desacelerando para um ritmo que deveria ser medido em micrometros - por segundo para ser apreciado. - - - bq. Seus companheiros entre nós - ficaram de boca aberta, assistindo sua bota tocar o chão. - Um passo tão limpo e preciso que parecia que jamais iria encontrar o solo, - apenas deslizar suavemente sobre ele. Então, antes que a aterrissagem - fosse notada por nós, estávamos indo para a cozinha, levados - pela onda de felicidade que sempre estava logo a frente de Harold Cham, - e sempre logo atrás dele, e especialmente concentrada diretamente - no seu próprio ser iluminado. - - - bq. Ele também carregava livremente ao seu lado a filha especialmente ignorante de um - estadista, que não nos deixava em paz com suas constantes críticas aos ateístas - e rotas ferroviárias. - - - bq. "Em casa, meus esforços para acender uma vela foram inúteis graças - a novos abalos causados por trens, que jogavam o fósforo na minha mão para perto das cortinas!" - Ela ridicularizou o Dr. Cham por seu agarre suave no braço dela - e sentiu ciúmes quando ele conseguiu sintonizar uma voz feminina agradável - no rádio logo que eles voltaram para sua residência. - - - bq. O sol se pôs, entretanto, e nós nos vimos em um deslumbre comunal embaixo de - grossas partículas de algodão que flutuavam pela sala do piano, um tanto - entretidos pelo _Programa Soneca da Tarde_, que tocava na vitrola com o volume - tão baixo na estação que nós só conseguíamos ouvir o arrastar das mangas - do finado Napoleão pelos lencóis. Eu senti um calafrio dentro de mim só de pensar! - Ainda assim, em cadeiras distantes, os dois amantes mantinham uma distância abrupta entre eles - e eu me senti cercado pelo olhar acalentador do Dr. Cham enquanto bebia jocosamente sua taça de xerez. - + - !^sidebar + Uma noite de voltagem desobstruída: > + + Eu desenterrei esse artigo do _The Consistent Reminder_, um jornal de Connecticut + que deu quatro estrelas na resenha do Dr. Cham. Midgie Dare, a resenhista do livro + que subitamente extendeu seu olhar crítico a qualquer coisa tangível, elogiou ou Doutor por suas + maneiras e inovações na mesma edição diária em que ela difamou melão e diminuiu + Manitoba por ter um péssimo serviço telefônico. + + + Eu consegui um pedaço do final do artigo dela. Aqui vai. + + + bq. Ele desmontou do cavalo com um cuidado inquestionável por qualquer um + que estivesse nas redondezas. Cortês de todos os lados, ele desceu da sela + gentilmente, desacelerando para um ritmo que deveria ser medido em micrometros + por segundo para ser apreciado. + + + bq. Seus companheiros entre nós + ficaram de boca aberta, assistindo sua bota tocar o chão. + Um passo tão limpo e preciso que parecia que jamais iria encontrar o solo, + apenas deslizar suavemente sobre ele. Então, antes que a aterrissagem + fosse notada por nós, estávamos indo para a cozinha, levados + pela onda de felicidade que sempre estava logo a frente de Harold Cham, + e sempre logo atrás dele, e especialmente concentrada diretamente + no seu próprio ser iluminado. + + + bq. Ele também carregava livremente ao seu lado a filha especialmente ignorante de um + estadista, que não nos deixava em paz com suas constantes críticas aos ateístas + e rotas ferroviárias. + + + bq. "Em casa, meus esforços para acender uma vela foram inúteis graças + a novos abalos causados por trens, que jogavam o fósforo na minha mão para perto das cortinas!" + Ela ridicularizou o Dr. Cham por seu agarre suave no braço dela + e sentiu ciúmes quando ele conseguiu sintonizar uma voz feminina agradável + no rádio logo que eles voltaram para sua residência. + + + bq. O sol se pôs, entretanto, e nós nos vimos em um deslumbre comunal embaixo de + grossas partículas de algodão que flutuavam pela sala do piano, um tanto + entretidos pelo _Programa Soneca da Tarde_, que tocava na vitrola com o volume + tão baixo na estação que nós só conseguíamos ouvir o arrastar das mangas + do finado Napoleão pelos lencóis. Eu senti um calafrio dentro de mim só de pensar! + Ainda assim, em cadeiras distantes, os dois amantes mantinham uma distância abrupta entre eles + e eu me senti cercado pelo olhar acalentador do Dr. Cham enquanto bebia jocosamente sua taça de xerez. + lang-pt/poignant-43.yml @@ -1,327 +1,327 @@ - - A Continuação da História do Instrutor de Órgão da Minha Filha: > - - Eu sei que você pode estar surpreso em saber que eu tenho uma filha. Você pensa que meu estilo - de escrita indica uma mente imatura ou infantil. Bem, por favor relaxe. Eu não tenho uma filha. - Mas isso não me impede de pensar no treinamento musical dela. - - - Enquanto essas histórias do planeta Endertromb eram relatadas a mim, eu me vi vagando - por corredores, passando as pontas dos meus dedos por sofás fortemente abotoados - e me envolvendo nos gritos saturados dos tubos, enquanto o instrutor de órgão da minha filha - tocava. Suas notas ressoavam tão ocas e profundas nas paredes de sua mansão - que eu comecei a confundí-las com um silêncio nefasto, e achava ainda mais fácil - me recolher ao espaço infinito dos meus pensamentos. Para pensar no planeta ancestral - e suas filosofias obscuras: seus templos carnais, corados com os resíduos dérmicos - dos seus mártires; seus cartéis de baleias, engolindo seus inimigos e prendendo-os por - décadas, arrastando-os para cima e para baixo em suas escadarias de costelas; suas brumas venenosas e - seus portais dolorosos; e, as cruéis dinastias - dos Originais, a espécie que clama paternidade de toda vida inteligente no universo. - - - Mas, eventualmente, eu ouvia aqueles tubos de oitavas mais altas cantar e acabava voltando - para a mesma tarde jovial de onde havia saído. - - - É interessante como até a brisa do nosso planeta é uma coisa um tanto estranha para - forasteiros. Ele também me contou sobre viajantes de Rath-d, que se aventuraram na Terra - cinco séculos atrás, mas se dissiparam rapidamente nas nossas correntes de ar já que eles, seus equipamentos e - sua armadura eram todos feitos de carvão. - - - Eu tinha me sentado ao órgão, ouvindo as histórias sobre sua colônia, enquanto ele acentuava suas - sinfonias e as histórias desapareciam por um tempo, até que a melodia terminasse. - Ele falava sobre ele e seus irmãos sendo abraçados pela cauda de sua mãe e arrancando - o tecido macio da parede interna. Um sabão suculento, esponjoso e melado que limpou - suas bocas e esôfagos enquanto descia. Eles mastigaram fortemente aquilo e espuma se formava. - Depois de comer, eles sopraram bolhas uns sobre os outros, cada bolha cheia de uma espuma densa, - sobre a qual eles dormiram. E de manhã bem cedo, quando a mãe os soltava do abraço, ela observava - serenamente enquanto seus bebês dormiam em um ensopado de bolas de carne escuras e um molho doce e grudento. - - - Ele soletrou todos os gostos de Endertromb. Dos seus órgãos cor de salmão engomados, que se tornavam - uma pasta quando cozidos, e seus olhos que derretiam e viravam um rico creme. Das suas manteigocias com tentáculos. - E ele estava apenas começando a apreciar essas delícias, ainda criança, para ser elevado de um - jardim de infância por um par de elefantes pigmeus que desçeram um enorme guindaste dos céus, e o ergueram - pela gola. - - - Eles o transplantaram para a Terra, o guiaram em seu ofício, tompeteando suas trombas alto para a cidade de - Grand Rapids ouvir, então se foram, chorando e abraçando uns aos outros. - - - "Mas, estranhamente (em-pithy-dah), Eu aprendi, toquei (pon-shoo) nos órgãos no meu planeta - (oth-rea) natal," ele disse. - - - O instrutor de órgão da minha filha fala essas palavras extras que você vê em parênteses. Quem é - que sabe se é sua língua nativa ou seu soluço sonoro. Ele mantém outro - traço de Endertromb: ele tem doze nomes. - - - "Não, (wen-is-wen)," ele disse. "Eu tenho um nome (im-apalla) que é dito (iff) - de muitas-muitas maneiras difentes." - - - Eu o chamo de Paij-ree nas manhãs e Paij-plo de tarde. - Já que estou escrevendo de dia, o chamarei de Paij-ree aqui. - - - h3. Protetores de Ouvido Múrmurio-Free - - - !>i/my.daughters.organ-1.gif(Alien at the keys.)! - - - Então eu disse a Paij-ree, "Paij-ree, eu estou escrevendo um livro. Para ensinar ao mundo Ruby." - - - "Oh, (pill-nog-pill-yacht) bacana," ele disse. Ele conhece Ruby há mais tempo que eu, mas mesmo assim: - _Eu_ serei o instrutor de Ruby da minha filha. - - - E eu disse, "Paij-ree, você está no livro. E as estórias do seu planeta." Eu falo com ele como - se ele fosse o E.T. Eu não sei porquê. Como o que disse em seguida, "E daí talvez algum dia - você possa ir pra casa pro seu pai e pra sua mãe!" - - - Ele replicou, "(pon-shoo) (pon-shoo) (em-pithy-dah)." Que é o jeito dele de expressar em voz alta - seu silêncio e medo. - - - Ele queria ver o que eu havia escrito, então eu mostrei a ele este pequeno método que escrevi pra você. - - - <pre> - def limpar_murmurios_de( frase ) - while frase.include? '(' - abre = frase.index( '(' ) - fecha = frase.index( ')', abre ) - frase[abre..fecha] = '' if fecha - end - end - </pre> - - - "Viu o que isto faz, Paij-ree? Qualquer Smotchkkiss velho pode usar este método - pra remover todas as o take all the incoherent babblings out of your speaking," I said. - - - E eu alimentei o método com algo que ele havia dito mais cedo. - - - <pre> - o_que_ele_disse = "Mas, estranhamente (em-pithy-dah), - Eu aprendi, toquei (pon-shoo) em órgãos no meu planeta - (oth-rea) natal." - limpar_murmurios_de( o_que_ele_disse ) - print o_que_ele_disse - </pre> - - - E saiu de certa forma uma frase mais clara. - - - <pre> - Mas, estranhamente , - Eu aprendi, toquei em órgãos no meu planeta - natal. - </pre> - - - "Você não deveria usar este (wary-to) loop while," ele disse. "Existem jeitos mais amáveis, (thopt-er), - e gentis." - - - No método @limpar_murmurios_de@, estou basicamente procurando por abre parênteses. Quando eu - encontrou um, eu procuro um fecha parênteses na sequencia. Uma vez que tenha encontrado ambos, eu troco - eles e seu conteúdo por uma string vazia. O loop @while@ continua até que todos os parênteses se acabem. - Os murmúrios são removidos e o método termina. - - - "Agora olhando este método," eu disse. "Eu vejo que há alguns aspectos confusos - e outras coisas que eu poderia ter feito melhor." Por favor não me olhe estranho por seu professor - ter escrito este código. Eu acho certo the mostrar algumas técnicas sloppy techniques - pra te ajudar to help you work through them with me. Então vamos. - - - Okay, *Aspecto confuso No. 1*: Este método limpa uma string. Mas e se nós acidentalmente - dermos a ele um @File@? Ou um número? O que acontece? E se rodarmos @limpar_murmurios_de( 1 )@? - - - Se nós dermos ao @limpar_murmurios_de@ o número 1, o Ruby irá imprimir o seguinte e depois sair. - - - <pre> - NoMethodError: undefined method `include?' for 1:Fixnum - from (irb):2:in `limpar_murmurios_de' - from (irb):8 - </pre> - - - O que você vê aqui ere is a rather twisted and verbose (mas noutras vezes muito útil) amiguinho - chamado de o *depurador*. He's a wound-up policeman who, ao menor sinal de problema, - imediatamente apreende todo e qualquer suspeito, os põe contra a parede e lê os direitos deles - tão rapidamente que ninguém consegue ouvir tudo. Mas está claro que há um problema. - E, é claro, tudo não passou de um mal entendido, certo? - - - Quando o Ruby ler pra você esses direitos de Miranda, preste atenção no começo. A primeira linha - é quase sempre tudo que você precisa. Nessa primeira linha está contido a mensagem essencial. E ali - em cima, a primeira linha está nos dizendo que não há método @include?@ para o número 1. - Lembra, quando estávamos conversando sobre o método @reverse@ no capítulo anterior? Naquela hora, eu disse, - "*vários métodos só estão disponíveis com certos tipos de valores*." Ambos @reverse@ e - @include?@ são métodos que funcionam com strings mas são sem sentido e indisponíveis para números. - - - Pra deixar claro: o método tenta usar o número. O método vai iniciar com @frase@ valendo 1. - Então, ele chega na segunda linha: @while frase.include? '('@. Números não têm método @include?@. - Maravilha, o depurador nos mostrou onde o problema está. Eu não esperava que alguém fosse passar - um número, então estou usando métodos que não funcionam com números. - - - *Viu, é só isso.* Nosso método é seu próprio bolso de ferramentas, certo? Ele age como seu próprio - widget independente de todo o resto. Pra todos por aí usando o método @limpar_murmurios_de@, - se eles passarem um número, será atirado pra eles esta mensagem de pânico que não faz - sentido pra eles. Eles serão convidados a bisbilhotar o método, o que realmente não é - trabalho deles. Eles não sabem como se virar lá dentro. - - - Felizmente, nós podemos inserir nossos próprios erros, nossas próprias *exceções*, o que pode fazer mais - sentido a algum desavisado que dê um objeto errado pra ser limpo. - - - <pre> - def limpar_murmurios_de( frase ) - unless frase.respond_to? :include? - raise ArgumentError, - "não posso limpar os múrmurios de um(a) #{ frase.class }" - end - while frase.include? '(' - abre = frase.index( '(' ) - fecha = frase.index( ')', abre ) - frase[abre..fecha] = '' if fecha - end - end - </pre> - - - Desta vez, se passarmos um número (de novo, o número 1), teremos algo mais sensato. - - - <pre> - ArgumentError: não posso limpar os múrmurios de um(a) Fixnum - from (irb):3:in `limpar_murmurios_de' - from (irb):12 - </pre> - - - O método @respond_to?@ é realmente bacana e eu imploro que você nunca se esqueça dele. - O @respond_to?@ checa qualquer objeto para garantir que nele contém um determinado método. Ele então retorna - com @true@ o @false@. No caso acima, é checado se o objeto @frase@ recebido contém algum método - @include?@. Se nenhum método @include?@ for encontrado, então causamos o erro. - - - Você deve estar pensando por que eu usei um símbolo com o @respond_to?@. Eu usei um símbolo @:include?@ - invés da string @'include?'@. Na verdade, ambos funcionarão com o @respond_to?@. - - - Geralmente símbolos são usados quando você está passando o nome de um método ou qualquer outro construtor. - É mais eficiente, chama mais atenção. O @respond_to?@ pergunta ao Ruby to look inside itself - and see if a method is available. Estamos conversando com o Ruby, então o símbolo helps denote that. - Não é grande coisa, Ruby só reconhece símbolos mais rapidamente que strings. - - - Agora, *Aspecto Confuso No. 2*: Você notou como nosso método modifica a frase? - - - <pre> - algo_dito = "Uma (gith) espaçonave." - limpar_murmurios_de( algo_dito ) - print algo_dito - </pre> - - - Você notou isso? Na primeira linha do código acima, a variável @algo_dito@ - contém a string @"Uma espaçonave (gith)."@. Mas, depois de invocar o método, na terceira - linha, nós imprimimos a variável @algo_dito@ e nesse momemento ela contém a string limpa - string @"Uma espaçonave."@. - - - Como isso funciona? Como o método modifica a string? Ele não deveria fazer uma cópia - da string antes de modificá-la? - - - Sim, absolutamente, ele deveria! *É falta de educação modificar strings daquele jeito.* Nós usamos @gsub@ e - @gsub!@ no capítulo passado. Você se lembra qual destes dois métodos é um *método destrutivo*, - que modifica strings diretamente? - - - Ou nós chamamos este método de @limpar_murmurios_de!@ (cortesia a todos os colegas bacanas - por aí que podem vir a usar este método) ou modificar o método para trabalhar em uma cópia - da string invés da coisa real. O que é uma modificação muito fácil! Nós só precisamos dar - um @dup@ na string. - - - <pre> - def limpar_murmurios_de( frase ) - unless frase.respond_to? :include? - raise ArgumentError, - "não posso limpar os múrmurios de um(a) #{ frase.class }" - end - frase = frase.dup - while frase.include? '(' - abre = frase.index( '(' ) - fecha = frase.index( ')', abre ) - frase[abre..fecha] = '' if fecha - end - frase - end - </pre> - - - O método @dup@ faz uma cópia de qualquer objeto. Veja a linha que adicionamos separada: - - - <pre> - frase = frase.dup - </pre> - - - Que linha de código peculiar. Como que @frase@ vira uma cópia de @frase@? - Ela se apaga? O que acontece com a @frase@ original? Ela desaparece? - - - Lembre que variáveis são como apelidos. Quando você vê @frase = "Uma (gith) espaçonave."@, - você o Ruby criando uma string e então dando um apelido a essa string. - - - Do mesmo modo, quando você vê @frase = frase.dup@, você ve o Ruby criando uma nova string e então - dando um apelido a essa string. Iso é útil dentro do seu método porque agora @frase@ é - um pelido para uma nova cópia da string que você pode usar seguramente *sem modificar a string - que foi passada pro método*. - - - Você vai ver muitos exemplos de nomes de variáveis seudo reusados. - - - <pre> - x = 5 - x = x + 1 - # x agora é igual a 6 - - y = "Endertromb" - y = y.length - # y agora é igual a 10 - - z = :include? - z = "a string".respond_to? z - # z agora é igual a true - </pre> - - - E, sim, algumas vezes objetos desaparecem. *Se você não consege pegar um objeto por uma váriavel, então - o Ruby vai entender que você já terminou com ele e vai se livrar dele.* Periodicamente, o Ruby envia seu - *garbage collector (coletor de lixo)* pra libertar estes objetos. Todo objeto é mantido na memória do - seu computador até que o coletor de lixo se livre dele. - - + - A Continuação da História do Instrutor de Órgão da Minha Filha: > + + Eu sei que você pode estar surpreso em saber que eu tenho uma filha. Você pensa que meu estilo + de escrita indica uma mente imatura ou infantil. Bem, por favor relaxe. Eu não tenho uma filha. + Mas isso não me impede de pensar no treinamento musical dela. + + + Enquanto essas histórias do planeta Endertromb eram relatadas a mim, eu me vi vagando + por corredores, passando as pontas dos meus dedos por sofás fortemente abotoados + e me envolvendo nos gritos saturados dos tubos, enquanto o instrutor de órgão da minha filha + tocava. Suas notas ressoavam tão ocas e profundas nas paredes de sua mansão + que eu comecei a confundí-las com um silêncio nefasto, e achava ainda mais fácil + me recolher ao espaço infinito dos meus pensamentos. Para pensar no planeta ancestral + e suas filosofias obscuras: seus templos carnais, corados com os resíduos dérmicos + dos seus mártires; seus cartéis de baleias, engolindo seus inimigos e prendendo-os por + décadas, arrastando-os para cima e para baixo em suas escadarias de costelas; suas brumas venenosas e + seus portais dolorosos; e, as cruéis dinastias + dos Originais, a espécie que clama paternidade de toda vida inteligente no universo. + + + Mas, eventualmente, eu ouvia aqueles tubos de oitavas mais altas cantar e acabava voltando + para a mesma tarde jovial de onde havia saído. + + + É interessante como até a brisa do nosso planeta é uma coisa um tanto estranha para + forasteiros. Ele também me contou sobre viajantes de Rath-d, que se aventuraram na Terra + cinco séculos atrás, mas se dissiparam rapidamente nas nossas correntes de ar já que eles, seus equipamentos e + sua armadura eram todos feitos de carvão. + + + Eu tinha me sentado ao órgão, ouvindo as histórias sobre sua colônia, enquanto ele acentuava suas + sinfonias e as histórias desapareciam por um tempo, até que a melodia terminasse. + Ele falava sobre ele e seus irmãos sendo abraçados pela cauda de sua mãe e arrancando + o tecido macio da parede interna. Um sabão suculento, esponjoso e melado que limpou + suas bocas e esôfagos enquanto descia. Eles mastigaram fortemente aquilo e espuma se formava. + Depois de comer, eles sopraram bolhas uns sobre os outros, cada bolha cheia de uma espuma densa, + sobre a qual eles dormiram. E de manhã bem cedo, quando a mãe os soltava do abraço, ela observava + serenamente enquanto seus bebês dormiam em um ensopado de bolas de carne escuras e um molho doce e grudento. + + + Ele soletrou todos os gostos de Endertromb. Dos seus órgãos cor de salmão engomados, que se tornavam + uma pasta quando cozidos, e seus olhos que derretiam e viravam um rico creme. Das suas manteigocias com tentáculos. + E ele estava apenas começando a apreciar essas delícias, ainda criança, para ser elevado de um + jardim de infância por um par de elefantes pigmeus que desçeram um enorme guindaste dos céus, e o ergueram + pela gola. + + + Eles o transplantaram para a Terra, o guiaram em seu ofício, tompeteando suas trombas alto para a cidade de + Grand Rapids ouvir, então se foram, chorando e abraçando uns aos outros. + + + "Mas, estranhamente (em-pithy-dah), Eu aprendi, toquei (pon-shoo) nos órgãos no meu planeta + (oth-rea) natal," ele disse. + + + O instrutor de órgão da minha filha fala essas palavras extras que você vê em parênteses. Quem é + que sabe se é sua língua nativa ou seu soluço sonoro. Ele mantém outro + traço de Endertromb: ele tem doze nomes. + + + "Não, (wen-is-wen)," ele disse. "Eu tenho um nome (im-apalla) que é dito (iff) + de muitas-muitas maneiras difentes." + + + Eu o chamo de Paij-ree nas manhãs e Paij-plo de tarde. + Já que estou escrevendo de dia, o chamarei de Paij-ree aqui. + + + h3. Protetores de Ouvido Múrmurio-Free + + + !>i/my.daughters.organ-1.gif(Alien at the keys.)! + + + Então eu disse a Paij-ree, "Paij-ree, eu estou escrevendo um livro. Para ensinar ao mundo Ruby." + + + "Oh, (pill-nog-pill-yacht) bacana," ele disse. Ele conhece Ruby há mais tempo que eu, mas mesmo assim: + _Eu_ serei o instrutor de Ruby da minha filha. + + + E eu disse, "Paij-ree, você está no livro. E as estórias do seu planeta." Eu falo com ele como + se ele fosse o E.T. Eu não sei porquê. Como o que disse em seguida, "E daí talvez algum dia + você possa ir pra casa pro seu pai e pra sua mãe!" + + + Ele replicou, "(pon-shoo) (pon-shoo) (em-pithy-dah)." Que é o jeito dele de expressar em voz alta + seu silêncio e medo. + + + Ele queria ver o que eu havia escrito, então eu mostrei a ele este pequeno método que escrevi pra você. + + + <pre> + def limpar_murmurios_de( frase ) + while frase.include? '(' + abre = frase.index( '(' ) + fecha = frase.index( ')', abre ) + frase[abre..fecha] = '' if fecha + end + end + </pre> + + + "Viu o que isto faz, Paij-ree? Qualquer Smotchkkiss velho pode usar este método + pra remover todas as o take all the incoherent babblings out of your speaking," I said. + + + E eu alimentei o método com algo que ele havia dito mais cedo. + + + <pre> + o_que_ele_disse = "Mas, estranhamente (em-pithy-dah), + Eu aprendi, toquei (pon-shoo) em órgãos no meu planeta + (oth-rea) natal." + limpar_murmurios_de( o_que_ele_disse ) + print o_que_ele_disse + </pre> + + + E saiu de certa forma uma frase mais clara. + + + <pre> + Mas, estranhamente , + Eu aprendi, toquei em órgãos no meu planeta + natal. + </pre> + + + "Você não deveria usar este (wary-to) loop while," ele disse. "Existem jeitos mais amáveis, (thopt-er), + e gentis." + + + No método @limpar_murmurios_de@, estou basicamente procurando por abre parênteses. Quando eu + encontrou um, eu procuro um fecha parênteses na sequencia. Uma vez que tenha encontrado ambos, eu troco + eles e seu conteúdo por uma string vazia. O loop @while@ continua até que todos os parênteses se acabem. + Os murmúrios são removidos e o método termina. + + + "Agora olhando este método," eu disse. "Eu vejo que há alguns aspectos confusos + e outras coisas que eu poderia ter feito melhor." Por favor não me olhe estranho por seu professor + ter escrito este código. Eu acho certo the mostrar algumas técnicas sloppy techniques + pra te ajudar to help you work through them with me. Então vamos. + + + Okay, *Aspecto confuso No. 1*: Este método limpa uma string. Mas e se nós acidentalmente + dermos a ele um @File@? Ou um número? O que acontece? E se rodarmos @limpar_murmurios_de( 1 )@? + + + Se nós dermos ao @limpar_murmurios_de@ o número 1, o Ruby irá imprimir o seguinte e depois sair. + + + <pre> + NoMethodError: undefined method `include?' for 1:Fixnum + from (irb):2:in `limpar_murmurios_de' + from (irb):8 + </pre> + + + O que você vê aqui ere is a rather twisted and verbose (mas noutras vezes muito útil) amiguinho + chamado de o *depurador*. He's a wound-up policeman who, ao menor sinal de problema, + imediatamente apreende todo e qualquer suspeito, os põe contra a parede e lê os direitos deles + tão rapidamente que ninguém consegue ouvir tudo. Mas está claro que há um problema. + E, é claro, tudo não passou de um mal entendido, certo? + + + Quando o Ruby ler pra você esses direitos de Miranda, preste atenção no começo. A primeira linha + é quase sempre tudo que você precisa. Nessa primeira linha está contido a mensagem essencial. E ali + em cima, a primeira linha está nos dizendo que não há método @include?@ para o número 1. + Lembra, quando estávamos conversando sobre o método @reverse@ no capítulo anterior? Naquela hora, eu disse, + "*vários métodos só estão disponíveis com certos tipos de valores*." Ambos @reverse@ e + @include?@ são métodos que funcionam com strings mas são sem sentido e indisponíveis para números. + + + Pra deixar claro: o método tenta usar o número. O método vai iniciar com @frase@ valendo 1. + Então, ele chega na segunda linha: @while frase.include? '('@. Números não têm método @include?@. + Maravilha, o depurador nos mostrou onde o problema está. Eu não esperava que alguém fosse passar + um número, então estou usando métodos que não funcionam com números. + + + *Viu, é só isso.* Nosso método é seu próprio bolso de ferramentas, certo? Ele age como seu próprio + widget independente de todo o resto. Pra todos por aí usando o método @limpar_murmurios_de@, + se eles passarem um número, será atirado pra eles esta mensagem de pânico que não faz + sentido pra eles. Eles serão convidados a bisbilhotar o método, o que realmente não é + trabalho deles. Eles não sabem como se virar lá dentro. + + + Felizmente, nós podemos inserir nossos próprios erros, nossas próprias *exceções*, o que pode fazer mais + sentido a algum desavisado que dê um objeto errado pra ser limpo. + + + <pre> + def limpar_murmurios_de( frase ) + unless frase.respond_to? :include? + raise ArgumentError, + "não posso limpar os múrmurios de um(a) #{ frase.class }" + end + while frase.include? '(' + abre = frase.index( '(' ) + fecha = frase.index( ')', abre ) + frase[abre..fecha] = '' if fecha + end + end + </pre> + + + Desta vez, se passarmos um número (de novo, o número 1), teremos algo mais sensato. + + + <pre> + ArgumentError: não posso limpar os múrmurios de um(a) Fixnum + from (irb):3:in `limpar_murmurios_de' + from (irb):12 + </pre> + + + O método @respond_to?@ é realmente bacana e eu imploro que você nunca se esqueça dele. + O @respond_to?@ checa qualquer objeto para garantir que nele contém um determinado método. Ele então retorna + com @true@ o @false@. No caso acima, é checado se o objeto @frase@ recebido contém algum método + @include?@. Se nenhum método @include?@ for encontrado, então causamos o erro. + + + Você deve estar pensando por que eu usei um símbolo com o @respond_to?@. Eu usei um símbolo @:include?@ + invés da string @'include?'@. Na verdade, ambos funcionarão com o @respond_to?@. + + + Geralmente símbolos são usados quando você está passando o nome de um método ou qualquer outro construtor. + É mais eficiente, chama mais atenção. O @respond_to?@ pergunta ao Ruby to look inside itself + and see if a method is available. Estamos conversando com o Ruby, então o símbolo helps denote that. + Não é grande coisa, Ruby só reconhece símbolos mais rapidamente que strings. + + + Agora, *Aspecto Confuso No. 2*: Você notou como nosso método modifica a frase? + + + <pre> + algo_dito = "Uma (gith) espaçonave." + limpar_murmurios_de( algo_dito ) + print algo_dito + </pre> + + + Você notou isso? Na primeira linha do código acima, a variável @algo_dito@ + contém a string @"Uma espaçonave (gith)."@. Mas, depois de invocar o método, na terceira + linha, nós imprimimos a variável @algo_dito@ e nesse momemento ela contém a string limpa + string @"Uma espaçonave."@. + + + Como isso funciona? Como o método modifica a string? Ele não deveria fazer uma cópia + da string antes de modificá-la? + + + Sim, absolutamente, ele deveria! *É falta de educação modificar strings daquele jeito.* Nós usamos @gsub@ e + @gsub!@ no capítulo passado. Você se lembra qual destes dois métodos é um *método destrutivo*, + que modifica strings diretamente? + + + Ou nós chamamos este método de @limpar_murmurios_de!@ (cortesia a todos os colegas bacanas + por aí que podem vir a usar este método) ou modificar o método para trabalhar em uma cópia + da string invés da coisa real. O que é uma modificação muito fácil! Nós só precisamos dar + um @dup@ na string. + + + <pre> + def limpar_murmurios_de( frase ) + unless frase.respond_to? :include? + raise ArgumentError, + "não posso limpar os múrmurios de um(a) #{ frase.class }" + end + frase = frase.dup + while frase.include? '(' + abre = frase.index( '(' ) + fecha = frase.index( ')', abre ) + frase[abre..fecha] = '' if fecha + end + frase + end + </pre> + + + O método @dup@ faz uma cópia de qualquer objeto. Veja a linha que adicionamos separada: + + + <pre> + frase = frase.dup + </pre> + + + Que linha de código peculiar. Como que @frase@ vira uma cópia de @frase@? + Ela se apaga? O que acontece com a @frase@ original? Ela desaparece? + + + Lembre que variáveis são como apelidos. Quando você vê @frase = "Uma (gith) espaçonave."@, + você o Ruby criando uma string e então dando um apelido a essa string. + + + Do mesmo modo, quando você vê @frase = frase.dup@, você ve o Ruby criando uma nova string e então + dando um apelido a essa string. Iso é útil dentro do seu método porque agora @frase@ é + um pelido para uma nova cópia da string que você pode usar seguramente *sem modificar a string + que foi passada pro método*. + + + Você vai ver muitos exemplos de nomes de variáveis seudo reusados. + + + <pre> + x = 5 + x = x + 1 + # x agora é igual a 6 + + y = "Endertromb" + y = y.length + # y agora é igual a 10 + + z = :include? + z = "a string".respond_to? z + # z agora é igual a true + </pre> + + + E, sim, algumas vezes objetos desaparecem. *Se você não consege pegar um objeto por uma váriavel, então + o Ruby vai entender que você já terminou com ele e vai se livrar dele.* Periodicamente, o Ruby envia seu + *garbage collector (coletor de lixo)* pra libertar estes objetos. Todo objeto é mantido na memória do + seu computador até que o coletor de lixo se livre dele. + + lang-pt/poignant-44.yml @@ -1,18 +1,18 @@ - - !^sidebar - Tirado de Os Comedores de Cachecóis: > - - (_from Chapter VII: When Push Comes to Shove -- or Love_.) - - - "Nunca diga meu nome de novo!" gritou Chester, e com o mesmo entusiasmo, ele voltou para a - tela de diálogo *Arquivo > Configurar Publicação...* para otimizar mais ainda seu filme até - meros 15k. - - -# Mrs. Cothway appeared in the vaulted entry way with three elegant Arabian horses, -# but Woody refused to look away from his Vaio and shaved another 6k off his movie. -# -# -# And so she cantered with them to the laundry room entrace, which was fatal for each of the mares, as -# young Annabelle fed them too much 7-Up and Earmuffs. - + - !^sidebar + Tirado de Os Comedores de Cachecóis: > + + (_from Chapter VII: When Push Comes to Shove -- or Love_.) + + + "Nunca diga meu nome de novo!" gritou Chester, e com o mesmo entusiasmo, ele voltou para a + tela de diálogo *Arquivo > Configurar Publicação...* para otimizar mais ainda seu filme até + meros 15k. + + +# Mrs. Cothway appeared in the vaulted entry way with three elegant Arabian horses, +# but Woody refused to look away from his Vaio and shaved another 6k off his movie. +# +# +# And so she cantered with them to the laundry room entrace, which was fatal for each of the mares, as +# young Annabelle fed them too much 7-Up and Earmuffs. + lang-pt/poignant-45.yml @@ -1,293 +1,293 @@ - - > - Oh, e mais uma coisa sobre o @dup@. Algumas coisas não podem ser "dupadas". Números, por exemplo. - Símbolos (que se parecem com @:morte@) são idênticos quando grafados iguais. Assim como números. - - - Além disso, algumas variáveis especiais: @nil@, @true@, @false@. Estas são coisas que o Ruby não vai - te deixar alterar, então não faz sentido copiar mesmo. Quero dizer, imagine se você pudesse mudar o - @false@ para que seja @true@. A coisa toda vira uma mentira. - - - Talvez o *Aspecto Confuso No. 3* seja um simples. Estou usando aquelas chaves na string. - Estou tratando a como se ela fosse um Array ou Hash. Eu posso fazer isso. Porque strings - têm um método @[]@. - - - Quando usadas numa string, as chaves vão extrair parte daquela string. Mais uma vez, - espaço para as pás da empilhadeira. A string é como uma longa prateleira e a empilhadeira - tira os pedaços da string. - - - Dentro das chaves, nós passamos o _index (índice)_. É a etiqueta que colocamos entre as pás, - onde o trabalhador pode vê-las. Quando o assunto são strings, podemos usar vários objetos como - índices. - - - <pre> - str = "Uma string é uma longa prateleira de letras e espaços." - puts str[0] # imprime 85 (o código do caracter 'U') - puts str[0..-1] # imprime 'Uma string é uma longa prateleira de letras e espaços.' - puts str[1..-2] # imprime 'ma string é uma longa prateleira de letras e espaços' - puts str[1, 3] # imprime 'ma ' - puts str['prateleira'] # imrpime 'shelf' - </pre> - - - Tudo bem, o último *Aspecto Confuso No. 4*: este método pode ser enviado a um loop sem fim. - Você pode dar uma string para este método que vai fazer com que ele trave e nunca mais volte. - Dê uma olhada no método. Você consegue jogar um graveto que trave o loop? - - - <pre> - def limpar_murmurios_de( frase ) - unless frase.respond_to? :include? - raise ArgumentError, - "não posso limpar os múrmurios de um(a) #{ frase.class }" - end - frase = frase.dup - while frase.include? '(' - abre = frase.index( '(' ) - fecha = frase.index( ')', abre ) - frase[abre..fecha] = '' if fecha - end - frase - end - </pre> - - - Aqui, entorte o graveto antes de jogá-lo. - - - <pre> - graveto = "Aqui está uma ( curva." - limpar_murmurios_de( graveto ) - </pre> - - - Por que o método trava? Bem, o loop @while@ espera até que todos os parênteses abertos se - acabem antes de parar de looping. E ele só modifica um parêntese aberto que tenha um par parêntese fechado. - Então, se nenhum parêntese fechado é encontrado, o parêntese aberto não será modificado - e o @while@ nunca ficará satisfeito. - - - Como você reescreveria este método? Eu sei como me virar no Ruby, então eu usaria uma expressão - regular. - - - <pre> - def limpar_murmurios_de( frase ) - unless frase.respond_to? :gsub - raise ArgumentError, - "não posso limpar os múrmurios de um(a) #{ frase.class }" - end - frase.gsub( /\([-\w]+\)/, '' ) - end - </pre> - - - Dê o seu melhor quando pensar nos seus loops. É muito fácil especialmente pros loops @while@ e @until@ - saírem do controle. Melhor usar um iterador. E nós chegaremos em expressões regulares na hora certa. - - - Resumidamente, aqui está o que aprendemos sobre escrever métodos: - - - # Não se surpreenda se as pessoas passarem objetos inesperados pros seus métodos. - Se você não pode maneira algum usar o que te deram, @raise (cause)@ um erro. - - # É falta de educação mudar objetos que são dados aos seus métodos. Use @dup@ para - fazer uma cópia. Ou encontre um método como @gsub@ que automaticamente faz a cópia - enquanto faz o seu serviço. - - # As chaves podem ser usadas para procurar partes dentro de qualquer objeto @Array@, @Hash@ ou @String@, - já que estes objetos provém um método @[]@. E também, já que este objetos provém um método @[]=@, - as chaves podem ser usadas pra assignment (do lado esquerdo do sinal de igual) to - change the parts of those objects. - - # Cuidado com loops fujões. Evite @while@ e @until@ se você puder. - - - h3. Os Mecanismos do Estereótipo - - - !>i/my.daughters.organ-2.gif(Vendedor de gatos do espaço.)! - - - Imediatamente ouve-se um sussuro nas árvores atrás da casa do Paij-ree e acabou que era - o homem que caíra do céu. Seu nome era Doug e ele vendia gatos. - - - Então, assim que deu pra vê-lo, quando sua sombra (e as sombras dos gatos amarrados aos seus - pés) entrou na frente do passáro no gramado que nós estávamos tentando acertar com uma raquete, - enquanto ele retirava o hélio do grande balão, nós gritamos, "Olá, Doug!" - - - E ele diz, "Olá, Gonk-ree! Olá, Why!" - - - Paij-ree checa os bolsos pra ter certeza que ele tem o real-e-vinte-sete que vai precisar pra comprar - comprar os três gatos que ele necessita pra manter a fornalha abastecida e a parabólica virando. Estes - gatos geram montes de eletricidade estática quando Paij-ree os joga no gerador, onde eles esetarão em - inferioridade numérica a gigantes bastões de vidro, que os acariciam continuamente-- Mas, espere! - Você reparou como o corretor de gatos chamou ele de Gonk-ree? - - - E ele o chama de Gonk-ree de dia e Gonk-plo de noite. - - - Então o sufixo é definitivamente relacionado à luz do sol. Até onde eu sei, o prefixo indica - a relação de quem chama o Paij-ree. - - - <pre> - class String - - # As partes do nome do professor - # de órgão da minha filha. - @@silabas = [ - { 'Paij' => 'Pessoal', - 'Gonk' => 'Negócios', - 'Blon' => 'Escravo', - 'Stro' => 'Mestre', - 'Wert' => 'Pai', - 'Onnn' => 'Mãe' }, - { 'ree' => 'AM', - 'plo' => 'PM' } - ] - - # Um método pra determinar o que - # signfica certos nomes dele. - def significado_do_nome - partes = self.split( '-' ) - silabas = @@silabas.dup - significado = partes.collect do |p| - silabas.shift[p] - end - significado.join( ' ' ) - end - - end - </pre> - - - Agora eu fui bem mais além do que te mostrar apenas código banal. Houve aqui uma grave libertinagem - e um crime contra a natureza. Um crime que a maioria das linguagens não permitiriam que você cometesse. - Nós estamos mudando a @String@, *uma das classes do núcleo do Ruby*! - - - "Eu sei que isto é um pouco perigoso," Eu disse, quando passei isso por baixo do nariz do Paij-ree. - "Eu espero que ninguém se machuque." - - - "Todo Smotchkkiss deve experimentar o que esse (kep-yo-iko) perigo faz," ele disse. "Dogs and logs - and swampy bogs (kul-ip), all must be tasted." E ele deu uma golada no seu drink de pântano Beagle Berry. - - - Então o que é que eu estou adicionando à classe @String?@ Duas coisas: uma variável de classe e - um método. Um *método de instância* normal. - - - Eu gosto de ver a *arroba* como um caracter que significa *atributo*. A *arroba dupla* - *atributo coletivo*. Uma variável de classe. Todas as instâncias da classe podem olhar - pra esta váriavel e ela é a mesma pra todas. A variável @@@silabas@ é um Array - que agora pode ser usado dentro da classe String. - - - O novo método é @significado_do_nome@ e esse novo método pode ser usado com qualquer string. - - - bq. @print "Paij-ree".significado_do_nome@ imprime @Pessoal AM@. - - - Como você pode ver, Paij-ree é um nome pessoal. Um nome que os amigos usam nas manhãs. - - - Tenha certeza de ter visto a linha de código que usa @self@. Esta é uma variável especial, uma - variável que representa o objeto cujo método você está chamando. Para simplificar as coisas um - pouco, vamos tentar fazer um método que separe uma string pelos hífens. - - - <pre> - class String - def separar_hifen - self.split( '-' ) - end - end - </pre> - - - De novo, aqui está um método que pode ser usando com qualquer string. - - - bq. @"Gonk-plo".separar_hifen@ retorna o Array @['Gonk', 'plo']@. - - - Usar @self@ marca o a entrada em um novo estágio com idéias mais avançadas no Ruby. - Esta é uma linguagem de definição. Você está definindo um método, desenhando ele antes dele ser usado. Você está - preparando para a existência de um objeto que use aquele método. Você está dizendo, "Quando @separar_hifen@ - for usado, haverá uma string a qual estaremos separando-hífens. E @self@ é uma variável especial - que faz referência àquela string." - - - Ruby é uma linguagem de definição imbatível. Uma discussão suculenta e de rachar a cuca estará no seu caminho - mais fundo no livro. - - - Na maioria das vezes você não precisa usar @self@ explícitamente, já que você pode chamar métodos - diretamente dentro de outra definição de método. - - - <pre> - class String - def separar_hifen; split( '-' ); end - end - </pre> - - - No método @significado_do_nome@, encontre o loop. Aprender sobre @Array#collect@ é essencial. - Vamos olhar de perto. - - - <pre> - significado = partes.collect do |p| - silabas.shift[p] - end - </pre> - - - O Array @partes@ contém o nome separado. @['Paij', 'plo']@, por exemplo. Estamos iterando por - cada item naquele Array com @collect@. Mas @collect@ vai uma passo a frente ao que o @each@ faz. Assim - como @each@, collect joga cada item pela calha como uma variável de bloco. E aí, ao término do - block, @collect@ *mantém a resposta que o block dá e a adiciona em um novo Array*. O método - @collect@ é o jeito perfeito de se fazer um novo Array que é baseado em itens de um Array existente. - - - O Doug tem três gatos à venda. Um custa doze centavos, um sessenta e três centavos, um nove centavos. - Vamos ver quanto cada gato custaria se nós adicionássemos uma gorjeta de 20%. - - - <pre> - gatosegorjetas = [0.12, 0.63, 0.09].collect { |custogato| custogato + ( custogato * 0.20 ) } - </pre> - - - Costumo dizer que a propriedade do Paij-ree é um charmoso pedaço de floresta quando não está chovendo gatos e Doug. - Por vários dias, Paij-ree e eu acampamos em tendas perto do rio atrás da casa dele, subsistindo de - fumaça de turdus e retalhando indiozinhos adormecidos ao por do sol. Em uma ocasião ele perdeu no - carteado e eu sabia que sua mente estava distraída, pensando em Endertromb. Tudo isso deve estar - remoendo nele por algum tempo já. Eu fui o primeiro confidente que ele tivera. - - - "Acabei de vir de Ambrose," Eu disse. "Sort of my own underground home, a place where elves - strive to perfect animals." - - - He mumbled and nodded. "You can't be (poth-in-oin) part of (in) such things." - - - "Você acha que nós falharemos?" - - - "Eu (preep) já vi isso antes," ele disse. E daí, ele falou sobre a Loteria. - - + - > + Oh, e mais uma coisa sobre o @dup@. Algumas coisas não podem ser "dupadas". Números, por exemplo. + Símbolos (que se parecem com @:morte@) são idênticos quando grafados iguais. Assim como números. + + + Além disso, algumas variáveis especiais: @nil@, @true@, @false@. Estas são coisas que o Ruby não vai + te deixar alterar, então não faz sentido copiar mesmo. Quero dizer, imagine se você pudesse mudar o + @false@ para que seja @true@. A coisa toda vira uma mentira. + + + Talvez o *Aspecto Confuso No. 3* seja um simples. Estou usando aquelas chaves na string. + Estou tratando a como se ela fosse um Array ou Hash. Eu posso fazer isso. Porque strings + têm um método @[]@. + + + Quando usadas numa string, as chaves vão extrair parte daquela string. Mais uma vez, + espaço para as pás da empilhadeira. A string é como uma longa prateleira e a empilhadeira + tira os pedaços da string. + + + Dentro das chaves, nós passamos o _index (índice)_. É a etiqueta que colocamos entre as pás, + onde o trabalhador pode vê-las. Quando o assunto são strings, podemos usar vários objetos como + índices. + + + <pre> + str = "Uma string é uma longa prateleira de letras e espaços." + puts str[0] # imprime 85 (o código do caracter 'U') + puts str[0..-1] # imprime 'Uma string é uma longa prateleira de letras e espaços.' + puts str[1..-2] # imprime 'ma string é uma longa prateleira de letras e espaços' + puts str[1, 3] # imprime 'ma ' + puts str['prateleira'] # imrpime 'shelf' + </pre> + + + Tudo bem, o último *Aspecto Confuso No. 4*: este método pode ser enviado a um loop sem fim. + Você pode dar uma string para este método que vai fazer com que ele trave e nunca mais volte. + Dê uma olhada no método. Você consegue jogar um graveto que trave o loop? + + + <pre> + def limpar_murmurios_de( frase ) + unless frase.respond_to? :include? + raise ArgumentError, + "não posso limpar os múrmurios de um(a) #{ frase.class }" + end + frase = frase.dup + while frase.include? '(' + abre = frase.index( '(' ) + fecha = frase.index( ')', abre ) + frase[abre..fecha] = '' if fecha + end + frase + end + </pre> + + + Aqui, entorte o graveto antes de jogá-lo. + + + <pre> + graveto = "Aqui está uma ( curva." + limpar_murmurios_de( graveto ) + </pre> + + + Por que o método trava? Bem, o loop @while@ espera até que todos os parênteses abertos se + acabem antes de parar de looping. E ele só modifica um parêntese aberto que tenha um par parêntese fechado. + Então, se nenhum parêntese fechado é encontrado, o parêntese aberto não será modificado + e o @while@ nunca ficará satisfeito. + + + Como você reescreveria este método? Eu sei como me virar no Ruby, então eu usaria uma expressão + regular. + + + <pre> + def limpar_murmurios_de( frase ) + unless frase.respond_to? :gsub + raise ArgumentError, + "não posso limpar os múrmurios de um(a) #{ frase.class }" + end + frase.gsub( /\([-\w]+\)/, '' ) + end + </pre> + + + Dê o seu melhor quando pensar nos seus loops. É muito fácil especialmente pros loops @while@ e @until@ + saírem do controle. Melhor usar um iterador. E nós chegaremos em expressões regulares na hora certa. + + + Resumidamente, aqui está o que aprendemos sobre escrever métodos: + + + # Não se surpreenda se as pessoas passarem objetos inesperados pros seus métodos. + Se você não pode maneira algum usar o que te deram, @raise (cause)@ um erro. + + # É falta de educação mudar objetos que são dados aos seus métodos. Use @dup@ para + fazer uma cópia. Ou encontre um método como @gsub@ que automaticamente faz a cópia + enquanto faz o seu serviço. + + # As chaves podem ser usadas para procurar partes dentro de qualquer objeto @Array@, @Hash@ ou @String@, + já que estes objetos provém um método @[]@. E também, já que este objetos provém um método @[]=@, + as chaves podem ser usadas pra assignment (do lado esquerdo do sinal de igual) to + change the parts of those objects. + + # Cuidado com loops fujões. Evite @while@ e @until@ se você puder. + + + h3. Os Mecanismos do Estereótipo + + + !>i/my.daughters.organ-2.gif(Vendedor de gatos do espaço.)! + + + Imediatamente ouve-se um sussuro nas árvores atrás da casa do Paij-ree e acabou que era + o homem que caíra do céu. Seu nome era Doug e ele vendia gatos. + + + Então, assim que deu pra vê-lo, quando sua sombra (e as sombras dos gatos amarrados aos seus + pés) entrou na frente do passáro no gramado que nós estávamos tentando acertar com uma raquete, + enquanto ele retirava o hélio do grande balão, nós gritamos, "Olá, Doug!" + + + E ele diz, "Olá, Gonk-ree! Olá, Why!" + + + Paij-ree checa os bolsos pra ter certeza que ele tem o real-e-vinte-sete que vai precisar pra comprar + comprar os três gatos que ele necessita pra manter a fornalha abastecida e a parabólica virando. Estes + gatos geram montes de eletricidade estática quando Paij-ree os joga no gerador, onde eles esetarão em + inferioridade numérica a gigantes bastões de vidro, que os acariciam continuamente-- Mas, espere! + Você reparou como o corretor de gatos chamou ele de Gonk-ree? + + + E ele o chama de Gonk-ree de dia e Gonk-plo de noite. + + + Então o sufixo é definitivamente relacionado à luz do sol. Até onde eu sei, o prefixo indica + a relação de quem chama o Paij-ree. + + + <pre> + class String + + # As partes do nome do professor + # de órgão da minha filha. + @@silabas = [ + { 'Paij' => 'Pessoal', + 'Gonk' => 'Negócios', + 'Blon' => 'Escravo', + 'Stro' => 'Mestre', + 'Wert' => 'Pai', + 'Onnn' => 'Mãe' }, + { 'ree' => 'AM', + 'plo' => 'PM' } + ] + + # Um método pra determinar o que + # signfica certos nomes dele. + def significado_do_nome + partes = self.split( '-' ) + silabas = @@silabas.dup + significado = partes.collect do |p| + silabas.shift[p] + end + significado.join( ' ' ) + end + + end + </pre> + + + Agora eu fui bem mais além do que te mostrar apenas código banal. Houve aqui uma grave libertinagem + e um crime contra a natureza. Um crime que a maioria das linguagens não permitiriam que você cometesse. + Nós estamos mudando a @String@, *uma das classes do núcleo do Ruby*! + + + "Eu sei que isto é um pouco perigoso," Eu disse, quando passei isso por baixo do nariz do Paij-ree. + "Eu espero que ninguém se machuque." + + + "Todo Smotchkkiss deve experimentar o que esse (kep-yo-iko) perigo faz," ele disse. "Dogs and logs + and swampy bogs (kul-ip), all must be tasted." E ele deu uma golada no seu drink de pântano Beagle Berry. + + + Então o que é que eu estou adicionando à classe @String?@ Duas coisas: uma variável de classe e + um método. Um *método de instância* normal. + + + Eu gosto de ver a *arroba* como um caracter que significa *atributo*. A *arroba dupla* + *atributo coletivo*. Uma variável de classe. Todas as instâncias da classe podem olhar + pra esta váriavel e ela é a mesma pra todas. A variável @@@silabas@ é um Array + que agora pode ser usado dentro da classe String. + + + O novo método é @significado_do_nome@ e esse novo método pode ser usado com qualquer string. + + + bq. @print "Paij-ree".significado_do_nome@ imprime @Pessoal AM@. + + + Como você pode ver, Paij-ree é um nome pessoal. Um nome que os amigos usam nas manhãs. + + + Tenha certeza de ter visto a linha de código que usa @self@. Esta é uma variável especial, uma + variável que representa o objeto cujo método você está chamando. Para simplificar as coisas um + pouco, vamos tentar fazer um método que separe uma string pelos hífens. + + + <pre> + class String + def separar_hifen + self.split( '-' ) + end + end + </pre> + + + De novo, aqui está um método que pode ser usando com qualquer string. + + + bq. @"Gonk-plo".separar_hifen@ retorna o Array @['Gonk', 'plo']@. + + + Usar @self@ marca o a entrada em um novo estágio com idéias mais avançadas no Ruby. + Esta é uma linguagem de definição. Você está definindo um método, desenhando ele antes dele ser usado. Você está + preparando para a existência de um objeto que use aquele método. Você está dizendo, "Quando @separar_hifen@ + for usado, haverá uma string a qual estaremos separando-hífens. E @self@ é uma variável especial + que faz referência àquela string." + + + Ruby é uma linguagem de definição imbatível. Uma discussão suculenta e de rachar a cuca estará no seu caminho + mais fundo no livro. + + + Na maioria das vezes você não precisa usar @self@ explícitamente, já que você pode chamar métodos + diretamente dentro de outra definição de método. + + + <pre> + class String + def separar_hifen; split( '-' ); end + end + </pre> + + + No método @significado_do_nome@, encontre o loop. Aprender sobre @Array#collect@ é essencial. + Vamos olhar de perto. + + + <pre> + significado = partes.collect do |p| + silabas.shift[p] + end + </pre> + + + O Array @partes@ contém o nome separado. @['Paij', 'plo']@, por exemplo. Estamos iterando por + cada item naquele Array com @collect@. Mas @collect@ vai uma passo a frente ao que o @each@ faz. Assim + como @each@, collect joga cada item pela calha como uma variável de bloco. E aí, ao término do + block, @collect@ *mantém a resposta que o block dá e a adiciona em um novo Array*. O método + @collect@ é o jeito perfeito de se fazer um novo Array que é baseado em itens de um Array existente. + + + O Doug tem três gatos à venda. Um custa doze centavos, um sessenta e três centavos, um nove centavos. + Vamos ver quanto cada gato custaria se nós adicionássemos uma gorjeta de 20%. + + + <pre> + gatosegorjetas = [0.12, 0.63, 0.09].collect { |custogato| custogato + ( custogato * 0.20 ) } + </pre> + + + Costumo dizer que a propriedade do Paij-ree é um charmoso pedaço de floresta quando não está chovendo gatos e Doug. + Por vários dias, Paij-ree e eu acampamos em tendas perto do rio atrás da casa dele, subsistindo de + fumaça de turdus e retalhando indiozinhos adormecidos ao por do sol. Em uma ocasião ele perdeu no + carteado e eu sabia que sua mente estava distraída, pensando em Endertromb. Tudo isso deve estar + remoendo nele por algum tempo já. Eu fui o primeiro confidente que ele tivera. + + + "Acabei de vir de Ambrose," Eu disse. "Sort of my own underground home, a place where elves + strive to perfect animals." + + + He mumbled and nodded. "You can't be (poth-in-oin) part of (in) such things." + + + "Você acha que nós falharemos?" + + + "Eu (preep) já vi isso antes," ele disse. E daí, ele falou sobre a Loteria. + + lang-pt/poignant-46.yml @@ -1,61 +1,61 @@ - - A Cabra Quer Ver Um Filme Inteiro: > - - - !i/the.goat-1.gif(Blinky, winky, uma cabra... desperta...)! - - - O elevador se abriu numa sala verde cheia de estantes e arquivos. - Rolos de filme e latas de filme e fitas de vídeo por toda parte. O Dr. Cham não - fazia idéia do que a maioria das coisas eram. Tudo que ele viu uma grande, bagunça futurística. - - - Ele chamou novamente, esbarrando em estreitos becos entre estantes, - "Al-ô-ô?? Estou procurando vida inteligente, sou um viajante - do espaço!" Ele tropeçou quando seu pé enroscou num videocassete. - "Algum outro ser que eu possa me comunicar?" - - - Com as mãos em volta da boca, ele gritou, "Al-ô-ô?" - - - "Crying out loud."* A cabra sonolenta veio trotando pelo corredor. - * Livro do poeta norte-americano Cid Corman - - - !i/dr.cham-5.gif(A cabra já conhece o Dr. Cham.)! - - - "Eu odeio aquele livro," disse a cabra. "Eu acho que o autor é insincero." - - - "Mesmo?" perguntou o Dr. Cham. - - - "Tenho certeza que tudo é verdade. Mas é muito enfeitado. Eu fico tipo: - Chega. Já entendi. Pára com isso." - - - "I'm not quite sure what to make of it," said the Doctor. "It seems like an honest effort. - I actually wrote something in Ruby back there." - - - "Isto não dá às cabras uma boa reputação," disse a cabra. - - - "Mas você é a única cabra no livro," disse o Doutor. - - - "E totalmente mal interpretada." - - - !i/dr.cham-6.gif(The mechanics behind devouring Dr. Cham.)! - - - The goat closed his mouth and Dr. Cham held his heart. - - - "Eu sou na verdade muito letrada," disse a cabra. "Se bem que, recentemente, eu estou vendo - mais filmes. Eu amo filmes estrangeiros. Um de meus parentes acabou de trazer _Ishtar_ - do seu planeta. Wow, aquilo foi excelente." - - + - A Cabra Quer Ver Um Filme Inteiro: > + + + !i/the.goat-1.gif(Blinky, winky, uma cabra... desperta...)! + + + O elevador se abriu numa sala verde cheia de estantes e arquivos. + Rolos de filme e latas de filme e fitas de vídeo por toda parte. O Dr. Cham não + fazia idéia do que a maioria das coisas eram. Tudo que ele viu uma grande, bagunça futurística. + + + Ele chamou novamente, esbarrando em estreitos becos entre estantes, + "Al-ô-ô?? Estou procurando vida inteligente, sou um viajante + do espaço!" Ele tropeçou quando seu pé enroscou num videocassete. + "Algum outro ser que eu possa me comunicar?" + + + Com as mãos em volta da boca, ele gritou, "Al-ô-ô?" + + + "Crying out loud."* A cabra sonolenta veio trotando pelo corredor. + * Livro do poeta norte-americano Cid Corman + + + !i/dr.cham-5.gif(A cabra já conhece o Dr. Cham.)! + + + "Eu odeio aquele livro," disse a cabra. "Eu acho que o autor é insincero." + + + "Mesmo?" perguntou o Dr. Cham. + + + "Tenho certeza que tudo é verdade. Mas é muito enfeitado. Eu fico tipo: + Chega. Já entendi. Pára com isso." + + + "I'm not quite sure what to make of it," said the Doctor. "It seems like an honest effort. + I actually wrote something in Ruby back there." + + + "Isto não dá às cabras uma boa reputação," disse a cabra. + + + "Mas você é a única cabra no livro," disse o Doutor. + + + "E totalmente mal interpretada." + + + !i/dr.cham-6.gif(The mechanics behind devouring Dr. Cham.)! + + + The goat closed his mouth and Dr. Cham held his heart. + + + "Eu sou na verdade muito letrada," disse a cabra. "Se bem que, recentemente, eu estou vendo + mais filmes. Eu amo filmes estrangeiros. Um de meus parentes acabou de trazer _Ishtar_ + do seu planeta. Wow, aquilo foi excelente." + + lang-pt/poignant-47.yml @@ -1,30 +1,30 @@ - - !^sidebar - ~: | - - <pre> - nós queremos um tamborim! - / - | nós todos queremos um tamborim! - | / - \__ | - / o o \__/\__/\_ - /. \ o o \____ - /' ----/ \ - _____ / ' / /.\\ #------/ - / / / \\ - / /// - /de \ - /\ \vez en\\.. - /qu/ \do estas fotos\\ - /an/ \não fun\ \ci onam\ - *** *** direito mas - acho que desta vez - funcionou - ooo o - oo - o - o - {o} - ^ - </pre> - + - !^sidebar + ~: | + + <pre> + nós queremos um tamborim! + / + | nós todos queremos um tamborim! + | / + \__ | + / o o \__/\__/\_ + /. \ o o \____ + /' ----/ \ + _____ / ' / /.\\ #------/ + / / / \\ + / /// + /de \ + /\ \vez en\\.. + /qu/ \do estas fotos\\ + /an/ \não fun\ \ci onam\ + *** *** direito mas + acho que desta vez + funcionou + ooo o + oo + o + o + {o} + ^ + </pre> + lang-pt/poignant-48.yml @@ -1,519 +1,519 @@ - - > - "Eu não visito o meu planeta há muito tempo. Seria difícil considerá-lo minha casa - a esta altura do campeonato." - - - "Bem, Warren Beatty é maravilhoso. Sua personagem é basicamente socialmente aleijada. Ele - até tenta se matar, mas Dustin Hoffman senta no peitoril da janela e começa a chorar - e cantar uma música totalmente hilária, é de partir o coração. Eu tenho ele aqui, - você devia assistí-lo." - - - "Posso pegar algo para comer?" perguntou o Doutor. E ainda se sentia sujo. - - - "How about we watch a film and you can have a buttermelon with tentacles?" said the goat. - - - So, they worked their way back toward the goat's projector. Back by the freezer locker, - they sat on a giant rug and broke off the appendages of frozen buttermelons. The shell - was solid, but once it cracked, rich fruit cream was in abundance. Sweet to taste and - a very pleasant scent. - - - "First film, you've got to see," said the goat. "Locally filmed and produced. I'm - good friends with the lady who did casting. Dated her for awhile. Knew everyone - who was going to play the different roles long before it was announced." - - - The goat set the projector by Dr. Cham. "I ve got the music on the surround sound. - You can man the knob." - - - !i/filmstrip-1.gif(The Originals and their lonesome planet.)! - - - Dr. Cham's mind wandered at this point in the presentation, just as the land war - mounted between the two throngs of animal settlers. The details of their wars - and campaigns continued to consume the spool of transparent film that Dr. Cham - was feeding through the projector. - - - War after war after war. The Sieging of Elmer Lake. The Last Stand of Newton P. Giraffe - and Sons. Dog Invasion of Little Abandoned Cloud. Nenhum animal morreu nessas guerras. - Most often an attack consisted of bopping another - animal on the head. And they philipped each other s noses. But, believe me, - it was humiliating. - - - Blasted crying shame. Things could have worked out. - - - h3. O Nascimento de um Objeto - - - "Não se preocupe," disse a cabra, anxious to sway Dr. Chams attention back to the film. "Things _do_ - work out." - - - No Ruby, o Objeto é o centro exato das todas as coisas. Ele é O Original. - - - <pre> - class UrsoTostado < Object; end - </pre> - - - The angle bracket indicates *inheritance*. Isto significa que a nova classe @UrsoTostado@ - é um nova classe baseada na classe @Objeto@. Todo método que @Objeto@ tem vai estar - disponível na @UrsoTostado@. Constantes disponíveis em @Objeto@ vão estar disponíveis em - @UrsoTostado@. - - - Mas todo objeto é herdeiro de @Object@. O código... - - - <pre> - class UrsoTostado; end - </pre> - - - É idêntico a... - - - <pre> - class UrsoTostado < Object; end - </pre> - - - Herança é útil. Você pode criar espécies de objetos que se relacionam entre si. - Quase sempre, quando você está dissecando um problema, você vai se deparar com vários objetos que - compartilham atributos. Você pode ter menos trabalho herdando de classes que já solucionam - parte desse problema. - - - Você pode ter uma classe @BrasilEndereco@ que guarda o endereço, cidade, estado, - e cep de alguem que more no Brasil. Quando você começar a guardar endereços - da Inglaterra, você pode adicionar uma classe @ReinoUnidoEnderecos@. Se você então - garantir que os dois endereços herdem de uma classe mãe @Endereco@, você pode - planejar seu software de correspondência de modo que aceite todo tipo de endereço. - - - <pre> - def envie_a_eles_um_kit( endereco ) - unless endereco.is_a? Endereco - raise ArgumentError, "Objeto Endereco não encontrado." - end - print endereco.formatted - end - </pre> - - - Além disso, herança é ótimo se você quer sobreescrever certos comportamentos numa classe. - Por exemplo, talvez você queira fazer a sua própria variação variation to the @Array@ class. - You want to enhance the @join@ method. But if you change @Array#join@ directly, you - will affect other classes in Ruby that use Arrays. - - - Então você começa sua própria classe chamada @MeuArray@, que é baseada na classe @Array@ original. - - - <pre> - class MeuArray < Array - # Contruir uma string neste array, formatando cada entrada - # e depois as unindo. - def join( sep = $,, format = "%s" ) - collect do |item| - sprintf( format, item ) - end.join( sep ) - end - end - </pre> - - - @MeuArray@ é agora uma classe @Array@ customizada com o seu próprio método @join@. @Array@ é - a *superclass (classe-superior, classe-mãe)* do @MeuArray@. Cada objeto tem um método @superclass@ - onde você pode verificar esta relação. - - - <pre> - irb> MinhaArray.superclass - => Array - </pre> - - - Perfeito. Nós administramos um hotel e nós temos uma @Array@ dos tamanhos dos nossos quarots: @[3, 4, 6]@. - Vamos imprimir isso de um jeito bacana pra encadenarmos. - - - <pre> - quartos = MinhaArray[3, 4, 6] - print "Nós temos quartos de " + quartos.join( ", ", "%d camas" ) + " disponíveis." - </pre> - - - Que imprime, "Nós temos quartos de 3 camas, 4 camas, 6 camas disponíveis." - - - Dr. Cham estava procurando por um banheiro, but archival video tape was everywhere. - Ele acabou encontrando um lugar, que poderia ser um banheiro. Tinha um vaso de metal. - Mas mais importante, era escuro e escondido. - - - Enquanto s in there, let me add that enquanto Os Originais slaughtered The Invaders - to prove their rights as First Creatures, o Objeto Ruby Object não disputou nada. - Ele é rei absoluto Objeto o Primeiro. - - - Observe. - - - <pre> - irb> Class.superclass - => Module - irb> Kernel.class - => Module - irb> Module.superclass - => Object - irb> Object.superclass - => nil - </pre> - - - Até @Classe@ é um @Objeto@! Veja, mesmo as classes sendo linguagem de definição para objetos, - nós ainda pode mos chamar métodos de classe nelas e tratá-los como objetos ocasionalmente. It may seem - like a dizzying circle, but it s truly a very strict parentage. E garante que quando você - altera o @Object@, você altera *tudo no Ruby*. Which is impossibly scary and all-powerful - and cataclysmic and awesome! *Ruby não te restringe, minha irmã, meu irmão!* - - - Entre @Class@ e @Object@, você vê @Module@? Se @Object@ é o rei, the one who has - sired every other part of Ruby, then @Module@ is the poor waifish nun, shielding - and protecting all her little Ruby townspeople children. (To complete the analogy: - @Class@ é a professora da escola da vila e @Kernel@ é the self-important colonel.) - - - O motivo da existência do @Module@ é dar comida e abrigo a código. Métodos - podem ficar abrigados embaixo da manta do @Module@. @Module@ pode conter classes, constantes e - variáveis de qualquer tipo. - - - "Mas o que um Module _faz_?" você pergunta. "Como ele é lucrativamente utilizado??" - - - "Isso é tudo que ele faz!!" Eu replico, mostrando as palmas da mão na maior expressão - de futilidade conhecida pelo homem. "Agora me escute -- pois não me repetirei -- essa - Mãe Módulo Superior deu a estes pobres objetos um lugar pra morar!!" - - - <pre> - # Veja, aqui está o module -- onde mais seu código poderia estar? - module AtenciosaSantaInes - - # Uma CONSTANTE repousa perto da porta. Ótimo. - HOMEM_DESDENTADO_COM_GARFO = ['homem', 'garfo', 'exposed gums'] - - # Uma Class está comendo, vivendo bem na cozinha. - class CriancaGordaDeCera; end - - # Um Método está se escondendo lá atrás no armário banana, Deus sabe porquê. - def timida_garota_com_cara_de_raposa; {'please' => 'eu quero uma bolota de carvalho por favor'}; end - - end - </pre> - - - Agora você tem que ir pela Santa Inês para achá-los. - - - <pre> - >> AtenciosaSantaInes::HOMEM_DESDENTADO_COM_GARFO - => ["homem", "garfo", "exposed gums"] - >> AtenciosaSantaInes::CriancaGordaDeCera.new - => #<AtenciosaSantaInes::FatWaxyChild:0xb7d2ad78> - >> AtenciosaSantaInes::instance_methods - => ["timida_garota_com_cara_de_raposa"] - </pre> - - - Lembre-se sempre que um @Module@ é somente um hotel. Um teto sob as cabeças deles. Ele não é uma - auto-consciente @Classe@ e, portanto, não pode ser trazida à vida com @new@. - - - <pre> - >> AtenciosaSantaInes.new - NoMethodError: undefined method `new' for AtenciosaSantaInes:Module - from (irb):2 - </pre> - - - Santa Inês deu a própria vida pra cuidar desses pedaços de código desesperados. - Por favor. Não tire isso dela. - - - Se, todavia, você quer roubar da Santa Inês, eu posso te ajudar. - Você pode arrumar um grande mosteiro pra engrupir o ministério da @AtenciosaSantaInes@ e daí - o quê sobrará pra ela? - - - Para isso você pode usar @extend@, que vai puxar todos os métodos do módulo pra dentro de uma classe ou um objeto. - - - <pre> - >> class FundacaoDeAmorEAmparoTimeWarnerAolCitibank; end - >> FundacaoDeAmorEAmparoTimeWarnerAolCitibank.extend AtenciosaSantaInes - >> FundacaoDeAmorEAmparoTimeWarnerAolCitibank::instance_methods - => ["timida_garota_com_cara_de_raposa"] - </pre> - - - Na verdade, ninguém _roubou_ da @AtenciosaSantaInes@, somente pegaram emprestado. - A @timida_garota_com_cara_de_raposa@ agora tem dois endereços. - - - Você deve admitir. O velho mosteiro pode ser comprado um zilhão de vezes e a pequena garota-com-cara-de-raposa - _ainda_ estará nos fundos no armário banana esperando uma bolota de carvalho! Que pena que não podemos alimentá-la. - Ela é um método sem argumentos. - - - When Dr. Cham came out refreshed, the filmstrip was a bit behind. Mas a cabra não notou, - então o Doutor avançou alguns quadros até fazer algum sentido. - - - !i/filmstrip-2.gif(The goats that told a planet it was ugly.)! - - - Então os invasores deixaram o planeta. - - - "Este planeta _é_ decrépito," disse o Dr. Cham. "O castelo é bacana. Mas por dentro - é um desastre." - - - "O castelo parece uma projeção," disse a cabra. "All the flowers - and apple blossoms and the sky even. É uma projeção de baixa resolução." - - - "Sim? Ele é encantador." - - - "I guess." - - - !i/filmstrip-3.gif(The spool ends.)! - - - "That's messed up!" said the goat. "Não é assim que o filme termina! - Não teve sangue! O que aconteceu? O que aconteceu? Você apertou o botão errado, idiota?" - - - "Bem, eu não sei," disse o Dr. Cham. Ele girou o botão pra frente e pra trás. - Tapped the lens. - - - "Cheque a fita! Cheque a fita!" - - - Dr. Cham tirou um pedaço do filme do alimentador do projetor, derretido e pingando - nas pontas. - - - "Maldição! Estes projetores são de qualidade! Nunca vi isso acontecer. Não pode ser." - - - h3. Hunting For a Voice - - - "Eu não acho que tenha sido o projetor," disse o Dr. Cham. "Something flew across that screen - and uttered a blistering moan." - - - "I don't have any dupes of that movie," said the goat somberly. "And that girl. That casting - director. I never see her anymore." - - - Dr. Cham stood up and looked over the dumpy aisles of magnetic carnage, searching. - - - "Oh, hey, you should call that girl," the goat went on. "You could talk to her, get an understanding. - Tell her about me. Don't act like your my friend, just, you know, 'Oh, that guy? - Yeah, whatta maroon.'" - - - Dr. Cham spotted the doorway and exited. - - - The hallways were an entirely new world of mess. In the goat's archives, the shelves had been messy. - In the hallway, shelves were completely tipped. Sinks were falling through the ceiling. - The Doctor ventured under the debris, kicking through plywood when necessary. - - - "You shouldn't be out here," said the goat. "You're on someone else's property at this point. - A couple of pygmy elephants own all this. They're nasty guys. They'll beat the crap outta you - with their trunks. They ball it up and just whack ya." - - - Dr. Cham pushed a file cabinet out of his way, which fell through a flimsy wall, then through - the floor of the next room over. And they heard it fall through several floors after that. - - - "I'm trying to remember how it goes in the book," said Dr. Cham, as he walked swiftly through - the hall. "That milky fog that swept - across the projection. We find that thing." He jiggled a door handle, broke it off. Forged - through the doorway and disappeared inside. - - - "You really get a kick out of beating stuff up, don't you?" said the goat. "Walls, doors." - The goat headbutted a wall. The wall shuddered and then laid still. - - - Then, it was quiet. And black. - - - The goat stayed put in the bleak hallway, expecting Dr. Cham to flip over a few desks and emerge, - ready to move on from the room he'd busted into. But Dr. Cham didn't return, and the goat opted - to share a moment with the neglected wreckage left by his neighbors. Not that he could see at all. - He could only hear the occassional rustling of the piles of invoices and carbon copy masters and - manila envelopes when he shifted his legs. - - - The ground seemed to buckling right under the goat, as if the heaps of kipple around him were - beginning to slide toward his weight. He would be at the center of this whirlpool of elephant - documentation. Would he die of papercuts first? Or would he suffocate under the solid burial - by office supplies? - - - A soft light, however, crept up to him. A floating, silver fish. No, it was a -- was it scissors? - The scissors grew into a shimmering cluster of intellegent bread, each slice choking on glitter. - But, no, it was hands. And an Easter hat. - - - !i/hannah-1.gif(The goat alone in the hallway, meets an apparition.)! - - - In another room, Dr. Cham stood under the clear glass silently. The ceiling had abruptly - gone transparent, then starlight washed over his pants and jacket. He walked further to - the room's center in muted colors, lit as softly as an ancient manuscript in its own box at - the museum. More stars, more cotton clusters of fire, unveiled as he came across the floor. - And it peeked into view soon enough, he expected it to be larger, but it wasn't. - - - Earth. Like a painted egg, still fresh. He felt long cello strings sing right up - against his spine. How could that be called Peoplemud? Here was a vibrant and grassy - lightbulb. The one big ball that had something going for it. - - - He thought of The Rockettes. Actually, he missed The Rockettes. What a bunch of - great dancers. He had yelled something to The Rockettes when he saw them. Something - very observant and flattering. - - - Oh, yes, while The Rockettes were spinning, arm in arm, he had yelled, "Concentric circles!" - Which no one else cared to observe. - - - And this thought was enough to feed Dr. Cham's superiority complex. He wore a goofy - smile as he retraced his footsteps. He truthfully felt his genius coming through in - such a statement. To realize the simplicity of a circle was his. He reflected on it - all the way back to the hallway. - - - Which I think is great. Adore yourself when you have a second. - - - !i/hannah-2.gif(The Doctor knows this ghost.)! - - - "Oh, right," said the goat. "Your niece. The niece you killed. I'm with ya now." - - - For just a few moments, they all looked at each other. Just enough - time for both Dr. Cham and the goat to think: _Oh, yeah. Hannah - causes us a lot of trouble. She's already talking about maple donuts._ - - - "Does she start talking about maple donuts right away like that?" - asked the goat. - - - "Yes, she does," said the Doctor. "She brings it up to you, then - she brings it up to me. She sees a maple donut somewhere -- I don't - quite remember where." - - - "Do I see a real maple donut?" Hannah said. "I need a real one." - - - "Okay, okay," said the goat. "Yeah, I remember: here's where she says - that if she gets a real maple donut, she'll become a real person again. - Because her real destiny was to own a bakery and you ruined that destiny - and now she's trapped as a ghost." - - - "Hey, that's the truth!" Hannah yelped. - - - "It's terrible that we must bear through this whole scene again," said - the Doctor. "The donuts are immaterial. They should be left out altogether." - - - "Man, I am having a _hard_ time remembering all of this chapter," said - the goat. "I don't even remember how to get out of this hallway. I must - have read that book like thirty times. Do we blast through a wall? Do - we scream until someone finds us?" - - - "We get Hannah to float through walls and she finds some kind of machine," - says Dr. Cham. "I have to write a program -- it all works out somehow." - - - "But, you know what I'm saying?" said the goat. "I forget all the details. - Especially the earlier chapters. I mean I can remember the ending perfectly. - It's hard to sit through all this. The end is so much better." - - - Dr. Cham folded his arms and teetered on a heel. "The porcupine." He - smiled greedily at the goat. - - - "Oh, totally. The porcupine is definitely who I want to meet," said the - goat. "I wonder what he does with all that money when the book is over." - - - Dr. Cham nodded respectfully. "I'm very excited to see him wearing slippers." - - - "Those infernal slippers!" said the goat and he haw-hawed coarsely, a shower - of saliva cascading from his jaws. - - - Hannah's mind rattled, waiting for this nonsense to break for a moment. - She tipped her head on its side and the rattle slid along the curve of - her cranium. The little noise died away, though, as the back of her head - vanished (_fluxed out_ is what she called it) and then her head was - back again with its little rattle and she caught herself doing that - careless moaning again. *HRRRRRR-RRR-OH-RRRR-RRRR.* - - - "I'm not as into the chunky bacon stuff," said the goat. "I don't see - what's so great about it." - - - Could she speak while moaning? *BON-BON.* Com um sotaque francês. *BOHN-BOHN. - BOHN-APPE-TEET-OHHHH-RRRR.* - - - "I know she's harmless, but that sound freaks me out. My hair is - *completely* on end." - - - "Hannah?" disse o Dr. Cham. "Onde você está, criança? Come do a good turn - for us, my niece." - - - She was right near them, in and out. And they could hear her - cleaning up her voice, bright, speaking like a angel scattering stardust. - Yes, the whole maple donut story came out again, and more about the - bakery she would own, the muffins and rolls and baguettes. - - + - > + "Eu não visito o meu planeta há muito tempo. Seria difícil considerá-lo minha casa + a esta altura do campeonato." + + + "Bem, Warren Beatty é maravilhoso. Sua personagem é basicamente socialmente aleijada. Ele + até tenta se matar, mas Dustin Hoffman senta no peitoril da janela e começa a chorar + e cantar uma música totalmente hilária, é de partir o coração. Eu tenho ele aqui, + você devia assistí-lo." + + + "Posso pegar algo para comer?" perguntou o Doutor. E ainda se sentia sujo. + + + "How about we watch a film and you can have a buttermelon with tentacles?" said the goat. + + + So, they worked their way back toward the goat's projector. Back by the freezer locker, + they sat on a giant rug and broke off the appendages of frozen buttermelons. The shell + was solid, but once it cracked, rich fruit cream was in abundance. Sweet to taste and + a very pleasant scent. + + + "First film, you've got to see," said the goat. "Locally filmed and produced. I'm + good friends with the lady who did casting. Dated her for awhile. Knew everyone + who was going to play the different roles long before it was announced." + + + The goat set the projector by Dr. Cham. "I ve got the music on the surround sound. + You can man the knob." + + + !i/filmstrip-1.gif(The Originals and their lonesome planet.)! + + + Dr. Cham's mind wandered at this point in the presentation, just as the land war + mounted between the two throngs of animal settlers. The details of their wars + and campaigns continued to consume the spool of transparent film that Dr. Cham + was feeding through the projector. + + + War after war after war. The Sieging of Elmer Lake. The Last Stand of Newton P. Giraffe + and Sons. Dog Invasion of Little Abandoned Cloud. Nenhum animal morreu nessas guerras. + Most often an attack consisted of bopping another + animal on the head. And they philipped each other s noses. But, believe me, + it was humiliating. + + + Blasted crying shame. Things could have worked out. + + + h3. O Nascimento de um Objeto + + + "Não se preocupe," disse a cabra, anxious to sway Dr. Chams attention back to the film. "Things _do_ + work out." + + + No Ruby, o Objeto é o centro exato das todas as coisas. Ele é O Original. + + + <pre> + class UrsoTostado < Object; end + </pre> + + + The angle bracket indicates *inheritance*. Isto significa que a nova classe @UrsoTostado@ + é um nova classe baseada na classe @Objeto@. Todo método que @Objeto@ tem vai estar + disponível na @UrsoTostado@. Constantes disponíveis em @Objeto@ vão estar disponíveis em + @UrsoTostado@. + + + Mas todo objeto é herdeiro de @Object@. O código... + + + <pre> + class UrsoTostado; end + </pre> + + + É idêntico a... + + + <pre> + class UrsoTostado < Object; end + </pre> + + + Herança é útil. Você pode criar espécies de objetos que se relacionam entre si. + Quase sempre, quando você está dissecando um problema, você vai se deparar com vários objetos que + compartilham atributos. Você pode ter menos trabalho herdando de classes que já solucionam + parte desse problema. + + + Você pode ter uma classe @BrasilEndereco@ que guarda o endereço, cidade, estado, + e cep de alguem que more no Brasil. Quando você começar a guardar endereços + da Inglaterra, você pode adicionar uma classe @ReinoUnidoEnderecos@. Se você então + garantir que os dois endereços herdem de uma classe mãe @Endereco@, você pode + planejar seu software de correspondência de modo que aceite todo tipo de endereço. + + + <pre> + def envie_a_eles_um_kit( endereco ) + unless endereco.is_a? Endereco + raise ArgumentError, "Objeto Endereco não encontrado." + end + print endereco.formatted + end + </pre> + + + Além disso, herança é ótimo se você quer sobreescrever certos comportamentos numa classe. + Por exemplo, talvez você queira fazer a sua própria variação variation to the @Array@ class. + You want to enhance the @join@ method. But if you change @Array#join@ directly, you + will affect other classes in Ruby that use Arrays. + + + Então você começa sua própria classe chamada @MeuArray@, que é baseada na classe @Array@ original. + + + <pre> + class MeuArray < Array + # Contruir uma string neste array, formatando cada entrada + # e depois as unindo. + def join( sep = $,, format = "%s" ) + collect do |item| + sprintf( format, item ) + end.join( sep ) + end + end + </pre> + + + @MeuArray@ é agora uma classe @Array@ customizada com o seu próprio método @join@. @Array@ é + a *superclass (classe-superior, classe-mãe)* do @MeuArray@. Cada objeto tem um método @superclass@ + onde você pode verificar esta relação. + + + <pre> + irb> MinhaArray.superclass + => Array + </pre> + + + Perfeito. Nós administramos um hotel e nós temos uma @Array@ dos tamanhos dos nossos quarots: @[3, 4, 6]@. + Vamos imprimir isso de um jeito bacana pra encadenarmos. + + + <pre> + quartos = MinhaArray[3, 4, 6] + print "Nós temos quartos de " + quartos.join( ", ", "%d camas" ) + " disponíveis." + </pre> + + + Que imprime, "Nós temos quartos de 3 camas, 4 camas, 6 camas disponíveis." + + + Dr. Cham estava procurando por um banheiro, but archival video tape was everywhere. + Ele acabou encontrando um lugar, que poderia ser um banheiro. Tinha um vaso de metal. + Mas mais importante, era escuro e escondido. + + + Enquanto s in there, let me add that enquanto Os Originais slaughtered The Invaders + to prove their rights as First Creatures, o Objeto Ruby Object não disputou nada. + Ele é rei absoluto Objeto o Primeiro. + + + Observe. + + + <pre> + irb> Class.superclass + => Module + irb> Kernel.class + => Module + irb> Module.superclass + => Object + irb> Object.superclass + => nil + </pre> + + + Até @Classe@ é um @Objeto@! Veja, mesmo as classes sendo linguagem de definição para objetos, + nós ainda pode mos chamar métodos de classe nelas e tratá-los como objetos ocasionalmente. It may seem + like a dizzying circle, but it s truly a very strict parentage. E garante que quando você + altera o @Object@, você altera *tudo no Ruby*. Which is impossibly scary and all-powerful + and cataclysmic and awesome! *Ruby não te restringe, minha irmã, meu irmão!* + + + Entre @Class@ e @Object@, você vê @Module@? Se @Object@ é o rei, the one who has + sired every other part of Ruby, then @Module@ is the poor waifish nun, shielding + and protecting all her little Ruby townspeople children. (To complete the analogy: + @Class@ é a professora da escola da vila e @Kernel@ é the self-important colonel.) + + + O motivo da existência do @Module@ é dar comida e abrigo a código. Métodos + podem ficar abrigados embaixo da manta do @Module@. @Module@ pode conter classes, constantes e + variáveis de qualquer tipo. + + + "Mas o que um Module _faz_?" você pergunta. "Como ele é lucrativamente utilizado??" + + + "Isso é tudo que ele faz!!" Eu replico, mostrando as palmas da mão na maior expressão + de futilidade conhecida pelo homem. "Agora me escute -- pois não me repetirei -- essa + Mãe Módulo Superior deu a estes pobres objetos um lugar pra morar!!" + + + <pre> + # Veja, aqui está o module -- onde mais seu código poderia estar? + module AtenciosaSantaInes + + # Uma CONSTANTE repousa perto da porta. Ótimo. + HOMEM_DESDENTADO_COM_GARFO = ['homem', 'garfo', 'exposed gums'] + + # Uma Class está comendo, vivendo bem na cozinha. + class CriancaGordaDeCera; end + + # Um Método está se escondendo lá atrás no armário banana, Deus sabe porquê. + def timida_garota_com_cara_de_raposa; {'please' => 'eu quero uma bolota de carvalho por favor'}; end + + end + </pre> + + + Agora você tem que ir pela Santa Inês para achá-los. + + + <pre> + >> AtenciosaSantaInes::HOMEM_DESDENTADO_COM_GARFO + => ["homem", "garfo", "exposed gums"] + >> AtenciosaSantaInes::CriancaGordaDeCera.new + => #<AtenciosaSantaInes::FatWaxyChild:0xb7d2ad78> + >> AtenciosaSantaInes::instance_methods + => ["timida_garota_com_cara_de_raposa"] + </pre> + + + Lembre-se sempre que um @Module@ é somente um hotel. Um teto sob as cabeças deles. Ele não é uma + auto-consciente @Classe@ e, portanto, não pode ser trazida à vida com @new@. + + + <pre> + >> AtenciosaSantaInes.new + NoMethodError: undefined method `new' for AtenciosaSantaInes:Module + from (irb):2 + </pre> + + + Santa Inês deu a própria vida pra cuidar desses pedaços de código desesperados. + Por favor. Não tire isso dela. + + + Se, todavia, você quer roubar da Santa Inês, eu posso te ajudar. + Você pode arrumar um grande mosteiro pra engrupir o ministério da @AtenciosaSantaInes@ e daí + o quê sobrará pra ela? + + + Para isso você pode usar @extend@, que vai puxar todos os métodos do módulo pra dentro de uma classe ou um objeto. + + + <pre> + >> class FundacaoDeAmorEAmparoTimeWarnerAolCitibank; end + >> FundacaoDeAmorEAmparoTimeWarnerAolCitibank.extend AtenciosaSantaInes + >> FundacaoDeAmorEAmparoTimeWarnerAolCitibank::instance_methods + => ["timida_garota_com_cara_de_raposa"] + </pre> + + + Na verdade, ninguém _roubou_ da @AtenciosaSantaInes@, somente pegaram emprestado. + A @timida_garota_com_cara_de_raposa@ agora tem dois endereços. + + + Você deve admitir. O velho mosteiro pode ser comprado um zilhão de vezes e a pequena garota-com-cara-de-raposa + _ainda_ estará nos fundos no armário banana esperando uma bolota de carvalho! Que pena que não podemos alimentá-la. + Ela é um método sem argumentos. + + + When Dr. Cham came out refreshed, the filmstrip was a bit behind. Mas a cabra não notou, + então o Doutor avançou alguns quadros até fazer algum sentido. + + + !i/filmstrip-2.gif(The goats that told a planet it was ugly.)! + + + Então os invasores deixaram o planeta. + + + "Este planeta _é_ decrépito," disse o Dr. Cham. "O castelo é bacana. Mas por dentro + é um desastre." + + + "O castelo parece uma projeção," disse a cabra. "All the flowers + and apple blossoms and the sky even. É uma projeção de baixa resolução." + + + "Sim? Ele é encantador." + + + "I guess." + + + !i/filmstrip-3.gif(The spool ends.)! + + + "That's messed up!" said the goat. "Não é assim que o filme termina! + Não teve sangue! O que aconteceu? O que aconteceu? Você apertou o botão errado, idiota?" + + + "Bem, eu não sei," disse o Dr. Cham. Ele girou o botão pra frente e pra trás. + Tapped the lens. + + + "Cheque a fita! Cheque a fita!" + + + Dr. Cham tirou um pedaço do filme do alimentador do projetor, derretido e pingando + nas pontas. + + + "Maldição! Estes projetores são de qualidade! Nunca vi isso acontecer. Não pode ser." + + + h3. Hunting For a Voice + + + "Eu não acho que tenha sido o projetor," disse o Dr. Cham. "Something flew across that screen + and uttered a blistering moan." + + + "I don't have any dupes of that movie," said the goat somberly. "And that girl. That casting + director. I never see her anymore." + + + Dr. Cham stood up and looked over the dumpy aisles of magnetic carnage, searching. + + + "Oh, hey, you should call that girl," the goat went on. "You could talk to her, get an understanding. + Tell her about me. Don't act like your my friend, just, you know, 'Oh, that guy? + Yeah, whatta maroon.'" + + + Dr. Cham spotted the doorway and exited. + + + The hallways were an entirely new world of mess. In the goat's archives, the shelves had been messy. + In the hallway, shelves were completely tipped. Sinks were falling through the ceiling. + The Doctor ventured under the debris, kicking through plywood when necessary. + + + "You shouldn't be out here," said the goat. "You're on someone else's property at this point. + A couple of pygmy elephants own all this. They're nasty guys. They'll beat the crap outta you + with their trunks. They ball it up and just whack ya." + + + Dr. Cham pushed a file cabinet out of his way, which fell through a flimsy wall, then through + the floor of the next room over. And they heard it fall through several floors after that. + + + "I'm trying to remember how it goes in the book," said Dr. Cham, as he walked swiftly through + the hall. "That milky fog that swept + across the projection. We find that thing." He jiggled a door handle, broke it off. Forged + through the doorway and disappeared inside. + + + "You really get a kick out of beating stuff up, don't you?" said the goat. "Walls, doors." + The goat headbutted a wall. The wall shuddered and then laid still. + + + Then, it was quiet. And black. + + + The goat stayed put in the bleak hallway, expecting Dr. Cham to flip over a few desks and emerge, + ready to move on from the room he'd busted into. But Dr. Cham didn't return, and the goat opted + to share a moment with the neglected wreckage left by his neighbors. Not that he could see at all. + He could only hear the occassional rustling of the piles of invoices and carbon copy masters and + manila envelopes when he shifted his legs. + + + The ground seemed to buckling right under the goat, as if the heaps of kipple around him were + beginning to slide toward his weight. He would be at the center of this whirlpool of elephant + documentation. Would he die of papercuts first? Or would he suffocate under the solid burial + by office supplies? + + + A soft light, however, crept up to him. A floating, silver fish. No, it was a -- was it scissors? + The scissors grew into a shimmering cluster of intellegent bread, each slice choking on glitter. + But, no, it was hands. And an Easter hat. + + + !i/hannah-1.gif(The goat alone in the hallway, meets an apparition.)! + + + In another room, Dr. Cham stood under the clear glass silently. The ceiling had abruptly + gone transparent, then starlight washed over his pants and jacket. He walked further to + the room's center in muted colors, lit as softly as an ancient manuscript in its own box at + the museum. More stars, more cotton clusters of fire, unveiled as he came across the floor. + And it peeked into view soon enough, he expected it to be larger, but it wasn't. + + + Earth. Like a painted egg, still fresh. He felt long cello strings sing right up + against his spine. How could that be called Peoplemud? Here was a vibrant and grassy + lightbulb. The one big ball that had something going for it. + + + He thought of The Rockettes. Actually, he missed The Rockettes. What a bunch of + great dancers. He had yelled something to The Rockettes when he saw them. Something + very observant and flattering. + + + Oh, yes, while The Rockettes were spinning, arm in arm, he had yelled, "Concentric circles!" + Which no one else cared to observe. + + + And this thought was enough to feed Dr. Cham's superiority complex. He wore a goofy + smile as he retraced his footsteps. He truthfully felt his genius coming through in + such a statement. To realize the simplicity of a circle was his. He reflected on it + all the way back to the hallway. + + + Which I think is great. Adore yourself when you have a second. + + + !i/hannah-2.gif(The Doctor knows this ghost.)! + + + "Oh, right," said the goat. "Your niece. The niece you killed. I'm with ya now." + + + For just a few moments, they all looked at each other. Just enough + time for both Dr. Cham and the goat to think: _Oh, yeah. Hannah + causes us a lot of trouble. She's already talking about maple donuts._ + + + "Does she start talking about maple donuts right away like that?" + asked the goat. + + + "Yes, she does," said the Doctor. "She brings it up to you, then + she brings it up to me. She sees a maple donut somewhere -- I don't + quite remember where." + + + "Do I see a real maple donut?" Hannah said. "I need a real one." + + + "Okay, okay," said the goat. "Yeah, I remember: here's where she says + that if she gets a real maple donut, she'll become a real person again. + Because her real destiny was to own a bakery and you ruined that destiny + and now she's trapped as a ghost." + + + "Hey, that's the truth!" Hannah yelped. + + + "It's terrible that we must bear through this whole scene again," said + the Doctor. "The donuts are immaterial. They should be left out altogether." + + + "Man, I am having a _hard_ time remembering all of this chapter," said + the goat. "I don't even remember how to get out of this hallway. I must + have read that book like thirty times. Do we blast through a wall? Do + we scream until someone finds us?" + + + "We get Hannah to float through walls and she finds some kind of machine," + says Dr. Cham. "I have to write a program -- it all works out somehow." + + + "But, you know what I'm saying?" said the goat. "I forget all the details. + Especially the earlier chapters. I mean I can remember the ending perfectly. + It's hard to sit through all this. The end is so much better." + + + Dr. Cham folded his arms and teetered on a heel. "The porcupine." He + smiled greedily at the goat. + + + "Oh, totally. The porcupine is definitely who I want to meet," said the + goat. "I wonder what he does with all that money when the book is over." + + + Dr. Cham nodded respectfully. "I'm very excited to see him wearing slippers." + + + "Those infernal slippers!" said the goat and he haw-hawed coarsely, a shower + of saliva cascading from his jaws. + + + Hannah's mind rattled, waiting for this nonsense to break for a moment. + She tipped her head on its side and the rattle slid along the curve of + her cranium. The little noise died away, though, as the back of her head + vanished (_fluxed out_ is what she called it) and then her head was + back again with its little rattle and she caught herself doing that + careless moaning again. *HRRRRRR-RRR-OH-RRRR-RRRR.* + + + "I'm not as into the chunky bacon stuff," said the goat. "I don't see + what's so great about it." + + + Could she speak while moaning? *BON-BON.* Com um sotaque francês. *BOHN-BOHN. + BOHN-APPE-TEET-OHHHH-RRRR.* + + + "I know she's harmless, but that sound freaks me out. My hair is + *completely* on end." + + + "Hannah?" disse o Dr. Cham. "Onde você está, criança? Come do a good turn + for us, my niece." + + + She was right near them, in and out. And they could hear her + cleaning up her voice, bright, speaking like a angel scattering stardust. + Yes, the whole maple donut story came out again, and more about the + bakery she would own, the muffins and rolls and baguettes. + + lang-pt/poignant-49.yml @@ -1,416 +1,416 @@ - - O Roubo do Capitão Loteria: > - - - !>i/my.daughters.organ-3.gif(Os tubos e misturas das loterias.)! - - - E agora, as histórias das Loterias Paij-ree. - - - Em Endertromb, o pai do inventou a loteria. A idéia surgiu quando estava rezando - para Escavador Dosh. - - - Escavador Dosh é uma espécie de deus para eles. Mas dez vezes mais - assustador. Esse cara cava um túnel infinitamente profundo através do planeta - e sai morto. Mas ele não está realmente morto. Ele está realmente _um segundo_ - atrás deles. E ele come tempo. - - - É mais ou menos complicado, porque o Escavador Dosh mata totalmente as pessoas. Mas - eu convido você a fazer o que ele diz, ele não é tão mal. Talvez eu fale sobre isso - mais tarde. É um tal de fala sobre dor, porque isso é tão assustador e ainda um dos - meus amigos realmente acredita em tudo isso. Eu consigo um tipo de - estrangulador -- não que eu esteja precisando, mais - I get kind of choked up -- not like I'm crying, more like I'm choking. - - - De qualquer forma, enquanto rezava, três números vieram para o pai do Paij-ree. - - - Ele então se perguntou. "O que são esses números?" - - - E sua mente tocou um pequeno vídeo clip dele vendendo todos os tipos de números. E, - por anos e anos, viajando e vendendo números. - - - E ele perguntou ao seu cérebro, "Pessoas comprarão números?" - - - E seu cérebro disse, "Se eles compram o direito de três números, dê-lhes um prémio." - - - Pelo que ele mesmo imaginava um salto alto com um ski e jogando neve nas pessoas - presentes. Não questione: ele seria um ícone. - - - Então ele foi e fez o que seu cérebro disse e vendeu números. O pai da loteria - simples consistia em três únicos números, retirados de um conjunto de 25 números. - - - <pre> - class BilheteLoteria - - INTERVALO_NUMERICO = 1..25 - - attr_reader :numeros_escolhidos, :data_compra - - def initialize( *numeros_escolhidos ) - if numeros_escolhidos.length != 3 - raise ArgumentError, "três números devem ser escolhido" - elsif numeros_escolhidos.uniq.length != 3 - raise ArgumentError, "os três escolhidos devem ser números diferentes" - elsif numeros_escolhidos.detect { |p| not INTERVALO_NUMERICO === p } - raise ArgumentError, "os três escolhidos devem ser números entre 1 e 25." - end - @numeros_escolhidos = numeros_escolhidos - @data_compra = Time.now - end - - end - </pre> - - - Sim, a classe @BilheteLoteria@ contém os três números (@@numeros_escolhidos@) e o - momento em que o bilhete foi adquirido (@@data_compra@). O intervalo de números - permitidos (de *um* a *vinte e cinco*) é mantido na constante @INTERVALO_NUMERICO@. - - - O método @initialize@ pode ter qualquer número de argumentos passados. O *asterísco* - no argumento @numeros_escolhidos@ significa que *quaisquer argumentos serão passados - como um Array*. Tendo os argumentos em um Array significa que métodos como @uniq@ e - @detect@ podem ser usados juntos nos argumentos. - - - Esta classe contém duas definições: o método de definição (@def@) e um - de definição de atributos (@attr_reader@). Ambos são, realmente, *apenas métodos de - definição*. - - - O @attr_reader@ é um atalho idêntico à escrever o este código Ruby: - - - <pre> - class BilheteLoteria - def numeros_escolhidos; @numeros_escolhidos; end - def data_compra; @data_compra; end - end - </pre> - - - Atributos são métodos empacotados para variáveis de instância (assim como - @@numeros_escolhidos@) que podem ser usados *fora da própria classe*. Pai da - Paij-ree queria codificar uma máquina que pudesse ler números e a data da - compra do bilhete. Para fazer isso, estas variáveis de instância devem ser expostas. - - - Vamos criar um bilhete aleatório e ler os números de volta: - - - <pre> - bilhete = BilheteLoteria.new( rand( 25 ) + 1, - rand( 25 ) + 1, rand( 25 ) + 1 ) - p bilhete.numeros_escolhidos - </pre> - - - Executando o código acima, eu apenas pego: @[23, 14, 20]@. Você receberá um - erro se acontecer dos dois números aleatórios serem idênticos. - - - Entretanto, eu não posso mudar os números escolhidos no bilhete de loteria de - fora da classe. - - - <pre> - bilhete.numeros_escolhidos = [2, 6, 19] - </pre> - - - Eu receberei um erro: @undefined method `numeros_escolhidos=`@ - Isto porque @attr_reader@ somente adiciona um método de *leitura*, não um método - de escrita. Embora isso seja bom. Nós não queremos mudanças nos números ou na - data. - - - Então, os bilhetes são _objetos_. Instâncias da classe @BilheteLoteria@. Faça - um bilhete com @BilheteLoteria.new@. Cada bilhete tem as suas variáveis de instância - @@numeros_escolhidos@ e @@data_compra@. - - - O capitão loteria teria necessidade de gerar três números aleatórios no - encerramento do sorteio, por isso vamos acrescentar um método de classe - conveniente para geração aleatória de bilhetes. - - - <pre> - class BilheteLoteria - def self.novo_aleatorio - new( rand( 25 ) + 1, rand( 25 ) + 1, rand( 25 ) + 1 ) - end - end - </pre> - - - Oh, não. Mas nós temos um estúpido erro que aparece quando dois dos números - aleatórios são idênticos. Se dois números são iguais, o @initialize@ lança um - @ArgumentError@. - - - O truque é voltar e reiniciar o método se um erro acontecer. - Nós podemos usar o @rescue@ (_resgate_) do Ruby para apanhar o erro e @redo@ - (_refazer_) o método do início. - - - <pre> - class BilheteLoteria - def self.novo_aleatorio - new( rand( 25 ) + 1, rand( 25 ) + 1, rand( 25 ) + 1 ) - rescue ArgumentError - redo - end - end - </pre> - - - Melhor. Pode demorar duas vezes mais para os números cairem juntos - corretamente, mas cairão. O tempo de espera fará o suspense, não? - - - O capitão loteria mantém um registro de todos que compraram bilhetes, - junto com os números sorteados. - - - <pre> - class SorteioLoteria - @@bilhetes = {} - def SorteioLoteria.comprado_por( cliente, *bilhetes ) - unless @@bilhetes.has_key?( cliente ) - @@bilhetes[cliente] = [] - end - @@bilhetes[cliente] += bilhetes - end - end - </pre> - - - Yal-dal-rip-sip foi o primeiro cliente. - - - <pre> - SorteioLoteria.comprado_por 'Yal-dal-rip-sip', - BilheteLoteria.new( 12, 6, 19 ), - BilheteLoteria.new( 5, 1, 3 ), - BilheteLoteria.new( 24, 6, 8 ) - </pre> - - - Quando chega a hora de sortear a loteria, o pai do Paij-ree (o capitão loteria) - adiciona um bit de código para selecionar aleatoriamente os números. - - - <pre> - class BilheteLoteria - def pontuacao( final ) - contador = 0 - final.numeros_escolhidos.each do |nota| - contador += 1 if numeros_escolhidos.include? nota - end - contador - end - end - </pre> - - - O método @pontuacao@ compara um @BilheteLoteria@ com um bilhete aleatório, - o qual representa a combinação vencedora. O bilhete aleatório é passado - através da variável @final@. O bilhete recupera um ponto para todo número - vencedor. A pontuação final é retornada pelo método @pontuacao@. - - - <pre> - irb> bilhete = BilheteLoteria.new( 2, 5, 19 ) - irb> vencedor = BilheteLoteria.new( 4, 5, 19 ) - irb> bilhete.pontuacao( vencedor ) - => 2 - </pre> - - - Você verá como Paij-ree é brilhante, em tempo hábil. Seu pai lhe encarregou - de finalizar a loteria para ele, enquanto a demanda de bilhetes consumidos... - - Você não pode apenas imaginar o jovem Paij-ree em seu escritório, - - You will see how brilliant Paij-ree is, in time. His father commissioned him - to finish the lottery for him, while the demand for tickets consumed the - lottery captain's daylight hours. Can't you just imagine young Paij-ree in his stuffy - suit, snapping a rubber band in his young thumbs at the company meetings where he proposed the - final piece of the system? Sure, when he stood up, his dad did all the talking for - him, but he flipped on the projector and performed all the hand motions. - - - <pre> - class << SorteioLoteria - def joga - final = BilheteLoteria.novo_aleatorio - vencedores = {} - @@bilhetes.each do |comprador, lista_bilhetes| - lista_bilhetes.each do |bilhete| - pontuacao = bilhete.pontuacao( final ) - next if pontuacao.zero? - vencedores[comprador] ||= [] - vencedores[comprador] << [ bilhete, pontuacao ] - end - end - @@bilhetes.clear - vencedores - end - end - </pre> - - - His father's associates were stunned. What was this? (Paij-ree knew this - was just another class method definition -- they would all feel completely - demoralized when he told them so.) They couldn't understand the *double - angle bracket* up there! Yes, it was a concatenator, but how is it in - the class title? - - - _Infants_, thought Paij-ree, although he held everyone of those men in very - high esteem. He was just a kid and kids are tough as a brick's teeth. - - - O operador @<<@ permite à você alterar a definição de um objeto. - Paij-ree simplesmente tinha usado a classe @SorteioLoteria@, e o método - dele, @joga@, seria um método de instância normal. Mas, uma vez que ele - usou o operador @<<@, o método @joga@ será adicionado diretamente à classe, - como um método de classe. - - - Quando você viu @class << objeto@, acredite em seu coração, _eu estou adicionando diretamente - para a definição de @objeto@._ - - - A - The budding organ instructor also threw in a tricky syntax worth examining. - In the ninth line, a winner has been found. - - - <pre> - winners[buyer] ||= [] - winners[buyer] << [ ticket, score ] - </pre> - - - The @||=@ syntax is a shortcut. - - - <pre> - winners[buyer] = winners[buyer] || [] - </pre> - - - The *double pipe* is an *or* logic. Set @winners[buyer]@ equal to @winners[buyer]@ or, - if @winners[buyer]@ is nil, set it to @[]@. This shortcut is a little strange, but if you - can really plant it in your head, it's a nice timesaver. You're just making sure a variable - is set before using it. - - - <pre> - irb> LotteryDraw.play.each do |winner, tickets| - irb> puts winner + "won on " + tickets.length + " ticket(s)!" - irb> tickets.each do |ticket, score| - irb> puts "\t" + ticket.picks.join( ', ' ) + ": " + score - irb> end - irb> end - - Gram-yol won on 2 ticket(s)! - 25, 14, 33: 1 - 12, 11, 29: 1 - Tarker-azain won on 1 ticket(s)! - 13, 15, 29: 2 - Bramlor-exxon won on 1 ticket(s)! - 2, 6, 14: 1 - </pre> - - - But these salad days were not to continue for Paij-ree and his father. His father often - neglected to launder his uniform and contracted a moss disease on his shoulders. The disease - gradually stole his equilibrium and his sense of direction. - - - His father still futilely attempted to keep the business running. He spiraled through the - city, sometimes tumbling leg-over-leg down the cobbled stone, most often slowly feeling the walls, - counting bricks to the math parlours and coachmen stations, where he would thrust tickets - at the bystanders, who hounded him and slapped him away with long, wet beets. Later, Paij-ree - would find him in a corner, his blood running into the city drains alongside the juices of the - dark, splattered beets, which juice weaseled its way up into his veins and stung and clotted - and glowed fiercely like a congested army of brake lights fighting their way through toll bridges. - - - h3. A Word About Accessors (Because I Love You and I Hope For Your Success and My Hair is On End - About This and Dreams Really Do Come True) - - - Earlier, I mentioned that @attr_reader@ adds *reader* methods, but not *writer* methods. - - - <pre> - irb> ticket = LotteryTicket.new - irb> ticket.picks = 3 - NoMethodError: undefined method `picks=' for #<LotteryTicket:0xb7d49110> - </pre> - - - Which is okay in this case, since Paij-ree's father didn't want the numbers to be - changed after the ticket was bought. If we were interested in having instance - variables which had *both readers and writers*, we would use @attr_accessor@. - - - <pre> - class LotteryTicket - attr_accessor :picks, :purchased - end - </pre> - - - Which is exactly the same as this lengthier code: - - - <pre> - class LotteryTicket - def picks; @picks; end - def picks=(var); @picks = var; end - def purchased; @purchased; end - def purchased=(var); @purchased = var; end - end - </pre> - - - Holy cats! Look at those writer methods for a moment. They are the methods named - @picks=@ and @purchased=@. These methods *intercept outside assignment* to instance variables. - Usually you will just let @attr_reader@ or @attr_accessor@ (or even perhaps @attr_writer@) - do the work for you. - Other times you may want to put a guard at the door yourself, checking variables in closer - detail. - - - <pre> - class SkatingContest - def the_winner; @the_winner; end - def the_winner=( name ) - unless name.respond_to? :to_str - raise ArgumentError, "The winner's name must be a String, - not a math problem or a list of names or any of that business." - end - @the_winner = name - end - end - </pre> - - - Most of the time you won't use this. But, as we move along through your lessons, you'll find that - Ruby has lots of escape hatches and alley ways you can sneak into and hack code into. I'm also - preparing you for metaprogramming, which, if you can smell that dragon, is ominously near. - + - O Roubo do Capitão Loteria: > + + + !>i/my.daughters.organ-3.gif(Os tubos e misturas das loterias.)! + + + E agora, as histórias das Loterias Paij-ree. + + + Em Endertromb, o pai do inventou a loteria. A idéia surgiu quando estava rezando + para Escavador Dosh. + + + Escavador Dosh é uma espécie de deus para eles. Mas dez vezes mais + assustador. Esse cara cava um túnel infinitamente profundo através do planeta + e sai morto. Mas ele não está realmente morto. Ele está realmente _um segundo_ + atrás deles. E ele come tempo. + + + É mais ou menos complicado, porque o Escavador Dosh mata totalmente as pessoas. Mas + eu convido você a fazer o que ele diz, ele não é tão mal. Talvez eu fale sobre isso + mais tarde. É um tal de fala sobre dor, porque isso é tão assustador e ainda um dos + meus amigos realmente acredita em tudo isso. Eu consigo um tipo de + estrangulador -- não que eu esteja precisando, mais + I get kind of choked up -- not like I'm crying, more like I'm choking. + + + De qualquer forma, enquanto rezava, três números vieram para o pai do Paij-ree. + + + Ele então se perguntou. "O que são esses números?" + + + E sua mente tocou um pequeno vídeo clip dele vendendo todos os tipos de números. E, + por anos e anos, viajando e vendendo números. + + + E ele perguntou ao seu cérebro, "Pessoas comprarão números?" + + + E seu cérebro disse, "Se eles compram o direito de três números, dê-lhes um prémio." + + + Pelo que ele mesmo imaginava um salto alto com um ski e jogando neve nas pessoas + presentes. Não questione: ele seria um ícone. + + + Então ele foi e fez o que seu cérebro disse e vendeu números. O pai da loteria + simples consistia em três únicos números, retirados de um conjunto de 25 números. + + + <pre> + class BilheteLoteria + + INTERVALO_NUMERICO = 1..25 + + attr_reader :numeros_escolhidos, :data_compra + + def initialize( *numeros_escolhidos ) + if numeros_escolhidos.length != 3 + raise ArgumentError, "três números devem ser escolhido" + elsif numeros_escolhidos.uniq.length != 3 + raise ArgumentError, "os três escolhidos devem ser números diferentes" + elsif numeros_escolhidos.detect { |p| not INTERVALO_NUMERICO === p } + raise ArgumentError, "os três escolhidos devem ser números entre 1 e 25." + end + @numeros_escolhidos = numeros_escolhidos + @data_compra = Time.now + end + + end + </pre> + + + Sim, a classe @BilheteLoteria@ contém os três números (@@numeros_escolhidos@) e o + momento em que o bilhete foi adquirido (@@data_compra@). O intervalo de números + permitidos (de *um* a *vinte e cinco*) é mantido na constante @INTERVALO_NUMERICO@. + + + O método @initialize@ pode ter qualquer número de argumentos passados. O *asterísco* + no argumento @numeros_escolhidos@ significa que *quaisquer argumentos serão passados + como um Array*. Tendo os argumentos em um Array significa que métodos como @uniq@ e + @detect@ podem ser usados juntos nos argumentos. + + + Esta classe contém duas definições: o método de definição (@def@) e um + de definição de atributos (@attr_reader@). Ambos são, realmente, *apenas métodos de + definição*. + + + O @attr_reader@ é um atalho idêntico à escrever o este código Ruby: + + + <pre> + class BilheteLoteria + def numeros_escolhidos; @numeros_escolhidos; end + def data_compra; @data_compra; end + end + </pre> + + + Atributos são métodos empacotados para variáveis de instância (assim como + @@numeros_escolhidos@) que podem ser usados *fora da própria classe*. Pai da + Paij-ree queria codificar uma máquina que pudesse ler números e a data da + compra do bilhete. Para fazer isso, estas variáveis de instância devem ser expostas. + + + Vamos criar um bilhete aleatório e ler os números de volta: + + + <pre> + bilhete = BilheteLoteria.new( rand( 25 ) + 1, + rand( 25 ) + 1, rand( 25 ) + 1 ) + p bilhete.numeros_escolhidos + </pre> + + + Executando o código acima, eu apenas pego: @[23, 14, 20]@. Você receberá um + erro se acontecer dos dois números aleatórios serem idênticos. + + + Entretanto, eu não posso mudar os números escolhidos no bilhete de loteria de + fora da classe. + + + <pre> + bilhete.numeros_escolhidos = [2, 6, 19] + </pre> + + + Eu receberei um erro: @undefined method `numeros_escolhidos=`@ + Isto porque @attr_reader@ somente adiciona um método de *leitura*, não um método + de escrita. Embora isso seja bom. Nós não queremos mudanças nos números ou na + data. + + + Então, os bilhetes são _objetos_. Instâncias da classe @BilheteLoteria@. Faça + um bilhete com @BilheteLoteria.new@. Cada bilhete tem as suas variáveis de instância + @@numeros_escolhidos@ e @@data_compra@. + + + O capitão loteria teria necessidade de gerar três números aleatórios no + encerramento do sorteio, por isso vamos acrescentar um método de classe + conveniente para geração aleatória de bilhetes. + + + <pre> + class BilheteLoteria + def self.novo_aleatorio + new( rand( 25 ) + 1, rand( 25 ) + 1, rand( 25 ) + 1 ) + end + end + </pre> + + + Oh, não. Mas nós temos um estúpido erro que aparece quando dois dos números + aleatórios são idênticos. Se dois números são iguais, o @initialize@ lança um + @ArgumentError@. + + + O truque é voltar e reiniciar o método se um erro acontecer. + Nós podemos usar o @rescue@ (_resgate_) do Ruby para apanhar o erro e @redo@ + (_refazer_) o método do início. + + + <pre> + class BilheteLoteria + def self.novo_aleatorio + new( rand( 25 ) + 1, rand( 25 ) + 1, rand( 25 ) + 1 ) + rescue ArgumentError + redo + end + end + </pre> + + + Melhor. Pode demorar duas vezes mais para os números cairem juntos + corretamente, mas cairão. O tempo de espera fará o suspense, não? + + + O capitão loteria mantém um registro de todos que compraram bilhetes, + junto com os números sorteados. + + + <pre> + class SorteioLoteria + @@bilhetes = {} + def SorteioLoteria.comprado_por( cliente, *bilhetes ) + unless @@bilhetes.has_key?( cliente ) + @@bilhetes[cliente] = [] + end + @@bilhetes[cliente] += bilhetes + end + end + </pre> + + + Yal-dal-rip-sip foi o primeiro cliente. + + + <pre> + SorteioLoteria.comprado_por 'Yal-dal-rip-sip', + BilheteLoteria.new( 12, 6, 19 ), + BilheteLoteria.new( 5, 1, 3 ), + BilheteLoteria.new( 24, 6, 8 ) + </pre> + + + Quando chega a hora de sortear a loteria, o pai do Paij-ree (o capitão loteria) + adiciona um bit de código para selecionar aleatoriamente os números. + + + <pre> + class BilheteLoteria + def pontuacao( final ) + contador = 0 + final.numeros_escolhidos.each do |nota| + contador += 1 if numeros_escolhidos.include? nota + end + contador + end + end + </pre> + + + O método @pontuacao@ compara um @BilheteLoteria@ com um bilhete aleatório, + o qual representa a combinação vencedora. O bilhete aleatório é passado + através da variável @final@. O bilhete recupera um ponto para todo número + vencedor. A pontuação final é retornada pelo método @pontuacao@. + + + <pre> + irb> bilhete = BilheteLoteria.new( 2, 5, 19 ) + irb> vencedor = BilheteLoteria.new( 4, 5, 19 ) + irb> bilhete.pontuacao( vencedor ) + => 2 + </pre> + + + Você verá como Paij-ree é brilhante, em tempo hábil. Seu pai lhe encarregou + de finalizar a loteria para ele, enquanto a demanda de bilhetes consumidos... + + Você não pode apenas imaginar o jovem Paij-ree em seu escritório, + + You will see how brilliant Paij-ree is, in time. His father commissioned him + to finish the lottery for him, while the demand for tickets consumed the + lottery captain's daylight hours. Can't you just imagine young Paij-ree in his stuffy + suit, snapping a rubber band in his young thumbs at the company meetings where he proposed the + final piece of the system? Sure, when he stood up, his dad did all the talking for + him, but he flipped on the projector and performed all the hand motions. + + + <pre> + class << SorteioLoteria + def joga + final = BilheteLoteria.novo_aleatorio + vencedores = {} + @@bilhetes.each do |comprador, lista_bilhetes| + lista_bilhetes.each do |bilhete| + pontuacao = bilhete.pontuacao( final ) + next if pontuacao.zero? + vencedores[comprador] ||= [] + vencedores[comprador] << [ bilhete, pontuacao ] + end + end + @@bilhetes.clear + vencedores + end + end + </pre> + + + His father's associates were stunned. What was this? (Paij-ree knew this + was just another class method definition -- they would all feel completely + demoralized when he told them so.) They couldn't understand the *double + angle bracket* up there! Yes, it was a concatenator, but how is it in + the class title? + + + _Infants_, thought Paij-ree, although he held everyone of those men in very + high esteem. He was just a kid and kids are tough as a brick's teeth. + + + O operador @<<@ permite à você alterar a definição de um objeto. + Paij-ree simplesmente tinha usado a classe @SorteioLoteria@, e o método + dele, @joga@, seria um método de instância normal. Mas, uma vez que ele + usou o operador @<<@, o método @joga@ será adicionado diretamente à classe, + como um método de classe. + + + Quando você viu @class << objeto@, acredite em seu coração, _eu estou adicionando diretamente + para a definição de @objeto@._ + + + A + The budding organ instructor also threw in a tricky syntax worth examining. + In the ninth line, a winner has been found. + + + <pre> + winners[buyer] ||= [] + winners[buyer] << [ ticket, score ] + </pre> + + + The @||=@ syntax is a shortcut. + + + <pre> + winners[buyer] = winners[buyer] || [] + </pre> + + + The *double pipe* is an *or* logic. Set @winners[buyer]@ equal to @winners[buyer]@ or, + if @winners[buyer]@ is nil, set it to @[]@. This shortcut is a little strange, but if you + can really plant it in your head, it's a nice timesaver. You're just making sure a variable + is set before using it. + + + <pre> + irb> LotteryDraw.play.each do |winner, tickets| + irb> puts winner + "won on " + tickets.length + " ticket(s)!" + irb> tickets.each do |ticket, score| + irb> puts "\t" + ticket.picks.join( ', ' ) + ": " + score + irb> end + irb> end + + Gram-yol won on 2 ticket(s)! + 25, 14, 33: 1 + 12, 11, 29: 1 + Tarker-azain won on 1 ticket(s)! + 13, 15, 29: 2 + Bramlor-exxon won on 1 ticket(s)! + 2, 6, 14: 1 + </pre> + + + But these salad days were not to continue for Paij-ree and his father. His father often + neglected to launder his uniform and contracted a moss disease on his shoulders. The disease + gradually stole his equilibrium and his sense of direction. + + + His father still futilely attempted to keep the business running. He spiraled through the + city, sometimes tumbling leg-over-leg down the cobbled stone, most often slowly feeling the walls, + counting bricks to the math parlours and coachmen stations, where he would thrust tickets + at the bystanders, who hounded him and slapped him away with long, wet beets. Later, Paij-ree + would find him in a corner, his blood running into the city drains alongside the juices of the + dark, splattered beets, which juice weaseled its way up into his veins and stung and clotted + and glowed fiercely like a congested army of brake lights fighting their way through toll bridges. + + + h3. A Word About Accessors (Because I Love You and I Hope For Your Success and My Hair is On End + About This and Dreams Really Do Come True) + + + Earlier, I mentioned that @attr_reader@ adds *reader* methods, but not *writer* methods. + + + <pre> + irb> ticket = LotteryTicket.new + irb> ticket.picks = 3 + NoMethodError: undefined method `picks=' for #<LotteryTicket:0xb7d49110> + </pre> + + + Which is okay in this case, since Paij-ree's father didn't want the numbers to be + changed after the ticket was bought. If we were interested in having instance + variables which had *both readers and writers*, we would use @attr_accessor@. + + + <pre> + class LotteryTicket + attr_accessor :picks, :purchased + end + </pre> + + + Which is exactly the same as this lengthier code: + + + <pre> + class LotteryTicket + def picks; @picks; end + def picks=(var); @picks = var; end + def purchased; @purchased; end + def purchased=(var); @purchased = var; end + end + </pre> + + + Holy cats! Look at those writer methods for a moment. They are the methods named + @picks=@ and @purchased=@. These methods *intercept outside assignment* to instance variables. + Usually you will just let @attr_reader@ or @attr_accessor@ (or even perhaps @attr_writer@) + do the work for you. + Other times you may want to put a guard at the door yourself, checking variables in closer + detail. + + + <pre> + class SkatingContest + def the_winner; @the_winner; end + def the_winner=( name ) + unless name.respond_to? :to_str + raise ArgumentError, "The winner's name must be a String, + not a math problem or a list of names or any of that business." + end + @the_winner = name + end + end + </pre> + + + Most of the time you won't use this. But, as we move along through your lessons, you'll find that + Ruby has lots of escape hatches and alley ways you can sneak into and hack code into. I'm also + preparing you for metaprogramming, which, if you can smell that dragon, is ominously near. + lang-pt/poignant-50.yml @@ -1,75 +1,75 @@ - - !^sidebar - Another Excerpt from The Scarf Eaters: > - - (_from Chapter VIII: Sky High_.) - - - "I know you," said Brent. "And I know your timelines. - You couldn't have done this Flash piece." - - - "So, you're saying I'm predictable?" said Deborah. She - opened her hands and the diced potatoes stumbled like little, - drunk sea otters happily into the open crockpot. - - - "You're very linear," said Brent. He took up a mechanical pencil, - held it straight before his eyes, gazing tightly at it before - replacing it in the pencil holder on the counter. "Do you - even know how to load a scene? How to jump frames? This - movie I saw was all over the place, Deb." - - - She heaped five knit scarves and a single bandana into the slow - cooker and set it on high. She closed the lid, leaving her hand - resting upon it. - - - "What is it about this movie?" Deborah asked. "You go to - Flash sites all the time. You played the Elf Snowball game - for two seconds, it didn't interest you. You didn't care for - Elf Bowling games even. And you weren't even phased by that - Hit The Penguin flash game. Elf versus Penguin? Don't even - ask! - - - "Now this movie comes along and you can't get a grip." - She walked over and siddled up next to him. "Yo, bro, it's me. - Deborah. What happened when you saw that movie?" - - - "Everything," said Brent, his eyes reflecting a million worlds. - "And: nothing. It opened with a young girl riding upon a wild - boar. She was playing harmonica. The harmonica music washed in - and out, uneasy, unsure. But she rode naturally, as if it wasn't - anything of a big deal to ride a wild boar. And with - Flash, riding a wild boar really isn't a big deal." - - - Deborah unclasped her bracelet and set it on the counter by the - crockpot. - - - "The bottom of the movie started to break up, an ink puddle formed. - The boar reared up, but his legs gave way to the all the dark, - sputtering ink." - - - "Dark clouds converged. Hardcore music started to play. Secret - agents came out of the clouds. CIA guys and stuff. The animation - simply rocked. - - - "And then, at the very end of the movie, these words fade upon the - screen. In white, bold letters." - - - "Sky high," said Deborah. - - - "How did you know?" Brent's lip quivered. Could she be trusted? - - - "There is no room left in the world," she said. "No room for Scarf Eaters, - no room for you and I. Here, take my hand." - + - !^sidebar + Another Excerpt from The Scarf Eaters: > + + (_from Chapter VIII: Sky High_.) + + + "I know you," said Brent. "And I know your timelines. + You couldn't have done this Flash piece." + + + "So, you're saying I'm predictable?" said Deborah. She + opened her hands and the diced potatoes stumbled like little, + drunk sea otters happily into the open crockpot. + + + "You're very linear," said Brent. He took up a mechanical pencil, + held it straight before his eyes, gazing tightly at it before + replacing it in the pencil holder on the counter. "Do you + even know how to load a scene? How to jump frames? This + movie I saw was all over the place, Deb." + + + She heaped five knit scarves and a single bandana into the slow + cooker and set it on high. She closed the lid, leaving her hand + resting upon it. + + + "What is it about this movie?" Deborah asked. "You go to + Flash sites all the time. You played the Elf Snowball game + for two seconds, it didn't interest you. You didn't care for + Elf Bowling games even. And you weren't even phased by that + Hit The Penguin flash game. Elf versus Penguin? Don't even + ask! + + + "Now this movie comes along and you can't get a grip." + She walked over and siddled up next to him. "Yo, bro, it's me. + Deborah. What happened when you saw that movie?" + + + "Everything," said Brent, his eyes reflecting a million worlds. + "And: nothing. It opened with a young girl riding upon a wild + boar. She was playing harmonica. The harmonica music washed in + and out, uneasy, unsure. But she rode naturally, as if it wasn't + anything of a big deal to ride a wild boar. And with + Flash, riding a wild boar really isn't a big deal." + + + Deborah unclasped her bracelet and set it on the counter by the + crockpot. + + + "The bottom of the movie started to break up, an ink puddle formed. + The boar reared up, but his legs gave way to the all the dark, + sputtering ink." + + + "Dark clouds converged. Hardcore music started to play. Secret + agents came out of the clouds. CIA guys and stuff. The animation + simply rocked. + + + "And then, at the very end of the movie, these words fade upon the + screen. In white, bold letters." + + + "Sky high," said Deborah. + + + "How did you know?" Brent's lip quivered. Could she be trusted? + + + "There is no room left in the world," she said. "No room for Scarf Eaters, + no room for you and I. Here, take my hand." + lang-pt/poignant-51.yml @@ -1,144 +1,144 @@ - - > - Paij-ree was an enterprising young Endertromaltoek. He hammered animal bones into long, - glistening trumpets with deep holes that were plugged by corks the musicians banded to - their fingers. Sure, he only sold three of those units, but he was widely reviled as - a freelance scholar, a demonic one, for he was of a poorer class and the poor only - ever acquired their brilliance through satanic practice. Of course, they were right, - indeed, he did have a bargain with the dark mages, whom he kept appointments with annually, - enduring torturous hot springs, bathing as they chanted spells. - - - He adored his father, even as his father deteriorated into but a gyroscope. He idolized the - man's work and spent his own small earnings playing the lottery. He loved to watch the - numerals, each painted upon hollow clay balls, rise in the _robloch_ (which is any fluid, - pond or spill that has happened to withstand the presence of ghosts), the great bankers - tying them together on a silver string, reading them in order. - - - Even today, Paij-ree paints the scenes with crude strokes of black ink on sheets of aluminum - foil. It is very touching to see him caught up in the preciousness of his memory, but I don't - know exactly why he does it on aluminum foil. His drawings rip too easily. Paij-ree himself - gets mixed up and will serve you crumbcake right off of some of this art, even after it has - been properly framed. So many things about him are troubling and absurd and downright wretched. - - - The disease spread over his father's form and marshy weeds covered his father's hands - and face. The moss pulled his spine up into a rigid uprightness. So thick was the - growth over his head that he appeared to wear a shrub molded into a bowler's hat. He - also called himself by a new name -- *Quos* -- and he healed the people he touched, leaving - a pile of full-blooded, greenly-cheeked villages in his wake as he travelled the - townships. Many called him The Mossiah and wept on his feet, which wet the buds and caused - him to weed into the ground. This made him momentarily angry, he harshly jogged his legs - to break free and thrashed his fists wildly in the sky, bringing down a storm of lightning - shards upon these pitiful. - - - Paij-ree was apart from the spiritual odysseys of his father (in fact, thought the man - dead), so he only saw the decay of the lottery without its captain present. Here is - where Paij-ree went to work, reviving the dead lottery of his family. - - - h3. Gambling with Fewer Fingers - - - The city was crowded with people who had lost interest in the lottery. The weather - had really worn everyone down as well. Such terrible rain flooding their cellars. - The entire city was forced to move up one story. You'd go to put the cap back on your - pen and you'd ruin the pen, since the cap was already full of slosh. Everyone was depleted, - many people drowned. - - - Paij-ree found himself wasting his days in a quadruple bunkbed, the only furniture that - managed to stay above sea level. He slept on the top bed. The third bed up was dry as - well, so he let a homeless crater gull nest upon it. The gull didn't need the whole bed, - so Paij-ree also kept his calculators and pencils down there. - - - At first, these were very dark times for both of them, and they insisted on remaining - haggard at all times. Paij-ree became obsessed with his fingernails, kept them long and - pristine, while the rest of him deteriorated under a suit of hair. In the company of - Paij-ree, the crater gull learned his own eccentrity and plucked all the feathers on - the right side of his body. He looked like a cutaway diagram. - - - They learned to have happier times. Paij-ree carved a flute from the wall with his nails and played - it often. Mostly he played his relaxed ballads during the daytime. In the evening, - they pounded the wall and shook the bed frame in time to his songs. The gull went - nuts when he played a certain four notes and he looped this section repeatedly, - watching the gull swoop and circle in ectasy. Paij-ree could hardly keep his - composure over the effect the little tune had and he couldn't keep it together, - fell all apart, slobbering and horse-giggling. - - - Paij-ree called the gull _Eb-F-F-A_, after that favorite song. - - - Friendship can be a very good catalyst for progress. A friend can find traits in you - that no one else can. It's like they searched your person and somehow came up - with five full sets of silverware you never knew were there. And even though - that friend may not understand why you had these utensils concealed, it's still a - great feat, worth honoring. - - - While _Eb-F-F-A_ didn't find silverware, he did find something else. A - pile of something else. Since Paij-ree was stranded on the quadruple bed, the gull - would scout around for food. One day, he flew down upon a barrel, floating over where - the toolshed had been. _Eb-F-F-A_ walked on top of the barrel, spinning it back to Paij-ree's - house and they cracked it open, revealing Paij-ree's lost collection of duck bills. - - - Yes, real duck bills. (_Eb-F-F-A_ was esophagizing his squawks, remaining calm, - sucking beads of sweat back into his forehead -- ducks were not _of his chosen feather_, - but still in the species.) Paij-ree clapped gleefully, absolutely, he had intended - to shingle his house with these, they could have deflected a bit of the torrent. - Probably not much, nothing to cry about. - - - And the roof glue was at the barrel's bottom and they were two enterprising - bunkmates with time to kill, so they made a raft from the previously-quacked - lip shades. And off they were to the country! Stirring through a real mess of - city and soup. How strange it was to hit a beach and find out it was just the old - dirt road passed Toffletown Junction. - - - In the country, they sold. It was always a long walk to the next plantation, - but there would be a few buyers up in the mansion ("Welcome to The Mansion Built on Beets", - they'd say or, "The Mansion Built on Cellophane Substitutes -- don't you know how - harmful real cellophane can be?") And one of the families wrapped up some excess - jelly and ham in some cellophane for the two travellers. And they almost died one day later - because of it. - - - Then, when the heat came and, as the first countryside lottery was at nigh, - a farmer called to them from his field, as he stood by his grazing cow. - Paij-ree and _Eb-F-F-A_ wandered out to him, murmuring to each other as to - whether they should offer him the Wind-Beaten Ticket Special or whether he - might want to opt in to winning Risky Rosco's Original Homestyle Country - Medallion. - - - But the farmer waved them down as he approached, "No, put your calculators and probability - wheels away. It's for my grazledon." He meant his cow. The Endertromb version: - twice as much flesh, twice as meaty, doesn't produce milk, produces paper plates. Still, - it grazes. - - - "Your grazledon (poh-kon-ic) wants a lucky ticket?" asked Paij-ree. - - - "He saw you two and got real excited," said the farmer. "He doesn't know numbers, - but he understands luck a bit. He almost got hit by a doter plane one day and, when - I found him, he just gave shrug. It was like he said, 'Well, I guess that worked out - okay.'" - - - "The whole (shas-op) lottery is numer-(ig-ig)-ic," said Paij-ree. "Does he know - (elsh) notes? My eagle knows (losh) notes." Paij-ree whistled at the crater gull, - who cooed back a sustained _D_. - - - The farmer couldn't speak to his grazledon's tonal awareness, so Paij-ree sent the gull - to find out (_D-D-D-A-D_, _go-teach-the-gra-zle_) while he hacked some notes into - his calculator. - - + - > + Paij-ree was an enterprising young Endertromaltoek. He hammered animal bones into long, + glistening trumpets with deep holes that were plugged by corks the musicians banded to + their fingers. Sure, he only sold three of those units, but he was widely reviled as + a freelance scholar, a demonic one, for he was of a poorer class and the poor only + ever acquired their brilliance through satanic practice. Of course, they were right, + indeed, he did have a bargain with the dark mages, whom he kept appointments with annually, + enduring torturous hot springs, bathing as they chanted spells. + + + He adored his father, even as his father deteriorated into but a gyroscope. He idolized the + man's work and spent his own small earnings playing the lottery. He loved to watch the + numerals, each painted upon hollow clay balls, rise in the _robloch_ (which is any fluid, + pond or spill that has happened to withstand the presence of ghosts), the great bankers + tying them together on a silver string, reading them in order. + + + Even today, Paij-ree paints the scenes with crude strokes of black ink on sheets of aluminum + foil. It is very touching to see him caught up in the preciousness of his memory, but I don't + know exactly why he does it on aluminum foil. His drawings rip too easily. Paij-ree himself + gets mixed up and will serve you crumbcake right off of some of this art, even after it has + been properly framed. So many things about him are troubling and absurd and downright wretched. + + + The disease spread over his father's form and marshy weeds covered his father's hands + and face. The moss pulled his spine up into a rigid uprightness. So thick was the + growth over his head that he appeared to wear a shrub molded into a bowler's hat. He + also called himself by a new name -- *Quos* -- and he healed the people he touched, leaving + a pile of full-blooded, greenly-cheeked villages in his wake as he travelled the + townships. Many called him The Mossiah and wept on his feet, which wet the buds and caused + him to weed into the ground. This made him momentarily angry, he harshly jogged his legs + to break free and thrashed his fists wildly in the sky, bringing down a storm of lightning + shards upon these pitiful. + + + Paij-ree was apart from the spiritual odysseys of his father (in fact, thought the man + dead), so he only saw the decay of the lottery without its captain present. Here is + where Paij-ree went to work, reviving the dead lottery of his family. + + + h3. Gambling with Fewer Fingers + + + The city was crowded with people who had lost interest in the lottery. The weather + had really worn everyone down as well. Such terrible rain flooding their cellars. + The entire city was forced to move up one story. You'd go to put the cap back on your + pen and you'd ruin the pen, since the cap was already full of slosh. Everyone was depleted, + many people drowned. + + + Paij-ree found himself wasting his days in a quadruple bunkbed, the only furniture that + managed to stay above sea level. He slept on the top bed. The third bed up was dry as + well, so he let a homeless crater gull nest upon it. The gull didn't need the whole bed, + so Paij-ree also kept his calculators and pencils down there. + + + At first, these were very dark times for both of them, and they insisted on remaining + haggard at all times. Paij-ree became obsessed with his fingernails, kept them long and + pristine, while the rest of him deteriorated under a suit of hair. In the company of + Paij-ree, the crater gull learned his own eccentrity and plucked all the feathers on + the right side of his body. He looked like a cutaway diagram. + + + They learned to have happier times. Paij-ree carved a flute from the wall with his nails and played + it often. Mostly he played his relaxed ballads during the daytime. In the evening, + they pounded the wall and shook the bed frame in time to his songs. The gull went + nuts when he played a certain four notes and he looped this section repeatedly, + watching the gull swoop and circle in ectasy. Paij-ree could hardly keep his + composure over the effect the little tune had and he couldn't keep it together, + fell all apart, slobbering and horse-giggling. + + + Paij-ree called the gull _Eb-F-F-A_, after that favorite song. + + + Friendship can be a very good catalyst for progress. A friend can find traits in you + that no one else can. It's like they searched your person and somehow came up + with five full sets of silverware you never knew were there. And even though + that friend may not understand why you had these utensils concealed, it's still a + great feat, worth honoring. + + + While _Eb-F-F-A_ didn't find silverware, he did find something else. A + pile of something else. Since Paij-ree was stranded on the quadruple bed, the gull + would scout around for food. One day, he flew down upon a barrel, floating over where + the toolshed had been. _Eb-F-F-A_ walked on top of the barrel, spinning it back to Paij-ree's + house and they cracked it open, revealing Paij-ree's lost collection of duck bills. + + + Yes, real duck bills. (_Eb-F-F-A_ was esophagizing his squawks, remaining calm, + sucking beads of sweat back into his forehead -- ducks were not _of his chosen feather_, + but still in the species.) Paij-ree clapped gleefully, absolutely, he had intended + to shingle his house with these, they could have deflected a bit of the torrent. + Probably not much, nothing to cry about. + + + And the roof glue was at the barrel's bottom and they were two enterprising + bunkmates with time to kill, so they made a raft from the previously-quacked + lip shades. And off they were to the country! Stirring through a real mess of + city and soup. How strange it was to hit a beach and find out it was just the old + dirt road passed Toffletown Junction. + + + In the country, they sold. It was always a long walk to the next plantation, + but there would be a few buyers up in the mansion ("Welcome to The Mansion Built on Beets", + they'd say or, "The Mansion Built on Cellophane Substitutes -- don't you know how + harmful real cellophane can be?") And one of the families wrapped up some excess + jelly and ham in some cellophane for the two travellers. And they almost died one day later + because of it. + + + Then, when the heat came and, as the first countryside lottery was at nigh, + a farmer called to them from his field, as he stood by his grazing cow. + Paij-ree and _Eb-F-F-A_ wandered out to him, murmuring to each other as to + whether they should offer him the Wind-Beaten Ticket Special or whether he + might want to opt in to winning Risky Rosco's Original Homestyle Country + Medallion. + + + But the farmer waved them down as he approached, "No, put your calculators and probability + wheels away. It's for my grazledon." He meant his cow. The Endertromb version: + twice as much flesh, twice as meaty, doesn't produce milk, produces paper plates. Still, + it grazes. + + + "Your grazledon (poh-kon-ic) wants a lucky ticket?" asked Paij-ree. + + + "He saw you two and got real excited," said the farmer. "He doesn't know numbers, + but he understands luck a bit. He almost got hit by a doter plane one day and, when + I found him, he just gave shrug. It was like he said, 'Well, I guess that worked out + okay.'" + + + "The whole (shas-op) lottery is numer-(ig-ig)-ic," said Paij-ree. "Does he know + (elsh) notes? My eagle knows (losh) notes." Paij-ree whistled at the crater gull, + who cooed back a sustained _D_. + + + The farmer couldn't speak to his grazledon's tonal awareness, so Paij-ree sent the gull + to find out (_D-D-D-A-D_, _go-teach-the-gra-zle_) while he hacked some notes into + his calculator. + + lang-pt/poignant-52.yml @@ -1,116 +1,116 @@ - <pre> - class AnimalLottoTicket - - # A list of valid notes. - NOTES = [:Ab, :A, :Bb, :B, :C, :Db, :D, :Eb, :E, :F, :Gb, :G] - - # Stores the three picked notes and a purchase date. - attr_reader :picks, :purchased - - # Creates a new ticket from three chosen notes. The three notes - # must be unique notes. - def initialize( note1, note2, note3 ) - if [note1, note2, note3].uniq! - raise ArgumentError, "the three picks must be different notes" - elsif picks.detect { |p| not NOTES.include? p } - raise ArgumentError, "the three picks must be notes in the chromatic scale." - end - @picks = picks - @purchased = Time.now - end - - # Score this ticket against the final draw. - def score( final ) - count = 0 - final.picks.each do |note| - count +=1 if picks.include? note - end - count - end - - # Constructor to create a random AnimalLottoTicket - def self.new_random - new( NOTES[ rand( NOTES.length ) ], NOTES[ rand( NOTES.length ) ], - NOTES[ rand( NOTES.length ) ] ) - rescue ArgumentError - redo - end - - end - </pre> - - - No need for the animal's tickets to behave drastically different from the traditional - tickets. The @AnimalLottoTicket@ class is internally different, but exposes the same - methods seen in the original @LotteryTicket@ class. - The @score@ method is even identical to the @score@ method from the old @LotteryTicket@ - class. - - - Instead of using a class variable to store the musical note list, they're stored in - a constant called @AnimalLottoTicket::NOTES@. Variables change and the note list - shouldn't change. Constants are designed to stay the same. You can still change the - constant, but you'll have to be tricky or Ruby will speak up. - - - <pre> - irb> AnimalLottoTicket::NOTES = [:TOOT, :TWEET, :BLAT] - (irb):3: warning: already initialized constant NOTES - => [:TOOT, :TWEET, :BLAT] - </pre> - - - The gull came back with the grazledon, his name was Merphy, he was thrilled to play chance, - he puffed his face dreamily, whistled five and six notes - in series, they all held his collar, pulled him close to the calculator and let him breathe - three notes, then they choked the bedosh outta him until his ticket was printed and - everything was nicely catalogued inside @@@tickets['merphy']@. Thankyou, see ya at the draw! - - - So, the fever of the lottery became an epidemic among the simple minds of the animals. - Paij-ree saved his costs, used the same @LotteryDraw@ class he'd used in the corporate environment of - the lottery from his childhood. And soon enough, the animals were making their own - music and their own maps and films. - - - "What about The Originals?" I asked Paij-ree. "They must have hated your animals!" - - - But he winced sourly and pinched his forehead. "I am an Original. You as well. - Do we (ae-o) hate any of them?" - - - Not too long after the lottery ended, Paij-ree felt the crater gull _Eb-F-F-A_ - lighting upon his shoulder, which whistled an urgent and sad _C-Eb-D C-A-Eb_. - These desparate notes sent an organ roll of chills straight through Paij-ree. Had the - King God of Potted Soil, Our Beloved Topiary, *the Mossiah Quos*, Literal Father of - That Man Who Would Be My Daughter's Organ Instructor -- had he truly come to his end? - How could this be? Could the great arbors no longer nourish him and guide the moist crosswinds - to him? Or did his own spindly lichen hedge up his way and grow against his breathing? - - - _You never mind_, went the tune of the gull. _He has detoriated and weakened and fallen in the - lit door of your home cottage. His tendrils needing and crying for the day to not end. - For the sun to stay fixed and wide and attentive._ - - - Plor-ian, the house attendant, kept the pitchers coming and Quos stayed well watered - until Paij-ree arrived to survey the decaying buds of soft plant and the emerging face of - his father, the lottery captain. His skin deeply pocked like an overly embroidered pillow. - Great shoots springing from his sleeves now curled back with lurching thirst. - - - Paij-ree combed back the longer stems around his father's eyes and those coming from the - corners of his mouth. While I'd like to tell you that Paij-ree's tears rolled down - his sleeves and into the pours of his father, rejuvenating and restoring the grassy gentleman: - I cannot say this. - - - Rather, Paij-ree's tears rolled down his sleeves and into the creaking clapboard floor, - nourishing the vile weeds, energizing the dark plant matter, which literally lept through - the floor at night and strangled Our Quos. Yank, pull, crack. And that was his skull. - - - So Paij-ree could never be called Wert-ree or Wert-plo after that. - - + <pre> + class AnimalLottoTicket + + # A list of valid notes. + NOTES = [:Ab, :A, :Bb, :B, :C, :Db, :D, :Eb, :E, :F, :Gb, :G] + + # Stores the three picked notes and a purchase date. + attr_reader :picks, :purchased + + # Creates a new ticket from three chosen notes. The three notes + # must be unique notes. + def initialize( note1, note2, note3 ) + if [note1, note2, note3].uniq! + raise ArgumentError, "the three picks must be different notes" + elsif picks.detect { |p| not NOTES.include? p } + raise ArgumentError, "the three picks must be notes in the chromatic scale." + end + @picks = picks + @purchased = Time.now + end + + # Score this ticket against the final draw. + def score( final ) + count = 0 + final.picks.each do |note| + count +=1 if picks.include? note + end + count + end + + # Constructor to create a random AnimalLottoTicket + def self.new_random + new( NOTES[ rand( NOTES.length ) ], NOTES[ rand( NOTES.length ) ], + NOTES[ rand( NOTES.length ) ] ) + rescue ArgumentError + redo + end + + end + </pre> + + + No need for the animal's tickets to behave drastically different from the traditional + tickets. The @AnimalLottoTicket@ class is internally different, but exposes the same + methods seen in the original @LotteryTicket@ class. + The @score@ method is even identical to the @score@ method from the old @LotteryTicket@ + class. + + + Instead of using a class variable to store the musical note list, they're stored in + a constant called @AnimalLottoTicket::NOTES@. Variables change and the note list + shouldn't change. Constants are designed to stay the same. You can still change the + constant, but you'll have to be tricky or Ruby will speak up. + + + <pre> + irb> AnimalLottoTicket::NOTES = [:TOOT, :TWEET, :BLAT] + (irb):3: warning: already initialized constant NOTES + => [:TOOT, :TWEET, :BLAT] + </pre> + + + The gull came back with the grazledon, his name was Merphy, he was thrilled to play chance, + he puffed his face dreamily, whistled five and six notes + in series, they all held his collar, pulled him close to the calculator and let him breathe + three notes, then they choked the bedosh outta him until his ticket was printed and + everything was nicely catalogued inside @@@tickets['merphy']@. Thankyou, see ya at the draw! + + + So, the fever of the lottery became an epidemic among the simple minds of the animals. + Paij-ree saved his costs, used the same @LotteryDraw@ class he'd used in the corporate environment of + the lottery from his childhood. And soon enough, the animals were making their own + music and their own maps and films. + + + "What about The Originals?" I asked Paij-ree. "They must have hated your animals!" + + + But he winced sourly and pinched his forehead. "I am an Original. You as well. + Do we (ae-o) hate any of them?" + + + Not too long after the lottery ended, Paij-ree felt the crater gull _Eb-F-F-A_ + lighting upon his shoulder, which whistled an urgent and sad _C-Eb-D C-A-Eb_. + These desparate notes sent an organ roll of chills straight through Paij-ree. Had the + King God of Potted Soil, Our Beloved Topiary, *the Mossiah Quos*, Literal Father of + That Man Who Would Be My Daughter's Organ Instructor -- had he truly come to his end? + How could this be? Could the great arbors no longer nourish him and guide the moist crosswinds + to him? Or did his own spindly lichen hedge up his way and grow against his breathing? + + + _You never mind_, went the tune of the gull. _He has detoriated and weakened and fallen in the + lit door of your home cottage. His tendrils needing and crying for the day to not end. + For the sun to stay fixed and wide and attentive._ + + + Plor-ian, the house attendant, kept the pitchers coming and Quos stayed well watered + until Paij-ree arrived to survey the decaying buds of soft plant and the emerging face of + his father, the lottery captain. His skin deeply pocked like an overly embroidered pillow. + Great shoots springing from his sleeves now curled back with lurching thirst. + + + Paij-ree combed back the longer stems around his father's eyes and those coming from the + corners of his mouth. While I'd like to tell you that Paij-ree's tears rolled down + his sleeves and into the pours of his father, rejuvenating and restoring the grassy gentleman: + I cannot say this. + + + Rather, Paij-ree's tears rolled down his sleeves and into the creaking clapboard floor, + nourishing the vile weeds, energizing the dark plant matter, which literally lept through + the floor at night and strangled Our Quos. Yank, pull, crack. And that was his skull. + + + So Paij-ree could never be called Wert-ree or Wert-plo after that. + + lang-pt/poignant-52a.yml @@ -1,138 +1,138 @@ - - Them What Make the Rules: > - - Hannah lept back from the wall and clenched down on her fingers. - - - "This is the wall," said Dr. Cham. "The Originals are in there. My child, can you - lead us to the observation deck?" - - - "You expect us to go up against those guys?" asked the goat. "They're mad as koalas. But these - koalas have lasers!" - - - "We prevail, though," said Dr. Cham. "You and I know this." - - - "Okay, well I'm muddled on that point," said the goat. "Do we really win? - Or could we be thinking about _Kramer vs. Kramer_? Does Dustin Hoffman win or do we win?" - - - "No. No. No. No." Hannah hovered and dragged her legs along the wall nervously. - "There is a man with a huge face in there!" - - - "Mr. Face," said the Doctor. "He is the original face." - - - "He didn't see me," said Hannah and moaned. *HOMA-HOMA-ALLO-ALLO.* - - - She made that hollow weeping through the crumbling mouseholes and the freezer gateways, - fluxing in and out, causing the video checkpoints to hiss and the wall panels to - brace themselves and fall silent. The three passed through two levels of frayed security - and emerged in the observation deck overlooking the cargo bay. - - - !i/the.originals-1.jpg(Klon Ooper. Corwood. Mr. Face. Vonblisser. The Originals.)! - - - "The last living among The Originals," said Dr. Cham. "Are you alright with this, - Hannah?" Which she didn't hear in any way, as her eyes laid fixed on the legendary - creatures. - - - "Look at them," said the goat. "These guys wrote the rule books, Doctor. We owe - everything to these guys." - - - "What about God?" said Dr. Cham. - - - "I don't really know," said the goat. "Hannah probably knows better than any of us - about that." - - - Hannah said nothing. She only really knew one other ghost and that was her Post-Decease Mediator, - Jamie Huft. Who didn't seem to have any answers for her and required questions to be submitted - in writing with a self-addressed stamped envelope included. Hannah hadn't gotten the ball rolling - on that P.O. Box yet. - - - "We must be up in the mountains," said the goat. "Look out at that blackness." - - - "I saw another deck like this down by where we found Hannah," said Dr. Cham. "Down closer - to your living area. You should take time to search for it. It's very peaceful there. - You can see Earth and the seven seas." - - - "The seven seas?" The goat wondered if that was near The Rockettes. He'd read his share - of material on precision dancing and he'd seen that line of legs, mincing across the - stage like a big, glitsy rototiller. - - - Hannah stirred to life. - - - !i/the.originals-2.jpg(Hannah panicks. Maple donuts are within reach.)! - - - !i/the.originals-3.jpg(They couldn't hear them, but they saw their slides.)! - - - And none of the three spoke when The Originals flicked off the slide projector - and boarded a very slender rocketship and cleanly exploded through a crevice in the - cargo bay roof. - - - "Oh, boy," said the goat. - - - "What?" said Hannah. - - - "You're going to die," said the goat. - - - Dr. Cham looked over the controls in front of them, a long panel of padded handles and - green screens. - - - "I'm already dead. I'm a ghost." - - - The goat looked down at the Doctor, who was rummaging under the control panel. "Okay, well - if your uncle isn't going to have a talk with you, I'm going to make things very clear. There's - a good chance these guys are going to build a bomb. And you see how I'm fidgeting? You see - how my knees are wobbling?" - - - "Yeah." - - - "Yeah, that's how real this is, kid. I don't remember anything from that _confounded book_ except - that these guys are building a bomb that can blow up the ghost world. - Because once the ghost world's gone, then Digger Dosh gets his one second back. - It's a trade they've worked out. Hell, it's sick stuff, that's all you need to know." - - - "But I'm dead." - - - "Okay, well, we're talking, aren't we? You can talk, so are you dead?" The goat shook his head. - "I wish I could remember if we win or if it was Dustin Hoffman." - - - Hannah cried. "Why do I have to die again?" She wailed and her legs fell into - flux and she sunk into the floor. *MOH-MOHHH-MAO-MAOOO.* - - - Dr. Cham had forceably yanked on a plush handle, which unlocked and slid open like a breadbox. - He reached his hands inside and found a keyboard firmly bolted deep inside. - - - "That's it," he said and pulled up @irb@, which appeared on a display to the left of his - concealed typing. He checked the Ruby version. - - + - Them What Make the Rules: > + + Hannah lept back from the wall and clenched down on her fingers. + + + "This is the wall," said Dr. Cham. "The Originals are in there. My child, can you + lead us to the observation deck?" + + + "You expect us to go up against those guys?" asked the goat. "They're mad as koalas. But these + koalas have lasers!" + + + "We prevail, though," said Dr. Cham. "You and I know this." + + + "Okay, well I'm muddled on that point," said the goat. "Do we really win? + Or could we be thinking about _Kramer vs. Kramer_? Does Dustin Hoffman win or do we win?" + + + "No. No. No. No." Hannah hovered and dragged her legs along the wall nervously. + "There is a man with a huge face in there!" + + + "Mr. Face," said the Doctor. "He is the original face." + + + "He didn't see me," said Hannah and moaned. *HOMA-HOMA-ALLO-ALLO.* + + + She made that hollow weeping through the crumbling mouseholes and the freezer gateways, + fluxing in and out, causing the video checkpoints to hiss and the wall panels to + brace themselves and fall silent. The three passed through two levels of frayed security + and emerged in the observation deck overlooking the cargo bay. + + + !i/the.originals-1.jpg(Klon Ooper. Corwood. Mr. Face. Vonblisser. The Originals.)! + + + "The last living among The Originals," said Dr. Cham. "Are you alright with this, + Hannah?" Which she didn't hear in any way, as her eyes laid fixed on the legendary + creatures. + + + "Look at them," said the goat. "These guys wrote the rule books, Doctor. We owe + everything to these guys." + + + "What about God?" said Dr. Cham. + + + "I don't really know," said the goat. "Hannah probably knows better than any of us + about that." + + + Hannah said nothing. She only really knew one other ghost and that was her Post-Decease Mediator, + Jamie Huft. Who didn't seem to have any answers for her and required questions to be submitted + in writing with a self-addressed stamped envelope included. Hannah hadn't gotten the ball rolling + on that P.O. Box yet. + + + "We must be up in the mountains," said the goat. "Look out at that blackness." + + + "I saw another deck like this down by where we found Hannah," said Dr. Cham. "Down closer + to your living area. You should take time to search for it. It's very peaceful there. + You can see Earth and the seven seas." + + + "The seven seas?" The goat wondered if that was near The Rockettes. He'd read his share + of material on precision dancing and he'd seen that line of legs, mincing across the + stage like a big, glitsy rototiller. + + + Hannah stirred to life. + + + !i/the.originals-2.jpg(Hannah panicks. Maple donuts are within reach.)! + + + !i/the.originals-3.jpg(They couldn't hear them, but they saw their slides.)! + + + And none of the three spoke when The Originals flicked off the slide projector + and boarded a very slender rocketship and cleanly exploded through a crevice in the + cargo bay roof. + + + "Oh, boy," said the goat. + + + "What?" said Hannah. + + + "You're going to die," said the goat. + + + Dr. Cham looked over the controls in front of them, a long panel of padded handles and + green screens. + + + "I'm already dead. I'm a ghost." + + + The goat looked down at the Doctor, who was rummaging under the control panel. "Okay, well + if your uncle isn't going to have a talk with you, I'm going to make things very clear. There's + a good chance these guys are going to build a bomb. And you see how I'm fidgeting? You see + how my knees are wobbling?" + + + "Yeah." + + + "Yeah, that's how real this is, kid. I don't remember anything from that _confounded book_ except + that these guys are building a bomb that can blow up the ghost world. + Because once the ghost world's gone, then Digger Dosh gets his one second back. + It's a trade they've worked out. Hell, it's sick stuff, that's all you need to know." + + + "But I'm dead." + + + "Okay, well, we're talking, aren't we? You can talk, so are you dead?" The goat shook his head. + "I wish I could remember if we win or if it was Dustin Hoffman." + + + Hannah cried. "Why do I have to die again?" She wailed and her legs fell into + flux and she sunk into the floor. *MOH-MOHHH-MAO-MAOOO.* + + + Dr. Cham had forceably yanked on a plush handle, which unlocked and slid open like a breadbox. + He reached his hands inside and found a keyboard firmly bolted deep inside. + + + "That's it," he said and pulled up @irb@, which appeared on a display to the left of his + concealed typing. He checked the Ruby version. + + lang-pt/poignant-53.yml @@ -1,138 +1,138 @@ - <pre> - irb> RUBY_VERSION - => "1.8.3" - </pre> - - - Ruby was up-to-date. What else could he do? Scanning @constants@ and @class_variables@ was pointless. - The only reason that had worked with the @Elevator@ class was because someone had left @irb@ running - with their classes still loaded. - - - He had just loaded this @irb@, so no special classes were available yet. He had to find some classes. - He started by loading the @`rbconfig`@ file to get an idea of what Ruby's settings were. - - - <pre> - irb> require 'rbconfig' - => true - irb> Config::CONFIG - => {"abs_srcdir"=>"$(ac_abs_srcdir)", "sitedir"=>"bay://Ruby/lib/site_ruby", ... } - </pre> - - - Too much information to sort through there. The @Config::CONFIG@ constant is a Hash that - contains every environment setting used to setup Ruby. You can find the operating system - name at @Config::CONFIG['host_os']@. The directory where core Ruby libraries are stored - can be found at @Config::CONFIG['rubylibdir']@. Ruby programs can store helper files at - @Config::CONFIG['datadir']@. - - - What Dr. Cham really needed, though, was a list of all the libraries that aren't core Ruby - libraries. Libraries which were installed by The Originals or whoever manned this console. - He checked a few global variables for this information. - - - <pre> - irb> $" - => ["irb.rb", "e2mmap.rb", "irb/init.rb", ... "rbconfig.rb"] - irb> $: - => ["bay://Ruby/lib/site_ruby/1.9", "bay://Ruby/lib/site_ruby/1.9/i686-unknown", - "bay://Ruby/lib/site_ruby", "bay://Ruby/lib/1.9", - "bay://Ruby/lib/1.9/i686-unknown", "."] - </pre> - - - Aha, good. Dr. Cham stroked his beard and looked over his @irb@ session. The @$"@ global variable - contains an Array of every library which has been loaded with @require@. Most of these libraries - had been loaded by @irb@. He had loaded @'rbconfig.rb'@ earlier, though. - - - The @$:@ global variable, which can also be accessed as @$LOAD_PATH@, contains a list of all - the directories which Ruby will check when you try to load a file with @require@. When Dr. - Cham ran @require 'rbconfig'@, Ruby checked each directory in order. - - - <pre> - bay://Ruby/lib/site_ruby/1.9/rbconfig.rb - bay://Ruby/lib/site_ruby/1.9/i686-unknown/rbconfig.rb (*) - bay://Ruby/lib/site_ruby/rbconfig.rb - bay://Ruby/lib/1.9/rbconfig.rb - bay://Ruby/lib/1.9/i686-unknown/rbconfig.rb - ./rbconfig.rb - </pre> - - - The second path was where Ruby ended up finding the rbconfig.rb file. Dr. Cham guessed that - the first five paths were *absolute paths*. These were paths to directories on a drive called - @bay@. Absolute paths may vary on your system. On Windows, absolute paths will start with - a drive letter. On Linux, absolute paths start with a slash. - - - The directory @"."@ indicates a *relative path*. The lone period represents the current - work directory. The directory where Dr. Cham started up @irb@. So, after Ruby has searched - all the standard places, it checks the current directory. - - - The goat had peeked his head around Dr. Cham and was watching all these instructions - transpire, as he licked his lips to keep his salivations from running all over the monitors - and glossy buttons. He had been interjecting a few short cheers (along the lines of: - _No, not that_ or _Yes, yes, right_ or _Okay, well, your choice_), but now he was - fully involved, recommending code, "Try @require 'setup'@ or, no, try - @3 * 5@. Make sure that basic math works." - - - "Of course the math works," said Dr. Cham. "Let me be, I need to find some useful classes." - - - "It's a basic sanity test," said the goat. "Just try it. Do @3 * 5@ and see what - comes up." - - - Dr. Cham caved. - - - <pre> - irb> 3 * 5 - => 15 - </pre> - - - "Okay, great! We're in business!" the goat tossed his furry face about in glee. - - - Dr. Cham patted the goat's head, "Well done. We can continue." - - - <pre> - irb> Dir.chdir( "bay://Ruby/lib/site_ruby/1.9/" ) - => 0 - irb> Dir["./*.{rb}"] - => ['endertromb.rb', 'mindreader.rb', 'wishmaker.rb'] - </pre> - - - Dr. Cham had use @chdir@ to change the current working directory over the the first - path listed in @$LOAD_PATH@. This first path in @site_ruby@ is a common place to store - custom classes. - - - Here were the three legendary classes that my daughter's organ instructor had inscribed - for me earlier in this chapter. And, Dr. Cham, having read this selfsame chapter, recognized - these three pieces of the system immediately. - - - The @Endertromb@ class which contained the mysteries of this planet's powers. The @MindReader@ - class which, upon scanning the minds of its inhabitants, read each mind's contents. And, finally, - the crucial @WishMaker@ class which powered the granting of ten-letter wishes, should the wish - ever find its way to the core of Endertromb. - - - "How about @4 * 56 + 9@?" asked the goat. "We don't know if it can do compound expressions." - - - "I've got the @MindReader@ right here," said Dr. Cham. "And I have the @WishMaker@ here next to it. - This planet can read minds. And this planet can make wishes. Now, let's see if it can do both at - the same time." - - + <pre> + irb> RUBY_VERSION + => "1.8.3" + </pre> + + + Ruby was up-to-date. What else could he do? Scanning @constants@ and @class_variables@ was pointless. + The only reason that had worked with the @Elevator@ class was because someone had left @irb@ running + with their classes still loaded. + + + He had just loaded this @irb@, so no special classes were available yet. He had to find some classes. + He started by loading the @`rbconfig`@ file to get an idea of what Ruby's settings were. + + + <pre> + irb> require 'rbconfig' + => true + irb> Config::CONFIG + => {"abs_srcdir"=>"$(ac_abs_srcdir)", "sitedir"=>"bay://Ruby/lib/site_ruby", ... } + </pre> + + + Too much information to sort through there. The @Config::CONFIG@ constant is a Hash that + contains every environment setting used to setup Ruby. You can find the operating system + name at @Config::CONFIG['host_os']@. The directory where core Ruby libraries are stored + can be found at @Config::CONFIG['rubylibdir']@. Ruby programs can store helper files at + @Config::CONFIG['datadir']@. + + + What Dr. Cham really needed, though, was a list of all the libraries that aren't core Ruby + libraries. Libraries which were installed by The Originals or whoever manned this console. + He checked a few global variables for this information. + + + <pre> + irb> $" + => ["irb.rb", "e2mmap.rb", "irb/init.rb", ... "rbconfig.rb"] + irb> $: + => ["bay://Ruby/lib/site_ruby/1.9", "bay://Ruby/lib/site_ruby/1.9/i686-unknown", + "bay://Ruby/lib/site_ruby", "bay://Ruby/lib/1.9", + "bay://Ruby/lib/1.9/i686-unknown", "."] + </pre> + + + Aha, good. Dr. Cham stroked his beard and looked over his @irb@ session. The @$"@ global variable + contains an Array of every library which has been loaded with @require@. Most of these libraries + had been loaded by @irb@. He had loaded @'rbconfig.rb'@ earlier, though. + + + The @$:@ global variable, which can also be accessed as @$LOAD_PATH@, contains a list of all + the directories which Ruby will check when you try to load a file with @require@. When Dr. + Cham ran @require 'rbconfig'@, Ruby checked each directory in order. + + + <pre> + bay://Ruby/lib/site_ruby/1.9/rbconfig.rb + bay://Ruby/lib/site_ruby/1.9/i686-unknown/rbconfig.rb (*) + bay://Ruby/lib/site_ruby/rbconfig.rb + bay://Ruby/lib/1.9/rbconfig.rb + bay://Ruby/lib/1.9/i686-unknown/rbconfig.rb + ./rbconfig.rb + </pre> + + + The second path was where Ruby ended up finding the rbconfig.rb file. Dr. Cham guessed that + the first five paths were *absolute paths*. These were paths to directories on a drive called + @bay@. Absolute paths may vary on your system. On Windows, absolute paths will start with + a drive letter. On Linux, absolute paths start with a slash. + + + The directory @"."@ indicates a *relative path*. The lone period represents the current + work directory. The directory where Dr. Cham started up @irb@. So, after Ruby has searched + all the standard places, it checks the current directory. + + + The goat had peeked his head around Dr. Cham and was watching all these instructions + transpire, as he licked his lips to keep his salivations from running all over the monitors + and glossy buttons. He had been interjecting a few short cheers (along the lines of: + _No, not that_ or _Yes, yes, right_ or _Okay, well, your choice_), but now he was + fully involved, recommending code, "Try @require 'setup'@ or, no, try + @3 * 5@. Make sure that basic math works." + + + "Of course the math works," said Dr. Cham. "Let me be, I need to find some useful classes." + + + "It's a basic sanity test," said the goat. "Just try it. Do @3 * 5@ and see what + comes up." + + + Dr. Cham caved. + + + <pre> + irb> 3 * 5 + => 15 + </pre> + + + "Okay, great! We're in business!" the goat tossed his furry face about in glee. + + + Dr. Cham patted the goat's head, "Well done. We can continue." + + + <pre> + irb> Dir.chdir( "bay://Ruby/lib/site_ruby/1.9/" ) + => 0 + irb> Dir["./*.{rb}"] + => ['endertromb.rb', 'mindreader.rb', 'wishmaker.rb'] + </pre> + + + Dr. Cham had use @chdir@ to change the current working directory over the the first + path listed in @$LOAD_PATH@. This first path in @site_ruby@ is a common place to store + custom classes. + + + Here were the three legendary classes that my daughter's organ instructor had inscribed + for me earlier in this chapter. And, Dr. Cham, having read this selfsame chapter, recognized + these three pieces of the system immediately. + + + The @Endertromb@ class which contained the mysteries of this planet's powers. The @MindReader@ + class which, upon scanning the minds of its inhabitants, read each mind's contents. And, finally, + the crucial @WishMaker@ class which powered the granting of ten-letter wishes, should the wish + ever find its way to the core of Endertromb. + + + "How about @4 * 56 + 9@?" asked the goat. "We don't know if it can do compound expressions." + + + "I've got the @MindReader@ right here," said Dr. Cham. "And I have the @WishMaker@ here next to it. + This planet can read minds. And this planet can make wishes. Now, let's see if it can do both at + the same time." + + lang-pt/poignant-53a.yml @@ -1,147 +1,147 @@ - - Them What Live the Dream: > - - While The Originals' craft had long disappeared, Dr. Cham frantically worked away at the - computer built into the control panel up in the observation deck. Hannah had disappeared - into the floor (or perhaps those little sparks along the ground were still wisps of her - paranormal presence!) and the goat amicably watched Dr. Cham hack out a Ruby module. - - - <pre> - require 'endertromb' - module WishScanner - def scan_for_a_wish - wish = self.read.detect do |thought| - thought.index( 'wish: ' ) == 0 - end - wish.gsub( 'wish: ', '' ) - end - end - </pre> - - - "What's your plan?" asked the goat. "It seems like I could have solved this problem in - like three lines." - - - "This @Module@ is the new @WishScanner@ technology," he said. "The scanner only picks up - a wish if it starts with the word @wish@ and a colon and a space. That way the planet doesn't - fill up with every less-than-ten-letter word that appears in people's heads." - - - "Why don't you just use a class?" asked the goat. - - - "Because a @Module@ is simpler than a class. It's basically just a storage facility - for methods. It keeps a group of methods together. You can't create new objects - from a method." - - - "But aren't you going to want a @WishScanner@ object, so you can actually use - it?" said the goat, appalled. - - - "I'm going to mix it into the @MindReader@," said Dr. Cham. And he did. - - - <pre> - require 'mindreader' - class MindReader - include MindScanner - end - </pre> - - - "Now, the @MindScanner@ module is mixed in to the @MindReader@," said Dr. Cham. - "I can call the @scan_for_a_wish@ method on any @MindReader@ object." - - - "So, it's a mixin," said the goat. "The @MindScanner@ mixin." - - - "Yes, any module which is introduced into a class with @include@ is a mixin to that - class. If you go back and look at the @scan_for_a_wish@ method, you'll see that it - calls a @self.read@ method. I just have to make sure that whatever class I'm mixing - @MindScanner@ into has a @read@ method. Otherwise, an error will be thrown." - - - "That seems really wierd that the mixin requires certain methods that it doesn't already have. - It seems like it should work by itself." - - - Dr. Cham looked up from the keyboard at the goat. "Well, it's sort of like your video collection. - None of your video cassettes work unless they are put in a machine that uses video cassettes. - The depend on each other. A mixin has some basic requirements, but once a class meets those - requirements, you can add all this extra functionality in." - - - "Hey, that's cool," said the goat. - - - "You read the book thirty times and you didn't pick that up?" asked Dr. Cham. - - - "You're a much better teacher in person," said the goat. "I really didn't think I was going - to like you very much." - - - "I completely understand," said the Doctor. "This is much more real than the cartoons - make it seem." - - - <pre> - require 'wishmaker' - reader = MindReader.new - wisher = WishMaker.new - loop do - wish = reader.scan_for_a_wish - if wish - wisher.grant( wish ) - end - end - </pre> - - - - Irb sat and looped on the screen. It'll do that until you hit Control-C. But Dr. Cham let it - churn away. Looping endlessly, scanning the mind waves for a proper wish. - - - And Dr. Cham readied his wish. At first, he thought immediately of a @stallion@. To ride bareback - over the vales of Sedna. But he pulled the thought back, his wish hadn't been formed properly. - A stallion was useless in pursuing The Originals, so he closed his eyes again, bit his lip - and he thought to himself: @wish: whale@. - - - h3. Last Whale to Peoplemud - - - The blocky, sullen whale appeared down at the castle entrance, where Hannah was - bashing on a rosebud with her hand. She whacked at it with a fist, but it only stayed - perfect and pleasant and crisp against the solid blue sky of Endertromb. - - - "I'm bored," she said to the whale. *BOHR-BOHR-OHRRRRRR.* - - - "Ok," said the whale, deep and soft. As the word slid along his massive tongue, its - edges chipped off and the word slid out polished and worn in a bubble by his mouth's - corner. - - - "I always have to die," said the young ghost. "People always kill me." - - - The whale fluttered his short fins, which hung at useless distance from the ground. - So, he pushed himself toward her with his tail. Scooting over patches of grass. - - - "People kill, so who do they kill?" said the girl. "Me. They kill me every time." - - - The whale made it to within three meters of the girl, where he towered like a - great war monument that represents enough dead soldiers to actually steal a lumbering step - towards you. And now, the whale rested his tail and, exhausted by the climb thus far, - let his eyelids fall shut and became a gently puffing clay mountain, his shadow - rich and doubled-up all around the hardly visible Hannah. - - + - Them What Live the Dream: > + + While The Originals' craft had long disappeared, Dr. Cham frantically worked away at the + computer built into the control panel up in the observation deck. Hannah had disappeared + into the floor (or perhaps those little sparks along the ground were still wisps of her + paranormal presence!) and the goat amicably watched Dr. Cham hack out a Ruby module. + + + <pre> + require 'endertromb' + module WishScanner + def scan_for_a_wish + wish = self.read.detect do |thought| + thought.index( 'wish: ' ) == 0 + end + wish.gsub( 'wish: ', '' ) + end + end + </pre> + + + "What's your plan?" asked the goat. "It seems like I could have solved this problem in + like three lines." + + + "This @Module@ is the new @WishScanner@ technology," he said. "The scanner only picks up + a wish if it starts with the word @wish@ and a colon and a space. That way the planet doesn't + fill up with every less-than-ten-letter word that appears in people's heads." + + + "Why don't you just use a class?" asked the goat. + + + "Because a @Module@ is simpler than a class. It's basically just a storage facility + for methods. It keeps a group of methods together. You can't create new objects + from a method." + + + "But aren't you going to want a @WishScanner@ object, so you can actually use + it?" said the goat, appalled. + + + "I'm going to mix it into the @MindReader@," said Dr. Cham. And he did. + + + <pre> + require 'mindreader' + class MindReader + include MindScanner + end + </pre> + + + "Now, the @MindScanner@ module is mixed in to the @MindReader@," said Dr. Cham. + "I can call the @scan_for_a_wish@ method on any @MindReader@ object." + + + "So, it's a mixin," said the goat. "The @MindScanner@ mixin." + + + "Yes, any module which is introduced into a class with @include@ is a mixin to that + class. If you go back and look at the @scan_for_a_wish@ method, you'll see that it + calls a @self.read@ method. I just have to make sure that whatever class I'm mixing + @MindScanner@ into has a @read@ method. Otherwise, an error will be thrown." + + + "That seems really wierd that the mixin requires certain methods that it doesn't already have. + It seems like it should work by itself." + + + Dr. Cham looked up from the keyboard at the goat. "Well, it's sort of like your video collection. + None of your video cassettes work unless they are put in a machine that uses video cassettes. + The depend on each other. A mixin has some basic requirements, but once a class meets those + requirements, you can add all this extra functionality in." + + + "Hey, that's cool," said the goat. + + + "You read the book thirty times and you didn't pick that up?" asked Dr. Cham. + + + "You're a much better teacher in person," said the goat. "I really didn't think I was going + to like you very much." + + + "I completely understand," said the Doctor. "This is much more real than the cartoons + make it seem." + + + <pre> + require 'wishmaker' + reader = MindReader.new + wisher = WishMaker.new + loop do + wish = reader.scan_for_a_wish + if wish + wisher.grant( wish ) + end + end + </pre> + + + + Irb sat and looped on the screen. It'll do that until you hit Control-C. But Dr. Cham let it + churn away. Looping endlessly, scanning the mind waves for a proper wish. + + + And Dr. Cham readied his wish. At first, he thought immediately of a @stallion@. To ride bareback + over the vales of Sedna. But he pulled the thought back, his wish hadn't been formed properly. + A stallion was useless in pursuing The Originals, so he closed his eyes again, bit his lip + and he thought to himself: @wish: whale@. + + + h3. Last Whale to Peoplemud + + + The blocky, sullen whale appeared down at the castle entrance, where Hannah was + bashing on a rosebud with her hand. She whacked at it with a fist, but it only stayed + perfect and pleasant and crisp against the solid blue sky of Endertromb. + + + "I'm bored," she said to the whale. *BOHR-BOHR-OHRRRRRR.* + + + "Ok," said the whale, deep and soft. As the word slid along his massive tongue, its + edges chipped off and the word slid out polished and worn in a bubble by his mouth's + corner. + + + "I always have to die," said the young ghost. "People always kill me." + + + The whale fluttered his short fins, which hung at useless distance from the ground. + So, he pushed himself toward her with his tail. Scooting over patches of grass. + + + "People kill, so who do they kill?" said the girl. "Me. They kill me every time." + + + The whale made it to within three meters of the girl, where he towered like a + great war monument that represents enough dead soldiers to actually steal a lumbering step + towards you. And now, the whale rested his tail and, exhausted by the climb thus far, + let his eyelids fall shut and became a gently puffing clay mountain, his shadow + rich and doubled-up all around the hardly visible Hannah. + + lang-pt/poignant-54.yml @@ -1,55 +1,55 @@ - But another shadow combined, narrow and determined. Right behind her, the hand came - on to her shoulder, and the warm ghost inside the hand touched her sleeve. - - - "How did you get down here?" said the girl. - - - Dr. Cham sat right alongside her and the goat walked around and stood in front. - - - "Listen to us," said Dr. Cham. "We've got to follow this mangy pack of ne'er-do-wells - to the very end, Hannah. And to nab them, we need your faithful assistance!" - - - "I'm scared," cried Hannah. - - - "You're not scared," said the goat. "Come on. You're a terrifying little phantom child." - - - "Well," she said. "I'm a little bored." - - - Dr. Cham bent down on a knee, bringing his shaggy presence toward the ground, his face - just inches from hers. "If you come with us, if you can trust what we know, then we can bag - this foul troupe. Now, you say your destiny is to be a baker. I won't dispute that. - You have every right on Earth -- and Endertromb, for that matter -- to become a baker. - Say, if you didn't become a baker, that would be a great tragedy. Who's going to take - care of all those donuts if you don't?" - - - She shrugged. "That's what I've been saying." - - - "You're right," said the Doctor. "You've been saying it from the start." He looked up to - the sky, where the wind whistled peacefully despite its forceful piercing by The Originals' - rocketship. "If your destiny is to be a baker, then mine is to stop all this, to end the - mayhem that is just beginning to boil. And hear me, child -- hear how sure and solid my voice - becomes when I say this -- I ended your life, I bear sole responsibility for your life as - an apparition, but I will get it back. It's going to take more than a donut, but you will - have a real childhood. I promise you." - - - !i/whale.escape-1.jpg(On the wished whale... away...)! - - - Sure, it took a minute for the goat to cut his wish down to ten letters, but he was shortly on - his way, following the same jetstreams up into the sky, up toward Dr. Cham and his ghost - niece Hannah. Up toward the villanous animal combo pak called The Originals. Up toward - The Rockettes. - - - And Digger Dosh bludgeoned and feasted on each second they left behind them. - - + But another shadow combined, narrow and determined. Right behind her, the hand came + on to her shoulder, and the warm ghost inside the hand touched her sleeve. + + + "How did you get down here?" said the girl. + + + Dr. Cham sat right alongside her and the goat walked around and stood in front. + + + "Listen to us," said Dr. Cham. "We've got to follow this mangy pack of ne'er-do-wells + to the very end, Hannah. And to nab them, we need your faithful assistance!" + + + "I'm scared," cried Hannah. + + + "You're not scared," said the goat. "Come on. You're a terrifying little phantom child." + + + "Well," she said. "I'm a little bored." + + + Dr. Cham bent down on a knee, bringing his shaggy presence toward the ground, his face + just inches from hers. "If you come with us, if you can trust what we know, then we can bag + this foul troupe. Now, you say your destiny is to be a baker. I won't dispute that. + You have every right on Earth -- and Endertromb, for that matter -- to become a baker. + Say, if you didn't become a baker, that would be a great tragedy. Who's going to take + care of all those donuts if you don't?" + + + She shrugged. "That's what I've been saying." + + + "You're right," said the Doctor. "You've been saying it from the start." He looked up to + the sky, where the wind whistled peacefully despite its forceful piercing by The Originals' + rocketship. "If your destiny is to be a baker, then mine is to stop all this, to end the + mayhem that is just beginning to boil. And hear me, child -- hear how sure and solid my voice + becomes when I say this -- I ended your life, I bear sole responsibility for your life as + an apparition, but I will get it back. It's going to take more than a donut, but you will + have a real childhood. I promise you." + + + !i/whale.escape-1.jpg(On the wished whale... away...)! + + + Sure, it took a minute for the goat to cut his wish down to ten letters, but he was shortly on + his way, following the same jetstreams up into the sky, up toward Dr. Cham and his ghost + niece Hannah. Up toward the villanous animal combo pak called The Originals. Up toward + The Rockettes. + + + And Digger Dosh bludgeoned and feasted on each second they left behind them. + + lang-pt/poignant-54a.yml @@ -1 +1 @@ - - Centro da Cidade: + - Centro da Cidade: lang-pt/poignant-55.yml @@ -1,22 +1,22 @@ - - > - !i/wixl-1.jpg(Lost in Wixl)! - - !i/wixl-2.gif(This heist goes all the way up?)! - - - Oblivious to their involvement in the expansive plan of The Originals, both the tall fox and the - much shorter fox had wandered right into the red alert zone, the city Wixl. I desire a spatula - to scoop them aside with, shuffle them off to the coast near the beach hatcheries, hide them in - piles of fish eggs, hold down their pointy ears, concealing their luxurious hides. And above them - I would stand, casting an unmoving shadow, holding my rifle aloof. - - - I can't. I have you to teach. I have to groom and care for myself. The lightbulbs - upstairs need changing. A free pack of halogen lightbulbs just showed up out of the mail. Somebody out - there is obviously trying to get me to use them. So I'm going to screw 'em in. And just stand there, - casting an unmoving shadow, holding my rifle aloof. - - - Should that shadow be nice and defined, then I'll keep 'em. - - + - > + !i/wixl-1.jpg(Lost in Wixl)! + + !i/wixl-2.gif(This heist goes all the way up?)! + + + Oblivious to their involvement in the expansive plan of The Originals, both the tall fox and the + much shorter fox had wandered right into the red alert zone, the city Wixl. I desire a spatula + to scoop them aside with, shuffle them off to the coast near the beach hatcheries, hide them in + piles of fish eggs, hold down their pointy ears, concealing their luxurious hides. And above them + I would stand, casting an unmoving shadow, holding my rifle aloof. + + + I can't. I have you to teach. I have to groom and care for myself. The lightbulbs + upstairs need changing. A free pack of halogen lightbulbs just showed up out of the mail. Somebody out + there is obviously trying to get me to use them. So I'm going to screw 'em in. And just stand there, + casting an unmoving shadow, holding my rifle aloof. + + + Should that shadow be nice and defined, then I'll keep 'em. + + lang-pt/poignant-56.yml @@ -1,84 +1,84 @@ - - If I Were Looking For a Vehicle: > - - !i/wixl-7.gif(Sitting for a moment.)! - - - I like seeing these two out in the wild. They got pretty bored here in the studio. They started making - up wierd slogans and stuff. They had some phrase they kept repeating, forming fixations upon. - You can't be exposed to all that contrived fox nonsense. - - - Let's just say: I am really trying my best to keep things collegiate. Having never attended college, I can't - well say if every passage written chimes right with the stringent criteria which academia demands. - I have university friends aplenty, some who tour the globe in their pursuits, and I try to - inflect my voice with just their blend of high culture. - - - Sometimes I applaud myself for going beyond the work of my educated friends -- only in quiet corridors, we never - butt heads publicly -- because _I have actually subscribed_ to a school of thought while they are still - in their books, turning and turning. - - - *I am a preeventualist.* I have dabbled in it long enough and am glad to come forth with it. - Inevitably, some of you have already started mining this book for Marxist symbology. I am sad - to kill those interpretations, but I believe any nihilist conclusions you've drawn will still hold up - under scrutiny. - - - Anyway, I'll drop the rhetoric. I only mention preeventualism because, aside from being a refreshing - and easy alternative to the post-modernism we're born with, _this_ meta-cult offers a free lost-and-found - service for the residents of Wixl. - - - <pre> - require 'open-uri' - open( "http://preeventualist.org/lost" ) do |lost| - puts lost.read - end - </pre> - - - I have no way of alerting the foxes to this service. And I'm sure it's too soon for their truck to be listed. - Still, the good intentions are here. - - - If you're connected to the Internet, the above Ruby should have downloaded the web page from the Internet and - printed it to the screen. In a message resembling this: - - - <pre class="text"> - THE PREEVENTUALIST'S LOSING AND FINDING REGISTRY - (a free service benefiting the ENLIGHTENED who have been LIGHTENED) - - - --- - updates are made daily, please check back! - --- - - - this service is commissioned and - subsidized in part by The Ashley Raymond - Youth Study Clan - - - ... - all seals and privileges have been filed - under the notable authorship of Perry W. L. Von Frowling, - Magistrate Polywaif of Dispossession. Also, Seventh Straight Winner - of the esteemed Persistent Beggar's Community Cup. - ... - - - ABOUT THE REGISTRY - ================== - Hello, if you are new, please stay with us. A brief explanation of our service will - follow. First, a bit of important news from our beloved magistrate. (The kids call - him Uncle Von Guffuncle. Tehe!) - - IMPORTANT NEWS - ============== - / 15 April 2005 / - hi, big news. we were on channel 8 in wixl and ordish. cory saw it. i was on and - jerry mathers was on. if you didn't see it, e-mail cory. he tells it the best. all - i can say is those aren't MY hand motions!! (joke for people who watch channel 8.) - thanks harry and whole channel 8 news team!! + - If I Were Looking For a Vehicle: > + + !i/wixl-7.gif(Sitting for a moment.)! + + + I like seeing these two out in the wild. They got pretty bored here in the studio. They started making + up wierd slogans and stuff. They had some phrase they kept repeating, forming fixations upon. + You can't be exposed to all that contrived fox nonsense. + + + Let's just say: I am really trying my best to keep things collegiate. Having never attended college, I can't + well say if every passage written chimes right with the stringent criteria which academia demands. + I have university friends aplenty, some who tour the globe in their pursuits, and I try to + inflect my voice with just their blend of high culture. + + + Sometimes I applaud myself for going beyond the work of my educated friends -- only in quiet corridors, we never + butt heads publicly -- because _I have actually subscribed_ to a school of thought while they are still + in their books, turning and turning. + + + *I am a preeventualist.* I have dabbled in it long enough and am glad to come forth with it. + Inevitably, some of you have already started mining this book for Marxist symbology. I am sad + to kill those interpretations, but I believe any nihilist conclusions you've drawn will still hold up + under scrutiny. + + + Anyway, I'll drop the rhetoric. I only mention preeventualism because, aside from being a refreshing + and easy alternative to the post-modernism we're born with, _this_ meta-cult offers a free lost-and-found + service for the residents of Wixl. + + + <pre> + require 'open-uri' + open( "http://preeventualist.org/lost" ) do |lost| + puts lost.read + end + </pre> + + + I have no way of alerting the foxes to this service. And I'm sure it's too soon for their truck to be listed. + Still, the good intentions are here. + + + If you're connected to the Internet, the above Ruby should have downloaded the web page from the Internet and + printed it to the screen. In a message resembling this: + + + <pre class="text"> + THE PREEVENTUALIST'S LOSING AND FINDING REGISTRY + (a free service benefiting the ENLIGHTENED who have been LIGHTENED) + + + --- + updates are made daily, please check back! + --- + + + this service is commissioned and + subsidized in part by The Ashley Raymond + Youth Study Clan + + + ... + all seals and privileges have been filed + under the notable authorship of Perry W. L. Von Frowling, + Magistrate Polywaif of Dispossession. Also, Seventh Straight Winner + of the esteemed Persistent Beggar's Community Cup. + ... + + + ABOUT THE REGISTRY + ================== + Hello, if you are new, please stay with us. A brief explanation of our service will + follow. First, a bit of important news from our beloved magistrate. (The kids call + him Uncle Von Guffuncle. Tehe!) + + IMPORTANT NEWS + ============== + / 15 April 2005 / + hi, big news. we were on channel 8 in wixl and ordish. cory saw it. i was on and + jerry mathers was on. if you didn't see it, e-mail cory. he tells it the best. all + i can say is those aren't MY hand motions!! (joke for people who watch channel 8.) + thanks harry and whole channel 8 news team!! lang-pt/poignant-57.yml @@ -1,14 +1,14 @@ - - perry - - / 07 April 2005 / - we're all sifting through the carpet here at hq, but if you could all keep an eye out - for caitlin's clipboard, she's too quiet of a gal to post it and i know that it's - REALLY important to her. she had a few really expensive panoramic radiographs of her - husband's underbite clipped to a few irreplacable photos of her husband in a robocop - costume back when the underbite was more prominent. she says (to me), "they'll know - what i mean when they see them." i don't know what that means. :( - - i've checked: * the front desk * the hall * the waiting area * the bathroom * the candy - closet * the big tv area * the lunch counter * the disciples room * gaff's old room - (the one with the painting of the cherry tree) * the server room * staircase. i'll - update this as i find more rooms. + - perry + + / 07 April 2005 / + we're all sifting through the carpet here at hq, but if you could all keep an eye out + for caitlin's clipboard, she's too quiet of a gal to post it and i know that it's + REALLY important to her. she had a few really expensive panoramic radiographs of her + husband's underbite clipped to a few irreplacable photos of her husband in a robocop + costume back when the underbite was more prominent. she says (to me), "they'll know + what i mean when they see them." i don't know what that means. :( + + i've checked: * the front desk * the hall * the waiting area * the bathroom * the candy + closet * the big tv area * the lunch counter * the disciples room * gaff's old room + (the one with the painting of the cherry tree) * the server room * staircase. i'll + update this as i find more rooms. lang-pt/poignant-58.yml @@ -1,5 +1,5 @@ - - com amor, perry - - / 25 Fev 2005 / - servidor caiu às 3 horas. to puto com vocês. o gaff tá lá embaixo e ele vai - ficar lá até consertar. :O -- ATUALIZAÇÃO: consertado, de volta na ativa!! + - com amor, perry + + / 25 Fev 2005 / + servidor caiu às 3 horas. to puto com vocês. o gaff tá lá embaixo e ele vai + ficar lá até consertar. :O -- ATUALIZAÇÃO: consertado, de volta na ativa!! lang-pt/poignant-59.yml @@ -1,16 +1,16 @@ - - perry - - / 23 de fevereiro de 2005 / - eu sei que tem muito barulho hoje. stanley bros circus perdeu doze lhamas, um trailer, - um monte de cadeados e cinco tendas. eles ainda estão encontrando o material perdido. - por favor mantenham suas cabeças, eu preciso da ajuda de todos. esses comediantes não - têm nada. eu falo sério. hoje eu dei a um cara um adesivo roxo (é somente uma - coisa que eu gostaria de fazer como gesto de solidariedade) e ele praticamente dormiu nele - e nele cultivou os ingredientes pra molho de pizza. eles estão no fundo do poço. - - entao dôe por favor. eu sei que não temos paypal nem nada. se você quiser doar, - então divulgue que você encontrou alguma coisa (uma bicicleta de criança, uma compra do mês - com um monte de coisas estragadas ) e que isso tenha o nome do pessoal do circo escrito nele - ou algo assim. - - + - perry + + / 23 de fevereiro de 2005 / + eu sei que tem muito barulho hoje. stanley bros circus perdeu doze lhamas, um trailer, + um monte de cadeados e cinco tendas. eles ainda estão encontrando o material perdido. + por favor mantenham suas cabeças, eu preciso da ajuda de todos. esses comediantes não + têm nada. eu falo sério. hoje eu dei a um cara um adesivo roxo (é somente uma + coisa que eu gostaria de fazer como gesto de solidariedade) e ele praticamente dormiu nele + e nele cultivou os ingredientes pra molho de pizza. eles estão no fundo do poço. + + entao dôe por favor. eu sei que não temos paypal nem nada. se você quiser doar, + então divulgue que você encontrou alguma coisa (uma bicicleta de criança, uma compra do mês + com um monte de coisas estragadas ) e que isso tenha o nome do pessoal do circo escrito nele + ou algo assim. + + lang-pt/poignant-60.yml @@ -1,8 +1,8 @@ - - ótimo, perry - - /15 de novembro de 2004 - promoção do dia dos "esperansosos". se você perdeu algo hoje, pode escolher um - item grátis (no valor de $40 ou menor) da casa de alguém que encontrou algo. nos - estamos nos divertindo tanto com isso!! é EXATAMENTE assim que eu consegui minha - máquina de remar no ano passado e eu a AMO! - + - ótimo, perry + + /15 de novembro de 2004 + promoção do dia dos "esperansosos". se você perdeu algo hoje, pode escolher um + item grátis (no valor de $40 ou menor) da casa de alguém que encontrou algo. nos + estamos nos divertindo tanto com isso!! é EXATAMENTE assim que eu consegui minha + máquina de remar no ano passado e eu a AMO! + lang-pt/poignant-61.yml @@ -1,135 +1,135 @@ - - perry - </pre> - - - I think the Youth Study Clan is doing a great job with this service. It's a little hokey and - threadbare, but if it can get animals to stop using their instinctive means of declaring ownership, - then hats off. - - - Still, a preeventualist youth group? How can that be? You've got to at least _flirted with - real cynicism_ before you can become a preeventualist. And you definitely can't attend school. - So, I don't know. - - - Going back to the list of instructions from the Preeventualist's Losing and Finding Registry. - - - <pre class="text"> - USING THE L&F SERVER - ==================== - The L&F is a free service. The acts of losing and finding are essential qualities in - building a preeventualist lifestyle. We hope to accomodate your belief. - - - We do not use HTML, in order to simplify our work here. Our guys are already working - fifteen hour days. (Thanks, Terk!! Thanks, Horace!!) - - - You may search our service for your lost items. Or you may add your lost (or found) - item to our registry. This is done by typing the proper address into your browser. - - SEARCHING - ========= - To search for lost items, use the following address: - - http://preeventualist.org/lost/search?q={search word} - - You may replace {search word} with your search term. For example, to search for "cup": - - http://preeventualist.org/lost/search?q=cup - - You will be given a list of cups which have been lost or found. - - If you want to search for only lost cups or only found cups, use the `searchlost' and - `searchfound' pages: - - http://preeventualist.org/lost/searchlost?q=cup - </pre> - - - I'm not playing games. I know where the truck is. Really, I'm not teasing you. I'll - show you in just a sec. I'm just saying, look at the foxes: - - - !i/wixl-11.gif(Hummmmm.)! - - - They are helpless. And yet, here is this great tool. A possible key to getting out of this mess. - I just want to poke around, see if there are any clues here. - - - <pre> - require 'open-uri' - - # Searching all found items containing the word `truck'. - open( "http://preeventualist.org/lost/searchfound?q=truck" ) do |truck| - puts truck.read - end - </pre> - - - I'm not seeing anything about the tall fox's truck in this list. That's okay. - The foxes are out of it anyway. We have some time. - - - You've learned a very simple technique for retrieving a web page from the Internet. The code - uses the @OpenURI@ library, which was written by one of my favorite Rubyists, Akira Tanaka. He's - simplified reading from the Internet so that it's identical to reading a file from your computer. - - - In a previous chapter, we stored your diabolical ideas in a text file. You read these files in Ruby - using @open@. - - - <pre> - require 'open-uri' - - # Opening an idea file from a folder on your computer. - open( "folder/idea-about-hiding-lettuce-in-the-church-chairs.txt" ) do |idea| - puts idea.read - end - </pre> - - - Files are *input-output objects*. You can read and write to a file. In Ruby, all IO (input-output) - objects have @read@ and @write@ methods. The @open@ method slides an IO object *down the chute* - into a block for your use. IO is your ticket to the outside world. It's the rays of sunlight cast - through the prison bars. (However, you can't @write@ to a web page with @OpenURI@. You'll need to find a - tool for copying to your web server. An FTP program, for instance.) - - - If someone wants to read your diabolical idea about hiding lettuce in the church chairs, assuming - you've posted it as a web page: - - - <pre> - require 'open-uri' - - # Opening an idea file available on a web site. - open( "http://your.com/idea-about-hiding-lettuce-in-the-church-chairs.txt" ) do |idea| - puts idea.read - end - </pre> - - - The @OpenURI@ library also understands FTP addresses as well. This widens the possibilities for - where you can store files. On your system or elsewhere on the Internet. - - - h3. Reading Files Line by Line - - - When you're using @OpenURI@ to get information from the web with the @open@ and @read@ methods, - the page is given to you as a @String@. You can also read the page one line at a time, if you're - searching for something. Or if the page is big and you want to conserve your computer's memory. - - - <pre> - require 'open-uri' - open( "http://preeventualist.org/lost/searchfound?q=truck" ) do |truck| - truck.each_line do |line| - puts line if line['pickup'] - end - end - </pre> + - perry + </pre> + + + I think the Youth Study Clan is doing a great job with this service. It's a little hokey and + threadbare, but if it can get animals to stop using their instinctive means of declaring ownership, + then hats off. + + + Still, a preeventualist youth group? How can that be? You've got to at least _flirted with + real cynicism_ before you can become a preeventualist. And you definitely can't attend school. + So, I don't know. + + + Going back to the list of instructions from the Preeventualist's Losing and Finding Registry. + + + <pre class="text"> + USING THE L&F SERVER + ==================== + The L&F is a free service. The acts of losing and finding are essential qualities in + building a preeventualist lifestyle. We hope to accomodate your belief. + + + We do not use HTML, in order to simplify our work here. Our guys are already working + fifteen hour days. (Thanks, Terk!! Thanks, Horace!!) + + + You may search our service for your lost items. Or you may add your lost (or found) + item to our registry. This is done by typing the proper address into your browser. + + SEARCHING + ========= + To search for lost items, use the following address: + + http://preeventualist.org/lost/search?q={search word} + + You may replace {search word} with your search term. For example, to search for "cup": + + http://preeventualist.org/lost/search?q=cup + + You will be given a list of cups which have been lost or found. + + If you want to search for only lost cups or only found cups, use the `searchlost' and + `searchfound' pages: + + http://preeventualist.org/lost/searchlost?q=cup + </pre> + + + I'm not playing games. I know where the truck is. Really, I'm not teasing you. I'll + show you in just a sec. I'm just saying, look at the foxes: + + + !i/wixl-11.gif(Hummmmm.)! + + + They are helpless. And yet, here is this great tool. A possible key to getting out of this mess. + I just want to poke around, see if there are any clues here. + + + <pre> + require 'open-uri' + + # Searching all found items containing the word `truck'. + open( "http://preeventualist.org/lost/searchfound?q=truck" ) do |truck| + puts truck.read + end + </pre> + + + I'm not seeing anything about the tall fox's truck in this list. That's okay. + The foxes are out of it anyway. We have some time. + + + You've learned a very simple technique for retrieving a web page from the Internet. The code + uses the @OpenURI@ library, which was written by one of my favorite Rubyists, Akira Tanaka. He's + simplified reading from the Internet so that it's identical to reading a file from your computer. + + + In a previous chapter, we stored your diabolical ideas in a text file. You read these files in Ruby + using @open@. + + + <pre> + require 'open-uri' + + # Opening an idea file from a folder on your computer. + open( "folder/idea-about-hiding-lettuce-in-the-church-chairs.txt" ) do |idea| + puts idea.read + end + </pre> + + + Files are *input-output objects*. You can read and write to a file. In Ruby, all IO (input-output) + objects have @read@ and @write@ methods. The @open@ method slides an IO object *down the chute* + into a block for your use. IO is your ticket to the outside world. It's the rays of sunlight cast + through the prison bars. (However, you can't @write@ to a web page with @OpenURI@. You'll need to find a + tool for copying to your web server. An FTP program, for instance.) + + + If someone wants to read your diabolical idea about hiding lettuce in the church chairs, assuming + you've posted it as a web page: + + + <pre> + require 'open-uri' + + # Opening an idea file available on a web site. + open( "http://your.com/idea-about-hiding-lettuce-in-the-church-chairs.txt" ) do |idea| + puts idea.read + end + </pre> + + + The @OpenURI@ library also understands FTP addresses as well. This widens the possibilities for + where you can store files. On your system or elsewhere on the Internet. + + + h3. Reading Files Line by Line + + + When you're using @OpenURI@ to get information from the web with the @open@ and @read@ methods, + the page is given to you as a @String@. You can also read the page one line at a time, if you're + searching for something. Or if the page is big and you want to conserve your computer's memory. + + + <pre> + require 'open-uri' + open( "http://preeventualist.org/lost/searchfound?q=truck" ) do |truck| + truck.each_line do |line| + puts line if line['pickup'] + end + end + </pre> lang-pt/poignant-62.yml @@ -1,125 +1,125 @@ - - - The above code will retrieve the list of trucks found by preeventualists, then display only - those lines that actually contain the word 'pickup'. - That way we can trim out the descriptions and look for only the pertinent lines. - - - Above, the *index brackets* are used on a string, so the string is searched for whatever is inside - the brackets. Since the string @'pickup'@ is inside the brackets, the @line@ string is searched - for the word "pickup". - - - !i/wixl-13.gif(On being funny.)! - - - When a web page is loaded with @read@, the entire page is loaded into memory. Usually this - only takes up a few thousand bytes. But if a page is big (several megabytes), you'll probably - want to use @each_line@, which loads one line at a time to avoid exhausting memory. - - - h3. Yielding is Kiddie Blocks - - - Ruby often uses iterators in this fashion. Yes, iterators are used for cycling through each item in - a collection of items, such as an array or hash. Now look at an IO source as a collection of lines. - The iterator can crawl that collection of lines. - - - <pre> - class IO - # Definition for the each_line method. Notice how it has no - # argument list. Blocks don't need to be listed as arguments. - def each_line - until eof? # until we reach the end of the file... - yield readline # pass a line into the block - end - end - end - </pre> - - - The @yield@ keyword is the easiest way to use a block. One word. Just like a curtain has - a pullstring or like a suitcase has a handle. Inside a method, you can press the blinking - @yield@ button and it will run the block attached to that method. Glowing a strong red color - until the code inside the block is done. And then it goes back to blinking and you can press - the button again if you like. - - - <pre> - def yield_thrice - yield - yield - yield - end - </pre> - - - Punch the @yield@ button three times quick and the block gets to live its life three times. - - - <pre> - irb> a = ['first, birth.', 'then, a life of flickering images.', 'and, finally, the end.'] - irb> yield_thrice { puts a.shift } - # prints out: - # first, birth. - # then, a life of flickering images. - # and, finally, the end. - </pre> - - - The @shift@ method pulls the first item off an array. The barber @shift@ cuts the hair off - and hands it over. Then, the scalp. And just keeps going, whittling the poor guy down to - nothing. - - - You've seen blocks attached to methods. Any Ruby method can have block attached to the end. - - - <pre> - # The brief style of attaching a block to a method. - # Here the block is surrounded with curly braces. - open( "idea.txt" ) { |f| f.read } - - # The verbose style of attaching a block to a method. - # Here the block is surrounded with `do' and `end' - open( "idea.txt" ) do |f| - f.read - end - </pre> - - - If you pass arguments to @yield@, those arguments will also be passed to the block. - The block is riding in a little sidecar attached to the method's motorcycle. The method - yells out a list arguments, screaming to the block over all the wind as they're - racing through the desert. The block taps his helmet like, "I get it, my brain gets it." - - - <pre> - # The method opens two files and slides the resulting IO objects down the - # chute to an attached block. - def double_open filename1, filename2 - open( filename1 ) do |f1| - open( filename2 ) do |f2| - yield f1, f2 - end - end - end - - # Prints the files out side-by-side. - double_open( "idea1.txt", "idea2.txt" ) do |f1, f2| - puts f1.readline + " | " + f2.readline - end - </pre> - - - You may also wonder what the @yield@ keyword has to do with street signs. And really, - it's a good question with, I believe, a good answer. When you run a method, you are giving - that method control of your program. Control to do its job and then come back to with an - answer. - - - With @yield@, the method is stopping at the intersection, giving control back to you, to your block. The method is letting - you do your work before resuming its work. So while the @each_line@ method does the work of actually - reading lines from a file, the *block attached to the @each_line@ method* is handed the line - itself and gets a chance to hammer away at it in the sidecar. + + + The above code will retrieve the list of trucks found by preeventualists, then display only + those lines that actually contain the word 'pickup'. + That way we can trim out the descriptions and look for only the pertinent lines. + + + Above, the *index brackets* are used on a string, so the string is searched for whatever is inside + the brackets. Since the string @'pickup'@ is inside the brackets, the @line@ string is searched + for the word "pickup". + + + !i/wixl-13.gif(On being funny.)! + + + When a web page is loaded with @read@, the entire page is loaded into memory. Usually this + only takes up a few thousand bytes. But if a page is big (several megabytes), you'll probably + want to use @each_line@, which loads one line at a time to avoid exhausting memory. + + + h3. Yielding is Kiddie Blocks + + + Ruby often uses iterators in this fashion. Yes, iterators are used for cycling through each item in + a collection of items, such as an array or hash. Now look at an IO source as a collection of lines. + The iterator can crawl that collection of lines. + + + <pre> + class IO + # Definition for the each_line method. Notice how it has no + # argument list. Blocks don't need to be listed as arguments. + def each_line + until eof? # until we reach the end of the file... + yield readline # pass a line into the block + end + end + end + </pre> + + + The @yield@ keyword is the easiest way to use a block. One word. Just like a curtain has + a pullstring or like a suitcase has a handle. Inside a method, you can press the blinking + @yield@ button and it will run the block attached to that method. Glowing a strong red color + until the code inside the block is done. And then it goes back to blinking and you can press + the button again if you like. + + + <pre> + def yield_thrice + yield + yield + yield + end + </pre> + + + Punch the @yield@ button three times quick and the block gets to live its life three times. + + + <pre> + irb> a = ['first, birth.', 'then, a life of flickering images.', 'and, finally, the end.'] + irb> yield_thrice { puts a.shift } + # prints out: + # first, birth. + # then, a life of flickering images. + # and, finally, the end. + </pre> + + + The @shift@ method pulls the first item off an array. The barber @shift@ cuts the hair off + and hands it over. Then, the scalp. And just keeps going, whittling the poor guy down to + nothing. + + + You've seen blocks attached to methods. Any Ruby method can have block attached to the end. + + + <pre> + # The brief style of attaching a block to a method. + # Here the block is surrounded with curly braces. + open( "idea.txt" ) { |f| f.read } + + # The verbose style of attaching a block to a method. + # Here the block is surrounded with `do' and `end' + open( "idea.txt" ) do |f| + f.read + end + </pre> + + + If you pass arguments to @yield@, those arguments will also be passed to the block. + The block is riding in a little sidecar attached to the method's motorcycle. The method + yells out a list arguments, screaming to the block over all the wind as they're + racing through the desert. The block taps his helmet like, "I get it, my brain gets it." + + + <pre> + # The method opens two files and slides the resulting IO objects down the + # chute to an attached block. + def double_open filename1, filename2 + open( filename1 ) do |f1| + open( filename2 ) do |f2| + yield f1, f2 + end + end + end + + # Prints the files out side-by-side. + double_open( "idea1.txt", "idea2.txt" ) do |f1, f2| + puts f1.readline + " | " + f2.readline + end + </pre> + + + You may also wonder what the @yield@ keyword has to do with street signs. And really, + it's a good question with, I believe, a good answer. When you run a method, you are giving + that method control of your program. Control to do its job and then come back to with an + answer. + + + With @yield@, the method is stopping at the intersection, giving control back to you, to your block. The method is letting + you do your work before resuming its work. So while the @each_line@ method does the work of actually + reading lines from a file, the *block attached to the @each_line@ method* is handed the line + itself and gets a chance to hammer away at it in the sidecar. lang-pt/poignant-62a.yml @@ -1,66 +1,66 @@ - - - h3. Preeventualism in a Gilded Box - - - You've learned so much about @OpenURI@ and using @yield@ to write your own iterators. - You know your way around the lost-and-found service. Really, you can starting hunting - through the Wixl junk drawer without me. - - - Let's neatly _encapsulate_ the entire service into a single class. - - - <pre> - require 'open-uri' - module PreEventualist - def self.open page, query - qs = - query.map do |k, v| - URI.escape "#{ k }=#{ v }" - end.join "&" - URI.parse( "http://preeventualist.org/lost/" + page + "?" + qs ).open do |lost| - lost.read.split( "--\n" ) - end - end - def self.search word - open "search", "q" => word - end - def self.searchlost word - open "searchlost", "q" => word - end - def self.searchfound word - open "searchfound", "q" => word - end - def self.addfound your_name, item_lost, found_at, description - open "addfound", "name" => your_name, "item" => item_lost, - "at" => found_at, "desc" => description - end - def self.addlost your_name, item_found, last_seen, description - open "addlost", "name" => your_name, "item" => item_found, - "seen" => last_seen, "desc" => description - end - end - </pre> - - - At some point with your code, you need to start shaping it into something neat. Save the above - module in a file called @preeventualist.rb@. - - - This module is a very simple library for using the Preeventualist's service. This is exactly the - way libraries are written. You whip up a module or a class, store it in a file, and, if you're - happy with it and want the world to benefit, put it on the web. - - - These stragglers can you use your module just like I used @OpenURI@ earlier. - - - <pre> - irb> require 'preeventualist' - irb> puts PreEventualist.search( 'truck' ) - irb> puts PreEventualist.addfound( 'Why', 'Ruby skills', 'Wixl park', - "I can give you Ruby skills!\nCome visit poignantguide.net!" ) - </pre> - - + + + h3. Preeventualism in a Gilded Box + + + You've learned so much about @OpenURI@ and using @yield@ to write your own iterators. + You know your way around the lost-and-found service. Really, you can starting hunting + through the Wixl junk drawer without me. + + + Let's neatly _encapsulate_ the entire service into a single class. + + + <pre> + require 'open-uri' + module PreEventualist + def self.open page, query + qs = + query.map do |k, v| + URI.escape "#{ k }=#{ v }" + end.join "&" + URI.parse( "http://preeventualist.org/lost/" + page + "?" + qs ).open do |lost| + lost.read.split( "--\n" ) + end + end + def self.search word + open "search", "q" => word + end + def self.searchlost word + open "searchlost", "q" => word + end + def self.searchfound word + open "searchfound", "q" => word + end + def self.addfound your_name, item_lost, found_at, description + open "addfound", "name" => your_name, "item" => item_lost, + "at" => found_at, "desc" => description + end + def self.addlost your_name, item_found, last_seen, description + open "addlost", "name" => your_name, "item" => item_found, + "seen" => last_seen, "desc" => description + end + end + </pre> + + + At some point with your code, you need to start shaping it into something neat. Save the above + module in a file called @preeventualist.rb@. + + + This module is a very simple library for using the Preeventualist's service. This is exactly the + way libraries are written. You whip up a module or a class, store it in a file, and, if you're + happy with it and want the world to benefit, put it on the web. + + + These stragglers can you use your module just like I used @OpenURI@ earlier. + + + <pre> + irb> require 'preeventualist' + irb> puts PreEventualist.search( 'truck' ) + irb> puts PreEventualist.addfound( 'Why', 'Ruby skills', 'Wixl park', + "I can give you Ruby skills!\nCome visit poignantguide.net!" ) + </pre> + + lang-pt/poignant-62b.yml @@ -1,4 +1,4 @@ - - Enquanto Isso, O Porco-Espinho Pára Pra Abastecer: > - - !i/porcupine-1.gif(O porco-espinho paga por gasolina. Pipas?)! - + - Enquanto Isso, O Porco-Espinho Pára Pra Abastecer: > + + !i/porcupine-1.gif(O porco-espinho paga por gasolina. Pipas?)! + lang-pt/poignant-63.yml @@ -1,15 +1,15 @@ - - Um Assassinato de Dragão Patrocinado: > - - !i/wixl.dwemthy-1.gif(O assassino pula adentro.)! - - - "Olhe em Volta," disse a Raposa Pequena. "Alguns de nós não tem tempo para buscas. Alguns de nós tem maiores - responsabilidades, trabalhos, assim por diante. Sustento, Entendeu?" - - - "_Eiiii_, meu *TRABALHO* era assassinar o dragão!!" gritou o coelho Wee, piscando seus olhos e e pulando furioso - de galho em galho de lagoa em lagoa. "Seu focinho era uma *GRANDE* responsabilidade!! Seu hálito de fumaça era _problema meu!!!_. - Eu gastei cinquenta dólares em um tâxi *APENAS* para sair daqui, que foi outro _ENORME ENORME_ sacrifício. Você não tem - _nada sobre mim_, nem uma _simples_ acusação, todo a minha *HEROICIDADE* é _absoflautamente impessegável_, toda a minha *ABORDAGEM* é - _clarinentemente indamascável_, disse o Lester." - + - Um Assassinato de Dragão Patrocinado: > + + !i/wixl.dwemthy-1.gif(O assassino pula adentro.)! + + + "Olhe em Volta," disse a Raposa Pequena. "Alguns de nós não tem tempo para buscas. Alguns de nós tem maiores + responsabilidades, trabalhos, assim por diante. Sustento, Entendeu?" + + + "_Eiiii_, meu *TRABALHO* era assassinar o dragão!!" gritou o coelho Wee, piscando seus olhos e e pulando furioso + de galho em galho de lagoa em lagoa. "Seu focinho era uma *GRANDE* responsabilidade!! Seu hálito de fumaça era _problema meu!!!_. + Eu gastei cinquenta dólares em um tâxi *APENAS* para sair daqui, que foi outro _ENORME ENORME_ sacrifício. Você não tem + _nada sobre mim_, nem uma _simples_ acusação, todo a minha *HEROICIDADE* é _absoflautamente impessegável_, toda a minha *ABORDAGEM* é + _clarinentemente indamascável_, disse o Lester." + lang-pt/poignant-64.yml @@ -1,46 +1,46 @@ - - !^sidebar - The Inadvertant Meteor: > - - _When I first began my inquiry into preeventualism, I was relayed the following story. I was told that - this was all I needed to understand the philosophy._ - - - There was this sculptor who just wasn't satisfied with his work. He had primarily studied traditional subject - matter and excelled at sculpting both the human figure and elaborate vegetation. And he was really quite - an exquisite sculptor. He just didn't feel like he was making his mark upon the world. - - - By this time, he had aged well into his fifties and wanted to vaunt into the realm of legendary masters. - So he began to construct a massive sculpture of two pears with beads of dew clinging precariously to - them. - - - The sculpture was enormous and hovered ominously above the sculptor's hometown, held aloof by a massive - infrastructure of struts and beams. - In fact, the giant pears were so significant that they truly wreaked havoc on the Earth's rotation, - everso slightly, what with a new asteroid-sized fruit basket clinging to it. - - - The government sent jets and warcrafts to destroy the statue. They unleashed a vicious attack on the village, - dismantling the statue, blowing it into thousands of pieces, chipping away at it with missiles. Soon enough, - the statue was obliterated and all was back to normal. - - - A huge chunk of the statue had taken orbit in the heavens and often veered perilously close to the - planet. When it did, it was always met by an arsenal of advanced weaponry, which further damaged it - and deflected its course skyward. - - - Eventually, this inadvertant meteor was nothing more than the size of a very daunting man. And, when it - at last hit the ground, weathered and polished by its ninety year journey, it was hailed as an enigmatic - masterpiece, a message from the great beyond. Here was a stunning likeness of a male nude looking - wistfully into the sky with an intricate lacework of vines creeping around his waist and covering his - improprieties. - - - The statue was last sold for fifty-two million dollars and stayed in the permanent exhibit at the Louvre, - with the plaque: - - - bq. "Heavenly Nude" by Anonymous - + - !^sidebar + The Inadvertant Meteor: > + + _When I first began my inquiry into preeventualism, I was relayed the following story. I was told that + this was all I needed to understand the philosophy._ + + + There was this sculptor who just wasn't satisfied with his work. He had primarily studied traditional subject + matter and excelled at sculpting both the human figure and elaborate vegetation. And he was really quite + an exquisite sculptor. He just didn't feel like he was making his mark upon the world. + + + By this time, he had aged well into his fifties and wanted to vaunt into the realm of legendary masters. + So he began to construct a massive sculpture of two pears with beads of dew clinging precariously to + them. + + + The sculpture was enormous and hovered ominously above the sculptor's hometown, held aloof by a massive + infrastructure of struts and beams. + In fact, the giant pears were so significant that they truly wreaked havoc on the Earth's rotation, + everso slightly, what with a new asteroid-sized fruit basket clinging to it. + + + The government sent jets and warcrafts to destroy the statue. They unleashed a vicious attack on the village, + dismantling the statue, blowing it into thousands of pieces, chipping away at it with missiles. Soon enough, + the statue was obliterated and all was back to normal. + + + A huge chunk of the statue had taken orbit in the heavens and often veered perilously close to the + planet. When it did, it was always met by an arsenal of advanced weaponry, which further damaged it + and deflected its course skyward. + + + Eventually, this inadvertant meteor was nothing more than the size of a very daunting man. And, when it + at last hit the ground, weathered and polished by its ninety year journey, it was hailed as an enigmatic + masterpiece, a message from the great beyond. Here was a stunning likeness of a male nude looking + wistfully into the sky with an intricate lacework of vines creeping around his waist and covering his + improprieties. + + + The statue was last sold for fifty-two million dollars and stayed in the permanent exhibit at the Louvre, + with the plaque: + + + bq. "Heavenly Nude" by Anonymous + lang-pt/poignant-65.yml @@ -1,196 +1,196 @@ - - > - - "Quem é Lester?" falou a Raposa Pequena. - - - "Lester é meu taxista! Ele está estacionado na base do Dwemthy's Array!!" O Coelho ricocheteou furiosamente como uma proteção de tela - de um Super-Computador. _"Fale com o Dwemthy!!"_ - - - "Bom," disse a Raposa Pequena. Ele girou para trás para olhar para cima na Raposa Alta, Que estava sentada direita e olhando longe - no horizonte. "Espere, nós temos um estacionamento repartido no Dwemthy's Array?" - - - *"SIM!!* E um estande de Pretzel!!" - - - "Mas, ele é _um Array_? Eles vendem Churros?" - - - *"CHOCOLAVA!!"* berrou o coelho. - - - "E quanto aqueles cordas que brilham no escuro que você colocou no seu cabelo? Ou você pode apenas conte-las pelo seu lado ou até - no ar--" - - - *"BRAIDQUEST!!"* - - - "Você deve obter uma parte da comissão da vendedor," Falou a Raposa Pequena. "O pessoal saiu para ver você matar o dragão, certo?" - - - *"MAS!!* Eu não opero os braços-mecanicos que atualmente extraem o chocolava." - - - "Eu só estou falando. Você *faz* funcionar o mecanismo de matar. então você _tem uma estaca_ na sua salada." - - - "AH NÃOO!! Eu perdi minha folha de alface favorita no Dwemthy's Array!!" gritou o coelho, girando como uma espada de celebração sobre - a floresta de carvalhos. Distantly: "Or Lester's trunk, maybe?" - - - "You know-- Gheesh, can you stay put??" said Fox Small. - - - "My radio," said Fox Tall, stirring to life for a moment, "in my pickup." The glaze still seeping from his eyes. His stare quivered and - set back into his face, recalling another time and place. A drive out to Maryland. Sounds of Lionel Richie coming in - so clearly. The wipers going a bit too fast. He pulls up to a house. His mother answers the door. - She is a heavily fluffed fox. Tears and makeup. - - - Slumping back down, "That porcupine is changing my presets." - - - The rabbit bounded up on to the armrest of the park bench and spoke closely. *"BUT!!* Soon I will feast on - drgn's head and the juices of drgn's tongue!!" The rabbit sat still and held his paws kindly. - - - "(Which I hope will taste like cinnamon bears,)" whispered the rabbit, intimately. - - - "I love cinammon," said Fox Small. "I should go killing with you some time." - - - "You should," said the rabbit and the eyes shine-shined. - - - "Although, salivating over a tongue. You don't salivate over it, do you?" - - - "I DO!!" and the rabbit got so excited that Sticky Whip shot out of his eyes. (More on Sticky Whip in a later sidebar. - Don't let me forget. See also: _The Purist's Compendium to Novelty Retinal Cremes_ by Jory Patrick Sobgoblin, available wherever animal - attachment clips are sold.) - - - "Okay, you've hooked me. I want to hear all about it," Fox Small declared. - "Please, talk freely about the chimbly. Oh, and Dwemthy. Who is he? What makes him tick? Then maybe, if I'm still around after - that, you can tell me about what makes rabbits tick, and maybe you can hold our hands through this whole missing truck ordeal. - I need consolation more than anything else. I could probably use religion right now. I could use your personal bravery and - this sense of accomplishment you exude. Do you smoke a pipe? Could be a handy tool to coax along the pontification we - must engage in." - - - And the rabbit began expounding upon Dwemthy and the legend of Dwemthy and the ways of Dwemthy. - As with most stories of Dwemthy, the rabbit's tales were mostly embellishments. - Smotchkkiss, there are delicacies which I alone must address. - - - Please, never ask who Dwemthy is. Obviously he is a mastermind and would never disclose his location or true identity. He has sired dynasties. He has set living ogres aflame. Horses everywhere smell him at all times. Most of all, he knows carnal pleasures. And to think that this... - - - This is his Array. - - - h3. Dwemthy's Array - - - !i/dwemthy-asweome.gif(Dwemthy's Array has charmed and tormented the village folk for centuries.)! - - - You stand at the entrance of Dwemthy's Array. You are a rabbit who is about to die. - And deep at the end of the Array: - - - <pre> - class Dragon < Creature - life 1340 # tough scales - strength 451 # bristling veins - charisma 1020 # toothy smile - weapon 939 # fire breath - end - </pre> - - - A scalding _SEETHING LAVA_ infiltrates the *cacauphonous ENGORGED MINESHAFTS* deep within the ageless canopy of the _DWEMTHY FOREST_... chalky and nocturnal screams from *the belly of the RAVENOUS WILD STORKUPINE*... who eats *wet goslings* _RIGHT AFTER_ they've had a few graham crackers and a midday nap... amidst starved hippos _TECHNICALLY ORPHANED_ but truthfully sheltered by umbrellas owned jointly by car dealership conglomerates... beneath _uncapped vials_ of mildly pulpy *BLUE ELIXIR*... _which shall remain... heretofore... *UNDISTURBED... DWEMTHY!!!*_ - - - !i/wixl.dwemthy-2.gif(Luck and mother nature.)! - - - _If you don't understand Dwemthy's Array, it is Dwemthy's fault. He designed the game to complicate our lives and were it simpler, it would not be the awe-inspiring quest we've come to cherish in our arms this very hour._ - - - Dwemthy's Array has a winding history of great depth. It is not enough to simply say, "Dwemthy's - Array," over and over and expect to build credentials from that act alone. Come with me, I can take you back - a couple years, back to the sixties where it all started with metaprogramming and the dolphins. - - - You might be inclined to think that *metaprogramming* is another hacker word and was first overheard in private - phone calls between fax machines. Honest to God, I am here to tell you that it is stranger than that. - Metaprogramming began with _taking drugs in the company of dolphins_. - - - In the sixties, a prolific scientist named John C. Lilly began experimenting with his own senses, - to uncover the workings of his body. I can relate to this. I do this frequently when I am standing - in the middle of a road holding a pie or when I am hiding inside a cathedral. I pause to examine - my self. This has proven to be nigh impossible. I have filled three ruled pages with algebraic - notation, none of which has explained anything. The pie, incidentally, has been very easy to express - mathematically. - - - But the scientist Lilly went about his experiments otherwise. He ingested LSD in the company of dolphins. - Often in a dark, woeful isolation tank full of warm salt water. Pretty bleak. But it was science! (Lest you think him - criminal: until 1966, LSD was supplied by Sandoz Laboratories to any interested scientists, free of charge.) - - - *Drugs, dolphins and deprivation.* Which led to Lilly's foray into things meta. He wrote books on - mental programming, comparing humans and computers. You may choose to ingest any substance you want during - this next quote -- most likely you're reaching for the grain of salt -- but I assure you that there's - no Grateful Dead show on the lawn and no ravers in the basement. - - - bq. When one learns to learn, one is making models, using symbols, analogizing, making metaphors, in short, inventing and using language, mathematics, art, politics, business, etc. At the critical brain (cortex) size, languages and its consequences appear. To avoid the necessity of repeating learning to learn, symbols, metaphors, models each time, I symbolize the underlying idea in these operations as metaprogramming. - - - bq(attrib). John C. Lilly, _Programming and Metaprogramming in the Human Biocomputer_, New York, 1972. - - - We learn. But first we learn to learn. We setup programming in our mind which is the pathway to further - programming. (Lilly is largely talking about programming the brain and the nervous system, which he - collectively called the _biocomputer_.) - - - Lilly's metaprogramming was more about feeding yourself imagery, reinventing yourself, all that. - This sort of thinking links directly to folks out there who dabble in shamanism, wave their hands over tarot cards and - wake up early for karate class. I guess you could say metaprogramming is New Age, but it's all settled down - recently into a sleeping bag with plain old nerdiness. (If you got here from a Google search for "C++ Metaprogramming", - stick around, but I only ask that you _burn_ those neural pathways that originally invoked the search. Many thanks.) - - - Meta itself is spoken of no differently in your author's present day. - - - bq. All sensuous response to reality is an interpretation of - it. Beetles and monkeys clearly interpret their world, and act on the basis of what they see. - Our physical senses are themselves organs of interpretation. What distinguishes us from our fellow - animals is that we are able in turn to interpret these interpretations. In that sense, all human - language is meta-language. It is a second-order reflection on the 'language' of our bodies -- - of our sensory apparatus. - - - bq(attrib). Terry Eagleton, _After Theory_, London, 2003, ch. 3. - - - To that end, you could say programming itself is a meta-language. _All code_ speaks the language of action, - of a plan which hasn't been played yet, but shortly will. Stage directions for the players inside your - machine. I've waxed sentimental on this before. - - - But now we're advancing our study, venturing into metaprogramming, but don't sweat it, *it's still just the - Ruby you've seen already*, which is why Dwemthy feels no qualms thrusting it at you right away. Soon enough it will be - as easy to spot as addition or subtraction. At first it may seem intensely bright, like you've stumbled across your - first firefly, which has flown up in your face. Then, it becomes just _a little bobbing light_ which makes living - in Ohio so much nicer. - - + - > + + "Quem é Lester?" falou a Raposa Pequena. + + + "Lester é meu taxista! Ele está estacionado na base do Dwemthy's Array!!" O Coelho ricocheteou furiosamente como uma proteção de tela + de um Super-Computador. _"Fale com o Dwemthy!!"_ + + + "Bom," disse a Raposa Pequena. Ele girou para trás para olhar para cima na Raposa Alta, Que estava sentada direita e olhando longe + no horizonte. "Espere, nós temos um estacionamento repartido no Dwemthy's Array?" + + + *"SIM!!* E um estande de Pretzel!!" + + + "Mas, ele é _um Array_? Eles vendem Churros?" + + + *"CHOCOLAVA!!"* berrou o coelho. + + + "E quanto aqueles cordas que brilham no escuro que você colocou no seu cabelo? Ou você pode apenas conte-las pelo seu lado ou até + no ar--" + + + *"BRAIDQUEST!!"* + + + "Você deve obter uma parte da comissão da vendedor," Falou a Raposa Pequena. "O pessoal saiu para ver você matar o dragão, certo?" + + + *"MAS!!* Eu não opero os braços-mecanicos que atualmente extraem o chocolava." + + + "Eu só estou falando. Você *faz* funcionar o mecanismo de matar. então você _tem uma estaca_ na sua salada." + + + "AH NÃOO!! Eu perdi minha folha de alface favorita no Dwemthy's Array!!" gritou o coelho, girando como uma espada de celebração sobre + a floresta de carvalhos. Distantly: "Or Lester's trunk, maybe?" + + + "You know-- Gheesh, can you stay put??" said Fox Small. + + + "My radio," said Fox Tall, stirring to life for a moment, "in my pickup." The glaze still seeping from his eyes. His stare quivered and + set back into his face, recalling another time and place. A drive out to Maryland. Sounds of Lionel Richie coming in + so clearly. The wipers going a bit too fast. He pulls up to a house. His mother answers the door. + She is a heavily fluffed fox. Tears and makeup. + + + Slumping back down, "That porcupine is changing my presets." + + + The rabbit bounded up on to the armrest of the park bench and spoke closely. *"BUT!!* Soon I will feast on + drgn's head and the juices of drgn's tongue!!" The rabbit sat still and held his paws kindly. + + + "(Which I hope will taste like cinnamon bears,)" whispered the rabbit, intimately. + + + "I love cinammon," said Fox Small. "I should go killing with you some time." + + + "You should," said the rabbit and the eyes shine-shined. + + + "Although, salivating over a tongue. You don't salivate over it, do you?" + + + "I DO!!" and the rabbit got so excited that Sticky Whip shot out of his eyes. (More on Sticky Whip in a later sidebar. + Don't let me forget. See also: _The Purist's Compendium to Novelty Retinal Cremes_ by Jory Patrick Sobgoblin, available wherever animal + attachment clips are sold.) + + + "Okay, you've hooked me. I want to hear all about it," Fox Small declared. + "Please, talk freely about the chimbly. Oh, and Dwemthy. Who is he? What makes him tick? Then maybe, if I'm still around after + that, you can tell me about what makes rabbits tick, and maybe you can hold our hands through this whole missing truck ordeal. + I need consolation more than anything else. I could probably use religion right now. I could use your personal bravery and + this sense of accomplishment you exude. Do you smoke a pipe? Could be a handy tool to coax along the pontification we + must engage in." + + + And the rabbit began expounding upon Dwemthy and the legend of Dwemthy and the ways of Dwemthy. + As with most stories of Dwemthy, the rabbit's tales were mostly embellishments. + Smotchkkiss, there are delicacies which I alone must address. + + + Please, never ask who Dwemthy is. Obviously he is a mastermind and would never disclose his location or true identity. He has sired dynasties. He has set living ogres aflame. Horses everywhere smell him at all times. Most of all, he knows carnal pleasures. And to think that this... + + + This is his Array. + + + h3. Dwemthy's Array + + + !i/dwemthy-asweome.gif(Dwemthy's Array has charmed and tormented the village folk for centuries.)! + + + You stand at the entrance of Dwemthy's Array. You are a rabbit who is about to die. + And deep at the end of the Array: + + + <pre> + class Dragon < Creature + life 1340 # tough scales + strength 451 # bristling veins + charisma 1020 # toothy smile + weapon 939 # fire breath + end + </pre> + + + A scalding _SEETHING LAVA_ infiltrates the *cacauphonous ENGORGED MINESHAFTS* deep within the ageless canopy of the _DWEMTHY FOREST_... chalky and nocturnal screams from *the belly of the RAVENOUS WILD STORKUPINE*... who eats *wet goslings* _RIGHT AFTER_ they've had a few graham crackers and a midday nap... amidst starved hippos _TECHNICALLY ORPHANED_ but truthfully sheltered by umbrellas owned jointly by car dealership conglomerates... beneath _uncapped vials_ of mildly pulpy *BLUE ELIXIR*... _which shall remain... heretofore... *UNDISTURBED... DWEMTHY!!!*_ + + + !i/wixl.dwemthy-2.gif(Luck and mother nature.)! + + + _If you don't understand Dwemthy's Array, it is Dwemthy's fault. He designed the game to complicate our lives and were it simpler, it would not be the awe-inspiring quest we've come to cherish in our arms this very hour._ + + + Dwemthy's Array has a winding history of great depth. It is not enough to simply say, "Dwemthy's + Array," over and over and expect to build credentials from that act alone. Come with me, I can take you back + a couple years, back to the sixties where it all started with metaprogramming and the dolphins. + + + You might be inclined to think that *metaprogramming* is another hacker word and was first overheard in private + phone calls between fax machines. Honest to God, I am here to tell you that it is stranger than that. + Metaprogramming began with _taking drugs in the company of dolphins_. + + + In the sixties, a prolific scientist named John C. Lilly began experimenting with his own senses, + to uncover the workings of his body. I can relate to this. I do this frequently when I am standing + in the middle of a road holding a pie or when I am hiding inside a cathedral. I pause to examine + my self. This has proven to be nigh impossible. I have filled three ruled pages with algebraic + notation, none of which has explained anything. The pie, incidentally, has been very easy to express + mathematically. + + + But the scientist Lilly went about his experiments otherwise. He ingested LSD in the company of dolphins. + Often in a dark, woeful isolation tank full of warm salt water. Pretty bleak. But it was science! (Lest you think him + criminal: until 1966, LSD was supplied by Sandoz Laboratories to any interested scientists, free of charge.) + + + *Drugs, dolphins and deprivation.* Which led to Lilly's foray into things meta. He wrote books on + mental programming, comparing humans and computers. You may choose to ingest any substance you want during + this next quote -- most likely you're reaching for the grain of salt -- but I assure you that there's + no Grateful Dead show on the lawn and no ravers in the basement. + + + bq. When one learns to learn, one is making models, using symbols, analogizing, making metaphors, in short, inventing and using language, mathematics, art, politics, business, etc. At the critical brain (cortex) size, languages and its consequences appear. To avoid the necessity of repeating learning to learn, symbols, metaphors, models each time, I symbolize the underlying idea in these operations as metaprogramming. + + + bq(attrib). John C. Lilly, _Programming and Metaprogramming in the Human Biocomputer_, New York, 1972. + + + We learn. But first we learn to learn. We setup programming in our mind which is the pathway to further + programming. (Lilly is largely talking about programming the brain and the nervous system, which he + collectively called the _biocomputer_.) + + + Lilly's metaprogramming was more about feeding yourself imagery, reinventing yourself, all that. + This sort of thinking links directly to folks out there who dabble in shamanism, wave their hands over tarot cards and + wake up early for karate class. I guess you could say metaprogramming is New Age, but it's all settled down + recently into a sleeping bag with plain old nerdiness. (If you got here from a Google search for "C++ Metaprogramming", + stick around, but I only ask that you _burn_ those neural pathways that originally invoked the search. Many thanks.) + + + Meta itself is spoken of no differently in your author's present day. + + + bq. All sensuous response to reality is an interpretation of + it. Beetles and monkeys clearly interpret their world, and act on the basis of what they see. + Our physical senses are themselves organs of interpretation. What distinguishes us from our fellow + animals is that we are able in turn to interpret these interpretations. In that sense, all human + language is meta-language. It is a second-order reflection on the 'language' of our bodies -- + of our sensory apparatus. + + + bq(attrib). Terry Eagleton, _After Theory_, London, 2003, ch. 3. + + + To that end, you could say programming itself is a meta-language. _All code_ speaks the language of action, + of a plan which hasn't been played yet, but shortly will. Stage directions for the players inside your + machine. I've waxed sentimental on this before. + + + But now we're advancing our study, venturing into metaprogramming, but don't sweat it, *it's still just the + Ruby you've seen already*, which is why Dwemthy feels no qualms thrusting it at you right away. Soon enough it will be + as easy to spot as addition or subtraction. At first it may seem intensely bright, like you've stumbled across your + first firefly, which has flown up in your face. Then, it becomes just _a little bobbing light_ which makes living + in Ohio so much nicer. + + lang-pt/poignant-66.yml lang-pt/poignant-67.yml @@ -1,122 +1,122 @@ - - > - Metaprogramming is _writing code which writes code_. But not as M.C. Escher would sketch it. *The program isn't reaching - back around and overwriting itself, nor is the program jumping onto your screen and wrenching the keyboard from your - hands.* No, it's much smaller than that. - - - Let's say it's more like *a little orange pill* you won at the circus. When you suck on it, the coating wears away and - behind your teeth hatches a massive, floppy sponge brontosaurus. He slides down your tongue and leaps free, frollicking - over the pastures, yelping, "Papa!" And from then on, whenever he freaks out and attacks a van, well, that van is _sparkling - clean_ afterwards. - - - Now, let's say _someone else_ puts *their little orange pill* under the faucet. Not on their tongue, _under the faucet_. And this triggers a different catalysm, which - births a set of wailing sponge sextuplets. *Umbilical cords and everything.* Still very handy for cleaning the van. - But an altogether different kind of chamois. And, one day, these eight will stir Papa to tears when they perform the - violin concerto of their lives. - - - Metaprogramming is packing code into pill-form, such that a slender drop of water could trigger it to expand. - More importantly, you can control the pill's reaction, so that a brontosaurus is produced, scaly and lumbering. - Or septulets, *CERTAINLY*. Or seamstresses. Or cat brains. Or dragons. - - - <pre> - class Dragon < Creature - life 1340 # tough scales - strength 451 # bristling veins - charisma 1020 # toothy smile - weapon 939 # fire breath - end - </pre> - - - This is not metaprogramming yet. Only the pill. The _product_ of metaprogramming. We are pausing, looking at - the beast itself before descending beneath its flesh with a scalpel and microscope. - - - The @Dragon@ is a class. You've seen that many times now. The @Dragon@ is a descendant of the @Creature@ class. - - - Now, eyes up. Look at me. The @Creature@ class contains the metaprogramming code. You can write metaprogramming - code which can be used _everywhere_, throughout Ruby, in @Creature@ or @Dragon@, in @String@ or in @Object@, anywhere. - Our example here, since this is the most common form of meta-code, focuses on metaprogramming inside your own - classes only. - - - Each of the @Dragon@'s traits are simply *class methods*. You could also write this as: - - - <pre> - class Dragon < Creature - life( 1340 ) # tough scales - strength( 451 ) # bristling veins - charisma( 1020 ) # toothy smile - weapon( 939 ) # fire breath - end - </pre> - - - Removing the parens removes clutter, so let's leave them out. Only use parens when you are using - several methods together and you want to be very clear. - - - h3. Creature Code - - - Now, with a lateral slice across the diaphragm, we expose the innards of @Creature@. *Save this - code into a file called @dwemthy.rb@.* - - - <pre> - # The guts of life force within Dwemthy's Array - class Creature - - # Get a metaclass for this class - def self.metaclass; class << self; self; end; end - - # Advanced metaprogramming code for nice, clean traits - def self.traits( *arr ) - return @traits if arr.empty? - - # 1. Set up accessors for each variable - attr_accessor *arr - - # 2. Add a new class method to for each trait. - arr.each do |a| - metaclass.instance_eval do - define_method( a ) do |val| - @traits ||= {} - @traits[a] = val - end - end - end - - # 3. For each monster, the `initialize' method - # should use the default number for each trait. - class_eval do - define_method( :initialize ) do - self.class.traits.each do |k,v| - instance_variable_set("@#{k}", v) - end - end - end - - end - - # Creature attributes are read-only - traits :life, :strength, :charisma, :weapon - end - </pre> - - - Focus on the closing lines of code, specifically the line where the @traits@ are - being set up. All of the code before that line sets up the @traits@ class - method. This bears resemblance to the basic lottery tickets from the chapter previous. - - - <pre> - class LotteryTicket - attr_reader :picks, :purchased - end - </pre> + - > + Metaprogramming is _writing code which writes code_. But not as M.C. Escher would sketch it. *The program isn't reaching + back around and overwriting itself, nor is the program jumping onto your screen and wrenching the keyboard from your + hands.* No, it's much smaller than that. + + + Let's say it's more like *a little orange pill* you won at the circus. When you suck on it, the coating wears away and + behind your teeth hatches a massive, floppy sponge brontosaurus. He slides down your tongue and leaps free, frollicking + over the pastures, yelping, "Papa!" And from then on, whenever he freaks out and attacks a van, well, that van is _sparkling + clean_ afterwards. + + + Now, let's say _someone else_ puts *their little orange pill* under the faucet. Not on their tongue, _under the faucet_. And this triggers a different catalysm, which + births a set of wailing sponge sextuplets. *Umbilical cords and everything.* Still very handy for cleaning the van. + But an altogether different kind of chamois. And, one day, these eight will stir Papa to tears when they perform the + violin concerto of their lives. + + + Metaprogramming is packing code into pill-form, such that a slender drop of water could trigger it to expand. + More importantly, you can control the pill's reaction, so that a brontosaurus is produced, scaly and lumbering. + Or septulets, *CERTAINLY*. Or seamstresses. Or cat brains. Or dragons. + + + <pre> + class Dragon < Creature + life 1340 # tough scales + strength 451 # bristling veins + charisma 1020 # toothy smile + weapon 939 # fire breath + end + </pre> + + + This is not metaprogramming yet. Only the pill. The _product_ of metaprogramming. We are pausing, looking at + the beast itself before descending beneath its flesh with a scalpel and microscope. + + + The @Dragon@ is a class. You've seen that many times now. The @Dragon@ is a descendant of the @Creature@ class. + + + Now, eyes up. Look at me. The @Creature@ class contains the metaprogramming code. You can write metaprogramming + code which can be used _everywhere_, throughout Ruby, in @Creature@ or @Dragon@, in @String@ or in @Object@, anywhere. + Our example here, since this is the most common form of meta-code, focuses on metaprogramming inside your own + classes only. + + + Each of the @Dragon@'s traits are simply *class methods*. You could also write this as: + + + <pre> + class Dragon < Creature + life( 1340 ) # tough scales + strength( 451 ) # bristling veins + charisma( 1020 ) # toothy smile + weapon( 939 ) # fire breath + end + </pre> + + + Removing the parens removes clutter, so let's leave them out. Only use parens when you are using + several methods together and you want to be very clear. + + + h3. Creature Code + + + Now, with a lateral slice across the diaphragm, we expose the innards of @Creature@. *Save this + code into a file called @dwemthy.rb@.* + + + <pre> + # The guts of life force within Dwemthy's Array + class Creature + + # Get a metaclass for this class + def self.metaclass; class << self; self; end; end + + # Advanced metaprogramming code for nice, clean traits + def self.traits( *arr ) + return @traits if arr.empty? + + # 1. Set up accessors for each variable + attr_accessor *arr + + # 2. Add a new class method to for each trait. + arr.each do |a| + metaclass.instance_eval do + define_method( a ) do |val| + @traits ||= {} + @traits[a] = val + end + end + end + + # 3. For each monster, the `initialize' method + # should use the default number for each trait. + class_eval do + define_method( :initialize ) do + self.class.traits.each do |k,v| + instance_variable_set("@#{k}", v) + end + end + end + + end + + # Creature attributes are read-only + traits :life, :strength, :charisma, :weapon + end + </pre> + + + Focus on the closing lines of code, specifically the line where the @traits@ are + being set up. All of the code before that line sets up the @traits@ class + method. This bears resemblance to the basic lottery tickets from the chapter previous. + + + <pre> + class LotteryTicket + attr_reader :picks, :purchased + end + </pre> lang-pt/poignant-68.yml @@ -1,131 +1,131 @@ - - - Both @traits@ and @attr_reader@ are simply class methods. When @attr_reader@ is used in the @LotteryTicket@, - metaprogramming kicks in behind the scenes and starts blowing up balloons, creating - *reader* methods for the instance variables @@picks@ and @@purchased@ above. - - - The code for the @traits@ method is the metaprogramming I've been alluding to. - Comments in the code reveal the three stages the method goes through when adding - traits. - - - # The *list of traits is passed on to @attr_accessor@*, which builds *reader* and - *writer* code for instance variables. One for each trait. - - # *Class methods are added* for each trait. (A @life@ class method is added for a @:life@ - trait.) These class methods are used - in the class definition just like you would use @traits@ or @attr_accessor@. This way, you can specify - the trait, along with the points given for a trait to a certain creature. - - # *Add an initialize method* which sets up a new monster properly, - grabbing the right points and _POWER UP! POWER UP!_ the monster is - alive! - - - The beauty of these three steps is that you've taught Ruby how to code - monsters for you. So when Ruby gets to the @traits@: - - - <pre> - class Creature - traits :life, :strength, :charisma, :weapon - end - </pre> - - - Ruby fills in the code behind the scenes and transplants a spiny green - heart and jumpstarts the body with a pullcord. - Ruby will use the metaprogramming from the @Creature@ class and build - out all the various methods, expanding the @traits@ list like this: - - - <pre> - class Creature - - # 1. set up reader and writer methods - attr_accessor :life, :strength, :charisma, :weapon - - # 2. add new class methods to use in creature - def self.life( val ) - @traits ||= {} - @traits['life'] = val - end - - def self.strength( val ) - @traits ||= {} - @traits['strength'] = val - end - - def self.charisma( val ) - @traits ||= {} - @traits['charisma'] = val - end - - def self.weapon( val ) - @traits ||= {} - @traits['weapon'] = val - end - - # 3. initialize sets the default points for - # each trait - def initialize - self.class.traits.each do |k,v| - instance_variable_set("@#{k}", v) - end - end - - end - </pre> - - - Now, Ruby will gladly accept this - six-line @Dragon@ code, short enough to look nice when printed on playing - cards: - - - <pre> - class Dragon < Creature - life 1340 # tough scales - strength 451 # bristling veins - charisma 1020 # toothy smile - weapon 939 # fire breath - end - </pre> - - - h3. Eval, the Littlest Metaprogrammer - - - While the metaprogramming code above is just plain Ruby, it can be difficult to follow still. - I totally understand if you've come to this point and your eyes are spinning in their sockets - and your knees have locked up. The trickiest parts of the above are the lines which call - the methods @instance_eval@ and @class_eval@. Just rub some tiger balm on your joints while - I talk about @eval@. - - - We've been talking about *metaprogramming*. Writing code which writes code. The @eval@ - method hangs out in this alley. - The vagrant @eval@ takes code you have stored up in a string and it executes that code. - - - <pre> - drgn = Dragon.new - # is identical to... - drgn = eval( "Dragon.new" ) - # or, alternatively... - eval( "drgn = Dragon.new" ) - </pre> - - - Here, let's write a program which has a hole in it. Instead of writing a program - which creates a new @Dragon@, let's leave a hole where the @Dragon@ would be. - - - <pre> - print "What monster class have you come to battle? " - monster_class = gets - eval( "monster = " + monster_class + ".new" ) - p monster - </pre> - + + + Both @traits@ and @attr_reader@ are simply class methods. When @attr_reader@ is used in the @LotteryTicket@, + metaprogramming kicks in behind the scenes and starts blowing up balloons, creating + *reader* methods for the instance variables @@picks@ and @@purchased@ above. + + + The code for the @traits@ method is the metaprogramming I've been alluding to. + Comments in the code reveal the three stages the method goes through when adding + traits. + + + # The *list of traits is passed on to @attr_accessor@*, which builds *reader* and + *writer* code for instance variables. One for each trait. + + # *Class methods are added* for each trait. (A @life@ class method is added for a @:life@ + trait.) These class methods are used + in the class definition just like you would use @traits@ or @attr_accessor@. This way, you can specify + the trait, along with the points given for a trait to a certain creature. + + # *Add an initialize method* which sets up a new monster properly, + grabbing the right points and _POWER UP! POWER UP!_ the monster is + alive! + + + The beauty of these three steps is that you've taught Ruby how to code + monsters for you. So when Ruby gets to the @traits@: + + + <pre> + class Creature + traits :life, :strength, :charisma, :weapon + end + </pre> + + + Ruby fills in the code behind the scenes and transplants a spiny green + heart and jumpstarts the body with a pullcord. + Ruby will use the metaprogramming from the @Creature@ class and build + out all the various methods, expanding the @traits@ list like this: + + + <pre> + class Creature + + # 1. set up reader and writer methods + attr_accessor :life, :strength, :charisma, :weapon + + # 2. add new class methods to use in creature + def self.life( val ) + @traits ||= {} + @traits['life'] = val + end + + def self.strength( val ) + @traits ||= {} + @traits['strength'] = val + end + + def self.charisma( val ) + @traits ||= {} + @traits['charisma'] = val + end + + def self.weapon( val ) + @traits ||= {} + @traits['weapon'] = val + end + + # 3. initialize sets the default points for + # each trait + def initialize + self.class.traits.each do |k,v| + instance_variable_set("@#{k}", v) + end + end + + end + </pre> + + + Now, Ruby will gladly accept this + six-line @Dragon@ code, short enough to look nice when printed on playing + cards: + + + <pre> + class Dragon < Creature + life 1340 # tough scales + strength 451 # bristling veins + charisma 1020 # toothy smile + weapon 939 # fire breath + end + </pre> + + + h3. Eval, the Littlest Metaprogrammer + + + While the metaprogramming code above is just plain Ruby, it can be difficult to follow still. + I totally understand if you've come to this point and your eyes are spinning in their sockets + and your knees have locked up. The trickiest parts of the above are the lines which call + the methods @instance_eval@ and @class_eval@. Just rub some tiger balm on your joints while + I talk about @eval@. + + + We've been talking about *metaprogramming*. Writing code which writes code. The @eval@ + method hangs out in this alley. + The vagrant @eval@ takes code you have stored up in a string and it executes that code. + + + <pre> + drgn = Dragon.new + # is identical to... + drgn = eval( "Dragon.new" ) + # or, alternatively... + eval( "drgn = Dragon.new" ) + </pre> + + + Here, let's write a program which has a hole in it. Instead of writing a program + which creates a new @Dragon@, let's leave a hole where the @Dragon@ would be. + + + <pre> + print "What monster class have you come to battle? " + monster_class = gets + eval( "monster = " + monster_class + ".new" ) + p monster + </pre> + lang-pt/poignant-68a.yml @@ -1,176 +1,176 @@ - The program asks for a monster. If you type in @Dragon@, then the @monster_class@ variable - will contain the string @"Dragon"@. Inside the @eval@, a few strings get added together - to make the string @"monster = Dragon.new"@. And when the @eval@ executes this string, - the @monster@ variable contains a @Dragon@ object. Ready for battle. - - - This is great! Now we can leave it up to the player to pick a monster! Of course, - we're trusting the player to supply a real monster class. If they type in @BotanicalWitch@ - and there is no @BotanicalWitch@ class, they'll get an exception tossed in their face. - - - So, in short, @eval@ lets you make up code as you go. Which can be useful and which can - be dangerous as well. - - - The @instance_eval@ and @class_eval@ method used in the metaprogramming for the @Creature@ - class are slightly different from the normal @eval@. These two special methods run code just like - @eval@ does, but they duck into classes and objects and run the code there. - - - <pre> - # The instance_eval method runs code as if it were run inside an - # object's instance method. - irb> drgn = Dragon.new - irb> drgn.instance_eval do - irb> @name = "Tobias" - irb> end - - irb> drgn.instance_variable_get( "@name" ) - => "Tobias" - - # The class_eval method runs code is if inside a class definition. - irb> Dragon.class_eval do - irb> def name; @name; end - irb> end - - irb> drgn.name - => "Tobias" - </pre> - - - As you can see above, the @instance_eval@ and @class_eval@ methods also can take a code block - instead of a string. Which is just how things are done in Dwemthy's Array. - - - h3. Enough Belittling Instruction and Sly Juxtaposition -- Where Is Dwemthy's Array?? - - - Tread carefully -- here is *the other half of DWEMTHY'S ARRAY!!* - *Add these lines to @dwemthy.rb@.* - - - <pre> - class Creature - - # This method applies a hit taken during a fight. - def hit( damage ) - p_up = rand( charisma ) - if p_up % 9 == 7 - @life += p_up / 4 - puts "[#{ self.class } magick powers up #{ p_up }!]" - end - @life -= damage - puts "[#{ self.class } has died.]" if @life <= 0 - end - - # This method takes one turn in a fight. - def fight( enemy, weapon ) - if life <= 0 - puts "[#{ self.class } is too dead to fight!]" - return - end - - # Attack the opponent - your_hit = rand( strength + weapon ) - puts "[You hit with #{ your_hit } points of damage!]" - enemy.hit( your_hit ) - - # Retaliation - p enemy - if enemy.life > 0 - enemy_hit = rand( enemy.strength + enemy.weapon ) - puts "[Your enemy hit with #{ enemy_hit } points of damage!]" - self.hit( enemy_hit ) - end - end - - end - - class DwemthysArray < Array - alias _inspect inspect - def inspect; "#<#{ self.class }#{ _inspect }>"; end - def method_missing( meth, *args ) - answer = first.send( meth, *args ) - if first.life <= 0 - shift - if empty? - puts "[Whoa. You decimated Dwemthy's Array!]" - else - puts "[Get ready. #{ first.class } has emerged.]" - end - end - answer || 0 - end - end - </pre> - - - This code adds two methods to @Creature@. The @hit@ method which reacts to a hit from another - @Creature@. And the @fight@ method which lets you place your own blows against that @Creature@. - - - When your @Creature@ takes a hit, a bit of defense kicks in and your @charisma@ value is used to generate a power-up. Don't - ask me to explain the secrets behind this phenomenon. A random number is picked, some simple math - is done, and, if you're lucky, you get a couple life points. @@life += p_up / 4@. - - - Then, the enemy's blow is landed. @@life -= damage@. That's how the @Creature#hit@ method works. - - - The @fight@ method checks to see if your @Creature@ is alive. Next, a random - hit is placed on your opponent. If your opponent lives through the hit, it gets - a chance to strike back. Those are the workings of the @Creature#fight@ method. - - - I'll explain @DwemthysArray@ in a second. I really will. I'm having fun doing it. - Let's stick with hitting and fighting for now. - - - h3. Introducing: You. - - - You may certainly tinker with derivations on this rabbit. But official - Dwemthy Paradigms explicitly denote the code -- and the altogether character -- inscribed - below. *Save this as @rabbit.rb@.* - - - <pre> - class Rabbit < Creature - traits :bombs - - life 10 - strength 2 - charisma 44 - weapon 4 - bombs 3 - - # little boomerang - def ^( enemy ) - fight( enemy, 13 ) - end - # the hero's sword is unlimited!! - def /( enemy ) - fight( enemy, rand( 4 + ( ( enemy.life % 10 ) ** 2 ) ) ) - end - # lettuce will build your strength and extra ruffage - # will fly in the face of your opponent!! - def %( enemy ) - lettuce = rand( charisma ) - puts "[Healthy lettuce gives you #{ lettuce } life points!!]" - @life += lettuce - fight( enemy, 0 ) - end - # bombs, but you only have three!! - def *( enemy ) - if @bombs.zero? - puts "[UHN!! You're out of bombs!!]" - return - end - @bombs -= 1 - fight( enemy, 86 ) - end - end - </pre> - - + The program asks for a monster. If you type in @Dragon@, then the @monster_class@ variable + will contain the string @"Dragon"@. Inside the @eval@, a few strings get added together + to make the string @"monster = Dragon.new"@. And when the @eval@ executes this string, + the @monster@ variable contains a @Dragon@ object. Ready for battle. + + + This is great! Now we can leave it up to the player to pick a monster! Of course, + we're trusting the player to supply a real monster class. If they type in @BotanicalWitch@ + and there is no @BotanicalWitch@ class, they'll get an exception tossed in their face. + + + So, in short, @eval@ lets you make up code as you go. Which can be useful and which can + be dangerous as well. + + + The @instance_eval@ and @class_eval@ method used in the metaprogramming for the @Creature@ + class are slightly different from the normal @eval@. These two special methods run code just like + @eval@ does, but they duck into classes and objects and run the code there. + + + <pre> + # The instance_eval method runs code as if it were run inside an + # object's instance method. + irb> drgn = Dragon.new + irb> drgn.instance_eval do + irb> @name = "Tobias" + irb> end + + irb> drgn.instance_variable_get( "@name" ) + => "Tobias" + + # The class_eval method runs code is if inside a class definition. + irb> Dragon.class_eval do + irb> def name; @name; end + irb> end + + irb> drgn.name + => "Tobias" + </pre> + + + As you can see above, the @instance_eval@ and @class_eval@ methods also can take a code block + instead of a string. Which is just how things are done in Dwemthy's Array. + + + h3. Enough Belittling Instruction and Sly Juxtaposition -- Where Is Dwemthy's Array?? + + + Tread carefully -- here is *the other half of DWEMTHY'S ARRAY!!* + *Add these lines to @dwemthy.rb@.* + + + <pre> + class Creature + + # This method applies a hit taken during a fight. + def hit( damage ) + p_up = rand( charisma ) + if p_up % 9 == 7 + @life += p_up / 4 + puts "[#{ self.class } magick powers up #{ p_up }!]" + end + @life -= damage + puts "[#{ self.class } has died.]" if @life <= 0 + end + + # This method takes one turn in a fight. + def fight( enemy, weapon ) + if life <= 0 + puts "[#{ self.class } is too dead to fight!]" + return + end + + # Attack the opponent + your_hit = rand( strength + weapon ) + puts "[You hit with #{ your_hit } points of damage!]" + enemy.hit( your_hit ) + + # Retaliation + p enemy + if enemy.life > 0 + enemy_hit = rand( enemy.strength + enemy.weapon ) + puts "[Your enemy hit with #{ enemy_hit } points of damage!]" + self.hit( enemy_hit ) + end + end + + end + + class DwemthysArray < Array + alias _inspect inspect + def inspect; "#<#{ self.class }#{ _inspect }>"; end + def method_missing( meth, *args ) + answer = first.send( meth, *args ) + if first.life <= 0 + shift + if empty? + puts "[Whoa. You decimated Dwemthy's Array!]" + else + puts "[Get ready. #{ first.class } has emerged.]" + end + end + answer || 0 + end + end + </pre> + + + This code adds two methods to @Creature@. The @hit@ method which reacts to a hit from another + @Creature@. And the @fight@ method which lets you place your own blows against that @Creature@. + + + When your @Creature@ takes a hit, a bit of defense kicks in and your @charisma@ value is used to generate a power-up. Don't + ask me to explain the secrets behind this phenomenon. A random number is picked, some simple math + is done, and, if you're lucky, you get a couple life points. @@life += p_up / 4@. + + + Then, the enemy's blow is landed. @@life -= damage@. That's how the @Creature#hit@ method works. + + + The @fight@ method checks to see if your @Creature@ is alive. Next, a random + hit is placed on your opponent. If your opponent lives through the hit, it gets + a chance to strike back. Those are the workings of the @Creature#fight@ method. + + + I'll explain @DwemthysArray@ in a second. I really will. I'm having fun doing it. + Let's stick with hitting and fighting for now. + + + h3. Introducing: You. + + + You may certainly tinker with derivations on this rabbit. But official + Dwemthy Paradigms explicitly denote the code -- and the altogether character -- inscribed + below. *Save this as @rabbit.rb@.* + + + <pre> + class Rabbit < Creature + traits :bombs + + life 10 + strength 2 + charisma 44 + weapon 4 + bombs 3 + + # little boomerang + def ^( enemy ) + fight( enemy, 13 ) + end + # the hero's sword is unlimited!! + def /( enemy ) + fight( enemy, rand( 4 + ( ( enemy.life % 10 ) ** 2 ) ) ) + end + # lettuce will build your strength and extra ruffage + # will fly in the face of your opponent!! + def %( enemy ) + lettuce = rand( charisma ) + puts "[Healthy lettuce gives you #{ lettuce } life points!!]" + @life += lettuce + fight( enemy, 0 ) + end + # bombs, but you only have three!! + def *( enemy ) + if @bombs.zero? + puts "[UHN!! You're out of bombs!!]" + return + end + @bombs -= 1 + fight( enemy, 86 ) + end + end + </pre> + + lang-pt/poignant-68b.yml @@ -1,74 +1,74 @@ - You have four weapons. The boomerang. The hero's sword. The lettuce. And the bombs. - - - To start off, open up @irb@ and load the libraries we've created above. - - - <pre> - irb> require 'dwemthy' - irb> require 'rabbit' - </pre> - - - Now, unroll yourself. - - - <pre> - irb> r = Rabbit.new - irb> r.life - => 10 - irb> r.strength - => 2 - </pre> - - - Good, good. - - - h3. Rabbit Fights ScubaArgentine! - - - You cannot just go rushing into Dwemthy's Array, unseatbelted and merely - perfumed!! You must advance deliberately through the demonic cotillion. Or south, - through the thickets and labyrinth of coal. - - - For now, let's lurk covertly through the milky residue alongside the aqueducts. And - sneak up on the @ScubaArgentine@. - - - <pre> - class ScubaArgentine < Creature - life 46 - strength 35 - charisma 91 - weapon 2 - end - </pre> - - - To get the fight started, make sure you've created one of you and one of the - @ScubaArgentine@. - - - <pre> - irb> r = Rabbit.new - irb> s = ScubaArgentine.new - </pre> - - - Now use the little boomerang! - - - <pre> - irb> r ^ s - [You hit with 2 points of damage!] - #<ScubaArgentine:0x808c864 @charisma=91, @strength=35, @life=44, @weapon=2> - [Your enemy hit with 28 points of damage!] - [Rabbit has died.] - </pre> - - - For crying out loud!! Our sample rabbit died!! - - + You have four weapons. The boomerang. The hero's sword. The lettuce. And the bombs. + + + To start off, open up @irb@ and load the libraries we've created above. + + + <pre> + irb> require 'dwemthy' + irb> require 'rabbit' + </pre> + + + Now, unroll yourself. + + + <pre> + irb> r = Rabbit.new + irb> r.life + => 10 + irb> r.strength + => 2 + </pre> + + + Good, good. + + + h3. Rabbit Fights ScubaArgentine! + + + You cannot just go rushing into Dwemthy's Array, unseatbelted and merely + perfumed!! You must advance deliberately through the demonic cotillion. Or south, + through the thickets and labyrinth of coal. + + + For now, let's lurk covertly through the milky residue alongside the aqueducts. And + sneak up on the @ScubaArgentine@. + + + <pre> + class ScubaArgentine < Creature + life 46 + strength 35 + charisma 91 + weapon 2 + end + </pre> + + + To get the fight started, make sure you've created one of you and one of the + @ScubaArgentine@. + + + <pre> + irb> r = Rabbit.new + irb> s = ScubaArgentine.new + </pre> + + + Now use the little boomerang! + + + <pre> + irb> r ^ s + [You hit with 2 points of damage!] + #<ScubaArgentine:0x808c864 @charisma=91, @strength=35, @life=44, @weapon=2> + [Your enemy hit with 28 points of damage!] + [Rabbit has died.] + </pre> + + + For crying out loud!! Our sample rabbit died!! + + lang-pt/poignant-68c.yml @@ -1,45 +1,45 @@ - - !^sidebar - The Shoes Which Lies Are Made Of: > - - _Earlier, I told you that "The Inadvertant Meteor" was the only story you need to know in order to - understand preeventualism. But, really, all you need to understand about preeventualism is that - it is still in its infancy and any of its most basic concepts could change._ - - - _Which is why I've authored a competing story which I believe uncovers an entirely different - and very relevant intellectual scenario._ - - - There was a guy who had been around the block. And he wasn't very old, so he decided to write - a biography of his life. - - - Well, he started to lie in his biography. He made up some stories. But mostly little stories - that were inconsequential. Filler. Like he had a story about a painting he'd done of a red - background with elephant legs in front. - - - But he hadn't ever painted anything of the sort. He further embellished the story by talking - about a pricey auction he'd snuck into. An auction in New York City where he'd he overheard his - painting go to sale for twenty grand. But that wasn't the point of the story. The point was - that he could fold his body to fit under a lid on a banquet tray. People would raise the lid and - they wouldn't even notice him bracing himself inside. He didn't even mention the price his painting - sold at. - - - Anyway, he really started to like that story (and others like it), to the point where he - started to ignore his friends and family, instead preferring to watch what his lie self did after the - auction. In his head. - - - So, then, one day he was shopping and he found a pair of shoes that had stripey laces. - And he grabbed the shoes and went to the store counter, forcing them in the cashier's - face, yelling, "Look! Look at these! Look! These are the shoes my lie self would - wear!" And he bought the shoes and put them on and the whole Earth cracked open and - the cash register popped open and swallowed him up and he was suddenly elsewhere, in his - lie apartment, sitting down to paint dolphin noses, three of them on a green background. - - - It was a lot of work, painting all those noses. And he went broke for a while and had - to stoop so low as to filming abominable snowman NASCAR. - + - !^sidebar + The Shoes Which Lies Are Made Of: > + + _Earlier, I told you that "The Inadvertant Meteor" was the only story you need to know in order to + understand preeventualism. But, really, all you need to understand about preeventualism is that + it is still in its infancy and any of its most basic concepts could change._ + + + _Which is why I've authored a competing story which I believe uncovers an entirely different + and very relevant intellectual scenario._ + + + There was a guy who had been around the block. And he wasn't very old, so he decided to write + a biography of his life. + + + Well, he started to lie in his biography. He made up some stories. But mostly little stories + that were inconsequential. Filler. Like he had a story about a painting he'd done of a red + background with elephant legs in front. + + + But he hadn't ever painted anything of the sort. He further embellished the story by talking + about a pricey auction he'd snuck into. An auction in New York City where he'd he overheard his + painting go to sale for twenty grand. But that wasn't the point of the story. The point was + that he could fold his body to fit under a lid on a banquet tray. People would raise the lid and + they wouldn't even notice him bracing himself inside. He didn't even mention the price his painting + sold at. + + + Anyway, he really started to like that story (and others like it), to the point where he + started to ignore his friends and family, instead preferring to watch what his lie self did after the + auction. In his head. + + + So, then, one day he was shopping and he found a pair of shoes that had stripey laces. + And he grabbed the shoes and went to the store counter, forcing them in the cashier's + face, yelling, "Look! Look at these! Look! These are the shoes my lie self would + wear!" And he bought the shoes and put them on and the whole Earth cracked open and + the cash register popped open and swallowed him up and he was suddenly elsewhere, in his + lie apartment, sitting down to paint dolphin noses, three of them on a green background. + + + It was a lot of work, painting all those noses. And he went broke for a while and had + to stoop so low as to filming abominable snowman NASCAR. + lang-pt/poignant-69.yml @@ -1,144 +1,144 @@ - - > - Grim prospects. I can't ask you to return to the rabbit kingdom, though. - Just pretend like you didn't die and make a whole new rabbit. - - - <pre> - irb> r = Rabbit.new - - # attacking with boomerang! - irb> r ^ s - - # the hero's sword slashes! - irb> r / s - - # eating lettuce gives you life! - irb> r % s - - # you have three bombs! - irb> r * s - </pre> - - - Pretty neat looking, wouldn't you say? The code in @rabbit.rb@ alters a few math symbols - which work only with the @Rabbit@. Ruby allows you to change the behavior of math operators. After all, - *math operators are just methods!* - - - <pre> - # the boomerang is normally an XOR operator. - irb> 1.^( 1 ) - => 0 - - # the hero's sword normally divides numbers. - irb> 10./( 2 ) - => 5 - - # the lettuce gives the remainder of a division. - irb> 10.%( 3 ) - => 1 - - # the bomb is for multiplication. - irb> 10.*( 3 ) - => 30 - </pre> - - - Where it makes sense, you may choose to use math operators on some of your Classes. Ruby - uses these math operators on many of its own classes. Arrays, for example, have a handful - of math operators which you can see in the list of instance methods when you type: @ri Array@. - - - <pre> - # the plus operator combines two arrays into a single array - irb> ["D", "W", "E"] + ["M", "T", "H", "Y"] - => ["D", "W", "E", "M", "T", "H", "Y"] - - # minus removes all items in the second array found in the first - irb> ["D", "W", "E", "M", "T", "H", "Y"] - ["W", "T"] - => ["D", "E", "M", "H", "Y"] - - # the multiplier repeats the elements of an array - irb> ["D", "W"] * 3 - => ["D", "W", "D", "W", "D", "W"] - </pre> - - - You may be wondering: what does this mean for math, though? What if I add the number three - to an array? What if I add a string and a number? *How is Ruby going to react?* - - - Please remember these operators are just methods. But, since these operators _aren't readable - words_, it can be harder to tell what they do. Use @ri@. Often you'll find that the operators - are identical to other readable methods. You can then choose to use the operator or the method. - Whichever is clearer to you. - - - <pre> - # divide with an operator method ... - irb> 10 / 3 - => 3 - - # ... or a readable method? - irb> 10.div 3 - => 3 - </pre> - - - And that's how the Rabbit's sword divides. - - - h3. The Harsh Realities of Dwemthy's Array AWAIT YOU TO MASH YOU!! - - - Once you're done playchoking the last guy with his oxygen tube, it's time - to enter The Array. I doubt you can do it. You left your hatchet at home. And - I hope you didn't use all your bombs on the easy guy. - - - You have six foes. - - - <pre> - class IndustrialRaverMonkey < Creature - life 46 - strength 35 - charisma 91 - weapon 2 - end - - class DwarvenAngel < Creature - life 540 - strength 6 - charisma 144 - weapon 50 - end - - class AssistantViceTentacleAndOmbudsman < Creature - life 320 - strength 6 - charisma 144 - weapon 50 - end - - class TeethDeer < Creature - life 655 - strength 192 - charisma 19 - weapon 109 - end - - class IntrepidDecomposedCyclist < Creature - life 901 - strength 560 - charisma 422 - weapon 105 - end - - class Dragon < Creature - life 1340 # tough scales - strength 451 # bristling veins - charisma 1020 # toothy smile - weapon 939 # fire breath - end + - > + Grim prospects. I can't ask you to return to the rabbit kingdom, though. + Just pretend like you didn't die and make a whole new rabbit. + + + <pre> + irb> r = Rabbit.new + + # attacking with boomerang! + irb> r ^ s + + # the hero's sword slashes! + irb> r / s + + # eating lettuce gives you life! + irb> r % s + + # you have three bombs! + irb> r * s + </pre> + + + Pretty neat looking, wouldn't you say? The code in @rabbit.rb@ alters a few math symbols + which work only with the @Rabbit@. Ruby allows you to change the behavior of math operators. After all, + *math operators are just methods!* + + + <pre> + # the boomerang is normally an XOR operator. + irb> 1.^( 1 ) + => 0 + + # the hero's sword normally divides numbers. + irb> 10./( 2 ) + => 5 + + # the lettuce gives the remainder of a division. + irb> 10.%( 3 ) + => 1 + + # the bomb is for multiplication. + irb> 10.*( 3 ) + => 30 + </pre> + + + Where it makes sense, you may choose to use math operators on some of your Classes. Ruby + uses these math operators on many of its own classes. Arrays, for example, have a handful + of math operators which you can see in the list of instance methods when you type: @ri Array@. + + + <pre> + # the plus operator combines two arrays into a single array + irb> ["D", "W", "E"] + ["M", "T", "H", "Y"] + => ["D", "W", "E", "M", "T", "H", "Y"] + + # minus removes all items in the second array found in the first + irb> ["D", "W", "E", "M", "T", "H", "Y"] - ["W", "T"] + => ["D", "E", "M", "H", "Y"] + + # the multiplier repeats the elements of an array + irb> ["D", "W"] * 3 + => ["D", "W", "D", "W", "D", "W"] + </pre> + + + You may be wondering: what does this mean for math, though? What if I add the number three + to an array? What if I add a string and a number? *How is Ruby going to react?* + + + Please remember these operators are just methods. But, since these operators _aren't readable + words_, it can be harder to tell what they do. Use @ri@. Often you'll find that the operators + are identical to other readable methods. You can then choose to use the operator or the method. + Whichever is clearer to you. + + + <pre> + # divide with an operator method ... + irb> 10 / 3 + => 3 + + # ... or a readable method? + irb> 10.div 3 + => 3 + </pre> + + + And that's how the Rabbit's sword divides. + + + h3. The Harsh Realities of Dwemthy's Array AWAIT YOU TO MASH YOU!! + + + Once you're done playchoking the last guy with his oxygen tube, it's time + to enter The Array. I doubt you can do it. You left your hatchet at home. And + I hope you didn't use all your bombs on the easy guy. + + + You have six foes. + + + <pre> + class IndustrialRaverMonkey < Creature + life 46 + strength 35 + charisma 91 + weapon 2 + end + + class DwarvenAngel < Creature + life 540 + strength 6 + charisma 144 + weapon 50 + end + + class AssistantViceTentacleAndOmbudsman < Creature + life 320 + strength 6 + charisma 144 + weapon 50 + end + + class TeethDeer < Creature + life 655 + strength 192 + charisma 19 + weapon 109 + end + + class IntrepidDecomposedCyclist < Creature + life 901 + strength 560 + charisma 422 + weapon 105 + end + + class Dragon < Creature + life 1340 # tough scales + strength 451 # bristling veins + charisma 1020 # toothy smile + weapon 939 # fire breath + end </pre> \ No newline at end of file lang-pt/poignant-70.yml @@ -1,109 +1,109 @@ - - - These are the living, breathing monstrosities of Dwemthy's Array. I don't - know how they got there. No one knows. Actually, I'm guessing the @IntrepidDecomposedCyclist@ - rode his ten-speed. But the others: NO ONE knows. - - - If it's really important for you to know, let's just say the others were born there. - Can we move on?? - - - As Dwemthy's Array gets deeper, the challenge becomes more difficult. - - - <pre> - dwary = DwemthysArray[IndustrialRaverMonkey.new, - DwarvenAngel.new, - AssistantViceTentacleAndOmbudsman.new, - TeethDeer.new, - IntrepidDecomposedCyclist.new, - Dragon.new] - </pre> - - - Fight the Array and the monsters will appear as you go. Godspeed - and may you return with harrowing tales and nary an angel talon piercing - through your shoulder. - - - Start here: - - - <pre> - irb> r % dwary - </pre> - - - Oh, and none of this "I'm too young to die" business. I'm sick of that crap. - I'm not going to have you insulting our undead young people. They are our future. - After our future is over, that is. - - - !i/wixl.dwemthy-3.gif(The rabbit has changed us.)! - - - h3. The Making of Dwemthy's Array - - - Fast forward to a time when the winds have calmed. - The dragon is vanquished. The unwashed masses bow. We love you. - We are loyal to you. - - - But what is this centipede nibbling in your eardrum? You dig with your finger, but you can't - get him out! Blasted! It's that infernal Dwemthy's Array again. *Explain yourself - Dwemthy!* - - - Here, I shall unmask the Array itself for you. - - - <pre> - class DwemthysArray < Array - alias _inspect inspect - def inspect; "#<#{ self.class }#{ inspect }>"; end - def method_missing( meth, *args ) - answer = first.send( meth, *args ) - if first.life <= 0 - shift - if empty? - puts "[Whoa. You decimated Dwemthy's Array!]" - else - puts "[Get ready. #{ first.class } has emerged.]" - end - end - answer || 0 - end - end - </pre> - - - By now, you're probably feeling very familiar with inheritance. The @DwemthysArray@ class - inherits from @Array@ and, thus, behaves just like one. For being such a mystery, it's - alarmingly brief, yeah? - - - So it's an Array. Filled with monsters. But what does this extra code do? - - - h3. Inspect - - - The @inspect@ method isn't really a necessary part of Dwemthy's Array. It's something - Dwemthy added as a courtesy to his guests. (Many call him twisted, many call him - austere, but we'd all be ignorant to go without admiring the footwork he puts in for us.) - - - Every object in Ruby has an @inspect@ method. It is defined in the @Object@ class, - so it trickles down through the pedigree to every wee child object just born. - - - <pre> - irb> o = Object.new - => #<Object:0x81d60c0> - irb> o.inspect - => "#<Object:0x81d60c0>" - </pre> - - + + + These are the living, breathing monstrosities of Dwemthy's Array. I don't + know how they got there. No one knows. Actually, I'm guessing the @IntrepidDecomposedCyclist@ + rode his ten-speed. But the others: NO ONE knows. + + + If it's really important for you to know, let's just say the others were born there. + Can we move on?? + + + As Dwemthy's Array gets deeper, the challenge becomes more difficult. + + + <pre> + dwary = DwemthysArray[IndustrialRaverMonkey.new, + DwarvenAngel.new, + AssistantViceTentacleAndOmbudsman.new, + TeethDeer.new, + IntrepidDecomposedCyclist.new, + Dragon.new] + </pre> + + + Fight the Array and the monsters will appear as you go. Godspeed + and may you return with harrowing tales and nary an angel talon piercing + through your shoulder. + + + Start here: + + + <pre> + irb> r % dwary + </pre> + + + Oh, and none of this "I'm too young to die" business. I'm sick of that crap. + I'm not going to have you insulting our undead young people. They are our future. + After our future is over, that is. + + + !i/wixl.dwemthy-3.gif(The rabbit has changed us.)! + + + h3. The Making of Dwemthy's Array + + + Fast forward to a time when the winds have calmed. + The dragon is vanquished. The unwashed masses bow. We love you. + We are loyal to you. + + + But what is this centipede nibbling in your eardrum? You dig with your finger, but you can't + get him out! Blasted! It's that infernal Dwemthy's Array again. *Explain yourself + Dwemthy!* + + + Here, I shall unmask the Array itself for you. + + + <pre> + class DwemthysArray < Array + alias _inspect inspect + def inspect; "#<#{ self.class }#{ inspect }>"; end + def method_missing( meth, *args ) + answer = first.send( meth, *args ) + if first.life <= 0 + shift + if empty? + puts "[Whoa. You decimated Dwemthy's Array!]" + else + puts "[Get ready. #{ first.class } has emerged.]" + end + end + answer || 0 + end + end + </pre> + + + By now, you're probably feeling very familiar with inheritance. The @DwemthysArray@ class + inherits from @Array@ and, thus, behaves just like one. For being such a mystery, it's + alarmingly brief, yeah? + + + So it's an Array. Filled with monsters. But what does this extra code do? + + + h3. Inspect + + + The @inspect@ method isn't really a necessary part of Dwemthy's Array. It's something + Dwemthy added as a courtesy to his guests. (Many call him twisted, many call him + austere, but we'd all be ignorant to go without admiring the footwork he puts in for us.) + + + Every object in Ruby has an @inspect@ method. It is defined in the @Object@ class, + so it trickles down through the pedigree to every wee child object just born. + + + <pre> + irb> o = Object.new + => #<Object:0x81d60c0> + irb> o.inspect + => "#<Object:0x81d60c0>" + </pre> + + lang-pt/poignant-70a.yml @@ -1,110 +1,110 @@ - Have you noticed this? Whenever we create an object in @irb@, this noisy @#<Object>@ - verbage stumbles out! It's a little name badge for the object. The @inspect@ - method creates that name badge. The badge is just a string. - - - <pre> - irb> class Rabbit - irb> attr_accessor :slogan - irb> def initialize s; @slogan = s; end - irb> def inspect; "#<#{ self.class } says '#{ @slogan }'>"; end - irb> end - - irb> class FakeRabbit < Rabbit - irb> end - - irb> Rabbit.new "i blow'd the drgn's face off!!" - => #<Rabbit says 'i blow'd the drgn's face off!!'> - irb> FakeRabbit.new "Thusly and thusly and thusly..." - => #<FakeRabbit says 'Thusly and thusly and thusly...'> - </pre> - - - The thing is: @irb@ is talking back. Every time you run some code in @irb@, - the _return value_ from that code is inspected. How handy. It's a little - conversation between you and @irb@. And @irb@ is just reiterating what you're - saying so you can see it for your self. - - - You could write your own Ruby prompt very easily: - - - <pre> - loop do - print ">> " - puts "=> " + eval( gets ).inspect - end - </pre> - - - This prompt won't let you write Ruby code longer than a single line. It's the essence - of interactive Ruby, though. How do you like that? Two of your recently learned concepts - have come together in a most flavorful way. The @eval@ takes the typed code and runs it. - The response from @eval@ is then inspected. - - - Now, as you are fighting monsters in @irb@, Dwemthy's Array will be inspected and - replying with the monsters you have left to fight. - - - !i/wixl-5.gif(The foxes eat out.)! - - - h3. Method Missing - - - Don't you hate it when you yell "Deirdre!" and like ten people answer? That _never_ happens in - Ruby. If you call the @deirdre@ method, only one @deirdre@ method answers. You can't have - two methods named the same. If you add a second @deirdre@ method, the first one disappears. - - - You can, however, have a method which *answers to many names*. - - - <pre> - class NameCaller - def method_missing( name, *args ) - puts "You're calling `" + name + "' and you say:" - args.each { |say| puts " " + say } - puts "But no one is there yet." - end - def deirdre( *args ) - puts "Deirdre is right here and you say:" - args.each { |say| puts " " + say } - puts "And she loves every second of it." - puts "(I think she thinks you're poetic.)" - end - </pre> - - - When you call the method @deirdre@ above, I'm sure you know what will happen. Deirdre will - love every second of it, you and your dazzling poetry. - - - But what if you call @simon@? - - - <pre> - irb> NameCaller.new.simon( 'Hello?', 'Hello? Simon?' ) - You're calling `simon' and you say: - Hello? - Hello? Simon? - But no one is there yet. - </pre> - - - Yes, @method_missing@ is like an answering machine, which intercepts your method call. In Dwemthy's - Array we use call forwarding, so that when you attack the Array, it passes that attack on straight to - the first monster in the Array. - - - <pre> - def method_missing( meth, *args ) - answer = first.send( meth, *args ) - # ... snipped code here ... - end - </pre> - - - See! See! That skinny little @method_missing@ passes the buck! - + Have you noticed this? Whenever we create an object in @irb@, this noisy @#<Object>@ + verbage stumbles out! It's a little name badge for the object. The @inspect@ + method creates that name badge. The badge is just a string. + + + <pre> + irb> class Rabbit + irb> attr_accessor :slogan + irb> def initialize s; @slogan = s; end + irb> def inspect; "#<#{ self.class } says '#{ @slogan }'>"; end + irb> end + + irb> class FakeRabbit < Rabbit + irb> end + + irb> Rabbit.new "i blow'd the drgn's face off!!" + => #<Rabbit says 'i blow'd the drgn's face off!!'> + irb> FakeRabbit.new "Thusly and thusly and thusly..." + => #<FakeRabbit says 'Thusly and thusly and thusly...'> + </pre> + + + The thing is: @irb@ is talking back. Every time you run some code in @irb@, + the _return value_ from that code is inspected. How handy. It's a little + conversation between you and @irb@. And @irb@ is just reiterating what you're + saying so you can see it for your self. + + + You could write your own Ruby prompt very easily: + + + <pre> + loop do + print ">> " + puts "=> " + eval( gets ).inspect + end + </pre> + + + This prompt won't let you write Ruby code longer than a single line. It's the essence + of interactive Ruby, though. How do you like that? Two of your recently learned concepts + have come together in a most flavorful way. The @eval@ takes the typed code and runs it. + The response from @eval@ is then inspected. + + + Now, as you are fighting monsters in @irb@, Dwemthy's Array will be inspected and + replying with the monsters you have left to fight. + + + !i/wixl-5.gif(The foxes eat out.)! + + + h3. Method Missing + + + Don't you hate it when you yell "Deirdre!" and like ten people answer? That _never_ happens in + Ruby. If you call the @deirdre@ method, only one @deirdre@ method answers. You can't have + two methods named the same. If you add a second @deirdre@ method, the first one disappears. + + + You can, however, have a method which *answers to many names*. + + + <pre> + class NameCaller + def method_missing( name, *args ) + puts "You're calling `" + name + "' and you say:" + args.each { |say| puts " " + say } + puts "But no one is there yet." + end + def deirdre( *args ) + puts "Deirdre is right here and you say:" + args.each { |say| puts " " + say } + puts "And she loves every second of it." + puts "(I think she thinks you're poetic.)" + end + </pre> + + + When you call the method @deirdre@ above, I'm sure you know what will happen. Deirdre will + love every second of it, you and your dazzling poetry. + + + But what if you call @simon@? + + + <pre> + irb> NameCaller.new.simon( 'Hello?', 'Hello? Simon?' ) + You're calling `simon' and you say: + Hello? + Hello? Simon? + But no one is there yet. + </pre> + + + Yes, @method_missing@ is like an answering machine, which intercepts your method call. In Dwemthy's + Array we use call forwarding, so that when you attack the Array, it passes that attack on straight to + the first monster in the Array. + + + <pre> + def method_missing( meth, *args ) + answer = first.send( meth, *args ) + # ... snipped code here ... + end + </pre> + + + See! See! That skinny little @method_missing@ passes the buck! + lang-pt/poignant-70b.yml @@ -1,4 +1,4 @@ - - "Então, Sejamos Claros: O Porco-Espinho Está Agora Para o Mar": > - - !i/porcupine-2.gif(O porco-espinho e sua pipa.)! - + - "Então, Sejamos Claros: O Porco-Espinho Está Agora Para o Mar": > + + !i/porcupine-2.gif(O porco-espinho e sua pipa.)! + lang-pt/poignant-71.yml @@ -1,111 +1,111 @@ - - Caminhando, Caminhando, Caminhando e Caminhando cada vez mais: > - - A tardinha escureceu ao redor do par de raposas. Elas fizeram seu caminha através das - vielas lotadas de gambás cantantes, e ruas onde girafas em casacos esportivos - passavam por elas batendo com suas maletas. Elas continuaram caminhando. - - - E agora as lojas fechavam desenrolando suas portas de metal. - Grilos cantavam das calhas e acotovelavam-se diante da relaxante mudança. - - - !i/wixl-6.gif(Porque tantos ressentimentos?)! - - - "De qualquer maneira, vocês devem admitir que ele é um péssimo Presidente," disse Raposa Pequena. _"Por quê_ o Presidente Marcos tem um coelho como Vice Presidente - das Raposas." - - - "O Vice Presidente? o coelho com as _sobrancelhas_?" - - - "Não, o coelho com os *enormes lábios de salsicha*," disse Raposa Pequena. - - - Mas sua conversa foi abruptamente interrompida por um gato sardento que surgiu do céu em cima da calçada. - - - !i/wixl.blix-1.gif(Pelo menos eles ainda estão no livro...)! - - - O que isto significa?! - - - !i/wixl-14.gif(O livro vai acabar?)! - - - Ah, qual é? Isto é interessante. Mais foco. - - - Eu não vou apurrinhar ilustrando esta discussão que Blixy teve com as raposas neste momento! - É tudo um punhado de _conjectura_*. _Como_ eles podem presumir que sabem o cenário do meu drama familiar? - Eu amo minha irmã. Por um longo tempo, eu a _adorei_. (Esta é minha irmã Quil.) - - - Eu admito que houve um dia realmente doloroso a alguns meses atrás e eu meio que me apavorei. Eu estava - deitado na cadeira de piscina no quintal da minha mãe. Eu tinha uma latinha de Dr.Pepper e um pedaço - de torta alemã de chocolate. Estava comendo com um garfinho de criança. Todo o resto estava na lava-louça, - isto era tudo que eles tinham. Três dentes. - - - Minha mãe começou a falar sobre Quil. Tudo sobre quanto dinheiro ela estava esbanjando em calças e bolsas. - Uma bolsa de quinhentos dólares. Então ela disse, "Ela está perdendo isto. - Ela parecia totalmente dopada no telefone." (Ela cismou com isto, Quil estava fumando maconha - e gostando.) - - - Então passei a notar o quão observadora minha mãe podia ser. Por isto que, quando ela disse, "Na verdade acho que ela está - na cocaína," Eu _físicamente_ levantei e arremessei meu refrigerante do outro lado do quintal. - - - Ele foi parar navegando entre os troncos em algum lugar. Nós ficamos conversando por um tempo, estava escuro quando a latinha vôou. - Eu marchei um pouco. Enão gritei a plenos pulmões. - - - Meu tio Mike estava parado com a porta de vidro aberta, me encarando. Ele disse algo totalmente - nervoso como, "Ah, ok. Bem, eu vou--" E o chá no seu copo estava balançando pra frente e pra trás, derramando - tudo. Ele desapareceu. Ele não é muito bom em falar coisas para as pessoas. Ele é mais um assoviador. E ressonante. - - - !i/wixl.blix-2.gif(Moving along.)! - - - Então, sendo completamente honesto, sim, eu fiquei um pouco bravo. Eu fiquei bravo. Você sabe. Eu lidei com isto. - Quil me liga regularmente. Por alguma razão estúpida, raramente ligo para ela. - - - E mais, ela não acabou se matando. Então isto não é assunto. Quem pode saber se isto era real. - Ela apenas tomou muita vodka. E ela é pequena. Então foi apenas assustador ver a Quil embebedar-se daquele jeito. - Quer dizer forçar-se a isto. - - - Mas por quê falar sobre isto? Isto fará apenas ela sentir que estou desapontado. Ou que sou um idiota. - - - Bem, saí um pouco da linha. Onde eu estava? Blix está basicamente ajudando as raposas, colocando-as na - trilha do seu caminhão. Sim voltando aquilo tudo. - - - !i/wixl-3.gif(Sapos que guardam acentos no ônibus.)! - - - "Não podemos nos apertar para ir neste ônibus" disse a raposa menor. - - - "Pessoal, subam," disse Blix. "O que está impedindo? Ah, os sapos. Sim, apenas se apertem." - Blixy empurrou por trás. - - - "Ei," disse a Raposa Alta. "Estou comprimida neste pequeno degrau! Alguém se mexa!" - - - "Você conseguiu-- jovem raposa??" disse o gato. - - - "Não," disse Raposa Pequena, "não pode ver? O motorista continua balançando a cabeça e isto _realmente_ - me deixa nervoso. Eu não acho que ele nos queira." - - - "Vai," disse Blix. Desceu do seu degrau e andou pelo ônibus, espreitando através das - janelas de acrílico. "Bem, eu não sei pessoal. Eu não sei. Eu acho que tem muitos sapos." Ele bateu - na janela. "Ei! Mexam-se!" + - Caminhando, Caminhando, Caminhando e Caminhando cada vez mais: > + + A tardinha escureceu ao redor do par de raposas. Elas fizeram seu caminha através das + vielas lotadas de gambás cantantes, e ruas onde girafas em casacos esportivos + passavam por elas batendo com suas maletas. Elas continuaram caminhando. + + + E agora as lojas fechavam desenrolando suas portas de metal. + Grilos cantavam das calhas e acotovelavam-se diante da relaxante mudança. + + + !i/wixl-6.gif(Porque tantos ressentimentos?)! + + + "De qualquer maneira, vocês devem admitir que ele é um péssimo Presidente," disse Raposa Pequena. _"Por quê_ o Presidente Marcos tem um coelho como Vice Presidente + das Raposas." + + + "O Vice Presidente? o coelho com as _sobrancelhas_?" + + + "Não, o coelho com os *enormes lábios de salsicha*," disse Raposa Pequena. + + + Mas sua conversa foi abruptamente interrompida por um gato sardento que surgiu do céu em cima da calçada. + + + !i/wixl.blix-1.gif(Pelo menos eles ainda estão no livro...)! + + + O que isto significa?! + + + !i/wixl-14.gif(O livro vai acabar?)! + + + Ah, qual é? Isto é interessante. Mais foco. + + + Eu não vou apurrinhar ilustrando esta discussão que Blixy teve com as raposas neste momento! + É tudo um punhado de _conjectura_*. _Como_ eles podem presumir que sabem o cenário do meu drama familiar? + Eu amo minha irmã. Por um longo tempo, eu a _adorei_. (Esta é minha irmã Quil.) + + + Eu admito que houve um dia realmente doloroso a alguns meses atrás e eu meio que me apavorei. Eu estava + deitado na cadeira de piscina no quintal da minha mãe. Eu tinha uma latinha de Dr.Pepper e um pedaço + de torta alemã de chocolate. Estava comendo com um garfinho de criança. Todo o resto estava na lava-louça, + isto era tudo que eles tinham. Três dentes. + + + Minha mãe começou a falar sobre Quil. Tudo sobre quanto dinheiro ela estava esbanjando em calças e bolsas. + Uma bolsa de quinhentos dólares. Então ela disse, "Ela está perdendo isto. + Ela parecia totalmente dopada no telefone." (Ela cismou com isto, Quil estava fumando maconha + e gostando.) + + + Então passei a notar o quão observadora minha mãe podia ser. Por isto que, quando ela disse, "Na verdade acho que ela está + na cocaína," Eu _físicamente_ levantei e arremessei meu refrigerante do outro lado do quintal. + + + Ele foi parar navegando entre os troncos em algum lugar. Nós ficamos conversando por um tempo, estava escuro quando a latinha vôou. + Eu marchei um pouco. Enão gritei a plenos pulmões. + + + Meu tio Mike estava parado com a porta de vidro aberta, me encarando. Ele disse algo totalmente + nervoso como, "Ah, ok. Bem, eu vou--" E o chá no seu copo estava balançando pra frente e pra trás, derramando + tudo. Ele desapareceu. Ele não é muito bom em falar coisas para as pessoas. Ele é mais um assoviador. E ressonante. + + + !i/wixl.blix-2.gif(Moving along.)! + + + Então, sendo completamente honesto, sim, eu fiquei um pouco bravo. Eu fiquei bravo. Você sabe. Eu lidei com isto. + Quil me liga regularmente. Por alguma razão estúpida, raramente ligo para ela. + + + E mais, ela não acabou se matando. Então isto não é assunto. Quem pode saber se isto era real. + Ela apenas tomou muita vodka. E ela é pequena. Então foi apenas assustador ver a Quil embebedar-se daquele jeito. + Quer dizer forçar-se a isto. + + + Mas por quê falar sobre isto? Isto fará apenas ela sentir que estou desapontado. Ou que sou um idiota. + + + Bem, saí um pouco da linha. Onde eu estava? Blix está basicamente ajudando as raposas, colocando-as na + trilha do seu caminhão. Sim voltando aquilo tudo. + + + !i/wixl-3.gif(Sapos que guardam acentos no ônibus.)! + + + "Não podemos nos apertar para ir neste ônibus" disse a raposa menor. + + + "Pessoal, subam," disse Blix. "O que está impedindo? Ah, os sapos. Sim, apenas se apertem." + Blixy empurrou por trás. + + + "Ei," disse a Raposa Alta. "Estou comprimida neste pequeno degrau! Alguém se mexa!" + + + "Você conseguiu-- jovem raposa??" disse o gato. + + + "Não," disse Raposa Pequena, "não pode ver? O motorista continua balançando a cabeça e isto _realmente_ + me deixa nervoso. Eu não acho que ele nos queira." + + + "Vai," disse Blix. Desceu do seu degrau e andou pelo ônibus, espreitando através das + janelas de acrílico. "Bem, eu não sei pessoal. Eu não sei. Eu acho que tem muitos sapos." Ele bateu + na janela. "Ei! Mexam-se!" lang-pt/poignant-72.yml @@ -1,111 +1,111 @@ - - - E esta é a realidade de andar no trânsito intermunicipal em Wixl. É terrivelmente competitivo. O ônibus - da manhã é tão cheio que a maioria dos animais de colarinho branco conseguem sapos para guardar seus lugares durante o período da noite. - Por qualquer razão, isto funciona. Se tornou mercadoria do fluxo de trabalho de sua economia. - - - Se você consegue reunir um pouco de imaginação, pode ver um *sinal de percentagem* como um rosto inclinado de um sapo. - Visualisou a figura em sua cabeça? Agora deixe-me mostrar os sapos que acampam em strings. - - - <pre> - # O formato %s serve para posicionar strings cheias. - irb> "Assentos são ocupados por %s e %s." % ['um sapo', 'um sapo com dentes'] - => "Assentos são ocupados por um sapo e um sapo com dentes." - - # O %d formato serve para colocar numeros, enquanto o formato %f serve para - # floats (números decimais). - irb> sapos = [44, 162.30] - irb> imediatamente = "Os sapos preencheram %d assentos e pagaram %f cristais azuis." - irb> imediatamente % sapos - => "Os sapos preencheram 44 assentos e pagaram 162.30 cristais azuis." - - # A formatação é flexivel com tipos, você pode transmitir em strings - # e formatá-los como números. - irb> sapos = ['44', '162.30'] - irb> imediatamente % sapos - => "Os sapos preencheram 44 assentos e pagaram 162.30 cristais azuis." - </pre> - - - O que você está vendo acima usa o método @%@ nas classes @String@. - Este método pega *um string* e *um array* e mastiga-os para criar - uma nova string. Os itens da lista são puxados (em ordem) e - colocados em seus lugares reservados. É o começo de um dia de negócios - e os sapos já fizeram seu trabalho. - - - <pre> - # Observe, aqui está o método String#% chamado como os outros métodos. - irb> "Mexa-se por favor, %s.".%( 'sapo desdentado' ) - => "Mexa-se por favor, sapo desdentado" - - # Agora vamos chamar da maneira mais bonita, com o sinal de porcentagem - # entre o string e o array. - irb> "Aqui está sua frase 1098 para o ano, %s." % ['sapo com dentes'] - => "Aqui está sua frase 1098 para o ano, sapo com dentes." - </pre> - - - Isto também está disponível como o método @Kernel::format@ ou o método @Kernel::sprintf@ - (Na linguagem C, tem um método @sprintf@ que opera assim.) - - - <pre> - irb> format "Sapos são empilhados %d de profundidade e viajam a %d mph.", [5, 56] - => "Sapos são empilhados 5 de profundidade e viajam a 56 mph." - </pre> - - - Para a maioria das partes, você precisará somente @%s@ (strings), @%d@ (números inteiros) - ou @%f@ (números float) especificadores de formato. O símbolo @%p@ irá - executar @inspect@ num objeto. - - - Sim, então, o formato sapo é realmente útil para construir strings que são - montados por diferentes tipos de dados. Você pode aprender todos os vários tipos - de especificadores de formatos lendo a pagina @ri sprintf@. Só te darei - alguns rápidos indicadores. - - - Vamos dizer que você tem um array mas quer que os itens apareçam em uma - *ordem diferente* na string. Numa situação como esta, você pode identificar - itens específicos (colocando @1$@ para o primeiro item, @2$@ para o segundo, - e assim por diante) depois do sinal de porcentagem. - - - <pre> - irb> "Este ônibus tem mais %1$d paradas antes das %2$d horas. Isto são mais %1$d paradas." % [16, 8] - => "Este ônibus tem mais 16 paradas antes das 8 horas. Isto são mais 16 paradas." - </pre> - - - A segunda dica que tenho para você é que pode destinar um certo numero de caracteres - para cada item, uma largura. E se um item é menor que a largura, espaços extras - serão usados antes do item. Para preenchê-lo. - Se a largura é um número negativo, o item será forçado para esquerda e o - preenchimento virá depois dele. - - - <pre> - # Dê a um item 30 caracters de largura - irb> "Na traseira do ônibus: %30s." % ['sapos'] - => "Na traseira do ônibus: sapos." - - # Dê a um item justificado a esquerda 30 caracteres de largura - irb> "Na parte da frente do ônibus: %-30s." % ['sapos'] - => "Na parte da frente do ônibus: sapos ." - </pre> - - - Raposa Pequena continuou olhando para o motorista do ônibus. Lembre-se, ele não entraria no ônibus! - - - "Qual o problema?" disse a Raposa Alta. "Você não pode entrar e ficamos no corredor?" - - - "Você realmente quer entrar neste ônibus? Aquele motorista não tem mãos," disse Raposa Pequena, falando perto - de maneira a aquietar Raposa Alta, "e tudo o que ele tem, ao invés de mãos, são copos com canudos." - - + + + E esta é a realidade de andar no trânsito intermunicipal em Wixl. É terrivelmente competitivo. O ônibus + da manhã é tão cheio que a maioria dos animais de colarinho branco conseguem sapos para guardar seus lugares durante o período da noite. + Por qualquer razão, isto funciona. Se tornou mercadoria do fluxo de trabalho de sua economia. + + + Se você consegue reunir um pouco de imaginação, pode ver um *sinal de percentagem* como um rosto inclinado de um sapo. + Visualisou a figura em sua cabeça? Agora deixe-me mostrar os sapos que acampam em strings. + + + <pre> + # O formato %s serve para posicionar strings cheias. + irb> "Assentos são ocupados por %s e %s." % ['um sapo', 'um sapo com dentes'] + => "Assentos são ocupados por um sapo e um sapo com dentes." + + # O %d formato serve para colocar numeros, enquanto o formato %f serve para + # floats (números decimais). + irb> sapos = [44, 162.30] + irb> imediatamente = "Os sapos preencheram %d assentos e pagaram %f cristais azuis." + irb> imediatamente % sapos + => "Os sapos preencheram 44 assentos e pagaram 162.30 cristais azuis." + + # A formatação é flexivel com tipos, você pode transmitir em strings + # e formatá-los como números. + irb> sapos = ['44', '162.30'] + irb> imediatamente % sapos + => "Os sapos preencheram 44 assentos e pagaram 162.30 cristais azuis." + </pre> + + + O que você está vendo acima usa o método @%@ nas classes @String@. + Este método pega *um string* e *um array* e mastiga-os para criar + uma nova string. Os itens da lista são puxados (em ordem) e + colocados em seus lugares reservados. É o começo de um dia de negócios + e os sapos já fizeram seu trabalho. + + + <pre> + # Observe, aqui está o método String#% chamado como os outros métodos. + irb> "Mexa-se por favor, %s.".%( 'sapo desdentado' ) + => "Mexa-se por favor, sapo desdentado" + + # Agora vamos chamar da maneira mais bonita, com o sinal de porcentagem + # entre o string e o array. + irb> "Aqui está sua frase 1098 para o ano, %s." % ['sapo com dentes'] + => "Aqui está sua frase 1098 para o ano, sapo com dentes." + </pre> + + + Isto também está disponível como o método @Kernel::format@ ou o método @Kernel::sprintf@ + (Na linguagem C, tem um método @sprintf@ que opera assim.) + + + <pre> + irb> format "Sapos são empilhados %d de profundidade e viajam a %d mph.", [5, 56] + => "Sapos são empilhados 5 de profundidade e viajam a 56 mph." + </pre> + + + Para a maioria das partes, você precisará somente @%s@ (strings), @%d@ (números inteiros) + ou @%f@ (números float) especificadores de formato. O símbolo @%p@ irá + executar @inspect@ num objeto. + + + Sim, então, o formato sapo é realmente útil para construir strings que são + montados por diferentes tipos de dados. Você pode aprender todos os vários tipos + de especificadores de formatos lendo a pagina @ri sprintf@. Só te darei + alguns rápidos indicadores. + + + Vamos dizer que você tem um array mas quer que os itens apareçam em uma + *ordem diferente* na string. Numa situação como esta, você pode identificar + itens específicos (colocando @1$@ para o primeiro item, @2$@ para o segundo, + e assim por diante) depois do sinal de porcentagem. + + + <pre> + irb> "Este ônibus tem mais %1$d paradas antes das %2$d horas. Isto são mais %1$d paradas." % [16, 8] + => "Este ônibus tem mais 16 paradas antes das 8 horas. Isto são mais 16 paradas." + </pre> + + + A segunda dica que tenho para você é que pode destinar um certo numero de caracteres + para cada item, uma largura. E se um item é menor que a largura, espaços extras + serão usados antes do item. Para preenchê-lo. + Se a largura é um número negativo, o item será forçado para esquerda e o + preenchimento virá depois dele. + + + <pre> + # Dê a um item 30 caracters de largura + irb> "Na traseira do ônibus: %30s." % ['sapos'] + => "Na traseira do ônibus: sapos." + + # Dê a um item justificado a esquerda 30 caracteres de largura + irb> "Na parte da frente do ônibus: %-30s." % ['sapos'] + => "Na parte da frente do ônibus: sapos ." + </pre> + + + Raposa Pequena continuou olhando para o motorista do ônibus. Lembre-se, ele não entraria no ônibus! + + + "Qual o problema?" disse a Raposa Alta. "Você não pode entrar e ficamos no corredor?" + + + "Você realmente quer entrar neste ônibus? Aquele motorista não tem mãos," disse Raposa Pequena, falando perto + de maneira a aquietar Raposa Alta, "e tudo o que ele tem, ao invés de mãos, são copos com canudos." + + lang-pt/poignant-72a.yml @@ -1,52 +1,52 @@ - - !^sidebar - More From The Chilling Ongoing Preview of The Scarf Eaters: > - - (_from Chapter XII: Thank Heaven for Little Men_.) - - - "Close the door," Spencer repeated, but Lara's hand trembled and she fumbled sloppily at the latch. - Her dad hadn't taught her to close doors like this one. - - - "Yes, it's an unusual door," said Brent. He walked over and closed the door for her. - Then, he held her hand and looked into her eyes. His eyes lit up like huge matchsticks - that would be too huge to be practical. "It's an unusual handle, which ensures that - those who don't eat scarves stay out." - - - "Sit down, everyone," Spencer demanded, as he bounded across the room and took command. - "I command this organization," he stated. "The secret organization of The Scarf Eaters!" - - - The torches encircling the room blazed like invincibly huge matches and the handful of - teenagers sat. Except for Spencer who stood high and mighty, drawing all the oxygen - in the entire room into his nostrils before speaking. - - - "One of us," he said, dramatically and invincibly, "is missing!" - - - The entire room gasped, which also used oxygen. The room was abuzz. "Who?" "How?" - "Who was it?" Nobody knew. Except for Spencer, who lept across the room and took charge. - - - "Our dear friend Steve Bridell has been stolen from us," announced Spencer in a deafeningly - loud voice, as if thousands of giant matchsticks were struck against a brittle surface in - unison amidst a pile of oxygen. "Steve Bridell. Do any of you know Steve Bridell?" - - - The hall was silent. - - - Spencer continued. "Steve Bridell was an incredible resource and you all knew him - and loved him. He carved this enormous wooden man we use as our podium." Spencer pointed. - "He also made the set of wooden cymbals that are back in our instrument closet right now." - - - Some of the audience stood. - - - "Wait," instructed Spencer. "Don't go back there. I've already checked. The cymbals are - gone!" - - + - !^sidebar + More From The Chilling Ongoing Preview of The Scarf Eaters: > + + (_from Chapter XII: Thank Heaven for Little Men_.) + + + "Close the door," Spencer repeated, but Lara's hand trembled and she fumbled sloppily at the latch. + Her dad hadn't taught her to close doors like this one. + + + "Yes, it's an unusual door," said Brent. He walked over and closed the door for her. + Then, he held her hand and looked into her eyes. His eyes lit up like huge matchsticks + that would be too huge to be practical. "It's an unusual handle, which ensures that + those who don't eat scarves stay out." + + + "Sit down, everyone," Spencer demanded, as he bounded across the room and took command. + "I command this organization," he stated. "The secret organization of The Scarf Eaters!" + + + The torches encircling the room blazed like invincibly huge matches and the handful of + teenagers sat. Except for Spencer who stood high and mighty, drawing all the oxygen + in the entire room into his nostrils before speaking. + + + "One of us," he said, dramatically and invincibly, "is missing!" + + + The entire room gasped, which also used oxygen. The room was abuzz. "Who?" "How?" + "Who was it?" Nobody knew. Except for Spencer, who lept across the room and took charge. + + + "Our dear friend Steve Bridell has been stolen from us," announced Spencer in a deafeningly + loud voice, as if thousands of giant matchsticks were struck against a brittle surface in + unison amidst a pile of oxygen. "Steve Bridell. Do any of you know Steve Bridell?" + + + The hall was silent. + + + Spencer continued. "Steve Bridell was an incredible resource and you all knew him + and loved him. He carved this enormous wooden man we use as our podium." Spencer pointed. + "He also made the set of wooden cymbals that are back in our instrument closet right now." + + + Some of the audience stood. + + + "Wait," instructed Spencer. "Don't go back there. I've already checked. The cymbals are + gone!" + + lang-pt/poignant-73.yml @@ -1,110 +1,110 @@ - - > - "So what? You don't think animals with tentacles can drive?" - - - "Well, not only is he going to flub up the steering wheel but he has all these - legs all over the foot pedals. This is not smart. Let's get another bus. Come on." - - - "You know, he's probably been driving like that all day. Is he really going to - start crashing at this point in his career?" - - - "Buses do crash," said Fox Small. "Some do. This smells crashworthy." - - - "Sheer doo-doo!" And Fox Tall yelled to the driver, "Hey, cabby, how long - have you been driving this bus for?" - - - The bus driver peered over darkly under his cap and started to turn toward them, but his - tentacles were stuck to the wheel. He jerked swiftly at his forelegs and, failing their - release, he turned to the wheel and focused his energies on milking his glands for some - slicker secretions. Bubbles of mucus oozed. - - - "Let's get outta here," said Fox Tall and the two ran off into the street, slamming right - into the cat Blix. - - - "Alright, well, the bus is full," said Blix. "I don't know why the driver stopped if he knew the - bus was crammed with hoppers." - - - "We're thinking he was about to crash into us," said Fox Tall, "and he opened the - door to make it look like a planned route stop." - - - "Keep in mind, Blix, we hadn't really discussed that possibility out loud, so I haven't had a chance - to formally agree," said Fox Small. "Nevertheless, it sounds rational to me." - - - "I'm thinking all the buses are going to be full like this." Blix bit his lip, - thinking and flicking his eyes about. "Let's just--" He pointed down the circuitry - of apartment buildings that wound to the south. "But maybe--" He looked up and surveyed the stars, - scratching his head and counting the constellations with very small poking motions - from the tip of his finger. - - - "Are you getting our bearings from the stars and planets?" asked Fox Small. - - - Blix didn't speak, he ducked off to the north through a poorly laid avenue - back behind the paint store. - But before we follow them down that service road, Smotchkkiss, I have one more - frog for you, perched on a long lilypad that stretches out to hold anything at all. - - - <pre> - irb> cat = "Blix" - irb> puts "Does #{ cat } see what's up? Is #{ cat } aware??" - => "Does Blix see what's up? Is Blix aware??" - </pre> - - - The little frogs from earlier (@%s@ or @%d@) were only placeholders for - single strings. Saving places in the string. - - - The lilypads above start with a flower bud, the *octothorpe*. You've also - seen it as a pound sign on telephones. After the flower bud, two leaves - form the edges of the lilypad. The leaves are *curly braces*, also seen many - times before as the _crab pincers_ for a code block. - - - bq. An empty lilypad @"#{}"@ becomes an empty string @""@. - - - When the lilypad is found in a *double-quoted* string, Ruby runs any code found in between - the two leaves of the lilypad. The lilypad is lifted out and the result of the code is placed there in - the string. This lilypad swap is called _string interpolation_. - - - <pre> - irb> fellows = ['Blix', 'Fox Tall', 'Fox Small'] - irb> puts "Let us follow #{ fellows.join ' and ' } on their journey." - => "Let us follow Blix and Fox Tall and Fox Small on their journey." - </pre> - - - The lilypad is very durable and can hold any kind of code inside. Above - we are using @Array#join@, but you can do anything you like inside. Call - object methods, conditional @if@ or @case@ statements, even define classes. - - - <pre> - irb> blix_went = :north - irb> puts "Blix didn't speak, he ducked off to the #{ blix_went } through #{ - if blix_went == :north - 'a poorly laid avenue behind the paint store' - elsif blix_went == :south - 'the circuitry of apartment buildings' - else - '... well, who knows where he went.' - end }. But before we follow them..." - => "Blix didn't speak, he ducked off to the north through a poorly laid avenue - behind the paint store. But before we follow them..." - </pre> - - - + - > + "So what? You don't think animals with tentacles can drive?" + + + "Well, not only is he going to flub up the steering wheel but he has all these + legs all over the foot pedals. This is not smart. Let's get another bus. Come on." + + + "You know, he's probably been driving like that all day. Is he really going to + start crashing at this point in his career?" + + + "Buses do crash," said Fox Small. "Some do. This smells crashworthy." + + + "Sheer doo-doo!" And Fox Tall yelled to the driver, "Hey, cabby, how long + have you been driving this bus for?" + + + The bus driver peered over darkly under his cap and started to turn toward them, but his + tentacles were stuck to the wheel. He jerked swiftly at his forelegs and, failing their + release, he turned to the wheel and focused his energies on milking his glands for some + slicker secretions. Bubbles of mucus oozed. + + + "Let's get outta here," said Fox Tall and the two ran off into the street, slamming right + into the cat Blix. + + + "Alright, well, the bus is full," said Blix. "I don't know why the driver stopped if he knew the + bus was crammed with hoppers." + + + "We're thinking he was about to crash into us," said Fox Tall, "and he opened the + door to make it look like a planned route stop." + + + "Keep in mind, Blix, we hadn't really discussed that possibility out loud, so I haven't had a chance + to formally agree," said Fox Small. "Nevertheless, it sounds rational to me." + + + "I'm thinking all the buses are going to be full like this." Blix bit his lip, + thinking and flicking his eyes about. "Let's just--" He pointed down the circuitry + of apartment buildings that wound to the south. "But maybe--" He looked up and surveyed the stars, + scratching his head and counting the constellations with very small poking motions + from the tip of his finger. + + + "Are you getting our bearings from the stars and planets?" asked Fox Small. + + + Blix didn't speak, he ducked off to the north through a poorly laid avenue + back behind the paint store. + But before we follow them down that service road, Smotchkkiss, I have one more + frog for you, perched on a long lilypad that stretches out to hold anything at all. + + + <pre> + irb> cat = "Blix" + irb> puts "Does #{ cat } see what's up? Is #{ cat } aware??" + => "Does Blix see what's up? Is Blix aware??" + </pre> + + + The little frogs from earlier (@%s@ or @%d@) were only placeholders for + single strings. Saving places in the string. + + + The lilypads above start with a flower bud, the *octothorpe*. You've also + seen it as a pound sign on telephones. After the flower bud, two leaves + form the edges of the lilypad. The leaves are *curly braces*, also seen many + times before as the _crab pincers_ for a code block. + + + bq. An empty lilypad @"#{}"@ becomes an empty string @""@. + + + When the lilypad is found in a *double-quoted* string, Ruby runs any code found in between + the two leaves of the lilypad. The lilypad is lifted out and the result of the code is placed there in + the string. This lilypad swap is called _string interpolation_. + + + <pre> + irb> fellows = ['Blix', 'Fox Tall', 'Fox Small'] + irb> puts "Let us follow #{ fellows.join ' and ' } on their journey." + => "Let us follow Blix and Fox Tall and Fox Small on their journey." + </pre> + + + The lilypad is very durable and can hold any kind of code inside. Above + we are using @Array#join@, but you can do anything you like inside. Call + object methods, conditional @if@ or @case@ statements, even define classes. + + + <pre> + irb> blix_went = :north + irb> puts "Blix didn't speak, he ducked off to the #{ blix_went } through #{ + if blix_went == :north + 'a poorly laid avenue behind the paint store' + elsif blix_went == :south + 'the circuitry of apartment buildings' + else + '... well, who knows where he went.' + end }. But before we follow them..." + => "Blix didn't speak, he ducked off to the north through a poorly laid avenue + behind the paint store. But before we follow them..." + </pre> + + + lang-pt/poignant-74.yml @@ -1,112 +1,112 @@ - - - The foxes followed Blixy off behind the paint store and down the cracked, uneven asphalt. - All of the stores on the dilapidated lane leaned at angles to each other. In some places, - slabs of sidewalk jutted up from the ground, forming a perilous walkway, a disorderly - stack of ledges. Almost as if the city planners had hoped to pay tribute to the techtonic - plates. One small drug store had slid below the surface, nearly out of eyesight. - - - Truly, it was colorful, though. The paint store had been tossing out old paints - directly onto its neighbors. The shops nearest the paint store were clogged with hundreds - of colors, along the windowsills and in the rain gutters. Yes, on the walls and pavement. - - - Basically, beginning with the back porch of the paint store, the avenue erupted into a giant incongruous - and poorly-dyed market. - - - Further down, a dentist's office was primed with red paint and, over that, a fledgling artist - had depicted a large baby who had fallen through a chimney and arrived in a fireplace full of soot. - Crude black strokes marked the cloud of ashes raised during impact, easily mistaken for thick - hair on the child's arms and back. The child looked far too young to have much hair, but - there they were: rich, blonde curls which toppled liberally from the child's head. Under the child's - legs was painted the word _BREWSTER_. - - - The same artist had hit the library next store and had hastily slapped together a mural of - a green sports car being pulled from the mud by a team of legless babies tugging with shiny chains. - Again, the drastically blonde curls! - - - "I need answers," said the Fox Tall, who had ground to a halt in front of the scenery. - - - "I'm starting to believe there's no such thing," said Fox Small. "Maybe these are the - answers." - - - "Brewster?" said Fox Tall. He walked nearer to the library and touched the cheek of one - of the legless children who was closer in perspective. The child's cheek appeared to - contain a myriad of jawbones. - - - Blix was another two houses down, navigating through the askew brickwork, the paved gully that - led to _R.K.'s Gorilla Mint_, as the metallic sticker on the door read. The building was plastered - with miniature logos for the variety of payment options and identification acceptable at - _R.K.'s Gorilla Mint_. Even the bars over the window were lined with insurance disclosures and - security warnings and seals of government authorization, as well as addendums to all of these, - carbon paper covering stickers covering torn posters and advertising. And all mingled with - paint splashes that intruded wherever they pleased. - - - !i/wixl-9.gif(R.K.'s Gorilla Mint.)! - - - "I like the way the fresh paper feels against my tongue," said the gorilla at the counter. - His fingers rubbed quietly against the bills. He drew his face near to the fanned currency - and whisked his nose along the pulpy cash. - - - "Is R.K. in this evening?" asked Blix. - - - "R.K. is not," said the gorilla cashier. He turned to the three travellers and spread - his money out on the counter's surface, evenly spacing them apart and lining up all the - edges neatly. "Now, which one of these do you think is worth the most?" - - - The foxes looked over the different bills and Fox Small muttered to himself, "Well, - maybe-- no, but I'll bet-- Wait, does one of these have bananas on it? 'Cause that - one-- nope, no fruit or rope swings or-- Terrible, this is difficult!" And in a - lower voice, "So difficult to read. What does this one say? Symbols or something? - If all these bills have are symbols, it's going to be impossible for us to figure out - which one is of the greatest value." - - - "That's why I said, '_Guess_.'" The gorilla tapped each bill in order. "See, you've - got a 1 in 5 chance." - - - "Unless the symbols mean something," said Fox Tall. "Unless we can figure it out." - - - "We can figure it out," said Fox Small. - - - "No," said the gorilla. "The symbols are meaningless." - - - "Whoever created the money intended some meaning for them," said Fox Small. "Why - use _this_ symbol?" He pointed to an ampersand printed in dark ink. - - - "Yeah, we saw you sniffing the money and fantasizing about it back there," said - Fox Tall. "I'll bet these symbols mean all kinds of things to you!" - - - "No, I don't think so," said the gorilla. - - - If I can weigh in at this point, I think the symbols do have meaning. They may not - be _loaded_ with meaning, it may not be oozing out through the cracks, but I'm sure - there's a sliver of meaning. - - - <pre> - irb> $: - => ["/usr/lib/ruby/site_ruby/1.8", "/usr/lib/ruby/site_ruby/1.8/i686-linux", "/usr/lib/ruby/site_ruby", - "/usr/lib/ruby/1.8", "/usr/lib/ruby/1.8/i686-linux", "."] - </pre> - - + + + The foxes followed Blixy off behind the paint store and down the cracked, uneven asphalt. + All of the stores on the dilapidated lane leaned at angles to each other. In some places, + slabs of sidewalk jutted up from the ground, forming a perilous walkway, a disorderly + stack of ledges. Almost as if the city planners had hoped to pay tribute to the techtonic + plates. One small drug store had slid below the surface, nearly out of eyesight. + + + Truly, it was colorful, though. The paint store had been tossing out old paints + directly onto its neighbors. The shops nearest the paint store were clogged with hundreds + of colors, along the windowsills and in the rain gutters. Yes, on the walls and pavement. + + + Basically, beginning with the back porch of the paint store, the avenue erupted into a giant incongruous + and poorly-dyed market. + + + Further down, a dentist's office was primed with red paint and, over that, a fledgling artist + had depicted a large baby who had fallen through a chimney and arrived in a fireplace full of soot. + Crude black strokes marked the cloud of ashes raised during impact, easily mistaken for thick + hair on the child's arms and back. The child looked far too young to have much hair, but + there they were: rich, blonde curls which toppled liberally from the child's head. Under the child's + legs was painted the word _BREWSTER_. + + + The same artist had hit the library next store and had hastily slapped together a mural of + a green sports car being pulled from the mud by a team of legless babies tugging with shiny chains. + Again, the drastically blonde curls! + + + "I need answers," said the Fox Tall, who had ground to a halt in front of the scenery. + + + "I'm starting to believe there's no such thing," said Fox Small. "Maybe these are the + answers." + + + "Brewster?" said Fox Tall. He walked nearer to the library and touched the cheek of one + of the legless children who was closer in perspective. The child's cheek appeared to + contain a myriad of jawbones. + + + Blix was another two houses down, navigating through the askew brickwork, the paved gully that + led to _R.K.'s Gorilla Mint_, as the metallic sticker on the door read. The building was plastered + with miniature logos for the variety of payment options and identification acceptable at + _R.K.'s Gorilla Mint_. Even the bars over the window were lined with insurance disclosures and + security warnings and seals of government authorization, as well as addendums to all of these, + carbon paper covering stickers covering torn posters and advertising. And all mingled with + paint splashes that intruded wherever they pleased. + + + !i/wixl-9.gif(R.K.'s Gorilla Mint.)! + + + "I like the way the fresh paper feels against my tongue," said the gorilla at the counter. + His fingers rubbed quietly against the bills. He drew his face near to the fanned currency + and whisked his nose along the pulpy cash. + + + "Is R.K. in this evening?" asked Blix. + + + "R.K. is not," said the gorilla cashier. He turned to the three travellers and spread + his money out on the counter's surface, evenly spacing them apart and lining up all the + edges neatly. "Now, which one of these do you think is worth the most?" + + + The foxes looked over the different bills and Fox Small muttered to himself, "Well, + maybe-- no, but I'll bet-- Wait, does one of these have bananas on it? 'Cause that + one-- nope, no fruit or rope swings or-- Terrible, this is difficult!" And in a + lower voice, "So difficult to read. What does this one say? Symbols or something? + If all these bills have are symbols, it's going to be impossible for us to figure out + which one is of the greatest value." + + + "That's why I said, '_Guess_.'" The gorilla tapped each bill in order. "See, you've + got a 1 in 5 chance." + + + "Unless the symbols mean something," said Fox Tall. "Unless we can figure it out." + + + "We can figure it out," said Fox Small. + + + "No," said the gorilla. "The symbols are meaningless." + + + "Whoever created the money intended some meaning for them," said Fox Small. "Why + use _this_ symbol?" He pointed to an ampersand printed in dark ink. + + + "Yeah, we saw you sniffing the money and fantasizing about it back there," said + Fox Tall. "I'll bet these symbols mean all kinds of things to you!" + + + "No, I don't think so," said the gorilla. + + + If I can weigh in at this point, I think the symbols do have meaning. They may not + be _loaded_ with meaning, it may not be oozing out through the cracks, but I'm sure + there's a sliver of meaning. + + + <pre> + irb> $: + => ["/usr/lib/ruby/site_ruby/1.8", "/usr/lib/ruby/site_ruby/1.8/i686-linux", "/usr/lib/ruby/site_ruby", + "/usr/lib/ruby/1.8", "/usr/lib/ruby/1.8/i686-linux", "."] + </pre> + + lang-pt/poignant-74a.yml @@ -1,123 +1,123 @@ - Variables which start with the American cash sign are global variables. They can - be seen from anywhere in the program, *from inside any scope*. (Dr. Cham used this - variable while snooping around The Originals' computer bay.) - - - So why does the *cash sign followed by a colon* represent an array of *all directories - where Ruby will search when you try to load a file with @require@*? The cash sign - means "global." But why the colon? - - - Historically, on many operating systems, a list of directories contains colons which - separated each entry. I like to see the colon as a pair of eyes, scanning the directories - for files. We store our lookout list behind the eyes. - - - Here's a few more special global variables: - - - <pre> - irb> $" # The $" variable contains all files which have been loaded with `require' - => ["irb.rb", "e2mmap.rb", "irb/init.rb", ... "rbconfig.rb"] - # These files are stored somewhere else, but their code is being used - # in this program. Much like quoting someone else's work -- these are the - # footnotes -- hence the double-quote. - - irb> $0 # The $0 variable contains the running program's filename. - => "irb" # A zero can be considered the beginning of a number count. - # This variable answers the question, "Where did this program begin?" - - irb> $* # The $* variable contains all the arguments passed into a program. - => ['--prompt', 'simple'] - # This one is easy to remember, if you remember that Ruby methods - # also use the asterisk to capture arguments into an array. - - # The $! contains the current exception raised. - # The exclamation indicates a state of alarm. An exception! - irb> begin - irb> raise TypeError, "I don't believe this information." - irb> rescue - irb> p $! - irb> end - => #<TypeError: I don't believe this information.> - - # The $@ contains the current backtrace, if an exception was raised. - # The backtrace shows were Ruby was _at_ when the exception fired. - irb> begin - irb> raise TypeError, "I don't believe this information." - irb> rescue - irb> p $@ - irb> end - => ["(irb):25:in `irb_binding'", "/usr/lib/ruby/1.8/irb/workspace.rb:52:in `irb_binding'", - "/usr/lib/ruby/1.8/irb/workspace.rb:52"] - </pre> - - - "I don't remember you." Blix looked at the gorilla with great interest. - "Are you one of R.K.'s kids or something?" - - - "Oh, come on!" said Fox Small, holding up a bill with an exclamation mark on it up to the gorilla's nose. - "Don't tell me this means _nothing_ to you! This one is probably _really important_ - since it has an exclamation on it. Maybe it pays for emergency stuff! Hospital - bills or something!" - - - *"Yeah, surgery!"* said Fox Tall. - - - The gorilla looked at the foxes with disgust from under the brim of his cap. "No, - you're wrong. You can't pay for surgeries with that." - - - "But you see our point," said the small fox. He grabbed some of the other bills. - "And you say this bill _cannot_ pay for surgeries? Well that sounds like it has - a specific _non-surgery-related_ purpose. Now, the question mark one. Oh, what would that one be for?" - - - "Hey, give me those," the gorilla snatched at the bills over the counter, but - his long thumb kept getting in the way and every time he thought he had grabbed bills, - it turned out he had only grabbed his long thumb. - - - "Hey, hey, look, he's mad," said Fox Tall, happily clapping. "I wonder why. Did you notice - how mad he started getting once we mentioned all these interesting meanings? *We're on to - you! We figured out your game so fast!"* - - - "We totally did!" said Fox Small, one of his elbows caught in the grip of the gorilla, - the other arm waving a bill that featured an underscore. - "This one's for buying floor supplies, maybe even big rolls of tile and linoleum." - - - "See," said Fox Tall, working to pry the gorilla's fingers free, "we just have to figure out which is more expensive: - surgery or linoleum! This is _so easy!"_ - - - *"NO IT'S NOT!"* yelled the gorilla, yanking at the smaller fox and battering the - fox with his palms. *"YOU DON'T KNOW ANYTHING ABOUT MONKEY MONEY!! YOU DON'T EVEN _HAVE_ - YOUR OWN KINDS OF MONEY!!"* - - - "We could _easily_ have our own kinds of money!" said Fox Tall, taking the chimp's - hat and tossing it to the back of the room, where it sailed behind a wall of safety - deposit boxes. "And -- _your hat is outta here!_" - - - "Come on, give him back his bills," said Blix, waving his arms helplessly from the - sidelines. "We could really use this guy's help." - - - "Stop hitting me!" screamed the littlest fox. "I've almost figured out this one - with the dots on it!!" - - - Suddenly, with great precision and without warning, Fox Tall grabbed the monkey's nose - and slammed his face down against the counter. The pens and inkpads on its surface - rattled and "Bam!" said the fox. The gorilla's eyes spun sleepily - as his arms... then his neck... then his head slithered to the floor behind the counter. - - - Here are a few more global variables you might care to use: - - + Variables which start with the American cash sign are global variables. They can + be seen from anywhere in the program, *from inside any scope*. (Dr. Cham used this + variable while snooping around The Originals' computer bay.) + + + So why does the *cash sign followed by a colon* represent an array of *all directories + where Ruby will search when you try to load a file with @require@*? The cash sign + means "global." But why the colon? + + + Historically, on many operating systems, a list of directories contains colons which + separated each entry. I like to see the colon as a pair of eyes, scanning the directories + for files. We store our lookout list behind the eyes. + + + Here's a few more special global variables: + + + <pre> + irb> $" # The $" variable contains all files which have been loaded with `require' + => ["irb.rb", "e2mmap.rb", "irb/init.rb", ... "rbconfig.rb"] + # These files are stored somewhere else, but their code is being used + # in this program. Much like quoting someone else's work -- these are the + # footnotes -- hence the double-quote. + + irb> $0 # The $0 variable contains the running program's filename. + => "irb" # A zero can be considered the beginning of a number count. + # This variable answers the question, "Where did this program begin?" + + irb> $* # The $* variable contains all the arguments passed into a program. + => ['--prompt', 'simple'] + # This one is easy to remember, if you remember that Ruby methods + # also use the asterisk to capture arguments into an array. + + # The $! contains the current exception raised. + # The exclamation indicates a state of alarm. An exception! + irb> begin + irb> raise TypeError, "I don't believe this information." + irb> rescue + irb> p $! + irb> end + => #<TypeError: I don't believe this information.> + + # The $@ contains the current backtrace, if an exception was raised. + # The backtrace shows were Ruby was _at_ when the exception fired. + irb> begin + irb> raise TypeError, "I don't believe this information." + irb> rescue + irb> p $@ + irb> end + => ["(irb):25:in `irb_binding'", "/usr/lib/ruby/1.8/irb/workspace.rb:52:in `irb_binding'", + "/usr/lib/ruby/1.8/irb/workspace.rb:52"] + </pre> + + + "I don't remember you." Blix looked at the gorilla with great interest. + "Are you one of R.K.'s kids or something?" + + + "Oh, come on!" said Fox Small, holding up a bill with an exclamation mark on it up to the gorilla's nose. + "Don't tell me this means _nothing_ to you! This one is probably _really important_ + since it has an exclamation on it. Maybe it pays for emergency stuff! Hospital + bills or something!" + + + *"Yeah, surgery!"* said Fox Tall. + + + The gorilla looked at the foxes with disgust from under the brim of his cap. "No, + you're wrong. You can't pay for surgeries with that." + + + "But you see our point," said the small fox. He grabbed some of the other bills. + "And you say this bill _cannot_ pay for surgeries? Well that sounds like it has + a specific _non-surgery-related_ purpose. Now, the question mark one. Oh, what would that one be for?" + + + "Hey, give me those," the gorilla snatched at the bills over the counter, but + his long thumb kept getting in the way and every time he thought he had grabbed bills, + it turned out he had only grabbed his long thumb. + + + "Hey, hey, look, he's mad," said Fox Tall, happily clapping. "I wonder why. Did you notice + how mad he started getting once we mentioned all these interesting meanings? *We're on to + you! We figured out your game so fast!"* + + + "We totally did!" said Fox Small, one of his elbows caught in the grip of the gorilla, + the other arm waving a bill that featured an underscore. + "This one's for buying floor supplies, maybe even big rolls of tile and linoleum." + + + "See," said Fox Tall, working to pry the gorilla's fingers free, "we just have to figure out which is more expensive: + surgery or linoleum! This is _so easy!"_ + + + *"NO IT'S NOT!"* yelled the gorilla, yanking at the smaller fox and battering the + fox with his palms. *"YOU DON'T KNOW ANYTHING ABOUT MONKEY MONEY!! YOU DON'T EVEN _HAVE_ + YOUR OWN KINDS OF MONEY!!"* + + + "We could _easily_ have our own kinds of money!" said Fox Tall, taking the chimp's + hat and tossing it to the back of the room, where it sailed behind a wall of safety + deposit boxes. "And -- _your hat is outta here!_" + + + "Come on, give him back his bills," said Blix, waving his arms helplessly from the + sidelines. "We could really use this guy's help." + + + "Stop hitting me!" screamed the littlest fox. "I've almost figured out this one + with the dots on it!!" + + + Suddenly, with great precision and without warning, Fox Tall grabbed the monkey's nose + and slammed his face down against the counter. The pens and inkpads on its surface + rattled and "Bam!" said the fox. The gorilla's eyes spun sleepily + as his arms... then his neck... then his head slithered to the floor behind the counter. + + + Here are a few more global variables you might care to use: + + lang-pt/poignant-74b.yml @@ -1,127 +1,127 @@ - <pre> - irb> $/ # The $/ is the line separator, it is normally set to \n, which represents _Enter_ - => "\n" # or "end of line". The slash represents a sword slashing lines in a file. - - # The line separator controls how methods like each_line or readlines breaks up strings. - irb> "Jeff,Jerry,Jill\nMichael,Mary,Myrtle".each_line { |names| p names } - => "Jeff,Jerry,Jill\n" - => "Michael,Mary,Myrtle" - - # If you change the line separator, you change how many methods work, such as each_line. - # See what happens when I change the line separator to a comma. - irb> $/ = ',' - irb> "Jeff,Jerry,Jill\nMichael,Mary,Myrtle".each_line { |names| p names } - => "Jeff," - => "Jerry," - => "Jill\nMichael," - => "Mary," - => "Myrtle" - - irb> $, # The $, variable is the join separator, used when joining strings with - => nil # Array#join or Kernel::print. The comma is a common join character. - - # The join separator is normally empty. - irb> ['candle', 'soup', 'mackarel'].join - => "candlesoupmackarel" - irb> $, = ' * '; ['candle', 'soup', 'mackarel'].join - => "candle * soup * mackarel" - - # But, usually, you won't need the global variable. - irb> ['candle', 'soup', 'mackarel'].join ' # ' - => "candle # soup # mackarel" - - irb> $; # The $; variable is the split separator, used when splitting strings - => nil # with String#split. - - # The split separator is normally empty, which means String#split will separate - # the string where there is whitespace. - irb> "candle soup\nmackarel".split - => ["candle", "soup", "mackarel"] - irb> $; = 'a'; "candle soup\nmackarel".split - => ["c", "ndle soup\nm", "ck", "rel"] - - # But, usually, you won't need the global variable. - irb> "candle # soup # mackarel".split ' # ' - => ['candle', 'soup', 'mackarel'] - </pre> - - - Outside the _Gorilla Mint_, Blix scolded the foxes. "We could have used that guy's help! If he knows - where R.K. is, we could use his cunning!" - - - "*We don't need that ape's money!*" said Fox Small. "*We can make our _own_ money!*" - - - "*We could support electronic wristbands!*" said Fox Tall. - - - "His money is worthless," said Blix. "It's gorilla money. It has no value. It's worse than - blue crystals." - - - "But it serves a purpose," said Fox Tall. - - - "No it doesn't," said Fox Small. "He just said it's worthless." - - - "But what about linoleum and surgeries?" said Fox Tall. - - - "Yeah," said Fox Small, up at Blix. "What about linoleum and surgeries?" - - - "If all the hospitals were staffed by gorillas and all the home improvement chains were strictly operated - by gorillas, then -- YES -- you could buy linoleum and surgeries. But I _guarantee_ that you would have - very sloppy linoleum and very hideous surgeries. I don't think you'd make it out of that economy alive." - - - "So, if R.K. is so cunning," said Fox Tall, grinning slyly, "why does he print such worthless currency?" - - - "It's a cover for other activities," said Blix. "Besides, if you're so smart, why did you resort to - violently pounding that poor gorilla?" - - - "I guess that was a bad play," said Fox Tall, hanging his head. "My friend here will tell you that I've - been on edge all day." - - - "And your rage finally reared its fuming snout!" said Fox Small. "You're finally living up to your - goatee." - - - !i/wixl-10.gif! - - - Down the lanes they travelled, the two foxes oblivious to their direction, but having a good time - now that they had Blix leading the way with such urgency. They lapsed into a careless wandering right behind Blix - and spent their afternoon heckling most of the passersby. - - - One such target of their ongoing commentary was The Winged Scroll Carriers, pairs of bats that carry - documents which need to be immediately sworn and notarized. There can be no delay, they must go swift, - there is not even time to roll up the scroll, no, they must drop their swiss cheese and be out the door. - - - These couriers resemble a kind of Ruby construct called *delimited types*. A long series of characters - comprises the scroll, flanked on each side by a bat bracing its curly wings to hold the scroll together. - The opening bat wears a hat on which is written @%w@, which identifies the scroll as a set of words. - - - <pre> - irb> bats = %w{The Winged Scroll Carriers} - => ['The', 'Winged', 'Scroll', 'Carriers'] - </pre> - - - The @%w@ bats and their scroll, when fed into Ruby, emerge as an array of words. This syntax is a shortcut - in case you don't want to go through the trouble of decorating each word with commas and quotes. You are - in a hurry, too, there can be no delay. You jot out the words between the bats and let Ruby figure out where - to cut. - - - Other bats, other hats. For instance, the @%x@ hat runs an external program. - - + <pre> + irb> $/ # The $/ is the line separator, it is normally set to \n, which represents _Enter_ + => "\n" # or "end of line". The slash represents a sword slashing lines in a file. + + # The line separator controls how methods like each_line or readlines breaks up strings. + irb> "Jeff,Jerry,Jill\nMichael,Mary,Myrtle".each_line { |names| p names } + => "Jeff,Jerry,Jill\n" + => "Michael,Mary,Myrtle" + + # If you change the line separator, you change how many methods work, such as each_line. + # See what happens when I change the line separator to a comma. + irb> $/ = ',' + irb> "Jeff,Jerry,Jill\nMichael,Mary,Myrtle".each_line { |names| p names } + => "Jeff," + => "Jerry," + => "Jill\nMichael," + => "Mary," + => "Myrtle" + + irb> $, # The $, variable is the join separator, used when joining strings with + => nil # Array#join or Kernel::print. The comma is a common join character. + + # The join separator is normally empty. + irb> ['candle', 'soup', 'mackarel'].join + => "candlesoupmackarel" + irb> $, = ' * '; ['candle', 'soup', 'mackarel'].join + => "candle * soup * mackarel" + + # But, usually, you won't need the global variable. + irb> ['candle', 'soup', 'mackarel'].join ' # ' + => "candle # soup # mackarel" + + irb> $; # The $; variable is the split separator, used when splitting strings + => nil # with String#split. + + # The split separator is normally empty, which means String#split will separate + # the string where there is whitespace. + irb> "candle soup\nmackarel".split + => ["candle", "soup", "mackarel"] + irb> $; = 'a'; "candle soup\nmackarel".split + => ["c", "ndle soup\nm", "ck", "rel"] + + # But, usually, you won't need the global variable. + irb> "candle # soup # mackarel".split ' # ' + => ['candle', 'soup', 'mackarel'] + </pre> + + + Outside the _Gorilla Mint_, Blix scolded the foxes. "We could have used that guy's help! If he knows + where R.K. is, we could use his cunning!" + + + "*We don't need that ape's money!*" said Fox Small. "*We can make our _own_ money!*" + + + "*We could support electronic wristbands!*" said Fox Tall. + + + "His money is worthless," said Blix. "It's gorilla money. It has no value. It's worse than + blue crystals." + + + "But it serves a purpose," said Fox Tall. + + + "No it doesn't," said Fox Small. "He just said it's worthless." + + + "But what about linoleum and surgeries?" said Fox Tall. + + + "Yeah," said Fox Small, up at Blix. "What about linoleum and surgeries?" + + + "If all the hospitals were staffed by gorillas and all the home improvement chains were strictly operated + by gorillas, then -- YES -- you could buy linoleum and surgeries. But I _guarantee_ that you would have + very sloppy linoleum and very hideous surgeries. I don't think you'd make it out of that economy alive." + + + "So, if R.K. is so cunning," said Fox Tall, grinning slyly, "why does he print such worthless currency?" + + + "It's a cover for other activities," said Blix. "Besides, if you're so smart, why did you resort to + violently pounding that poor gorilla?" + + + "I guess that was a bad play," said Fox Tall, hanging his head. "My friend here will tell you that I've + been on edge all day." + + + "And your rage finally reared its fuming snout!" said Fox Small. "You're finally living up to your + goatee." + + + !i/wixl-10.gif! + + + Down the lanes they travelled, the two foxes oblivious to their direction, but having a good time + now that they had Blix leading the way with such urgency. They lapsed into a careless wandering right behind Blix + and spent their afternoon heckling most of the passersby. + + + One such target of their ongoing commentary was The Winged Scroll Carriers, pairs of bats that carry + documents which need to be immediately sworn and notarized. There can be no delay, they must go swift, + there is not even time to roll up the scroll, no, they must drop their swiss cheese and be out the door. + + + These couriers resemble a kind of Ruby construct called *delimited types*. A long series of characters + comprises the scroll, flanked on each side by a bat bracing its curly wings to hold the scroll together. + The opening bat wears a hat on which is written @%w@, which identifies the scroll as a set of words. + + + <pre> + irb> bats = %w{The Winged Scroll Carriers} + => ['The', 'Winged', 'Scroll', 'Carriers'] + </pre> + + + The @%w@ bats and their scroll, when fed into Ruby, emerge as an array of words. This syntax is a shortcut + in case you don't want to go through the trouble of decorating each word with commas and quotes. You are + in a hurry, too, there can be no delay. You jot out the words between the bats and let Ruby figure out where + to cut. + + + Other bats, other hats. For instance, the @%x@ hat runs an external program. + + lang-pt/poignant-74c.yml @@ -1,126 +1,126 @@ - <pre> - irb> %w{ruby --help} - => ["ruby", "--help"] - irb> %x{ruby --help} - => "Usage: ruby [switches] [--] [programfile] [arguments] ..." - </pre> - - - My favorite is the @%Q@ hat, which can also be written as just @%@. This acts just like a double-quoted string, - but looks nice when used with strings that run-on for many lines. Like, say you're adding a new method with @eval@. - - - <pre> - m = "bats!" - eval %{ - def #{ m } - puts "{" * 100 - end - } - </pre> - - - Just like a double-quoted string, you can use the string interpolation lilypads inside. - - - !i/wixl-15.png(Cloneberries: The More You Eat, The More *You*.)! - - - Blixy wagged his head. "Oh, dear me." - - - "Egads! My hand is pregnant," said Fox Tall, watching the little fox embryo slide about in his palm. - - - "They are good berries, though," said Blix. "The wine they make from these berries - will make ya grow a few eyeballs in your teeth. But no more than that." - - - "Ah, pain!" yelled Fox Small, as his miniature squeezed out through the pores in his scalp. But soon he - was cradling his little self and murmuring lullablies. _Nevermore, nevermore, sweetly sang the - nightingale. Winking starlight, sleeping still, whilst perched on a Sycamore stump._ - - - Making duplicates of Ruby objects is no more than a berry's worth of code. - - - <pre> - irb> tree = [:berry, :berry, :berry] - => [:berry, :berry, :berry] - irb> treechild = tree.clone - => [:berry, :berry, :berry] - </pre> - - - The @clone@ method makes an exact copy of a Ruby object. How does this differ from regular - assignment? - - - <pre> - irb> tree_charles_william_iii = tree - => [:berry, :berry, :berry] - </pre> - - - Assigning object to variables only creates more nicknames. The above Array can be called @tree_charles_william_iii@ - now. Or the shorter @tree@. The same object, but different names. - - - However, a clone is a copy of an object. You can modify it without affecting the original. - - - <pre> - irb> treechild << 'flower' - => [:berry, :berry, :berry, 'flower'] - irb> tree - => [:berry, :berry, :berry] - </pre> - - - The @clone@ method doesn't make copies of everything attached to the object, though. In the array above, only the - array is copied, not all the symbols and strings inside. - - - You may also see the @dup@ method used to copy objects. The @dup@ method makes copies which aren't as exact. For example, - there are objects in Ruby which are "frozen" and can't be altered. If you @clone@ the object, you get an exact copy which - is also frozen. If you use @dup@, you get an unfrozen copy that you can change if you like. - - - The @clone@ method also copies the metaclass of an object, whereas @dup@ does not. - - - <pre> - irb> o = Object.new - irb> class << o - irb> def nevermore; :nevermore; end - irb> end - - irb> o.clone.nevermore - => :nevermore - irb> o.dup.nevermore - # NoMethodError: undefined method `nevermore' for #<Object:0xb7d4a484> - # from (irb):7 - </pre> - - - You don't always need to make copies of objects, though, since many methods like @collect@ and @gsub@ - and @format@ make copies for you as part of their work. - - - !i/wixl-4.gif(Deer of the Smoky Pink Puffing.)! - - - Over the hills and down the valleys, they ran through the grass where the Deer of the Smoky Pink - Puffing roam. The sun was obscured by the lumbering pink clouds, emblazened with deer language, - tinting the horizon a gradient of grapefruit and secreting a glow over the meadow. The clouds - slid past each other, some bobbing upwards, destined for Canadian relatives. Others landing a - readable distance from a recipient's hooves. - - - "Let's stop! _Please!_" yelled Fox Tall. "You can't expect us to run in this *unbreathable fluff!*" - - - "Why are you yelling?" said Blix, as a thin stratus telegram wafted behind his legs. "You don't - need to raise your voice above a whisper. These long skinny clouds are usually just a mumble or - a sigh. They may not even make it all the way." - + <pre> + irb> %w{ruby --help} + => ["ruby", "--help"] + irb> %x{ruby --help} + => "Usage: ruby [switches] [--] [programfile] [arguments] ..." + </pre> + + + My favorite is the @%Q@ hat, which can also be written as just @%@. This acts just like a double-quoted string, + but looks nice when used with strings that run-on for many lines. Like, say you're adding a new method with @eval@. + + + <pre> + m = "bats!" + eval %{ + def #{ m } + puts "{" * 100 + end + } + </pre> + + + Just like a double-quoted string, you can use the string interpolation lilypads inside. + + + !i/wixl-15.png(Cloneberries: The More You Eat, The More *You*.)! + + + Blixy wagged his head. "Oh, dear me." + + + "Egads! My hand is pregnant," said Fox Tall, watching the little fox embryo slide about in his palm. + + + "They are good berries, though," said Blix. "The wine they make from these berries + will make ya grow a few eyeballs in your teeth. But no more than that." + + + "Ah, pain!" yelled Fox Small, as his miniature squeezed out through the pores in his scalp. But soon he + was cradling his little self and murmuring lullablies. _Nevermore, nevermore, sweetly sang the + nightingale. Winking starlight, sleeping still, whilst perched on a Sycamore stump._ + + + Making duplicates of Ruby objects is no more than a berry's worth of code. + + + <pre> + irb> tree = [:berry, :berry, :berry] + => [:berry, :berry, :berry] + irb> treechild = tree.clone + => [:berry, :berry, :berry] + </pre> + + + The @clone@ method makes an exact copy of a Ruby object. How does this differ from regular + assignment? + + + <pre> + irb> tree_charles_william_iii = tree + => [:berry, :berry, :berry] + </pre> + + + Assigning object to variables only creates more nicknames. The above Array can be called @tree_charles_william_iii@ + now. Or the shorter @tree@. The same object, but different names. + + + However, a clone is a copy of an object. You can modify it without affecting the original. + + + <pre> + irb> treechild << 'flower' + => [:berry, :berry, :berry, 'flower'] + irb> tree + => [:berry, :berry, :berry] + </pre> + + + The @clone@ method doesn't make copies of everything attached to the object, though. In the array above, only the + array is copied, not all the symbols and strings inside. + + + You may also see the @dup@ method used to copy objects. The @dup@ method makes copies which aren't as exact. For example, + there are objects in Ruby which are "frozen" and can't be altered. If you @clone@ the object, you get an exact copy which + is also frozen. If you use @dup@, you get an unfrozen copy that you can change if you like. + + + The @clone@ method also copies the metaclass of an object, whereas @dup@ does not. + + + <pre> + irb> o = Object.new + irb> class << o + irb> def nevermore; :nevermore; end + irb> end + + irb> o.clone.nevermore + => :nevermore + irb> o.dup.nevermore + # NoMethodError: undefined method `nevermore' for #<Object:0xb7d4a484> + # from (irb):7 + </pre> + + + You don't always need to make copies of objects, though, since many methods like @collect@ and @gsub@ + and @format@ make copies for you as part of their work. + + + !i/wixl-4.gif(Deer of the Smoky Pink Puffing.)! + + + Over the hills and down the valleys, they ran through the grass where the Deer of the Smoky Pink + Puffing roam. The sun was obscured by the lumbering pink clouds, emblazened with deer language, + tinting the horizon a gradient of grapefruit and secreting a glow over the meadow. The clouds + slid past each other, some bobbing upwards, destined for Canadian relatives. Others landing a + readable distance from a recipient's hooves. + + + "Let's stop! _Please!_" yelled Fox Tall. "You can't expect us to run in this *unbreathable fluff!*" + + + "Why are you yelling?" said Blix, as a thin stratus telegram wafted behind his legs. "You don't + need to raise your voice above a whisper. These long skinny clouds are usually just a mumble or + a sigh. They may not even make it all the way." + lang-pt/poignant-74d.yml @@ -1,52 +1,52 @@ - - !^sidebar - Steaks 'n' Slides: > - - My uncles love waterslides and they also love steakhouses. They have these waterslide days - which are directly followed by a trip over to Joey's Steakhouse. I _hate_ Joey's Steakhouse. It's - all big, brown shoe meat. Floppy and galoshy. Mixed with the stench of the uncles' chlorine. - - - Pruny fingers on meat slabs is The Revolting. - - - It's time for steaks and waterslides to come together in a truly repugnant manner. - My uncles have had steaks and waterslides their whole lives. The dynasty of steaks - and waterslides must come to a close. I will marry them in ways against nature! - - - Like this: - - - * Hand steaks to riders as they board the waterslide. Rider looks at the lifeguard. - Lifeguard says wait. Rider looks again. The lifeguard pauses. Then. Okay, it's time. - _Go, kid, go!_ And the look on that kid's face as he rushes down the slope, paws - full of chuck! _Go, kid, go!_ - - * Kids slide on top of steaks. For safety, we'd want the slides stacked five steaks deep. - - * Or, steaks do the sliding. In their own little swim trunks. - - * Or, people. With steak swim trunks. - - * People and steaks, side-by-side. - - * Steaks travelling down waterslides composed of steaks. - - * Steaks travelling down waterslides made of people. - - * And, of course, people eating steaks, but their tongues come out as waterslides and - they have to push the steaks up the waterslides. Which is impossible and a lifeguard has to climb - up the waterslide and manually insert the steak into the esophagus. - - * Waterslides eating people and steaks eating people. - - * Waterslides and steaks becoming friends after smelling people on each other's breath. - - * Or, steaks befriending waterslides, but waterslides not reciprocating. Waterslides - become increasingly despondent and detached, getting into bad crowds and sinking into - political extremity. Steaks make ankle bracelets out of people and leave them in the - waterslides' trouser pockets, when the trousers are unattended. They sneak out of the - waterslide commune via a huge waterslide made of steak swim trunks. - - * Or, like I said, people with steak swim trunks. - + - !^sidebar + Steaks 'n' Slides: > + + My uncles love waterslides and they also love steakhouses. They have these waterslide days + which are directly followed by a trip over to Joey's Steakhouse. I _hate_ Joey's Steakhouse. It's + all big, brown shoe meat. Floppy and galoshy. Mixed with the stench of the uncles' chlorine. + + + Pruny fingers on meat slabs is The Revolting. + + + It's time for steaks and waterslides to come together in a truly repugnant manner. + My uncles have had steaks and waterslides their whole lives. The dynasty of steaks + and waterslides must come to a close. I will marry them in ways against nature! + + + Like this: + + + * Hand steaks to riders as they board the waterslide. Rider looks at the lifeguard. + Lifeguard says wait. Rider looks again. The lifeguard pauses. Then. Okay, it's time. + _Go, kid, go!_ And the look on that kid's face as he rushes down the slope, paws + full of chuck! _Go, kid, go!_ + + * Kids slide on top of steaks. For safety, we'd want the slides stacked five steaks deep. + + * Or, steaks do the sliding. In their own little swim trunks. + + * Or, people. With steak swim trunks. + + * People and steaks, side-by-side. + + * Steaks travelling down waterslides composed of steaks. + + * Steaks travelling down waterslides made of people. + + * And, of course, people eating steaks, but their tongues come out as waterslides and + they have to push the steaks up the waterslides. Which is impossible and a lifeguard has to climb + up the waterslide and manually insert the steak into the esophagus. + + * Waterslides eating people and steaks eating people. + + * Waterslides and steaks becoming friends after smelling people on each other's breath. + + * Or, steaks befriending waterslides, but waterslides not reciprocating. Waterslides + become increasingly despondent and detached, getting into bad crowds and sinking into + political extremity. Steaks make ankle bracelets out of people and leave them in the + waterslides' trouser pockets, when the trousers are unattended. They sneak out of the + waterslide commune via a huge waterslide made of steak swim trunks. + + * Or, like I said, people with steak swim trunks. + lang-pt/poignant-75.yml @@ -1,157 +1,157 @@ - - > - "All that writing on the cloud is deer talk?" said Fox Small. - - - "Help! _Where are you guys?_" The taller fox ducked through a stormy tirade comprised of - thick, billowing smoke and sharp wisps. He whirled in every direction, "Somebody yell if you're - there!" - - - He searched for a fissure in the dense matter, combing forward with his hands. The verbose, angry - clouds responded by prodding him ahead, forcing him into tight corners in their brief pause - between sentences. He landed in a sinkhole and kept his head down as the cascades of smoke - surged forward. - - - "Yeah, deer can read this stuff," said Blix. "They just face their target and shoot it out of - their nostrils. I once heard of a guy who *rode* a stag's love poem." - - - "No way," said Fox Small. - - - "Sim," disse Blix. "Aquele cara era eu." Blix reached over his shoulder and latched onto - a spiral column of smoke that was twisting just above his head. "You just have to know - which clouds are wimpy and which clouds are grandiloquent." Blix let the cloud pull him along - and when the cloud banked upwards, Blix loosed his grip and kept his feet moving slowly - along the ground. "See, here's a good one, long like a broom handle. A guy found one once - and it was shaped _exactly_ like a car: windshield, driver's side airbag, power steering. - Uncanny!" - - - "_And that guy was--_" - - - *"It was!"* And Blix climbed up atop the long icy cloud, with its dangling glyphs, and stood proudly, - floating high above the small fox's pointy shadow. - - - "Oh, I could do that," said Fox Small. "Tall and I go jetskiing all the time. _I've stood - up on my jetski._ It's just like that." - - - Fox Tall dashed through a descending puff, shattering its sentence, which letters - came unglued and littered the ground with scrambled words, but he had only succeeded in - reaching the depressive portions of the deer correspondence, which manifested itself - as a dank and opaque mist. - - - Meanwhile, his smaller counterpart grabbed a narrow train of smoke that passed under his - arm. He was airborned and yelled, *"Tallyho!"* But he held too tightly and the cloud - evaporated under his arm and sent him back down with a short hop. - - - Since you're just beginning your use of Ruby, you may not fully grasp regular expressions - (or _regexps_) at first. You may even find yourself clipping out regexps from the "Regular - Expression Library":http://regexlib.com/DisplayPatterns.aspx and pasting them into your - code without having the foggiest idea why the expression works. Or _if_ it works! - - - <pre> - loop do - print "Enter your password: " - password = gets - if password.match( /^\w{8,15}$/ ) - break - else - puts "** Bad password! Must be 8 to 15 characters!" - end - end - </pre> - - - Do you see the unreadable deer language in the example code? The @/^\w{8,15)$/@ is a regular - expression. If I may translate, the regexp is saying, _Please only allow letters, numbers or - underscores. No less than eight and no more than fifteen._ - - - Expressões Regulares são uma mini-linguagem built into Ruby and many other programming languages. - I really shouldn't say _mini_, though, since regexps can be twisted and complicated and much more - difficult than any Ruby program. - - - Using regular expressions is extremely simple. It is like the Deer: making the smoke is an - arduous process. But hooking your elbow around the smoke and driving it to the Weinerschnitzel - to get mustard pretzel dogs is easy. - - - <pre> - irb> "good_password".match( /^\w{8,15}$/ ) - => #<MatchData:0xb7d54218> - irb> "this_bad_password_too_long".match( /^\w{8,15}$/ ) - => nil - </pre> - - - The @String#match@ method is the _simplest practical use_ of regexps. The @match@ method - checks to see if the string meets the rules inside the regexp. A regexp is only useful with - strings, to test strings for a series of conditions. If the conditions are met, a @MatchData@ - object is returned. If not, you get @nil@. - - - The most basic regular expressions are for *performing searches* inside strings. Let's say - you've got a big file and you want to search it for a word or phrase. Since a bit of time - has passed, let's search the Preeventualist's Losing and Finding Registry again. - - - <pre> - require 'preeventualist' - PreEventualist.searchfound( 'truck' ) do |page| - page.each_line do |line| - puts line if line.match( /truck/ ) - end - end - </pre> - - - This isn't too different from the code we used earlier to search for lines with the word "truck". Earlier - we used @puts line if line['truck']@, which is actually a simpler way of searching a string, if you're - just looking for a simple word. The regexp @/truck/@ is identical. Find the word "truck". Anywhere in the string. - - - Uhm, what if truck is capitalized. *Truck.* What then? - - - <pre> - puts line if line.match( /[Tt][Rr][Uu][Cc][Kk]/i ) - </pre> - - - The *character classes* are the sections surrounded by *square brackets*. Each character class gives - a list of characters which are valid matches for that spot. (The first spot matches either an uppercase @T@ - or a lowercase @t@. The second spot matches an @R@ or an @r@. And so on.) - - - But a simpler way to write it is like this: - - - <pre> - puts line if line.match( /truck/i ) - </pre> - - - The letter @i@ modifier at the end of the regexp indicates that the search is *not case-sensitive*. It - will match Truck. And TRUCK. And TrUcK. And other ups and downs. - - - Oh, and maybe you're truck is a certain model number. A T-1000. Or a T-2000. You can't remember. It's - a T _something_ thousand. - - - <pre> - puts line if line.match( /T-\d000/ ) - </pre> - - - See, deer language. The @\d@ represents a *digit*. It's a place holder in the regexp for any type of - number. The regexp will now match T-1000, T-2000, all the way up to T-9000. + - > + "All that writing on the cloud is deer talk?" said Fox Small. + + + "Help! _Where are you guys?_" The taller fox ducked through a stormy tirade comprised of + thick, billowing smoke and sharp wisps. He whirled in every direction, "Somebody yell if you're + there!" + + + He searched for a fissure in the dense matter, combing forward with his hands. The verbose, angry + clouds responded by prodding him ahead, forcing him into tight corners in their brief pause + between sentences. He landed in a sinkhole and kept his head down as the cascades of smoke + surged forward. + + + "Yeah, deer can read this stuff," said Blix. "They just face their target and shoot it out of + their nostrils. I once heard of a guy who *rode* a stag's love poem." + + + "No way," said Fox Small. + + + "Sim," disse Blix. "Aquele cara era eu." Blix reached over his shoulder and latched onto + a spiral column of smoke that was twisting just above his head. "You just have to know + which clouds are wimpy and which clouds are grandiloquent." Blix let the cloud pull him along + and when the cloud banked upwards, Blix loosed his grip and kept his feet moving slowly + along the ground. "See, here's a good one, long like a broom handle. A guy found one once + and it was shaped _exactly_ like a car: windshield, driver's side airbag, power steering. + Uncanny!" + + + "_And that guy was--_" + + + *"It was!"* And Blix climbed up atop the long icy cloud, with its dangling glyphs, and stood proudly, + floating high above the small fox's pointy shadow. + + + "Oh, I could do that," said Fox Small. "Tall and I go jetskiing all the time. _I've stood + up on my jetski._ It's just like that." + + + Fox Tall dashed through a descending puff, shattering its sentence, which letters + came unglued and littered the ground with scrambled words, but he had only succeeded in + reaching the depressive portions of the deer correspondence, which manifested itself + as a dank and opaque mist. + + + Meanwhile, his smaller counterpart grabbed a narrow train of smoke that passed under his + arm. He was airborned and yelled, *"Tallyho!"* But he held too tightly and the cloud + evaporated under his arm and sent him back down with a short hop. + + + Since you're just beginning your use of Ruby, you may not fully grasp regular expressions + (or _regexps_) at first. You may even find yourself clipping out regexps from the "Regular + Expression Library":http://regexlib.com/DisplayPatterns.aspx and pasting them into your + code without having the foggiest idea why the expression works. Or _if_ it works! + + + <pre> + loop do + print "Enter your password: " + password = gets + if password.match( /^\w{8,15}$/ ) + break + else + puts "** Bad password! Must be 8 to 15 characters!" + end + end + </pre> + + + Do you see the unreadable deer language in the example code? The @/^\w{8,15)$/@ is a regular + expression. If I may translate, the regexp is saying, _Please only allow letters, numbers or + underscores. No less than eight and no more than fifteen._ + + + Expressões Regulares são uma mini-linguagem built into Ruby and many other programming languages. + I really shouldn't say _mini_, though, since regexps can be twisted and complicated and much more + difficult than any Ruby program. + + + Using regular expressions is extremely simple. It is like the Deer: making the smoke is an + arduous process. But hooking your elbow around the smoke and driving it to the Weinerschnitzel + to get mustard pretzel dogs is easy. + + + <pre> + irb> "good_password".match( /^\w{8,15}$/ ) + => #<MatchData:0xb7d54218> + irb> "this_bad_password_too_long".match( /^\w{8,15}$/ ) + => nil + </pre> + + + The @String#match@ method is the _simplest practical use_ of regexps. The @match@ method + checks to see if the string meets the rules inside the regexp. A regexp is only useful with + strings, to test strings for a series of conditions. If the conditions are met, a @MatchData@ + object is returned. If not, you get @nil@. + + + The most basic regular expressions are for *performing searches* inside strings. Let's say + you've got a big file and you want to search it for a word or phrase. Since a bit of time + has passed, let's search the Preeventualist's Losing and Finding Registry again. + + + <pre> + require 'preeventualist' + PreEventualist.searchfound( 'truck' ) do |page| + page.each_line do |line| + puts line if line.match( /truck/ ) + end + end + </pre> + + + This isn't too different from the code we used earlier to search for lines with the word "truck". Earlier + we used @puts line if line['truck']@, which is actually a simpler way of searching a string, if you're + just looking for a simple word. The regexp @/truck/@ is identical. Find the word "truck". Anywhere in the string. + + + Uhm, what if truck is capitalized. *Truck.* What then? + + + <pre> + puts line if line.match( /[Tt][Rr][Uu][Cc][Kk]/i ) + </pre> + + + The *character classes* are the sections surrounded by *square brackets*. Each character class gives + a list of characters which are valid matches for that spot. (The first spot matches either an uppercase @T@ + or a lowercase @t@. The second spot matches an @R@ or an @r@. And so on.) + + + But a simpler way to write it is like this: + + + <pre> + puts line if line.match( /truck/i ) + </pre> + + + The letter @i@ modifier at the end of the regexp indicates that the search is *not case-sensitive*. It + will match Truck. And TRUCK. And TrUcK. And other ups and downs. + + + Oh, and maybe you're truck is a certain model number. A T-1000. Or a T-2000. You can't remember. It's + a T _something_ thousand. + + + <pre> + puts line if line.match( /T-\d000/ ) + </pre> + + + See, deer language. The @\d@ represents a *digit*. It's a place holder in the regexp for any type of + number. The regexp will now match T-1000, T-2000, all the way up to T-9000. lang-pt/poignant-76.yml @@ -1,147 +1,147 @@ - - - |\3. *Character Classes* | - - | @\d@ | matches digits | can also be written @[0-9]@ | - - | @\w@ | matches word characters (letters, numbers and the underscore) | can also be written @[A-Za-z0-9_]@ | - - | @\s@ | matches whitespace (spaces, tabs, carriage returns, line feeds) | a.k.a. @[ \t\r\n]@ | - - | @\D@ | matches everything _but_ digits | a negated set @[^\d]@ | - - | @\W@ | matches everything _but_ word chars | just like @[^\w]@ | - - | @\S@ | matches everything _but_ whitespace | also @[^\s]@ | - - | @.@ | the period matches *everything*. | - - - Building a regexp involves chaining these placeholders together to express your search. If you're looking for - a number, followed by whitespace: @/\d\s/@. If you're looking for three numbers in a row: @/\d\d\d/@. *The opening - and closing slashes mark the beginning and end of the regexp.* - - - A search for three numbers in a row can also be written as: @/\d{3}/@. Immediately following a character class - like @\d@, you can use a quantifier symbol to mark how many times you want the character class to be repeat. - - - |\3. *Quantifiers* | - - | @{n}@ | match exactly _n_ times | Precisely three numbers in a row is @/\d{3}/@ | - - | @{n,}@ | matches _n_ times or _more_ | Three or more letters in a row is @/[a-z]{3,}/i@ | - - | @{n,n2}@ | matches at least _n_ times but no more than _n2_ times | So, @/[\d,]{3,9}/@ matches - between three and nine characters which are numbers or commas | - - | @*@ | the asterisk @*@ is short for @{0,}@ | To match a colon, followed by zero or more word characters: @/:\w*/@ | - - | @+@ | the plus is short for @{1,}@ | To match one or more minus or plus signs, use @/[-+]+/@ | - - | @?@ | the question mark is short for @{0,1}@ | To match three numbers followed by an optional period: @/\d{3}[.]?/@ | - - - A really common regular expression is for matching phone numbers. American phone numbers (including an area - code) can be matched using the digit character class and the precise quantifiers. - - - <pre> - irb> "Call 909-375-4434" =~ /\d{3}-\d{3}-\d{4}/ - => 5 - irb> "The number is (909) 375-4434" =~ /[(]\d{3}[)]\s*\d{3}-\d{4}/ - => 14 - </pre> - - - This time, instead of using @match@ to search for the expression, the @=~@ operator was used. This operator is the - *match operator*, an equals sign followed by *a tilde*. The tilde is like a bit of smoke coming off the edge of a - smokestack. Remember the deer, the smoke they blow, a cryptic language just like regular expressions. The smoky - tilde points toward the regexp. - - - The match operator returns a number. The number is the spot in the string where the regular expression matched. - So when the match operator returns @5@, it's saying, "Before the match, there are five characters in the string." - - - If you need to get the full string matched, you can use the special @$&@ global variable if you're using the - match operator. Or, if you're using the @match@ method, you can get the full string by converting the @MatchData@ object - to a string. - - - <pre> - # Using =~ and $& together. - irb> "The number is (909) 375-4434" =~ /[(]\d{3}[)]\s*\d{3}-\d{4}/ - => 14 - irb> $& - => "(909) 375-4434" - - # Using the MatchData object. - irb> phone = /[(]\d{3}[)]\s*\d{3}-\d{4}/.match("The number is (909) 375-4434") - => #<MatchData:0xb7d51680> - irb> phone.to_s - => "(909) 375-4434" - </pre> - - - Most Rubyists prefer the second approach, as it uses an object within a _local variable_ rather than a _global variable_. - Global variables are kind of sketchy, since they can be easily overwritten. If you run two regular expressions in a - row, the global variable gets overwritten the second time. But with local variables, you can keep both matches around - as long as the variables are named differently. - - - Other than matching, another common use of regular expression is to do *search-and-replace* from within Ruby. - You can search for the word "cat" and replace it with the word "banjo." Sure, you can do that with strings or regexps. - - - <pre> - irb> song = "I swiped your cat / And I stole your cathodes" - irb> song.gsub 'cat', 'banjo' - => "I swiped your banjo / And I stole your banjohodes" - - irb> song.gsub /\bcat\b/, 'banjo' - => "I swiped your banjo / And I stole your cathodes" - </pre> - - - The @gsub@ method is named for "global substitution." Notice how in the first example it replaced the word "cat" and the first - three letters of "cathodes." Strings also have a simple @sub@ method which will substite only once. - - - And so this chapter ends, with Blix and the Foxes cruising aloft the solid pink belched from a very outspoken - deer somewhere in those pastures. - - -# Using regular expressions for substitution is incredibly sly. -# -# -# |\3. *Positional Marks* | -# -# | @^@ | matches the beginning of a line | Test a string for a starting pound sign: @/^#/@ | -# -# | @$@ | matches the end of a line | Look for empty lines: @/^\s*$/@ | -# -# | @\b@ | matches the edge of a word, beginning or end | Find words which start with a vowel: @/\b[aeiou]/@ | -# -# | @\A@ | matches the beginning of the string | Check if a string opens with a greeting: @/AHello/@ | -# -# | @\z@ | matches the end of the string | Ensure a string contains only word characters: @/\A\w\z/@ | -# -# -# h3. Scanning for Matches -# -# -# <pre> -# def load_dictionary( filename ) -# hsh = {} -# File.read( filename ).scan( /(.+): (.+)/ ) do |k, v| -# hsh[k] = v -# end -# end -# </pre> -# -# -# If I can offer one piece of advice with regard to regular expressions, it's this: be yourself. Don't get so -# wrapped up in regular expressions that you forget who you are. -# -# + + + |\3. *Character Classes* | + + | @\d@ | matches digits | can also be written @[0-9]@ | + + | @\w@ | matches word characters (letters, numbers and the underscore) | can also be written @[A-Za-z0-9_]@ | + + | @\s@ | matches whitespace (spaces, tabs, carriage returns, line feeds) | a.k.a. @[ \t\r\n]@ | + + | @\D@ | matches everything _but_ digits | a negated set @[^\d]@ | + + | @\W@ | matches everything _but_ word chars | just like @[^\w]@ | + + | @\S@ | matches everything _but_ whitespace | also @[^\s]@ | + + | @.@ | the period matches *everything*. | + + + Building a regexp involves chaining these placeholders together to express your search. If you're looking for + a number, followed by whitespace: @/\d\s/@. If you're looking for three numbers in a row: @/\d\d\d/@. *The opening + and closing slashes mark the beginning and end of the regexp.* + + + A search for three numbers in a row can also be written as: @/\d{3}/@. Immediately following a character class + like @\d@, you can use a quantifier symbol to mark how many times you want the character class to be repeat. + + + |\3. *Quantifiers* | + + | @{n}@ | match exactly _n_ times | Precisely three numbers in a row is @/\d{3}/@ | + + | @{n,}@ | matches _n_ times or _more_ | Three or more letters in a row is @/[a-z]{3,}/i@ | + + | @{n,n2}@ | matches at least _n_ times but no more than _n2_ times | So, @/[\d,]{3,9}/@ matches + between three and nine characters which are numbers or commas | + + | @*@ | the asterisk @*@ is short for @{0,}@ | To match a colon, followed by zero or more word characters: @/:\w*/@ | + + | @+@ | the plus is short for @{1,}@ | To match one or more minus or plus signs, use @/[-+]+/@ | + + | @?@ | the question mark is short for @{0,1}@ | To match three numbers followed by an optional period: @/\d{3}[.]?/@ | + + + A really common regular expression is for matching phone numbers. American phone numbers (including an area + code) can be matched using the digit character class and the precise quantifiers. + + + <pre> + irb> "Call 909-375-4434" =~ /\d{3}-\d{3}-\d{4}/ + => 5 + irb> "The number is (909) 375-4434" =~ /[(]\d{3}[)]\s*\d{3}-\d{4}/ + => 14 + </pre> + + + This time, instead of using @match@ to search for the expression, the @=~@ operator was used. This operator is the + *match operator*, an equals sign followed by *a tilde*. The tilde is like a bit of smoke coming off the edge of a + smokestack. Remember the deer, the smoke they blow, a cryptic language just like regular expressions. The smoky + tilde points toward the regexp. + + + The match operator returns a number. The number is the spot in the string where the regular expression matched. + So when the match operator returns @5@, it's saying, "Before the match, there are five characters in the string." + + + If you need to get the full string matched, you can use the special @$&@ global variable if you're using the + match operator. Or, if you're using the @match@ method, you can get the full string by converting the @MatchData@ object + to a string. + + + <pre> + # Using =~ and $& together. + irb> "The number is (909) 375-4434" =~ /[(]\d{3}[)]\s*\d{3}-\d{4}/ + => 14 + irb> $& + => "(909) 375-4434" + + # Using the MatchData object. + irb> phone = /[(]\d{3}[)]\s*\d{3}-\d{4}/.match("The number is (909) 375-4434") + => #<MatchData:0xb7d51680> + irb> phone.to_s + => "(909) 375-4434" + </pre> + + + Most Rubyists prefer the second approach, as it uses an object within a _local variable_ rather than a _global variable_. + Global variables are kind of sketchy, since they can be easily overwritten. If you run two regular expressions in a + row, the global variable gets overwritten the second time. But with local variables, you can keep both matches around + as long as the variables are named differently. + + + Other than matching, another common use of regular expression is to do *search-and-replace* from within Ruby. + You can search for the word "cat" and replace it with the word "banjo." Sure, you can do that with strings or regexps. + + + <pre> + irb> song = "I swiped your cat / And I stole your cathodes" + irb> song.gsub 'cat', 'banjo' + => "I swiped your banjo / And I stole your banjohodes" + + irb> song.gsub /\bcat\b/, 'banjo' + => "I swiped your banjo / And I stole your cathodes" + </pre> + + + The @gsub@ method is named for "global substitution." Notice how in the first example it replaced the word "cat" and the first + three letters of "cathodes." Strings also have a simple @sub@ method which will substite only once. + + + And so this chapter ends, with Blix and the Foxes cruising aloft the solid pink belched from a very outspoken + deer somewhere in those pastures. + + +# Using regular expressions for substitution is incredibly sly. +# +# +# |\3. *Positional Marks* | +# +# | @^@ | matches the beginning of a line | Test a string for a starting pound sign: @/^#/@ | +# +# | @$@ | matches the end of a line | Look for empty lines: @/^\s*$/@ | +# +# | @\b@ | matches the edge of a word, beginning or end | Find words which start with a vowel: @/\b[aeiou]/@ | +# +# | @\A@ | matches the beginning of the string | Check if a string opens with a greeting: @/AHello/@ | +# +# | @\z@ | matches the end of the string | Ensure a string contains only word characters: @/\A\w\z/@ | +# +# +# h3. Scanning for Matches +# +# +# <pre> +# def load_dictionary( filename ) +# hsh = {} +# File.read( filename ).scan( /(.+): (.+)/ ) do |k, v| +# hsh[k] = v +# end +# end +# </pre> +# +# +# If I can offer one piece of advice with regard to regular expressions, it's this: be yourself. Don't get so +# wrapped up in regular expressions that you forget who you are. +# +# lang-pt/poignant-76a.yml @@ -1,4 +1,4 @@ - - Just Stopping To Assure You That the Porcupine Hasn't Budged: > - - !i/porcupine-3.gif(The porcupine and his kite again.)! - + - Just Stopping To Assure You That the Porcupine Hasn't Budged: > + + !i/porcupine-3.gif(The porcupine and his kite again.)! + lang-pt/poignant-77.yml @@ -1,52 +1,52 @@ - - I'm Out: > - - !>i/quil-1.png! - - - !<i/quil-2.png! - - - Um dia, há algum tempo atrás quando conheci o Bigelow (o cachorro que fugiu com os balões), Eu voltei pro meu apartamento - hauling some board games I'd bought at a garage sale. And Quil was on my porch. O que me surpreendeu pois ela estava em - San Antonio por três meses. She was sleeping in a sleeping bag on my porch. - - - Ela não tinha grana para a escola de artes, então ela ficou na minha casa por uns cinco meses. - - - I found this used bunkbed for our place. At night we'd sit in our beds and read each other stories - from our notebooks. Eu estava escrevendo um livro sobre - uma criança que era um detetive e estava tentando descobrir quem matou this kid on his tennis team and all these animals - end up helping him figure it out. She was writing a book about this kid who puts an ad in the classifieds to get - other kids to join his made-up cult and they end up building a rocket ship. But during most of her book these - kids are lost in the woods and pretty directionless, which I got a kick out of hearing each night. - - - Yeah, each night it was poetry or stories or ideas for tricking our neighbors. Our neighbor Justin was - a big fan of Warhammer and he had all these real swords and tunics. We decided to make suits of armor out of tin - foil and go attack his apartment. We started ransacking his apartment and he loved it. So he made his own suit - of armor out of tin foil and we all went to a professional glamour studio and had a quality group shot taken. - - - !>i/quil-3.png! - - - Não estou dizendo que minha vida é melhor que a sua. Eu simplesmente sinto falta da minha irmã. As coisas não são mais como antigamente. - Estamos dissolvidos ou algo do tipo. - - - Não sei. Tô confuso. Is this growing up? Watching all your feathers come off? And even though some of those - feathers were the most lovely things? - - - I'm having a hard time telling who stopped it all up. Who stopped loving who? Did I stop caring? Maybe I only - saw her in two-dimensions and I didn't care to look at the other angles. I only saw planes. Then she shimmied up the z-axis when I wasn't - looking and I never did the homework to trace the coordinates. A limb on a geometrical tree and I am insisting on circles. - - - Blix estava certo. I'm in so shape to write this book. Goodbye until I can shake this. - - - !i/departure.png! - - + - I'm Out: > + + !>i/quil-1.png! + + + !<i/quil-2.png! + + + Um dia, há algum tempo atrás quando conheci o Bigelow (o cachorro que fugiu com os balões), Eu voltei pro meu apartamento + hauling some board games I'd bought at a garage sale. And Quil was on my porch. O que me surpreendeu pois ela estava em + San Antonio por três meses. She was sleeping in a sleeping bag on my porch. + + + Ela não tinha grana para a escola de artes, então ela ficou na minha casa por uns cinco meses. + + + I found this used bunkbed for our place. At night we'd sit in our beds and read each other stories + from our notebooks. Eu estava escrevendo um livro sobre + uma criança que era um detetive e estava tentando descobrir quem matou this kid on his tennis team and all these animals + end up helping him figure it out. She was writing a book about this kid who puts an ad in the classifieds to get + other kids to join his made-up cult and they end up building a rocket ship. But during most of her book these + kids are lost in the woods and pretty directionless, which I got a kick out of hearing each night. + + + Yeah, each night it was poetry or stories or ideas for tricking our neighbors. Our neighbor Justin was + a big fan of Warhammer and he had all these real swords and tunics. We decided to make suits of armor out of tin + foil and go attack his apartment. We started ransacking his apartment and he loved it. So he made his own suit + of armor out of tin foil and we all went to a professional glamour studio and had a quality group shot taken. + + + !>i/quil-3.png! + + + Não estou dizendo que minha vida é melhor que a sua. Eu simplesmente sinto falta da minha irmã. As coisas não são mais como antigamente. + Estamos dissolvidos ou algo do tipo. + + + Não sei. Tô confuso. Is this growing up? Watching all your feathers come off? And even though some of those + feathers were the most lovely things? + + + I'm having a hard time telling who stopped it all up. Who stopped loving who? Did I stop caring? Maybe I only + saw her in two-dimensions and I didn't care to look at the other angles. I only saw planes. Then she shimmied up the z-axis when I wasn't + looking and I never did the homework to trace the coordinates. A limb on a geometrical tree and I am insisting on circles. + + + Blix estava certo. I'm in so shape to write this book. Goodbye until I can shake this. + + + !i/departure.png! + + lang-pt/poignant-78.yml @@ -1 +1 @@ - - When You Wish Upon a Beard: + - When You Wish Upon a Beard: lang-pt/poignant-79.yml @@ -1,16 +1,16 @@ - - > - !i/wish.upon.a.beard-1.gif! - - - HEY THIS CHAPTER GOT DROPPED IN MY LAP. SOON I'LL HAVE it READY. I WILL. - - -# !i/wish.upon.a.beard-2.gif! -# -# !i/wish.upon.a.beard-5.gif! -# -# !i/wish.upon.a.beard-4.gif! -# -# !i/wish.upon.a.beard-3.gif! - -expansion_paks: + - > + !i/wish.upon.a.beard-1.gif! + + + HEY THIS CHAPTER GOT DROPPED IN MY LAP. SOON I'LL HAVE it READY. I WILL. + + +# !i/wish.upon.a.beard-2.gif! +# +# !i/wish.upon.a.beard-5.gif! +# +# !i/wish.upon.a.beard-4.gif! +# +# !i/wish.upon.a.beard-3.gif! + +expansion_paks: lang-pt/poignant-80.yml @@ -1 +1 @@ - - The Tiger's Vest (with a Basic Introduction to Irb): + - The Tiger's Vest (with a Basic Introduction to Irb): lang-pt/poignant-81.yml @@ -1,4 +1,4 @@ - - > - !i/tigers.vest-1.gif(Tiger has vest. Tiger likes girl robot. Earth crashing into sun...)! - - + - > + !i/tigers.vest-1.gif(Tiger has vest. Tiger likes girl robot. Earth crashing into sun...)! + + lang-pt/poignant-82.yml @@ -1,41 +1,41 @@ - - !^sidebar - Sobre as versões do Ruby: > - - Se você tem visitado vários sites que oferecem download do Ruby, você provavelmente viu várias versões - diferentes disponíveis. Parece lógico que quanto maior for o número da versão, - mais recente é a versão do Ruby. Mas isso não é verdade. Na terra do Ruby, números de versões têm significados - e eu gostaria que você fizesse a escolha certa. - - - A última versão *estável* do Ruby é a *1.8.3*. Versões estáveis oferecem os recursos mais recentes - que são testadas várias vezes e são recomendados para uso geral. Quando novas versões estáveis - são lançadas, você pode seguramente atualizar seu Ruby para estas novas versões. - - - A última versão do Ruby liberada para *desenvolvimento* é a *1.9.0*. A versão de desenvolvimento inclui - alterações experimentais e problemas não resolvidos. Esta versão é destinada a todos que queiram - espiar o futuro do Ruby, correndo o risco de encontrar alguns erros. - - - Agora, você notará que o número da versão é composto por três números individuais, - que são: *a versão maior*, *a versão menor*, e *a versão pequenina*. A - versão maior é aumentada toda vez que o Ruby é reescrito. A menor versão é alterada baseando-se - em mudanças radicais do Ruby. A versão pequenina é incrementada de poucos em poucos meses como menores - alterações e soluções para alguns erros. - - - Todas as edições do Ruby, até agora, têm a versão maior como 1. Quando o Ruby 2.0 vier, você verá - este número mudar para 2. - - - A menor versão indica se a versão é estável ou não. *Se a versão menor - é um numero par, então a versão é estável. Se for ímpar, então aquele Ruby - é uma versão para desenvolvimento*. Depois de um ano ou mais, quando a versão de desenvolvimento está pronta - para o mundo, ambos os números são incrementados e o número da versão pequenina volta para zero. - - - Ahh se eu pudesse lhe dar um gostinho de como o Ruby evolui! Eu não posso contar - quantas vezes uma idéia fresquinha pousa na lista de emails do Ruby-Core, onde os Imperadores do - Ruby conversam, e *aquela mesma idéia* começa a ser trabalhada em poucos dias. Como eu costumo - dizer, é uma bela engrenagem. - + - !^sidebar + Sobre as versões do Ruby: > + + Se você tem visitado vários sites que oferecem download do Ruby, você provavelmente viu várias versões + diferentes disponíveis. Parece lógico que quanto maior for o número da versão, + mais recente é a versão do Ruby. Mas isso não é verdade. Na terra do Ruby, números de versões têm significados + e eu gostaria que você fizesse a escolha certa. + + + A última versão *estável* do Ruby é a *1.8.3*. Versões estáveis oferecem os recursos mais recentes + que são testadas várias vezes e são recomendados para uso geral. Quando novas versões estáveis + são lançadas, você pode seguramente atualizar seu Ruby para estas novas versões. + + + A última versão do Ruby liberada para *desenvolvimento* é a *1.9.0*. A versão de desenvolvimento inclui + alterações experimentais e problemas não resolvidos. Esta versão é destinada a todos que queiram + espiar o futuro do Ruby, correndo o risco de encontrar alguns erros. + + + Agora, você notará que o número da versão é composto por três números individuais, + que são: *a versão maior*, *a versão menor*, e *a versão pequenina*. A + versão maior é aumentada toda vez que o Ruby é reescrito. A menor versão é alterada baseando-se + em mudanças radicais do Ruby. A versão pequenina é incrementada de poucos em poucos meses como menores + alterações e soluções para alguns erros. + + + Todas as edições do Ruby, até agora, têm a versão maior como 1. Quando o Ruby 2.0 vier, você verá + este número mudar para 2. + + + A menor versão indica se a versão é estável ou não. *Se a versão menor + é um numero par, então a versão é estável. Se for ímpar, então aquele Ruby + é uma versão para desenvolvimento*. Depois de um ano ou mais, quando a versão de desenvolvimento está pronta + para o mundo, ambos os números são incrementados e o número da versão pequenina volta para zero. + + + Ahh se eu pudesse lhe dar um gostinho de como o Ruby evolui! Eu não posso contar + quantas vezes uma idéia fresquinha pousa na lista de emails do Ruby-Core, onde os Imperadores do + Ruby conversam, e *aquela mesma idéia* começa a ser trabalhada em poucos dias. Como eu costumo + dizer, é uma bela engrenagem. + lang-pt/poignant-83.yml @@ -1,115 +1,115 @@ - - > - Let's install the very latest Ruby on your computer so you can follow all the examples - in the (Poignant) Guide and actually do things right now! (Yes, things!) - - - * If you are using *Microsoft Windows*, begin by downloading the "Ruby Installer for - Windows":http://rubyforge.org/frs/?group_id=167. Running this "one-click" installer will - setup Ruby for you, as well as a tidy pack of useful software, such as a small text editor and some - additional libraries. - - * If you are on Apple's *Mac OS X*, then Ruby might already be installed. Versions 10.2 and - 10.3 of OS X both came with Ruby. Still, I encourage you to upgrade Ruby so that all the examples - in this book will work for you. Download a *stable* "disk image":http://homepage.mac.com/discord/Ruby/. - You will need OS X 10.3 (Panther) and the XCode Tools in order to use this image. - - * On *FreeBSD*, Ruby is right there in the ports system. In fact, if you've used the essential - @portupgrade@ tool, then Ruby is already installed. Akinori Musha, one of Ruby's immensely - talented core developers, wrote portupgrade, which means that you can use your Ruby learning - right away to hack up your @pkgtools.conf@. - - _* <pre class="text"> - cd /usr/ports/lang/ruby18 - sudo make install - </pre> - - * On *RedHat* or *Mandrake* Linux, you can find "Ruby RPMs":http://rpmfind.net/linux/rpm2html/search.php?query=Ruby. - I believe Ruby is also available through Ximian's Red Carpet. - - * On *Debian*, use @apt-get install ruby@. - - * On *Gentoo*, @emerge ruby@. - - * Other *Linux* and *UNIX* platforms, even *OS X* (if the disk images don't work for you): - Download the "latest source code":http://ruby-lang.org/en/20020102.html. - For instance, "Ruby 1.8.3":ftp://ftp.ruby-lang.org/pub/ruby/ruby-1.8.3.tar.gz. To unpack and compile: - - _* <pre class="text"> - tar xzvf ruby-1.8.3.tar.gz - cd ruby-1.8.3 - ./configure - make - make install - </pre> - - _* (Again, the above commands are for installing Ruby from the source code. You may need to use - @su@ or @sudo@ to give you permission to run the @make install@.) - - - To test if Ruby is installed, open a command shell and run: @ruby -v@. If Ruby is installed - properly, you'll see a bit of version info. - - - <pre class="text"> - ruby 1.8.3 (2005-11-25) [i386-mswin32] - </pre> - - - * To open a command shell in *Microsoft Windows*, go to the Start Menu and select @Run...@. - Type in: @cmd@. Press OK. A command shell window will appear. - - * To open a command shell on *Mac OS X*, go to *Applications > Utilities*. Run the *Terminal* - program. - - - Okay, keep that command shell open cause we'll need it if the Earth gets rescued from its - plummet toward the sun. - - - !i/tigers.vest-2.gif(Tiger saves Earth with Ice Gun. Girl robot zooms around tuxed shop...)! - - - Ruby comes with a very, very, very extremely helpful tool called *Irb*. Interactive Ruby. - In your command shell, type: @irb@. - - - <pre> - irb(main):001:0> - </pre> - - - You should see the prompt above. This Irb prompt will allow you to enter Ruby code and, - upon pressing _Enter_, the code will run. - - - So, at the Irb prompt, do a: @3000 + 500@. - - - <pre> - irb(main):001:0> 3000 + 500 - => 3500 - irb(main):002:0> - </pre> - - - The example @3000 + 500@ is legitimate code. We're just not assigning the answer to a variable. - Which is okay in Irb, because Irb prints the answer given back by code you run. - - - Irb is a great calculator. - - - <pre> - irb(main):002:0> ( ( 220.00 + 34.15 ) * 1.08 ) / 12 - => 22.8735 - irb(main):003:0> "1011010".to_i( 2 ) - => 90 - irb(main):004:0> Time.now - Time.local( 2003, "Jul", 31, 8, 10, 0 ) - => 31119052.510118 - </pre> - - - The first example demonstrates a bit of math and is read as: _220.00 plus 34.15 times 1.08 divided by 12_. - The second example takes a binary string and converts it to a decimal number. The third example computes - the number of seconds between @now@ and July 31, 2003 at 8:10 AM. The answers to all of these are - printed back to us by Irb with a little ASCII arrow pointing. + - > + Let's install the very latest Ruby on your computer so you can follow all the examples + in the (Poignant) Guide and actually do things right now! (Yes, things!) + + + * If you are using *Microsoft Windows*, begin by downloading the "Ruby Installer for + Windows":http://rubyforge.org/frs/?group_id=167. Running this "one-click" installer will + setup Ruby for you, as well as a tidy pack of useful software, such as a small text editor and some + additional libraries. + + * If you are on Apple's *Mac OS X*, then Ruby might already be installed. Versions 10.2 and + 10.3 of OS X both came with Ruby. Still, I encourage you to upgrade Ruby so that all the examples + in this book will work for you. Download a *stable* "disk image":http://homepage.mac.com/discord/Ruby/. + You will need OS X 10.3 (Panther) and the XCode Tools in order to use this image. + + * On *FreeBSD*, Ruby is right there in the ports system. In fact, if you've used the essential + @portupgrade@ tool, then Ruby is already installed. Akinori Musha, one of Ruby's immensely + talented core developers, wrote portupgrade, which means that you can use your Ruby learning + right away to hack up your @pkgtools.conf@. + + _* <pre class="text"> + cd /usr/ports/lang/ruby18 + sudo make install + </pre> + + * On *RedHat* or *Mandrake* Linux, you can find "Ruby RPMs":http://rpmfind.net/linux/rpm2html/search.php?query=Ruby. + I believe Ruby is also available through Ximian's Red Carpet. + + * On *Debian*, use @apt-get install ruby@. + + * On *Gentoo*, @emerge ruby@. + + * Other *Linux* and *UNIX* platforms, even *OS X* (if the disk images don't work for you): + Download the "latest source code":http://ruby-lang.org/en/20020102.html. + For instance, "Ruby 1.8.3":ftp://ftp.ruby-lang.org/pub/ruby/ruby-1.8.3.tar.gz. To unpack and compile: + + _* <pre class="text"> + tar xzvf ruby-1.8.3.tar.gz + cd ruby-1.8.3 + ./configure + make + make install + </pre> + + _* (Again, the above commands are for installing Ruby from the source code. You may need to use + @su@ or @sudo@ to give you permission to run the @make install@.) + + + To test if Ruby is installed, open a command shell and run: @ruby -v@. If Ruby is installed + properly, you'll see a bit of version info. + + + <pre class="text"> + ruby 1.8.3 (2005-11-25) [i386-mswin32] + </pre> + + + * To open a command shell in *Microsoft Windows*, go to the Start Menu and select @Run...@. + Type in: @cmd@. Press OK. A command shell window will appear. + + * To open a command shell on *Mac OS X*, go to *Applications > Utilities*. Run the *Terminal* + program. + + + Okay, keep that command shell open cause we'll need it if the Earth gets rescued from its + plummet toward the sun. + + + !i/tigers.vest-2.gif(Tiger saves Earth with Ice Gun. Girl robot zooms around tuxed shop...)! + + + Ruby comes with a very, very, very extremely helpful tool called *Irb*. Interactive Ruby. + In your command shell, type: @irb@. + + + <pre> + irb(main):001:0> + </pre> + + + You should see the prompt above. This Irb prompt will allow you to enter Ruby code and, + upon pressing _Enter_, the code will run. + + + So, at the Irb prompt, do a: @3000 + 500@. + + + <pre> + irb(main):001:0> 3000 + 500 + => 3500 + irb(main):002:0> + </pre> + + + The example @3000 + 500@ is legitimate code. We're just not assigning the answer to a variable. + Which is okay in Irb, because Irb prints the answer given back by code you run. + + + Irb is a great calculator. + + + <pre> + irb(main):002:0> ( ( 220.00 + 34.15 ) * 1.08 ) / 12 + => 22.8735 + irb(main):003:0> "1011010".to_i( 2 ) + => 90 + irb(main):004:0> Time.now - Time.local( 2003, "Jul", 31, 8, 10, 0 ) + => 31119052.510118 + </pre> + + + The first example demonstrates a bit of math and is read as: _220.00 plus 34.15 times 1.08 divided by 12_. + The second example takes a binary string and converts it to a decimal number. The third example computes + the number of seconds between @now@ and July 31, 2003 at 8:10 AM. The answers to all of these are + printed back to us by Irb with a little ASCII arrow pointing. lang-pt/poignant-84.yml @@ -1,97 +1,97 @@ - - - h3. Lendo o prompt - - - Eu sei que o prompt com certeza parece desconcertante. Bem, vamos logo dissecá-lo. É muito simples. - O prompt tem três partes, cada uma separada por *dois pontos*. - - - A primeira seção, onde está escrito @irb(main)@, mostra *o nome do programa* que estamos rodando. A segunda - seção mostra o número da linha, *um contador de quantas linhas de Ruby nós digitamos*. A terceira seção é *um - nível de profundidade*. Toda vez que você abrir uma expressão que precisa ser fechada, o nível de profundidade - vai aumentar uma unidade. E toda vez que o Irb detectar que seu código não está terminado, *o fim do prompt - vai virar um asterisco.* - - - <pre> - irb(main):001:0> campainha = :apertada - => :apertada - irb(main):002:0> pistola_de_gelo = - irb(main):003:0* if campainha == :apertada - irb(main):004:1> :ligar - irb(main):005:1> else - irb(main):006:1* :desligar - irb(main):007:1> end - => :ligar - </pre> - - - Veja como o nível de profundidade aumentou para 1 quando eu abri o @if@. E como o asterisco indica a - continuação da linha. - - - h3. Ajustando o Prompt - - - Você não tem que gostar da aparência do prompt, entretanto. Não estou forçando você a fazer nada e, - se você quer hackeá-lo, estou do seu lado. - - - O Irb tem mais alguns prompts que podem agradar seus sentidos. Tente @irb --prompt simple@. - Desta vez o Irb vai lhe proporcionar um conjunto bem básico de setas, permitindo a você digitar seu - código sem todo o relatório de status. - - - <pre> - >> %w(braço do meu melhor amigo) - => ["braço", "do", "meu", "melhor", "amigo"] - >> - </pre> - - - Ruby vem com alguns prompts. O prompt *simple* visto acima. O prompt *xmp* que não tem nenhum - prompt e identa a seta de resposta. (Deve ficar bom para impressão.) Além disso, o prompt - *null*, que elimina todos os prompts. Defina o prompt fornecendo o nome dele na opção - @--prompt@. (Portanto, @irb --prompt null@.) - - - Você também pode fazer seu próprio prompt. O Irb é completamente customizável de dentro dele mesmo. - O objeto @conf@ contém todas as configurações do Irb. Algumas destas configurações são para o - controle do prompt. - - - <pre> - >> conf.methods.grep /prompt/ - => ["prompting?", "prompt_s", "prompt_s=", "prompt_c", "prompt_c=", - "prompt_i", "prompt_mode", "prompt_i=", "prompt_mode="] - </pre> - - - Vamos configurar nosso prompt para mostrar o número da linha com um pouquinho de decoração. - - - <pre> - >> conf.prompt_i = "%3n :> " # o prompt normal - >> conf.prompt_s = "%3n .%l " # o prompt de continuação de string - >> conf.prompt_c = "%3n .^ " # o prompt de continuação de código - >> conf.return_format = " => %s\n" # a seta de resposta - </pre> - - - Acima estão as quatro partes de um prompt Irb. O prompt de continuação de string é mostrado quando - uma string ainda está aberta quando você aperta _Enter_. O @%3n@ descreve que o Irb deve reservar três - caracteres para o número da linha. O @%l@ guarda um lugar para mostrar o tipo da string que será - continuada. (Se você está continuando uma string de aspas duplas, ele mostra aspas duplas. Se você - está continuando uma expressão regular, ele mostra uma barra.) - - - O resto são apenas símbolos para decorar o prompt. Então, em caso de continuação de uma linha de código, - eu mostro um acento circunflexo que aponta para a linha onde aquela linha de código começou. - - - Você pode ler mais sobre a customização do Irb e sobre salvar sua configuração num arquivo no - completo "guia para o Irb":http://www.ruby-doc.org/docs/ProgrammingRuby/html/irb.html, disponível no - _Programming Ruby_, grátis-para-seus-olhos-de-Internet-perambulantes. - - + + + h3. Lendo o prompt + + + Eu sei que o prompt com certeza parece desconcertante. Bem, vamos logo dissecá-lo. É muito simples. + O prompt tem três partes, cada uma separada por *dois pontos*. + + + A primeira seção, onde está escrito @irb(main)@, mostra *o nome do programa* que estamos rodando. A segunda + seção mostra o número da linha, *um contador de quantas linhas de Ruby nós digitamos*. A terceira seção é *um + nível de profundidade*. Toda vez que você abrir uma expressão que precisa ser fechada, o nível de profundidade + vai aumentar uma unidade. E toda vez que o Irb detectar que seu código não está terminado, *o fim do prompt + vai virar um asterisco.* + + + <pre> + irb(main):001:0> campainha = :apertada + => :apertada + irb(main):002:0> pistola_de_gelo = + irb(main):003:0* if campainha == :apertada + irb(main):004:1> :ligar + irb(main):005:1> else + irb(main):006:1* :desligar + irb(main):007:1> end + => :ligar + </pre> + + + Veja como o nível de profundidade aumentou para 1 quando eu abri o @if@. E como o asterisco indica a + continuação da linha. + + + h3. Ajustando o Prompt + + + Você não tem que gostar da aparência do prompt, entretanto. Não estou forçando você a fazer nada e, + se você quer hackeá-lo, estou do seu lado. + + + O Irb tem mais alguns prompts que podem agradar seus sentidos. Tente @irb --prompt simple@. + Desta vez o Irb vai lhe proporcionar um conjunto bem básico de setas, permitindo a você digitar seu + código sem todo o relatório de status. + + + <pre> + >> %w(braço do meu melhor amigo) + => ["braço", "do", "meu", "melhor", "amigo"] + >> + </pre> + + + Ruby vem com alguns prompts. O prompt *simple* visto acima. O prompt *xmp* que não tem nenhum + prompt e identa a seta de resposta. (Deve ficar bom para impressão.) Além disso, o prompt + *null*, que elimina todos os prompts. Defina o prompt fornecendo o nome dele na opção + @--prompt@. (Portanto, @irb --prompt null@.) + + + Você também pode fazer seu próprio prompt. O Irb é completamente customizável de dentro dele mesmo. + O objeto @conf@ contém todas as configurações do Irb. Algumas destas configurações são para o + controle do prompt. + + + <pre> + >> conf.methods.grep /prompt/ + => ["prompting?", "prompt_s", "prompt_s=", "prompt_c", "prompt_c=", + "prompt_i", "prompt_mode", "prompt_i=", "prompt_mode="] + </pre> + + + Vamos configurar nosso prompt para mostrar o número da linha com um pouquinho de decoração. + + + <pre> + >> conf.prompt_i = "%3n :> " # o prompt normal + >> conf.prompt_s = "%3n .%l " # o prompt de continuação de string + >> conf.prompt_c = "%3n .^ " # o prompt de continuação de código + >> conf.return_format = " => %s\n" # a seta de resposta + </pre> + + + Acima estão as quatro partes de um prompt Irb. O prompt de continuação de string é mostrado quando + uma string ainda está aberta quando você aperta _Enter_. O @%3n@ descreve que o Irb deve reservar três + caracteres para o número da linha. O @%l@ guarda um lugar para mostrar o tipo da string que será + continuada. (Se você está continuando uma string de aspas duplas, ele mostra aspas duplas. Se você + está continuando uma expressão regular, ele mostra uma barra.) + + + O resto são apenas símbolos para decorar o prompt. Então, em caso de continuação de uma linha de código, + eu mostro um acento circunflexo que aponta para a linha onde aquela linha de código começou. + + + Você pode ler mais sobre a customização do Irb e sobre salvar sua configuração num arquivo no + completo "guia para o Irb":http://www.ruby-doc.org/docs/ProgrammingRuby/html/irb.html, disponível no + _Programming Ruby_, grátis-para-seus-olhos-de-Internet-perambulantes. + + lang-pt/poignant-84a.yml @@ -1,18 +1,18 @@ - - !^sidebar - Windows Hiccups: > - - Okay, here's what you do to get tab completion working in Windows. - "Download this.":http://whytheluckystiff.net/ruby/dist/readline.so-for-1.8.zip - A zip with two files inside. These get copied into your Ruby installation. - Place readline.dll in the *bin* folder. The readline.so goes in - *lib/ruby/1.8/i386-mswin32* folder. - - - Then, run in your command shell: @irb --readline -r irb/completion@. - - - And for Europeans, you'll need "this.":http://whytheluckystiff.net/ruby/dist/Input.euro - Save it as *.inputrc* and place it in your home directory. (Your personal directory - which contains your Desktop and My Documents folders.) - - + - !^sidebar + Windows Hiccups: > + + Okay, here's what you do to get tab completion working in Windows. + "Download this.":http://whytheluckystiff.net/ruby/dist/readline.so-for-1.8.zip + A zip with two files inside. These get copied into your Ruby installation. + Place readline.dll in the *bin* folder. The readline.so goes in + *lib/ruby/1.8/i386-mswin32* folder. + + + Then, run in your command shell: @irb --readline -r irb/completion@. + + + And for Europeans, you'll need "this.":http://whytheluckystiff.net/ruby/dist/Input.euro + Save it as *.inputrc* and place it in your home directory. (Your personal directory + which contains your Desktop and My Documents folders.) + + lang-pt/poignant-85.yml @@ -1,309 +1,309 @@ - - > - h3. Tab Completion - - - Uma característica do Irb raramente mencionada é a vantagem do recurso de auto-completar com a tecla TAB. - Este tópico é um pouco de tabu no momento, uma vez que trabalhar com ele no Windows é um tanto horroroso. - (Não, não tenha medo. Agora, mais do que nunca, olhe à sua direita.) - - Se você estiver no Linux ou no FreeBSD, o recurso de auto-completar com a tecla TAB deverá funcionar imediatamente. - E se estiver usando OS X, você deverá ter certeza que está atualizado para última versão 1.8 e quando executar o Irb, use: - - <pre class="text"> - irb --readline -r irb/completion - </pre> - - - Basicamente, quando você teclar _TAB_, o Irb tentará adivinhar o que você está tentando digitar. - Tente digitar: @[].col@ e tecle _TAB_. o Irb finalizará isto. @[].collect@ e isto levará - seu cursor até o final então você pode adicionar mais conteúdo. - - - Se existem várias combinações, apenas teclar _TAB_ não adiantará. Mas pressione duas vezes - e o Ruby lhe dará uma lista completa de possíveis combinações. - - - Isto é ótimo se você quer apenas ver todos os metodos para um certo objeto. Digite em qualquer - número, um ponto, e use _TAB_. - - - <pre class="text"> - >> 42. - 42.floor 42.next 42.step - 42.__id__ 42.freeze 42.nil? 42.succ - 42.__send__ 42.frozen? 42.nonzero? 42.taint - 42.abs 42.hash 42.object_id 42.tainted? - 42.between? 42.id 42.prec 42.times - 42.ceil 42.id2name 42.prec_f 42.to_f - 42.chr 42.inspect 42.prec_i 42.to_i - 42.class 42.instance_eval 42.private_methods 42.to_int - 42.clone 42.instance_of? 42.protected_methods 42.to_s - 42.coerce 42.instance_variable_get 42.public_methods 42.to_sym - 42.display 42.instance_variable_set 42.quo 42.truncate - 42.div 42.instance_variables 42.remainder 42.type - 42.divmod 42.integer? 42.respond_to? 42.untaint - 42.downto 42.is_a? 42.round 42.upto - 42.dup 42.kind_of? 42.send 42.zero? - 42.eql? 42.method 42.singleton_method_added - 42.equal? 42.methods 42.singleton_methods - 42.extend 42.modulo 42.size - </pre> - - - Agora, tentando teclar @Kernel::@ e depois _TAB_. Todos os métodos do core. Nunca esqueça disto - e use o tempo todo. - - - !i/tigers.vest-3.gif(Except the robot flew away and the ice gun went on and on...)! - - - Ok, uma última coisa então vou parar de incomodar com toda esta ótima tecnologia. - Mas eu vou ter que falar isto alto, então tapem os ouvidos! Estou do outro lado do mundo, galera, mas o - volume vem do céu -- a bold, red crescendo of -- - - - h1={font-size:84pt; color:#FDD; line-height: 120%}. ((%{color:#A53}ri%)) - - - h3={color: #300}. (Ruby's Own 411 or 555-1212 or _Yes, Operator, Get Belgrade on the Line_ -- I'll - Venha cá -- Apenas batendo na tecla "jogo da velha" até alguém atender... - - - E o Ri atende. "Aqui é o Ri. Classe e dois pontos, por favor" - - - Você entra correndo, "Isto é a instância de um metodo, Operador. Enumerável#zip." - - - <pre class="text"> - ri Enumerable#zip - </pre> - - - Sem demora, corrija no seu display (tão rápido que até o gato sentado na - quina estica o pescoço, boceja e alcança a sua caneca real _A coisa mais - barulhenta desde Michael Dorn_): - - - <pre class="text"> - --------------------------------------------------------- Enumerable#zip - enum.zip(arg, ...) => array - enum.zip(arg, ...) {|arr| block } => nil - ------------------------------------------------------------------------ - Converte qualquer argumento em array, então une elementos de _enum_ - com elementos correpondentes de cada argumento. Isto gera uma - sequência de +enum#size+ _n_-element arrays, onde _n_ é um a mais - que a conta de argumentos. Se o tamanho de algum argumento é menos - que +enum#size+, valores de +nil+ são providênciados. Se é dado um - bloco, este é convocado para cada saída do array, caso contrário um - array de arrays é retornado. - - a = [ 4, 5, 6 ] - b = [ 7, 8, 9 ] - - (1..3).zip(a, b) #=> [[1, 4, 7], [2, 5, 8], [3, 6, 9]] - "cat\ndog".zip([1]) #=> [["cat\n", 1], ["dog", nil]] - (1..3).zip #=> [[1], [2], [3]] - </pre> - - - Isto é um dicinário íntegro de Ruby -- O poder de apenas perguntar está na ponta - de seus dedos -- não diga que nunca ouviu sobre este nenhum-dinheiro-supre-uma-vida-inteira-de - explicações-apropriadas!_ - - - Para ter uma explicação de qualquer classe, junto com diretório completo para - todos seus metodos, todos com uma voz suave que serve para acalmar qualquer um de - vocês cosmonautas em pânico aí lutando contra a atração de um raio trator de tolerância zero, - apenas use na shell: @ri Class@. - - - Mas para ajudar nos metodos da classe, você tira da manga: @ri Class::method@. - - - Apesar de metodos de instância usarem o jogo da velha ao invés do ponto. (Uma vez que ponto pode significar class *ou* - métodos de instância.) Digo: @ri Class#method@. - - - A completa distribuição das classe, uma lista completa desde o mais alto topo até o centro da Terra, - pode ser alcançado com @ri -c@. - - - e além do texto, você pode fazer HTML: @ri -Tf html String#gsub > gsub.html@. - - - *Ou mostrar ANSI colorido: @ri -Tf ansi String#gsub@.* E este é ultimo e o melhor. - - - h3. Dentro do Painel de controle do Ri - - - Atrá do Ri cantam um coro de vozes humanas, primeiramente Dave Thomas, um autor de _Programming - Ruby_, e absolutamente o pai adotivo americano do Ruby. Muitos destes discursos elaborado - do Ri são diretamente das referencias de _Programming Ruby_. Não esqueça de - agradecer ao Dave periodicamente. - - - O Ri extrai seu exuberante conjunto de informações do mesmo código que o Ruby é construído. Em cada um dos - arquivos de código contidos no armário de arquivo da chefia Ruby, comentários detalhados - descrevem tudo claramente. - - - Na classe @date@ de Ruby, aqui temos métodos bem comentados: - - - <pre> - # Obtenha o tempo desta data como [horas, minutos, segundos, - # fração de segundos] - def time() self.class.day_fraction_to_time(day_fraction) end - - # Obtenha a hora desta data. - def hour() time[0] end - - # Obtenha o minuto desta data. - def min() time[1] end - </pre> - - - Os comentários surgem no Ri. Digitamos: @ri Date#time@. - - - <pre class="text"> - -------------------------------------------------------------- Date#time - time() - ------------------------------------------------------------------------ - Get the time of this date as [hours, minutes, seconds, - fraction_of_a_second] - - </pre> - - - O Ri advinha muito de como um método funciona, embora espera que os codificadores - escrevam uma breve descrição nos comentários, pouco antes da definição de um método ou classe. - Eu sugeriria que sempre que for escrever um método, adicione uma breve descrição - nos comentários antes daquele método. Em tempo, você pode gerar uma - documentação Ri para aquele método. - - - Você também pode usar alguns caracteres especiais para aumentar sua descrição. Por - exemplo, se você indentar um parágrafo e usar um asterisco @*@ ou um hífen @-@ - pouco antes das letras da primeira frase, o parágrafo será reconhecido como um - ítem de lista. Então, se a sua descrição precisa ser convertida para HTML, você - verá o ítem de lista aparecer como uma lista de HTML desordenada. - - - <pre> - # Obtenha o tempo desta data como um array de: - # * horas - # * minutos - # * segundos - # * fração de segundos - def time() self.class.day_fraction_to_time(day_fraction) end - </pre> - - - Outra regras semelhantes: Listas que começam com digitos seguidos de períodos, - são reconhecidas como listas numéricas. Palavras enfatizadas são cercadas por traço baixo(underscore), - palavras em negrito por asteriscos, palavras em código por sinais de soma. Exemplos são simples blocos - de texto indentados por alguns espaços. Todas estas regras juntas são chamadas RDoc. - - - Aqui está um pedaço do RDoc do método @initialize@ em um dos meus projetos - chamado RedCloth. Observe o exemplo identado bem como a classe Ruby e - nomes de métodos alinhados com sinais de soma. - - - <pre> - # - # Retorna um novo objeto RedCloth, baseado em +String+ e - # cumprindo todas as +restrições+ incluídas. - # - # r = RedCloth.new( "h1. A <b>bold</b> man", [:filter_html] ) - # r.to_html - # #=>"<h1>A &lt;b&gt;bold&lt;/b&gt; man</h1>" - # - def initialize( string, restrictions = [] ) - @lite = false - restrictions.each { |r| method( "#{ r }=" ).call( true ) } - super( string ) - end - </pre> - - - Para a série completa de regras RDoc veja a seção *Markup* do - "README":http://rdoc.sourceforge.net/doc/files/README.html. - - - h3. Impulsionando seu próprio Ri - - - O Ri porém não lê automáticamente seus arquivos para você. Você tem que guiá-lo, - mostrar o caminho. Mude para o diretório do código que você gostaria de examinar. Então, - use a ferramenta RDoc para executar. - - - <pre class="text"> - cd ~/cvs/your-code - rdoc --ri-site - </pre> - - - Agora, tente usar @ri SuaClasse@ para assegurar que todas as suas descrições estão aparecendo - apropriadamente. - Se você quer fazer documentação HTML, tente isto: - - - <pre class="text"> - cd ~/cvs/your-code - rdoc - </pre> - - - O diretório @~/cvs/seu-código@ deverá agora também ter um diretório @doc@ - recente contendo documentação HTML para todas as suas classes. Veja @index.html@ - para as notícias agradáveis. - - - Pois então. Está tudo em suas mãos agora. Bem vindo ao Ruby. - - - !i/tigers.vest-4.gif(The tiger finds a new home and learns to eventually move on.)! - - -# -# Assim como o sol se pões e eu tenho que chamá-lo Paij-plo, Eu checo o tempo. -# -# -# bq. @puts Time.now@ -# -# which prints: @Sun Sep 12 18:34:50 EDT 2004@ -# -# -# Paij-plo se debruça no meu ombro, "E então está (re-eep) devorado." -# -# -# Quando ele diz isto, minha espinha escapa das minhas costas. É uma religião -# inteira (aterrorizado) e ela surge neste coloquialismo barato. Quando Paij-plo -# começa sua solente _é hora de comer_ ou seu _ele está bem atrás de nós_ falatório. -# -# -# Eu acho que havia um tempo em Endertromb quando todos viviam sem a morte. Paij-plo -# diz um "homem pantera" caíu em um enorme abismo, um túnel profundo ao redor do -# planeta. Seu corpo foi encontrado do outro lado do planeta. Mas ele não tinha ferimentos, seu -# corpo estava quente. Ele estava morto por apenas um segundo. -# -# -# Seu corpo ficou morto por um segundo. Continuou quente e nunca apodreceu. -# -# Eb-F-F-A. Então, Bb-D-D-F. - - -# Dr. Cham virou-se para a cabra. "Você sabe trabalhar com estes controles, né? Eu preciso -# arquivar um programa." -# -# -# " -# A cabra lançou suas pernas sobre o painel e com isto afrouxou algumas maçanetas suntuosas em um array de posições -# até que um slot abriu na base, do qual derramou uma longa corrente de prata. No final da corrente -# balançava uma densa retainer do tamanho de um filé de peixe. - + - > + h3. Tab Completion + + + Uma característica do Irb raramente mencionada é a vantagem do recurso de auto-completar com a tecla TAB. + Este tópico é um pouco de tabu no momento, uma vez que trabalhar com ele no Windows é um tanto horroroso. + (Não, não tenha medo. Agora, mais do que nunca, olhe à sua direita.) + + Se você estiver no Linux ou no FreeBSD, o recurso de auto-completar com a tecla TAB deverá funcionar imediatamente. + E se estiver usando OS X, você deverá ter certeza que está atualizado para última versão 1.8 e quando executar o Irb, use: + + <pre class="text"> + irb --readline -r irb/completion + </pre> + + + Basicamente, quando você teclar _TAB_, o Irb tentará adivinhar o que você está tentando digitar. + Tente digitar: @[].col@ e tecle _TAB_. o Irb finalizará isto. @[].collect@ e isto levará + seu cursor até o final então você pode adicionar mais conteúdo. + + + Se existem várias combinações, apenas teclar _TAB_ não adiantará. Mas pressione duas vezes + e o Ruby lhe dará uma lista completa de possíveis combinações. + + + Isto é ótimo se você quer apenas ver todos os metodos para um certo objeto. Digite em qualquer + número, um ponto, e use _TAB_. + + + <pre class="text"> + >> 42. + 42.floor 42.next 42.step + 42.__id__ 42.freeze 42.nil? 42.succ + 42.__send__ 42.frozen? 42.nonzero? 42.taint + 42.abs 42.hash 42.object_id 42.tainted? + 42.between? 42.id 42.prec 42.times + 42.ceil 42.id2name 42.prec_f 42.to_f + 42.chr 42.inspect 42.prec_i 42.to_i + 42.class 42.instance_eval 42.private_methods 42.to_int + 42.clone 42.instance_of? 42.protected_methods 42.to_s + 42.coerce 42.instance_variable_get 42.public_methods 42.to_sym + 42.display 42.instance_variable_set 42.quo 42.truncate + 42.div 42.instance_variables 42.remainder 42.type + 42.divmod 42.integer? 42.respond_to? 42.untaint + 42.downto 42.is_a? 42.round 42.upto + 42.dup 42.kind_of? 42.send 42.zero? + 42.eql? 42.method 42.singleton_method_added + 42.equal? 42.methods 42.singleton_methods + 42.extend 42.modulo 42.size + </pre> + + + Agora, tentando teclar @Kernel::@ e depois _TAB_. Todos os métodos do core. Nunca esqueça disto + e use o tempo todo. + + + !i/tigers.vest-3.gif(Except the robot flew away and the ice gun went on and on...)! + + + Ok, uma última coisa então vou parar de incomodar com toda esta ótima tecnologia. + Mas eu vou ter que falar isto alto, então tapem os ouvidos! Estou do outro lado do mundo, galera, mas o + volume vem do céu -- a bold, red crescendo of -- + + + h1={font-size:84pt; color:#FDD; line-height: 120%}. ((%{color:#A53}ri%)) + + + h3={color: #300}. (Ruby's Own 411 or 555-1212 or _Yes, Operator, Get Belgrade on the Line_ -- I'll + Venha cá -- Apenas batendo na tecla "jogo da velha" até alguém atender... + + + E o Ri atende. "Aqui é o Ri. Classe e dois pontos, por favor" + + + Você entra correndo, "Isto é a instância de um metodo, Operador. Enumerável#zip." + + + <pre class="text"> + ri Enumerable#zip + </pre> + + + Sem demora, corrija no seu display (tão rápido que até o gato sentado na + quina estica o pescoço, boceja e alcança a sua caneca real _A coisa mais + barulhenta desde Michael Dorn_): + + + <pre class="text"> + --------------------------------------------------------- Enumerable#zip + enum.zip(arg, ...) => array + enum.zip(arg, ...) {|arr| block } => nil + ------------------------------------------------------------------------ + Converte qualquer argumento em array, então une elementos de _enum_ + com elementos correpondentes de cada argumento. Isto gera uma + sequência de +enum#size+ _n_-element arrays, onde _n_ é um a mais + que a conta de argumentos. Se o tamanho de algum argumento é menos + que +enum#size+, valores de +nil+ são providênciados. Se é dado um + bloco, este é convocado para cada saída do array, caso contrário um + array de arrays é retornado. + + a = [ 4, 5, 6 ] + b = [ 7, 8, 9 ] + + (1..3).zip(a, b) #=> [[1, 4, 7], [2, 5, 8], [3, 6, 9]] + "cat\ndog".zip([1]) #=> [["cat\n", 1], ["dog", nil]] + (1..3).zip #=> [[1], [2], [3]] + </pre> + + + Isto é um dicinário íntegro de Ruby -- O poder de apenas perguntar está na ponta + de seus dedos -- não diga que nunca ouviu sobre este nenhum-dinheiro-supre-uma-vida-inteira-de + explicações-apropriadas!_ + + + Para ter uma explicação de qualquer classe, junto com diretório completo para + todos seus metodos, todos com uma voz suave que serve para acalmar qualquer um de + vocês cosmonautas em pânico aí lutando contra a atração de um raio trator de tolerância zero, + apenas use na shell: @ri Class@. + + + Mas para ajudar nos metodos da classe, você tira da manga: @ri Class::method@. + + + Apesar de metodos de instância usarem o jogo da velha ao invés do ponto. (Uma vez que ponto pode significar class *ou* + métodos de instância.) Digo: @ri Class#method@. + + + A completa distribuição das classe, uma lista completa desde o mais alto topo até o centro da Terra, + pode ser alcançado com @ri -c@. + + + e além do texto, você pode fazer HTML: @ri -Tf html String#gsub > gsub.html@. + + + *Ou mostrar ANSI colorido: @ri -Tf ansi String#gsub@.* E este é ultimo e o melhor. + + + h3. Dentro do Painel de controle do Ri + + + Atrá do Ri cantam um coro de vozes humanas, primeiramente Dave Thomas, um autor de _Programming + Ruby_, e absolutamente o pai adotivo americano do Ruby. Muitos destes discursos elaborado + do Ri são diretamente das referencias de _Programming Ruby_. Não esqueça de + agradecer ao Dave periodicamente. + + + O Ri extrai seu exuberante conjunto de informações do mesmo código que o Ruby é construído. Em cada um dos + arquivos de código contidos no armário de arquivo da chefia Ruby, comentários detalhados + descrevem tudo claramente. + + + Na classe @date@ de Ruby, aqui temos métodos bem comentados: + + + <pre> + # Obtenha o tempo desta data como [horas, minutos, segundos, + # fração de segundos] + def time() self.class.day_fraction_to_time(day_fraction) end + + # Obtenha a hora desta data. + def hour() time[0] end + + # Obtenha o minuto desta data. + def min() time[1] end + </pre> + + + Os comentários surgem no Ri. Digitamos: @ri Date#time@. + + + <pre class="text"> + -------------------------------------------------------------- Date#time + time() + ------------------------------------------------------------------------ + Get the time of this date as [hours, minutes, seconds, + fraction_of_a_second] + + </pre> + + + O Ri advinha muito de como um método funciona, embora espera que os codificadores + escrevam uma breve descrição nos comentários, pouco antes da definição de um método ou classe. + Eu sugeriria que sempre que for escrever um método, adicione uma breve descrição + nos comentários antes daquele método. Em tempo, você pode gerar uma + documentação Ri para aquele método. + + + Você também pode usar alguns caracteres especiais para aumentar sua descrição. Por + exemplo, se você indentar um parágrafo e usar um asterisco @*@ ou um hífen @-@ + pouco antes das letras da primeira frase, o parágrafo será reconhecido como um + ítem de lista. Então, se a sua descrição precisa ser convertida para HTML, você + verá o ítem de lista aparecer como uma lista de HTML desordenada. + + + <pre> + # Obtenha o tempo desta data como um array de: + # * horas + # * minutos + # * segundos + # * fração de segundos + def time() self.class.day_fraction_to_time(day_fraction) end + </pre> + + + Outra regras semelhantes: Listas que começam com digitos seguidos de períodos, + são reconhecidas como listas numéricas. Palavras enfatizadas são cercadas por traço baixo(underscore), + palavras em negrito por asteriscos, palavras em código por sinais de soma. Exemplos são simples blocos + de texto indentados por alguns espaços. Todas estas regras juntas são chamadas RDoc. + + + Aqui está um pedaço do RDoc do método @initialize@ em um dos meus projetos + chamado RedCloth. Observe o exemplo identado bem como a classe Ruby e + nomes de métodos alinhados com sinais de soma. + + + <pre> + # + # Retorna um novo objeto RedCloth, baseado em +String+ e + # cumprindo todas as +restrições+ incluídas. + # + # r = RedCloth.new( "h1. A <b>bold</b> man", [:filter_html] ) + # r.to_html + # #=>"<h1>A &lt;b&gt;bold&lt;/b&gt; man</h1>" + # + def initialize( string, restrictions = [] ) + @lite = false + restrictions.each { |r| method( "#{ r }=" ).call( true ) } + super( string ) + end + </pre> + + + Para a série completa de regras RDoc veja a seção *Markup* do + "README":http://rdoc.sourceforge.net/doc/files/README.html. + + + h3. Impulsionando seu próprio Ri + + + O Ri porém não lê automáticamente seus arquivos para você. Você tem que guiá-lo, + mostrar o caminho. Mude para o diretório do código que você gostaria de examinar. Então, + use a ferramenta RDoc para executar. + + + <pre class="text"> + cd ~/cvs/your-code + rdoc --ri-site + </pre> + + + Agora, tente usar @ri SuaClasse@ para assegurar que todas as suas descrições estão aparecendo + apropriadamente. + Se você quer fazer documentação HTML, tente isto: + + + <pre class="text"> + cd ~/cvs/your-code + rdoc + </pre> + + + O diretório @~/cvs/seu-código@ deverá agora também ter um diretório @doc@ + recente contendo documentação HTML para todas as suas classes. Veja @index.html@ + para as notícias agradáveis. + + + Pois então. Está tudo em suas mãos agora. Bem vindo ao Ruby. + + + !i/tigers.vest-4.gif(The tiger finds a new home and learns to eventually move on.)! + + +# +# Assim como o sol se pões e eu tenho que chamá-lo Paij-plo, Eu checo o tempo. +# +# +# bq. @puts Time.now@ +# +# which prints: @Sun Sep 12 18:34:50 EDT 2004@ +# +# +# Paij-plo se debruça no meu ombro, "E então está (re-eep) devorado." +# +# +# Quando ele diz isto, minha espinha escapa das minhas costas. É uma religião +# inteira (aterrorizado) e ela surge neste coloquialismo barato. Quando Paij-plo +# começa sua solente _é hora de comer_ ou seu _ele está bem atrás de nós_ falatório. +# +# +# Eu acho que havia um tempo em Endertromb quando todos viviam sem a morte. Paij-plo +# diz um "homem pantera" caíu em um enorme abismo, um túnel profundo ao redor do +# planeta. Seu corpo foi encontrado do outro lado do planeta. Mas ele não tinha ferimentos, seu +# corpo estava quente. Ele estava morto por apenas um segundo. +# +# +# Seu corpo ficou morto por um segundo. Continuou quente e nunca apodreceu. +# +# Eb-F-F-A. Então, Bb-D-D-F. + + +# Dr. Cham virou-se para a cabra. "Você sabe trabalhar com estes controles, né? Eu preciso +# arquivar um programa." +# +# +# " +# A cabra lançou suas pernas sobre o painel e com isto afrouxou algumas maçanetas suntuosas em um array de posições +# até que um slot abriu na base, do qual derramou uma longa corrente de prata. No final da corrente +# balançava uma densa retainer do tamanho de um filé de peixe. + lang-pt/poignant-86.yml @@ -1,359 +1,359 @@ -body { - background-image: url(i/2006.pale.jpg); - color: #222; - font-family: Utopia, Georgia, Times, serif; - line-height: 110%; - margin: 0; - padding: 0; -} -body.chapter { - padding-bottom: 36px; -} -body.expansion { - background: url(i/2006.pakback.png); - padding-bottom: 36px; -} -h1, h2, h3, h4, h5, h6 { - margin: 5px; - padding: 0; -} -h1 { - font-size: 2.2em; -} -#wrapper { - z-index: 10; -} -#main h2, .content h2 { - border-bottom: solid 1px #BBB; - font-size: 1.4em; - line-height: 130%; -} -.content h2 { - margin: 32px 5px 8px 5px; -} -#main h3, .content h3 { - font-size: 1.2em; - line-height: 120%; -} -.content h3 { - margin: 18px 5px 8px 5px; - border-bottom: solid 1px #CCC; -} -strong, em { - font-size: 1.1em; -} -a img { - border: 0; -} -blockquote { - font-style: italic; - font-size: larger; - line-height: 1.2; - color: #435; - margin: 0 75px; -} -blockquote .attrib { - display: block; - text-align: right; - font-style: normal; - font-variant: small-caps; -} -blockquote code, p code, li code { - color: #936; - font-style: normal; - background-color: #FFFEF9; - padding: 2px; - line-height: 170%; - font-size: 12pt; -} -blockquote code { - padding: 5px; - font-size: .9em; -} -.example { - border: solid 1px #C9B; - background-color: #FFF5F9; - padding: 3px; - margin: 5px 40px 5px 22px; -} -table { - padding: 5px 20px; -} -table td { - padding-right: 8px; -} -pre { - background-color: #FFFEF9; - padding: 5px; - margin: 0px; - color: #936; - line-height: 170%; -} -#sidepane { - float: left; - width: 420px; - z-index: 20; -} -#bookplate { - margin: 0; padding: 0; -} -#bookcontents { - background: url(i/2006.contents.jpg) no-repeat; - margin: 0; padding: 55px 120px 40px 20px; - margin-top: -3px; - font-size: 9pt; -} -#bookcontents ol li ol { - list-style: lower-alpha; -} -#bookseal { - position: absolute; - top: 433px; - left: 147px; - z-index: 2; -} -/* set the image to use and establish the lower-right position */ -.foxbox, .foxbox_body, .foxbox_head -{ - background: transparent url(i/2006.foxbox.jpg) no-repeat bottom right; -} -/* set the top-right image */ -.foxbox_head -{ - background-position: top left; - margin-right: -15px; /* pull the right image over on top of border */ - padding-right: 40px; /* right-image-gap + right-inside padding */ -} -/* set the top-left image */ -.foxbox_head h3 -{ - margin: 0; /* reset main site styles*/ - border: 0; /* ditto */ - padding: 10px 0 10px 30px; /* padding-left = image gap + interior padding ... no padding-right */ - height: auto !important; height: 1%; /* IE Holly Hack */ -} -/* set the lower-left corner image */ -.foxbox_body -{ - background-position: bottom left; - margin-right: 25px; /* interior-padding right */ - padding: 5px 0 15px 40px; /* mirror .foxbox_head right/left */ -} -.foxbox_body p { - font-size: 9pt; - margin: 8px; - padding: 0 10px 0 40px; - line-height: 120%; -} -#cornerkick { - z-index: 1; - position: absolute; - top: 1800px; - right: 0px; -} -.toc { - padding-left: 30px; -} -.toc ul { - margin: 0px; - padding: 0px; -} -.toc li { - font-size: .8em; - line-height: 140%; -} -.content li { - line-height: 170%; - padding: 10px 4px; -} -.content p { - line-height: 170%; -} -#main { - padding-top: 20px; - margin-left: 410px; -} -#main li { - font-size: 1.2em; -} -#main li ul li { - color: #666; - font-size: .8em; - list-style: none; -} -p { - margin: 0px 40px 0px 0px; - line-height: 20px; - padding: 10px; -} -p#terms { - font-size: .8em; - line-height: 140%; -} -.sidebar { - color: #000; - background-image: url(i/2006.pale.jpg); - width: 280px; - float: right; - padding: 0; - margin: 0; - margin-left: 14px; - z-index: 15; -} -.sidebar ul { - margin-top: 0px; -} -.sidebar li { - font-size: .9em; - line-height: 120%; - padding: 10px 4px; -} -.sidebar h1 { - background-color: #7A8A9A; - color: #EFF9ED; - text-align: center; - margin: 0; - padding: 4px; - font-size: .9em; -} -.sidebar h2 { - color: #555; - font-size: 1.0em; - border-bottom: solid 4px #CCC; - margin: 0; - padding: 10px; -} -.sidebar p { - font-size: .9em; - margin: 5px; - padding: 10px; -} -.sidebar blockquote { - background-color: #FFFFFF; - color: #666666; - font-size: .8em; - width: auto; - margin: 0px 14px; -} -.sidebar pre { - border: none; - background-color: #E6EDF3; - color: #334465; - font-weight: normal; - font-size: .9em; - margin: 5px; - padding: 0px; - line-height: 120%; -} -.bulletin { - background-color: #FFF; - color: #555; - padding: 5px; - font-size: .7em; -} - -#banner, #footer { - color: #4A4A4A; - padding: 0; - padding-top: 10px; - width: 850px; - margin: 0px auto; -} -#banner { - padding-top: 20px; -} -#footer { - padding-bottom: 20px; -} -#banner .pager, -#footer .pager { - float: right; - padding-top: 15px; - padding-right: 15px; - font-size: 11pt; -} -#banner .pagebar, -#footer .pagebar { - font-size: 11pt; -} -#container { - background: url(i/2006.bookstripe.gif) bottom left repeat-x; - width: 850px; - margin: 0px auto; - text-align: center; - padding: 0; - padding-bottom: 4px; -} -.page { - background: white url(i/2006.bookstripe.gif) top left repeat-x; - padding: 12px; - padding-right: 0; - margin: 0; -} -body.expansion #container { - background: url(i/2006.pakstripe.png) bottom left repeat-x; -} -body.expansion .page { - background: white url(i/2006.pakstripe.png) top left repeat-x; -} -body.expansion #banner { - color: #eee; -} -body.expansion #banner a:link, -body.expansion #banner a:visited, -body.expansion #banner a:active { - color: #cdf; -} -body.expansion #banner a:hover { - color: #ffc; -} -.pageLinks { - padding: 8px 5px; - text-align: left; - font-size: 9pt; -} -.content { - text-align: left; -} -.pageTitle { - line-height: 200%; - width: 600px; - margin: 0px auto; - text-align: center; -} -.pageTitle p { - margin: 0px; - line-height: 20px; - padding: 10px; -} - -/* printing */ -@page { size 8.5in 11in; margin: 0cm; } - -/* syntax highlighting */ -.keyword { - font-weight: bold; -} -.comment { - color: #555; -} -.string, .number { - color: #396; -} -.string { - background-color: #E9F5F5; -} -.regex { - background-color: #E9F1F5; - color: #435; -} -.ident { - color: #369; -} -.symbol { - color: #000; -} -.constant, .class { - color: #630; - font-weight: bold; -} +body { + background-image: url(i/2006.pale.jpg); + color: #222; + font-family: Utopia, Georgia, Times, serif; + line-height: 110%; + margin: 0; + padding: 0; +} +body.chapter { + padding-bottom: 36px; +} +body.expansion { + background: url(i/2006.pakback.png); + padding-bottom: 36px; +} +h1, h2, h3, h4, h5, h6 { + margin: 5px; + padding: 0; +} +h1 { + font-size: 2.2em; +} +#wrapper { + z-index: 10; +} +#main h2, .content h2 { + border-bottom: solid 1px #BBB; + font-size: 1.4em; + line-height: 130%; +} +.content h2 { + margin: 32px 5px 8px 5px; +} +#main h3, .content h3 { + font-size: 1.2em; + line-height: 120%; +} +.content h3 { + margin: 18px 5px 8px 5px; + border-bottom: solid 1px #CCC; +} +strong, em { + font-size: 1.1em; +} +a img { + border: 0; +} +blockquote { + font-style: italic; + font-size: larger; + line-height: 1.2; + color: #435; + margin: 0 75px; +} +blockquote .attrib { + display: block; + text-align: right; + font-style: normal; + font-variant: small-caps; +} +blockquote code, p code, li code { + color: #936; + font-style: normal; + background-color: #FFFEF9; + padding: 2px; + line-height: 170%; + font-size: 12pt; +} +blockquote code { + padding: 5px; + font-size: .9em; +} +.example { + border: solid 1px #C9B; + background-color: #FFF5F9; + padding: 3px; + margin: 5px 40px 5px 22px; +} +table { + padding: 5px 20px; +} +table td { + padding-right: 8px; +} +pre { + background-color: #FFFEF9; + padding: 5px; + margin: 0px; + color: #936; + line-height: 170%; +} +#sidepane { + float: left; + width: 420px; + z-index: 20; +} +#bookplate { + margin: 0; padding: 0; +} +#bookcontents { + background: url(i/2006.contents.jpg) no-repeat; + margin: 0; padding: 55px 120px 40px 20px; + margin-top: -3px; + font-size: 9pt; +} +#bookcontents ol li ol { + list-style: lower-alpha; +} +#bookseal { + position: absolute; + top: 433px; + left: 147px; + z-index: 2; +} +/* set the image to use and establish the lower-right position */ +.foxbox, .foxbox_body, .foxbox_head +{ + background: transparent url(i/2006.foxbox.jpg) no-repeat bottom right; +} +/* set the top-right image */ +.foxbox_head +{ + background-position: top left; + margin-right: -15px; /* pull the right image over on top of border */ + padding-right: 40px; /* right-image-gap + right-inside padding */ +} +/* set the top-left image */ +.foxbox_head h3 +{ + margin: 0; /* reset main site styles*/ + border: 0; /* ditto */ + padding: 10px 0 10px 30px; /* padding-left = image gap + interior padding ... no padding-right */ + height: auto !important; height: 1%; /* IE Holly Hack */ +} +/* set the lower-left corner image */ +.foxbox_body +{ + background-position: bottom left; + margin-right: 25px; /* interior-padding right */ + padding: 5px 0 15px 40px; /* mirror .foxbox_head right/left */ +} +.foxbox_body p { + font-size: 9pt; + margin: 8px; + padding: 0 10px 0 40px; + line-height: 120%; +} +#cornerkick { + z-index: 1; + position: absolute; + top: 1800px; + right: 0px; +} +.toc { + padding-left: 30px; +} +.toc ul { + margin: 0px; + padding: 0px; +} +.toc li { + font-size: .8em; + line-height: 140%; +} +.content li { + line-height: 170%; + padding: 10px 4px; +} +.content p { + line-height: 170%; +} +#main { + padding-top: 20px; + margin-left: 410px; +} +#main li { + font-size: 1.2em; +} +#main li ul li { + color: #666; + font-size: .8em; + list-style: none; +} +p { + margin: 0px 40px 0px 0px; + line-height: 20px; + padding: 10px; +} +p#terms { + font-size: .8em; + line-height: 140%; +} +.sidebar { + color: #000; + background-image: url(i/2006.pale.jpg); + width: 280px; + float: right; + padding: 0; + margin: 0; + margin-left: 14px; + z-index: 15; +} +.sidebar ul { + margin-top: 0px; +} +.sidebar li { + font-size: .9em; + line-height: 120%; + padding: 10px 4px; +} +.sidebar h1 { + background-color: #7A8A9A; + color: #EFF9ED; + text-align: center; + margin: 0; + padding: 4px; + font-size: .9em; +} +.sidebar h2 { + color: #555; + font-size: 1.0em; + border-bottom: solid 4px #CCC; + margin: 0; + padding: 10px; +} +.sidebar p { + font-size: .9em; + margin: 5px; + padding: 10px; +} +.sidebar blockquote { + background-color: #FFFFFF; + color: #666666; + font-size: .8em; + width: auto; + margin: 0px 14px; +} +.sidebar pre { + border: none; + background-color: #E6EDF3; + color: #334465; + font-weight: normal; + font-size: .9em; + margin: 5px; + padding: 0px; + line-height: 120%; +} +.bulletin { + background-color: #FFF; + color: #555; + padding: 5px; + font-size: .7em; +} + +#banner, #footer { + color: #4A4A4A; + padding: 0; + padding-top: 10px; + width: 850px; + margin: 0px auto; +} +#banner { + padding-top: 20px; +} +#footer { + padding-bottom: 20px; +} +#banner .pager, +#footer .pager { + float: right; + padding-top: 15px; + padding-right: 15px; + font-size: 11pt; +} +#banner .pagebar, +#footer .pagebar { + font-size: 11pt; +} +#container { + background: url(i/2006.bookstripe.gif) bottom left repeat-x; + width: 850px; + margin: 0px auto; + text-align: center; + padding: 0; + padding-bottom: 4px; +} +.page { + background: white url(i/2006.bookstripe.gif) top left repeat-x; + padding: 12px; + padding-right: 0; + margin: 0; +} +body.expansion #container { + background: url(i/2006.pakstripe.png) bottom left repeat-x; +} +body.expansion .page { + background: white url(i/2006.pakstripe.png) top left repeat-x; +} +body.expansion #banner { + color: #eee; +} +body.expansion #banner a:link, +body.expansion #banner a:visited, +body.expansion #banner a:active { + color: #cdf; +} +body.expansion #banner a:hover { + color: #ffc; +} +.pageLinks { + padding: 8px 5px; + text-align: left; + font-size: 9pt; +} +.content { + text-align: left; +} +.pageTitle { + line-height: 200%; + width: 600px; + margin: 0px auto; + text-align: center; +} +.pageTitle p { + margin: 0px; + line-height: 20px; + padding: 10px; +} + +/* printing */ +@page { size 8.5in 11in; margin: 0cm; } + +/* syntax highlighting */ +.keyword { + font-weight: bold; +} +.comment { + color: #555; +} +.string, .number { + color: #396; +} +.string { + background-color: #E9F5F5; +} +.regex { + background-color: #E9F1F5; + color: #435; +} +.ident { + color: #369; +} +.symbol { + color: #000; +} +.constant, .class { + color: #630; + font-weight: bold; +} scripts/layout/guide.css @@ -1,222 +1,222 @@ -require 'erb' -require 'ftools' -require 'yaml' -require 'rubygems' -require 'redcloth' -require 'syntax/convertors/html' - -class Localization - attr_accessor :locale, :version, :next_page, :previous_page, :encoding, - :turn_page, :header_title, :open_the_book, :written_by, - :sidebar, :contents, :expansion_pak, :expansion_pak_no, - :expansion_paks, :adverrtissements, :see_also, :english_version, - :header_title_emphasis - def self.load( file_name ) - l = self.new - YAML::load( File.open( file_name ) ).each do |k, v| - v = RedCloth.new(v).to_html if ['written_by', 'header_title'].include? k - l.instance_variable_set( "@#{k}", v ) - end - l.header_title_emphasis = l.header_title.gsub /\(([^)]+)\)/, '<span class="hilite">\1</span>' - l - end -end - -# Redefines to accomodate tests -class RedCloth - SYNTAX_CONVERT = Syntax::Convertors::HTML.for_syntax "ruby" - - # Intercept some Kernel calls for the cause of testing. - def loop - yield - end - - # Conversion to HTML - alias _to_html to_html - def to_html - @vars = {} - txt = self.dup - txt.gsub!( %r{<(setup|stdout)>(.+?)</\1>}m ) do |var| - ( @vars[$1] ||= [] ) << $2 - "## @#$1[#{@vars[$1].length-1}]" - end - txt.gsub!( %r{<pre>(.+?)</pre>}m ) do - "<pre>" + test_example( $1.strip ) + "</pre>" - end - txt._to_html. - gsub( %r{<pre>(.+?)</pre>}m ) do - "<div class='example'><pre><code> #{test_example $1.strip}</code></pre></div>" - end. - gsub( %r{<pre([^>]+)>\n*(.+?)</pre>}m ) do - "<div class='example'><pre#{$1}>#{$2}</pre></div>" - end. - gsub( %r{<code>([^%].*?)</code>}m ) do - SYNTAX_CONVERT.convert( $1.gsub( '&gt;', '>' ).gsub( '&lt;', '<' ).gsub( '&#38;', '&' ) ). - gsub( %r{^<pre>}, '<code>' ).gsub( %r{</pre>$}, '</code>' ) - end - end - def test_example( x ) - # begin - # eval( x.gsub( /^## @(\w+)\[(\d+)\]/ ) { @vars[$1][$2.to_i] } ) - # rescue Exception => e - # puts "*** Example failed ***", x, "--- Exception ---", e - # exit - # end - x.gsub( /^\s*## @(\w+)\[(\d+)\]/, '' ) - end -end - -module WhyTheLuckyStiff - -class Book - attr_accessor :author, :title, :terms, :image, :teaser, :chapters, :expansion_paks - def self.load( file_name ) - YAML::load( File.open( file_name ) ) - end -end - -class Section - attr_accessor :index, :header, :content - def initialize( i, h, c ) - @index, @header, @content = i, RedCloth::new( h.to_s, [:lite_mode] ), RedCloth::new( c.to_s ) - end -end - -class Sidebar - attr_accessor :title, :content -end - -YAML::add_domain_type( 'whytheluckystiff.net,2003', 'sidebar' ) do |taguri, val| - title = val.keys.first - YAML::object_maker( Sidebar, 'title' => ( RedCloth::new( title, [:lite_mode] ) if title ), 'content' => RedCloth::new( val.values.first ) ) -end -class Chapter - attr_accessor :index, :title, :sections - def initialize( i, t, sects ) - @index = i - @title = RedCloth::new( t, [:lite_mode] ) - i = 0 - @sections = sects.collect do |s| - if s.respond_to?( :keys ) - i += 1 - Section.new( i, s.keys.first, s.values.first ) - else - s - end - end - end -end - -YAML::add_domain_type( 'whytheluckystiff.net,2003', 'book' ) do |taguri, val| - ['chapters', 'expansion_paks'].each do |chaptype| - i = 0 - val[chaptype].collect! do |c| - i += 1 - Chapter::new( i, c.keys.first, c.values.first ) - end - end - val['teaser'].collect! do |t| - Section::new( 1, t.keys.first, t.values.first ) - end - val['terms'] = RedCloth::new( val['terms'] ) - val['title'] = RedCloth::new( val['title'], [:lite_mode] ) - YAML::object_maker( Book, val ) -end - -class Image - attr_accessor :file_name -end - -YAML::add_domain_type( 'whytheluckystiff.net,2003', 'img' ) do |taguri, val| - YAML::object_maker( Image, 'file_name' => "i/" + val ) -end -end - -# -# Convert the book to HTML -# -if __FILE__ == $0 - unless ARGV[0] - puts "Usage: #{$0} /path/to/save/html [en|fr|...]" - exit - end - - scripts = File.dirname(__FILE__) - $:.unshift scripts - - # external libs - Dir[File.expand_path('../lib/ext-*', scripts)].each do |path| - $:.unshift path - end - locale = "en" # default value - - if ARGV[1] - # Localisation: fr, br .. - locale = ARGV[1] - end - - book = "lang-#{locale}/poignant.yml" - loc_file = "lang-#{locale}/localization.yml" - - language = Localization.load( loc_file ) - raise NotImplementedError.new("Language #{locale} not yet supported") unless language - - site_path = ARGV[0] - - # FIXME: create given path if it does not exist. - if File.exists?( site_path ) - if !File.directory?( site_path ) - $stderr.puts "#{site_path} is not a directory" ## FIXME: raise would be better - exit 1 - end - else - File.makedirs( site_path ) - end - - book = WhyTheLuckyStiff::Book::load( book ) - chapter = nil - - # Write index page - index_tpl = ERB::new( File.open( "#{ scripts }/layout/index.erb" ).read ) - File.open( File.join( site_path, 'index.html' ), 'w' ) do |out| - out << index_tpl.result - end - - # Write chapter pages - chapter_tpl = ERB::new( File.open( "#{ scripts }/layout/chapter.erb" ).read ) - body_class = "chapter" - url_pre = "chapter" - collection = book.chapters - collection.each do |chapter| - File.open( File.join( site_path, "chapter-#{ chapter.index }.html" ), 'w' ) do |out| - out << chapter_tpl.result( binding ) - end - end - - # Write expansion pak pages - expak_tpl = ERB::new( File.open( "#{ scripts }/layout/chapter.erb" ).read ) - body_class = "expansion" - url_pre = "expansion-pak" - collection = book.expansion_paks - collection.each do |chapter| - File.open( File.join( site_path, "expansion-pak-#{ chapter.index }.html" ), 'w' ) do |out| - out << expak_tpl.result( binding ) - end - end - - # Write printable version - print_tpl = ERB::new( File.open( "#{ scripts }/layout/print.erb" ).read ) - File.open( File.join( site_path, "print.html" ), 'w' ) do |out| - out << print_tpl.result - end - - # Copy css + images into site - - File.makedirs( File.join( site_path, "i" ) ) - File.copy( "#{ scripts }/layout/guide.css", "#{ site_path }/guide.css" ) - Dir["#{ scripts }/images/*"].each do |copy_file| - next if File.directory? copy_file - File.copy( copy_file, File.join( site_path, "i", File.basename( copy_file ) ) ) - end -end - +require 'erb' +require 'ftools' +require 'yaml' +require 'rubygems' +require 'redcloth' +require 'syntax/convertors/html' + +class Localization + attr_accessor :locale, :version, :next_page, :previous_page, :encoding, + :turn_page, :header_title, :open_the_book, :written_by, + :sidebar, :contents, :expansion_pak, :expansion_pak_no, + :expansion_paks, :adverrtissements, :see_also, :english_version, + :header_title_emphasis + def self.load( file_name ) + l = self.new + YAML::load( File.open( file_name ) ).each do |k, v| + v = RedCloth.new(v).to_html if ['written_by', 'header_title'].include? k + l.instance_variable_set( "@#{k}", v ) + end + l.header_title_emphasis = l.header_title.gsub /\(([^)]+)\)/, '<span class="hilite">\1</span>' + l + end +end + +# Redefines to accomodate tests +class RedCloth + SYNTAX_CONVERT = Syntax::Convertors::HTML.for_syntax "ruby" + + # Intercept some Kernel calls for the cause of testing. + def loop + yield + end + + # Conversion to HTML + alias _to_html to_html + def to_html + @vars = {} + txt = self.dup + txt.gsub!( %r{<(setup|stdout)>(.+?)</\1>}m ) do |var| + ( @vars[$1] ||= [] ) << $2 + "## @#$1[#{@vars[$1].length-1}]" + end + txt.gsub!( %r{<pre>(.+?)</pre>}m ) do + "<pre>" + test_example( $1.strip ) + "</pre>" + end + txt._to_html. + gsub( %r{<pre>(.+?)</pre>}m ) do + "<div class='example'><pre><code> #{test_example $1.strip}</code></pre></div>" + end. + gsub( %r{<pre([^>]+)>\n*(.+?)</pre>}m ) do + "<div class='example'><pre#{$1}>#{$2}</pre></div>" + end. + gsub( %r{<code>([^%].*?)</code>}m ) do + SYNTAX_CONVERT.convert( $1.gsub( '&gt;', '>' ).gsub( '&lt;', '<' ).gsub( '&#38;', '&' ) ). + gsub( %r{^<pre>}, '<code>' ).gsub( %r{</pre>$}, '</code>' ) + end + end + def test_example( x ) + # begin + # eval( x.gsub( /^## @(\w+)\[(\d+)\]/ ) { @vars[$1][$2.to_i] } ) + # rescue Exception => e + # puts "*** Example failed ***", x, "--- Exception ---", e + # exit + # end + x.gsub( /^\s*## @(\w+)\[(\d+)\]/, '' ) + end +end + +module WhyTheLuckyStiff + +class Book + attr_accessor :author, :title, :terms, :image, :teaser, :chapters, :expansion_paks + def self.load( file_name ) + YAML::load( File.open( file_name ) ) + end +end + +class Section + attr_accessor :index, :header, :content + def initialize( i, h, c ) + @index, @header, @content = i, RedCloth::new( h.to_s, [:lite_mode] ), RedCloth::new( c.to_s ) + end +end + +class Sidebar + attr_accessor :title, :content +end + +YAML::add_domain_type( 'whytheluckystiff.net,2003', 'sidebar' ) do |taguri, val| + title = val.keys.first + YAML::object_maker( Sidebar, 'title' => ( RedCloth::new( title, [:lite_mode] ) if title ), 'content' => RedCloth::new( val.values.first ) ) +end +class Chapter + attr_accessor :index, :title, :sections + def initialize( i, t, sects ) + @index = i + @title = RedCloth::new( t, [:lite_mode] ) + i = 0 + @sections = sects.collect do |s| + if s.respond_to?( :keys ) + i += 1 + Section.new( i, s.keys.first, s.values.first ) + else + s + end + end + end +end + +YAML::add_domain_type( 'whytheluckystiff.net,2003', 'book' ) do |taguri, val| + ['chapters', 'expansion_paks'].each do |chaptype| + i = 0 + val[chaptype].collect! do |c| + i += 1 + Chapter::new( i, c.keys.first, c.values.first ) + end + end + val['teaser'].collect! do |t| + Section::new( 1, t.keys.first, t.values.first ) + end + val['terms'] = RedCloth::new( val['terms'] ) + val['title'] = RedCloth::new( val['title'], [:lite_mode] ) + YAML::object_maker( Book, val ) +end + +class Image + attr_accessor :file_name +end + +YAML::add_domain_type( 'whytheluckystiff.net,2003', 'img' ) do |taguri, val| + YAML::object_maker( Image, 'file_name' => "i/" + val ) +end +end + +# +# Convert the book to HTML +# +if __FILE__ == $0 + unless ARGV[0] + puts "Usage: #{$0} /path/to/save/html [en|fr|...]" + exit + end + + scripts = File.dirname(__FILE__) + $:.unshift scripts + + # external libs + Dir[File.expand_path('../lib/ext-*', scripts)].each do |path| + $:.unshift path + end + locale = "en" # default value + + if ARGV[1] + # Localisation: fr, br .. + locale = ARGV[1] + end + + book = "lang-#{locale}/poignant.yml" + loc_file = "lang-#{locale}/localization.yml" + + language = Localization.load( loc_file ) + raise NotImplementedError.new("Language #{locale} not yet supported") unless language + + site_path = ARGV[0] + + # FIXME: create given path if it does not exist. + if File.exists?( site_path ) + if !File.directory?( site_path ) + $stderr.puts "#{site_path} is not a directory" ## FIXME: raise would be better + exit 1 + end + else + File.makedirs( site_path ) + end + + book = WhyTheLuckyStiff::Book::load( book ) + chapter = nil + + # Write index page + index_tpl = ERB::new( File.open( "#{ scripts }/layout/index.erb" ).read ) + File.open( File.join( site_path, 'index.html' ), 'w' ) do |out| + out << index_tpl.result + end + + # Write chapter pages + chapter_tpl = ERB::new( File.open( "#{ scripts }/layout/chapter.erb" ).read ) + body_class = "chapter" + url_pre = "chapter" + collection = book.chapters + collection.each do |chapter| + File.open( File.join( site_path, "chapter-#{ chapter.index }.html" ), 'w' ) do |out| + out << chapter_tpl.result( binding ) + end + end + + # Write expansion pak pages + expak_tpl = ERB::new( File.open( "#{ scripts }/layout/chapter.erb" ).read ) + body_class = "expansion" + url_pre = "expansion-pak" + collection = book.expansion_paks + collection.each do |chapter| + File.open( File.join( site_path, "expansion-pak-#{ chapter.index }.html" ), 'w' ) do |out| + out << expak_tpl.result( binding ) + end + end + + # Write printable version + print_tpl = ERB::new( File.open( "#{ scripts }/layout/print.erb" ).read ) + File.open( File.join( site_path, "print.html" ), 'w' ) do |out| + out << print_tpl.result + end + + # Copy css + images into site + + File.makedirs( File.join( site_path, "i" ) ) + File.copy( "#{ scripts }/layout/guide.css", "#{ site_path }/guide.css" ) + Dir["#{ scripts }/images/*"].each do |copy_file| + next if File.directory? copy_file + File.copy( copy_file, File.join( site_path, "i", File.basename( copy_file ) ) ) + end +end + scripts/poignant.rb @@ -1,109 +1,109 @@ -# = Translation progress calculator -# -# by murphy -# -# == Usage -# -# Insert some comments into the book (using YAML comments: #...) -# that split it into parts, like this: -# -# # {{{ Index: 97% -# -# image: !^img poignant.guide.png -# ... -# # }}} -# -# # {{{ Chapter 1: 30% -# ... -# -# Then run -# -# scripts/progress.rb lang -# -# for your +lang+. -# -# == Syntax -# -# Open part:: {{{ <Description> -# Close part:: }}} -# Progress (percentage):: {{{ Chapter 5: 45% -# Don't count this:: {{{ <Description> ! -# -# == Vim -# -# As you might have recognized, this is also the syntax for Vim folding. -# So if you use Vim, you win twice. - -if ARGV.empty? - puts <<-USAGE -Compute translation progress. -Usage: - ruby progress {de|fr|...} - USAGE - exit -end - -lang = ARGV.first -file = "#{File.dirname($0)}/../lang-#{lang}/poignant.yml" - -puts -print "Scanning #{file} " -guide = File.read file -print '.' - -PART = / - \# \s* \{\{\{ \s* - ( .*? ) \n # $1 = name, progress - ( .*? ) # $2 = content - \# \s* \}\}\} \s* -/mx -PERCENT = / ( \d+ (?: \.\d+ )? ) % /x # integer or decimal number -NAME = / [^:]* /x # chars until : or end of string - -parts = [] -guide.scan(PART) do |desc, content| - print '.' - parts << { - :progress => - if desc[PERCENT] - $1.to_f / 100 - else - 0 - end, - :name => - desc[NAME], - :lines => - if desc['!'] - 0 - else - content.count("\n") - end - } -end - -puts ' done' -puts - -puts "Parts found: %d" % parts.size -puts - -exit if parts.empty? - -lines_total, lines_done = 0, 0.0 -for part in parts - lines_total += part[:lines] - lines_done += part[:lines] * part[:progress] -end -progress = lines_done / lines_total - -puts <<-RESULTS % [ - Lines in book: %6d - Lines translated: %6d - Progress: %5.2f%% translated. -RESULTS - lines_total, - lines_done, - progress * 100 -] - -# vim:foldmethod=manual +# = Translation progress calculator +# +# by murphy +# +# == Usage +# +# Insert some comments into the book (using YAML comments: #...) +# that split it into parts, like this: +# +# # {{{ Index: 97% +# +# image: !^img poignant.guide.png +# ... +# # }}} +# +# # {{{ Chapter 1: 30% +# ... +# +# Then run +# +# scripts/progress.rb lang +# +# for your +lang+. +# +# == Syntax +# +# Open part:: {{{ <Description> +# Close part:: }}} +# Progress (percentage):: {{{ Chapter 5: 45% +# Don't count this:: {{{ <Description> ! +# +# == Vim +# +# As you might have recognized, this is also the syntax for Vim folding. +# So if you use Vim, you win twice. + +if ARGV.empty? + puts <<-USAGE +Compute translation progress. +Usage: + ruby progress {de|fr|...} + USAGE + exit +end + +lang = ARGV.first +file = "#{File.dirname($0)}/../lang-#{lang}/poignant.yml" + +puts +print "Scanning #{file} " +guide = File.read file +print '.' + +PART = / + \# \s* \{\{\{ \s* + ( .*? ) \n # $1 = name, progress + ( .*? ) # $2 = content + \# \s* \}\}\} \s* +/mx +PERCENT = / ( \d+ (?: \.\d+ )? ) % /x # integer or decimal number +NAME = / [^:]* /x # chars until : or end of string + +parts = [] +guide.scan(PART) do |desc, content| + print '.' + parts << { + :progress => + if desc[PERCENT] + $1.to_f / 100 + else + 0 + end, + :name => + desc[NAME], + :lines => + if desc['!'] + 0 + else + content.count("\n") + end + } +end + +puts ' done' +puts + +puts "Parts found: %d" % parts.size +puts + +exit if parts.empty? + +lines_total, lines_done = 0, 0.0 +for part in parts + lines_total += part[:lines] + lines_done += part[:lines] * part[:progress] +end +progress = lines_done / lines_total + +puts <<-RESULTS % [ + Lines in book: %6d + Lines translated: %6d + Progress: %5.2f%% translated. +RESULTS + lines_total, + lines_done, + progress * 100 +] + +# vim:foldmethod=manual scripts/progress.rb @@ -1,35 +1,35 @@ -#!/usr/bin/env ruby -require 'net/http' -require 'rubygems' -require 'hpricot' -require 'open-uri' - -puts '# # -# URBAN DICTONARY -# # # # # # # # # # # # # # # # # # # # ###' -begin - u = Hpricot(open("http://www.urbandictionary.com/define.php?term=#{ARGV[0]}")) - puts u.at('#entries').inner_text.gsub(/(\n\n)|(comments)/,'') -rescue => e - nil -end - -puts ' - -# # -# GOOGLE -# # # # # # # # # # # # # # # # # # # # ###' -# http://www.wagnerandrade.com/blog/2008/05/ruby-snapshot-1 -html = Net::HTTP.new('translate.google.com').post('/translate_t', "langpair=en|pt&text=#{ARGV[0]}").body -puts Hpricot(html).at('#result_box').inner_text - -puts ' - -# # -# BABYLON -# # # # # # # # # # # # # # # # # # # # ###' -b = Hpricot(open("http://www.babylon.com/definition/#{ARGV[0]}/Portuguese")).at('#results-col').inner_text -puts b.gsub(/(\n\n)|(Erros Nunca Mais)|(Abaixe este dicionário)/, '') -# # -# BABEL FISH -# TODO +#!/usr/bin/env ruby +require 'net/http' +require 'rubygems' +require 'hpricot' +require 'open-uri' + +puts '# # +# URBAN DICTONARY +# # # # # # # # # # # # # # # # # # # # ###' +begin + u = Hpricot(open("http://www.urbandictionary.com/define.php?term=#{ARGV[0]}")) + puts u.at('#entries').inner_text.gsub(/(\n\n)|(comments)/,'') +rescue => e + nil +end + +puts ' + +# # +# GOOGLE +# # # # # # # # # # # # # # # # # # # # ###' +# http://www.wagnerandrade.com/blog/2008/05/ruby-snapshot-1 +html = Net::HTTP.new('translate.google.com').post('/translate_t', "langpair=en|pt&text=#{ARGV[0]}").body +puts Hpricot(html).at('#result_box').inner_text + +puts ' + +# # +# BABYLON +# # # # # # # # # # # # # # # # # # # # ###' +b = Hpricot(open("http://www.babylon.com/definition/#{ARGV[0]}/Portuguese")).at('#results-col').inner_text +puts b.gsub(/(\n\n)|(Erros Nunca Mais)|(Abaixe este dicionário)/, '') +# # +# BABEL FISH +# TODO scripts/traduz.rb e90c74931bf9f4c02d8183cecfbd3f86144aa260 Daniel Luz dev@mernen.com http://github.com/brunopedroso/poignant-br/commit/452ce37c322647c02429bdae09bb842a2cec4657 452ce37c322647c02429bdae09bb842a2cec4657 2008-06-26T21:07:46-07:00 2008-06-26T20:07:16-07:00 Padronizando estilo Unix (linhas terminando em \n, modos de arquivo 644) Revert "cap 83 conflict solving" This reverts commit 57f3e63634b0ae48acdfe670fe6f884c2e98bc20. 26a3511d97b405c60f011a0d72d130c8738a92bc Daniel Luz dev@mernen.com