Skip to content

Latest commit

 

History

History
75 lines (52 loc) · 3.54 KB

README.md

File metadata and controls

75 lines (52 loc) · 3.54 KB
Raw

OSMBtranstats é o nome deste projeto que organiza-se em volta do script get_stats.rb e do arquivo de configurações config.yml. Quer significar "OpenStreetMap Brazil/Basic Translations's Statistics". São estatísticas básicas de traduções de software na comunidade OpenStreetMap Brasil.

O uso do script reduz o tempo de manutenção da página wiki de situação das traduções brasileiras a alguns segundos ou menos de dois minutos, dependendo da qualidade da conexão à Internet.

Intenções que estão colocadas de lado mas são facilmente realizáveis: internacionalionalizar o projeto, com algumas pequenas alterações no código (que hoje recebe/trata apenas pt-br, pt_BR ou pt), possibilitando que comunidades de outros países o reutilizem.

Dependências

  • Git, para baixar os arquivos com mais praticidade
  • Ruby, a linguagem de programação
  • Bundler, para empacotar alguma dependência
  • Bibliotecas de software
  • transifex-ruby, lib para autenticar e colher dados no Transifex
  • nokogiri, lib para colher dados em páginas HTML
  • yamldiff, lib que extendemos para contar diferenças entre arquivos YAML

Instalar

Não é exatamente "instalação". Só das dependências, e colocar os arquivos num diretório.

No Ubuntu

$ sudo apt-get install git
$ sudo apt-get install ruby ruby-nokogiri
$ sudo apt-get install bundler

$ cd TEMP_DIR/
$ git clone https://github.com/tmaesaka/transifex-ruby.git
$ cd transifex-ruby
$ gem build transifex-ruby.gemspec
$ sudo gem install transifex-ruby-0.0.4.gem

$ cd TEMP_DIR/
$ git clone https://github.com/alexandre-mbm/yamldiff.git
$ cd yamldiff
$ bundle
$ gem build yamldiff.gemspec
$ sudo gem install yamldiff-0.0.10.gem

$ cd ~
$ https://github.com/OSMBrasil/OSMBtranstats.git
$ cd OSMBtranstats

Rotina pensada para Ubuntu 14.04 LTS mas não testada.

No Windows

  • Instale Git para Windows: msysGit
  • Instale Ruby no Windows: RubyInstaller
  • Siga as dicas para a instalação dos gems necessários
  • Este ambiente está validado, tendo sido o berço do projeto

Como usar

  1. Configure o config.yml com suas credenciais Transifex

  2. Execute

$ ruby get_stats.rb > stats.txt

  1. Copie o conteúdo de stats.txt para edição de WikiProject Brazil/Traduções/Situação

  2. Revise as alterações e salve a página

Licença

Dedicamos esta ferramenta ao domínio público através de CCO 1.0 (arquivo LICENSE).

Nossas três dependências diretas são liberadas sob a Expat License, também conhecida ambiguamente como MIT License; existe mais de uma "licença do MIT".

Ruby 2.x está sob licença dupla: Ruby License / FreeBSD License (conhecida como 2-clause BSDL).

Bundler é ferramenta disponibilizada sob a Expat License.