You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
132 lines
5.0 KiB
132 lines
5.0 KiB
# Brazilian Rails
|
|
|
|
[](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][brtraducoes]
|
|
|
|
**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
|
|
1. Instalar as dependências: bundle install (Se não tiver o bundler instalado, faça antes: gem install bundler)
|
|
1. Fazer os devidos ajustes com os respectivos testes (TestUnit se possível e tente fazer commits atômicos)
|
|
1. Fazer pull request
|
|
|
|
## Quem está por traz disso tudo?
|
|
|
|
O [Marcos Tapajós][mt] 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][tino], [André Luiz Kupkovski][andre], [A galera da Improve It][ii] 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](https://github.com/albertobraschi),
|
|
[Cássio Marques](https://github.com/cassiomarques),
|
|
[Danilo Jeremias da Silva](https://github.com/dannnylo),
|
|
[Eduardo Fiorezi](https://github.com/eduardofiorezi),
|
|
[Eduardo Hertz](https://github.com/eduardohertz),
|
|
[Elomar Nascimento dos Santos](https://github.com/elomarns),
|
|
[Everton Ribeiro](https://github.com/nuxlli),
|
|
[Fabio Akita](https://github.com/akitaonrails),
|
|
[Fernando Gomes](https://github.com/fernandogomes),
|
|
[Fernando Migliorini Luizão](https://github.com/fernandoluizao),
|
|
[Frederico Macedo](https://github.com/frederico),
|
|
[Gun.io Whitespace Robot](https://github.com/GunioRobot),
|
|
[Jhimy Fernandes Villar](https://github.com/stjhimy),
|
|
[João Vitor](https://github.com/joaovitor),
|
|
[Julio Santos Monteiro](https://github.com/jmonteiro),
|
|
[Kivanio Barbosa](https://github.com/kivanio),
|
|
[Marcus Derencius](https://github.com/derencius),
|
|
[Marcus Sá](http://about.me/marcus_sa),
|
|
[Mauricio Zaffari](https://github.com/mauriciozaffari),
|
|
[Rafael Felix](https://github/com/fellix),
|
|
[Rafael Uchoa](https://github.com/uchoaaa),
|
|
[Rafeal Carvalho](https://github.com/rafaeldx7),
|
|
[Ricardo Shiota Yasuda](https://github.com/shadow11),
|
|
[Rodrigo Manhães](https://github.com/rodrigomanhaes) e
|
|
[Sergio Brant](https://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][rf]
|
|
|
|
## Quem apoia nesta gem?
|
|
|
|
[Improve It][ii]
|
|
|
|
[![Improve It][logo]][ii]
|
|
|
|
[rf]: http://rubyforge.org/projects/brazilian-rails/
|
|
[api]: http://brazilian-rails.improveit.com.br/software_livre/brazilian_rails
|
|
[ii]: http://www.improveit.com.br
|
|
[logo]: http://www.improveit.com.br/images/logo/logo_improve_it_screen.gif "Improve It"
|
|
[tino]: http://tinogomes.wordpress.com
|
|
[andre]: http://www.workingwithrails.com/person/9227-andr-luiz-kupkovski
|
|
[rf]: http://rubyforge.org/projects/brazilian-rails
|
|
[mt]: http://www.improveit.com.br/tapajos
|
|
[vt]: http://www.improveit.com.br/vinicius
|
|
[gg]: http://ggarnier.wordpress.com/
|
|
[brtraducoes]: http://blog.improveit.com.br/articles/2009/02/13/o-brazilian-rails-e-o-suporte-i18n
|