GithubHelp home page GithubHelp logo

fcoloni / brazilian-rails Goto Github PK

View Code? Open in Web Editor NEW

This project forked from tapajos/brazilian-rails

1.0 2.0 0.0 992 KB

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.

Home Page: http://brazilian-rails.rubyforge.org

brazilian-rails's Introduction

Brazilian Rails

Build Status

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.

O que vem pela frente?

Existem vários plugins espalhados, que são úteis a comunidade brasileira, e gostaria de convocar seus colaboradores a entrar em contato comigo para que juntos nós migremos para gems dentro do Brazilian Rails.

Já usava como plugin, o que eu tenho que fazer?

NADA! Essa gem foi cuidadosamente pensada permitir seu uso como plugin sem precisar fazer mais nada, preservando-se a mesma forma de instalação anterior.

Cade o SVN?

Foi desativado por completo. Agora só teremos suporte GIT.

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.

Suporte à Ruby 1.9 (experimental)

As gems foram portadas para Ruby 1.9, porém o suporte ainda é experimental, e contamos com a comunidade para ajudar a melhorar o suporte. Todas as gems funcionam corretamente, mas caso decida usar a nova versão do Ruby, tome um cuidado especial com a gem brdata. O método Date#parse se comporta de maneira diferente nas versões 1.8 e 1.9 do Ruby, o que pode ocasionar alguns erros.

Como faço para instalar?

É muito difícil...

No Rails 3.x

Adicionar ao seu Gemfile:

gem 'brazilian-rails'

No Rails 2.x

Como plugin:

ruby script/plugin install git://github.com/tapajos/brazilian-rails.git

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

Como gem:

gem install brazilian-rails -v 2.1.15

Depois que todas as gems forem instaladas você pode utiliza-las individualmente ou carregando todas, como no trecho abaixo.

Rails::Initializer.run do |config|
	config.gem 'brazilian-rails', '2.1.15'
end

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?

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 --raw | grep "^Author: " | sed 's/Author: //' | sed 's/<.*$//' | sort | uniq

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 investe nesse plugin?

Este plugin é patrocinado pela Improve It.

Improve It

brazilian-rails's People

Contributors

tinogomes avatar tapajos avatar cassiomarques avatar fmluizao avatar elomarns avatar eduardohertz avatar dx7 avatar dreoliv avatar stjhimy avatar kivanio avatar eduardofiorezi avatar frederico avatar dannnylo avatar albertobraschi avatar smbrant avatar rodrigomanhaes avatar shadowmaru avatar uchoaaa avatar fellix avatar jmonteiro avatar joaovitor avatar feromes avatar akitaonrails avatar nuxlli avatar

Stargazers

Fabio Coloni avatar

Watchers

James Cloos avatar Fabio Coloni avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.