python / python/python-docs-pt-br

Script para ler e processar planilha de páginas mais acessadas

Aberta
#46 14 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Linguagem predominante
Python
Estrelas
164
Forks
42
Merge médio
14h 32min
PRs com merge (30d)
4

Descrição

Criar um script que leia planilhas como a relacionada abaixo, processe-a e emita uma lista de prioridades de tradução.

https://docs.google.com/spreadsheets/d/1RJapw9QAoLcdSV6et9G67LNTM3Pcn6XIv_h5S5ksFNk/edit?usp=sharing

A planilha acima apresenta as páginas mais requisitadas da documentação do Python no Brasil.

Conteúdo desejável da lista de prioridades:

  • nome do recursos (ex., library--datetime)
  • URL para tradução no Transifex)
  • (URL da documentação?)

Por exemplo: A URL https://docs.python.org/3/library/datetime.html resultaria no recurso de Transifex "library--datetime" ("/" substituída por "--", prefixo e extensão removida), resultando na URL para tradução: https://www.transifex.com/python-doc/python-39/translate/#pt_BR/library--datetime

Na URL para tradução, a parte "python-39" é o nome do projeto, composto de python-VERSÃO (VERSÃO retirado o ponto, 27, 39, 310). A versão pode ser atualizada, de forma que ser uma variável ajustável pode ser interessante.

Guia de contribuição

Nenhum guia de contribuição indexado para este repositório

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Direção de pesquisa

Comece revisando a planilha vinculada e os scripts ou pontos de entrada existentes do repositório para as ferramentas de documentação. Defina o formato de entrada e saída com base nos nomes dos recursos, nas URLs do Transifex e nas URLs opcionais da documentação; em seguida, verifique a variável de versão e a transformação de URL usando o exemplo datetime. O trabalho estará concluído quando o script processar a planilha e emitir uma lista utilizável de prioridades de tradução.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
python
Domínio
documentation, localization
Tipo de issue
Funcionalidade
Dificuldade
3/5
Tempo estimado
1-2 dias
Status de atividade
Estagnada
Clareza
Razoavelmente clara
Facilidade para iniciantes
42/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.