Gera código wiki com estatísticas de tradução da comunidade
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE
README.md
WINDOWS.md
config.yml
decorators.rb
file_collectors.rb
get_stats.rb
json_collectors.rb
noko_collectors.rb

README.md

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.