# Brazilian Rails

[![Build Status](secure.travis-ci.org/tapajos/brazilian-rails.png?branch=master)](http://travis-ci.org/tapajos/brazilian-rails)

Estamos testando, via Travis-CI, nas versões de Ruby ree, 1.8.7, 1.9.2 e 1.9.3, nas versões de Rails 2.3.x, 3.0.x, 3.1.x e 3.2.x

## O que foi?

O Brazilian Rails foi o plugin de internacionalização mais conhecido do Brasil e tinha como objetivo unir vários recursos de regras e traduções para o desenvolvedor brasileiro.

## O que é?

Brazilian Rails é um conjunto de gems para serem usadas com Ruby e com o Ruby on Rails e tem como objetivo unir alguns recursos úteis para os desenvolvedores brasileiros.

## Quais as gems que compõe o Brazilian Rails?

  • brcep

  • brdata

  • brdinheiro

  • brhelper

  • brnumeros

  • brstring

  • brcpfcnpj

  • brI18n

OBS: A gem brtraducao foi removida do Brazilian Rails devido a adição do suporte i18n do Rails. Ele continua podendo ser usada, porém não faz mais parte desse projeto. Para maiores detalhes, leia o post [O Brazilian Rails e o suporte i18n]

OBS: A gem brI18n foi criada para acomodar as traduções usando suporte i18n das versões mais recentes do Rails.

## Como faço para instalar?

É muito difícil…

### com Bundler

Adicionar ao seu Gemfile:

gem ‘brazilian-rails’

### sem Bundler

require “brazilian-rails”

Por padrão, a pluralização vem desabilitada, isso para não atrapalhar os projetos que já existem.

### I18n

Por padrão a gem não carrega o suporte de traduções do Rails, para usa-la você deve fazer o require abaixo:

require ‘brI18n’

## Como funciona?

Está tudo explicado na nossa [api][].

## Achei um BUG, o que eu faço?

No melhor seria fazer um fork, adicionar os testes para reproduzir o erro, implementar a devida correção e fazer um pull request. Se acha que não tem capacidade para isso (tá com preguiça), por favor, nos avise! Isso é fácil e rápido. Isso pode ser feito em <github.com/tapajos/brazilian-rails/issues>

## Como contribuir?

  1. Fazer um fork do projeto

  2. Instalar as dependências: bundle install (Se não tiver o bundler instalado, faça antes: gem install bundler)

  3. Fazer os devidos ajustes com os respectivos testes (TestUnit se possível e tente fazer commits atômicos)

  4. Fazer pull request

## Quem está por traz disso tudo?

O [Marcos Tapajós] tomou coragem para publicar todas as funcionalidades em um plugin, com testes unitários para garantir que tudo funcione conforme manda o figurino. Além do Tápa, outros loucos mantém tudo organizado, são: [Celestino Gomes], [André Luiz Kupkovski], [A galera da Improve It] e mais alguns que ficam escondidos para não pagar esse mico…

Muitos já contribuíram com o projeto.

git log --format='%an' | sort -u

[Andre Bernardes](github.com/albertobraschi), [Cássio Marques](github.com/cassiomarques), [Danilo Jeremias da Silva](github.com/dannnylo), [Eduardo Fiorezi](github.com/eduardofiorezi), [Eduardo Hertz](github.com/eduardohertz), [Elomar Nascimento dos Santos](github.com/elomarns), [Everton Ribeiro](github.com/nuxlli), [Fabio Akita](github.com/akitaonrails), [Fernando Gomes](github.com/fernandogomes), [Fernando Migliorini Luizão](github.com/fernandoluizao), [Frederico Macedo](github.com/frederico), [Gun.io Whitespace Robot](github.com/GunioRobot), [Jhimy Fernandes Villar](github.com/stjhimy), [João Vitor](github.com/joaovitor), [Julio Santos Monteiro](github.com/jmonteiro), [Kivanio Barbosa](github.com/kivanio), [Marcus Derencius](github.com/derencius), [Marcus Sá](about.me/marcus_sa), [Mauricio Zaffari](github.com/mauriciozaffari), [Rafael Felix](github/com/fellix), [Rafael Uchoa](github.com/uchoaaa), [Rafeal Carvalho](github.com/rafaeldx7), [Ricardo Shiota Yasuda](github.com/shadow11), [Rodrigo Manhães](github.com/rodrigomanhaes) e [Sergio Brant](github.com/smbrant)

## Algumas funcionalidades:

  • Date e Time no formato brasileiro

  • Números por Extenso

  • Dinheiro

  • Cpf e Cnpj

  • Feriado

  • Mensagens de erro traduzidas

  • etc

## Duvidas?

As duvidas podem ser enviadas diretamente a um dos desenvolvedores ou através da página do projeto no [RubyForge]

## Quem apoia nesta gem?

Improve It][ii
![Improve It]][ii

[rf]: rubyforge.org/projects/brazilian-rails/ [api]: brazilian-rails.improveit.com.br/software_livre/brazilian_rails [ii]: www.improveit.com.br [logo]: “Improve It” [tino]: tinogomes.wordpress.com [andre]: www.workingwithrails.com/person/9227-andr-luiz-kupkovski [rf]: rubyforge.org/projects/brazilian-rails [mt]: www.improveit.com.br/tapajos [vt]: www.improveit.com.br/vinicius [gg]: ggarnier.wordpress.com/ [brtraducoes]: blog.improveit.com.br/articles/2009/02/13/o-brazilian-rails-e-o-suporte-i18n