O (Comovente) Guia de Ruby do Why
No início deste mês de abril, o Carlos Brando anunciou em seu blog a tradução para Português do livro Why’s (Poignant) Guide to Ruby. A equipe de tradução realizou um grande trabalho, como pode ser visto no site do livro traduzido.
Logo depois do anúncio, surgiu uma demanda da comunidade por uma versão do livro traduzido em formato PDF, como pode ser visto nos comentários postados pelos leitores na página do anúncio. O Carlos Brando concordou com a demanda, mas levantou a premissa de que o PDF devia ser feito com qualidade.
Bem, resolvi encarar a empreitada e parti para o trabalho. Depois de experimentar várias alternativas para a geração do PDF, acabei partindo para a força bruta. Copiar página por página da web para um arquivo do BrOffice 3.0 e exportar para PDF. Mas por que isso? Com o BrOffice eu consigo, além de numeração de páginas no rodapé e um cabeçalho, gerar as barras laterais com texto adicional que permeiam todos os capítulos do livro e, principalmente, manter um índice automático que depois é exportado para o PDF como uma lista de bookmarks que facilitam a navegação e localização dentro do texto.
Admito que essa não é a melhor maneira de se gerar o PDF enquanto processo, pois as atualizações e correções não podem ser incorporadas automaticamente. Do jeito que está, nós teremos que acompanhar as atualizações no repositório do “código fonte” do livro no GitHub e, então, manualmente alterar o arquivo ODF (.odt, do Writer), que é o “código fonte” do PDF gerado. Ainda precisaremos estudar uma solução pra isso, vou conversar com o Brando e a equipe que mantém o trabalho original de tradução para encontrarmos juntos uma maneira melhor. Se você tiver uma sugestão de como melhorar esse trabalho, fique à vontade para enviar seus comentários.
Quanto ao conteúdo, está idêntico ao que foi publicado pelo Brando, inclusive com os erros apontados pelos leitores do blog Nome do Jogo no post de anúncio da tradução. Preferi não interferir ainda no trabalho realizado pela equipe, já que minha contribuição está focada na disponibilização do arquivo PDF. Obviamente, pretendo contribuir com revisões também.
Há também algumas oportunidades de melhoria no PDF gerado, como melhorar a fonte e o espaçamento entre linhas dos trechos de código, aprimorar o grafismo, talvez com umas cores de fundo para destacar os sidebars do restante do texto, fazer o cabeçalho igual ao original, etc.
Este trabalho, assim como o original em Inglês e sua tradução para o Português, é distribuído sob licença Creative-Commons Atribuição-Compartilhamento.
Ah, sim, claro! Os arquivos! Aqui estão. Bom proveito.
O (Comovente) Guia de Ruby do Why – PDF
O (Comovente) Guia de Ruby do Why – ODT (BrOffice 3.0 – Writer)
