Skip to content

Latest commit

 

History

History
131 lines (91 loc) · 4.98 KB

README.mkdn

File metadata and controls

131 lines (91 loc) · 4.98 KB

Brazilian Rails

Build Status

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 http://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, Cássio Marques, Danilo Jeremias da Silva, Eduardo Fiorezi, Eduardo Hertz, Elomar Nascimento dos Santos, Everton Ribeiro, Fabio Akita, Fernando Gomes, Fernando Migliorini Luizão, Frederico Macedo, Gun.io Whitespace Robot, Jhimy Fernandes Villar, João Vitor, Julio Santos Monteiro, Kivanio Barbosa, Marcus Derencius, Marcus Sá, Mauricio Zaffari, Rafael Felix, Rafael Uchoa, Rafeal Carvalho, Ricardo Shiota Yasuda, Rodrigo Manhães e Sergio Brant

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

Improve It