A Linha do Tempo é uma ferramenta que gera gráficos interativos a partir de datasets no formato .tsv hospedados no ptwikis e de eventos em wikitexto hospedados em uma página na Wikipédia.

Eventos[editar código-fonte]

Linha do Tempo
	Ptwikis/Linha do Tempo
Desenvolvedor	Jonas AGX e Crang115
Plataforma	Flask, jQuery e Rickshaw
Modelo do desenvolvimento	Software Livre
Lançamento	16 de setembro de 2013; há 10 anos
Versão estável	1.4 (30 de junho de 2014; há 9 anos)
Escrito em	JavaScript e Shell script
Sistema operativo	multiplataforma
Gênero(s)	visualizador de dados
Licença	GNU General Public License v3 ou superior
Estado do desenvolvimento	Corrente
Página oficial	https://tools.wmflabs.org/ptwikis/Linha_do_tempo

Os eventos exibidos na linha do tempo são gerados a partir da página Wikipédia:Arqueologia/Linha do tempo. Essa página é escrita colaborativamente e os eventos para serem importados devem ser adicionados, seguindo o padrão dos já existentes, dentro de uma das seguintes seções:

Geral
Combate ao vandalismo
Estatutos
Construção de artigos
Comunidade

(Caso em algum momento se deseje importar uma nova seção para a linha do tempo, além de criá-la na página de Arqueologia também será necessário atualizar o código do script ~/scripts/timeline/events/atualizaeventoslinhadotempo.sh).

Datasets[editar código-fonte]

Atualmente a linha do tempo oferece 10 datasets diferentes para visualização. Todos eles possuem dados mensais desde junho de 2001 até o mês anterior à data atual (para mais detalhes sobre atualização veja a seção Scripts de atualização). Esses dados estão armazenados no ptwikis no arquivo ~/ptwikis/static/timeline/data/linha_data.tsv (link para download) . Os datasets exibidos são os seguintes:

Wikipedistas

Wikipedistas com pelo menos 10 edições nos domínios 0 ou 102 desde a criação de sua conta ao final do mês.

NovosWikipedistas

Wikipedistas que completaram 10 edições nos domínios 0 ou 102 desde a criação de sua conta naquele mês.

Ativos

Wikipedistas que realizaram 5 ou mais edições nos domínios 0 ou 102 durante aquele mês.

MuitoAtivos

Wikipedistas que realizaram 100 ou mais edições nos domínios 0 ou 102 durante aquele mês.

Artigos

Total de páginas existentes nos domínios 0 ou 102 ao final do mês.

ArtigosPorDia

Diferença entre o Total de páginas existentes nos domínios 0 ou 102 ao final do mês e o mesmo valor do mês anterior, dividida pelo total de dias do mês.

MediaEdições

Média de revisões feitas por artigo. É a divisão entre o total de edições feitas nos domínios 0 e 102 (desde juho de 2001 até o final do mês) e o total de páginas existentes nos domínios 0 ou 102 ao final do mês.

EdiçõesMês

Total de edições feitas nos domínios 0 ou 102 durante o mês (esse dado inclui bots).

EdiçõesHumanos

Total de edições feitas nos domínios 0 ou 102 durante o mês por usuários que não são bots.

Redirecionamentos

Total de páginas nos domínios 0 ou 102 que sejam redirecionamentos ao final do mês.

Reversões

Reversões feitas durante o mês (considerando reversões apenas edições que tornam a página idêntica a uma versão anterior dela mesma)

Dados dinâmicos[editar código-fonte]

A partir dos datasets listados acima a linha do tempo oferece a posibilidade de criação de gráficos dinamicamente comparando dois datasets. Atualmente podem ser gerados gráficos dinâmicos com as seguintes funções:

soma
subtração
multiplicação
divisão

A partir da versão 1.4 os dados gerados dinamicamente passaram a ser listados como opções para a criação de novos cruzamentos.

Dados de Wikiprojetos[editar código-fonte]

A partir da versão 1.4 a Linha do Tempo passa a oferecer a exibição de dados de wikiprojetos.

Wikiprojeto Saúde[editar código-fonte]

Inicialmente foi adicionado apenas o Wikiprojeto Saúde com os seguintes datasets:

Saúde:AtivosEditando

Usuários ativos na Wikipédia naquele mês que realizaram pelo menos uma edição em páginas que estão no escopo do Wikiprojeto Saúde.

Saúde:Editores

Usuários que realizaram pelo menos uma edição em páginas que estão no escopo do Wikiprojeto Saúde.

Saúde:EdiçõesHumanos

Edições feitas naquele mês em páginas que estão no escopo do Wikiprojeto Saúde por usuários não marcados como bot.

Saúde:Edições

Edições feitas naquele mês em páginas que estão no escopo do Wikiprojeto Saúde.

Esses dados estão hospedados em ~/ptwikis/static/timeline/data/saude/ (link para download) e seguem o mesmo padrão de .tsv dos datasets originais da linha do tempo.

Novos datasets relacionados ao Wikiprojeto podem ser adicionados se houver interesse da comunidade em acompanhá-los. Fique a vontade para sugerir alguns na página de discussão.

Desenvolvimento[editar código-fonte]

A ferramenta utiliza as bibliotecas javascript jQuery e Rickshaw (baseada na d3).

Além da estrutura de visualização de dados também fazem parte da linha do tempo os scripts que podem ser encontrados na pasta ~/scripts/timeline/ , que são responsáveis por atualizar as informações periodicamente.

Scripts de atualização[editar código-fonte]

Os scripts de atualização da linha do tempo podem ser encontrados na pasta ~/scripts/timeline/ . Hoje existem dois script configurados na crontab para rodar periodicamente:

events/atualizaeventoslinhadotempo.sh

Esse script é executado todos os dias às 16 horas (GMT) lendo a página Wikipédia:Arqueologia/Linha do tempo e atualizando o arquivo ~/ptwikis/static/timeline/data/events.json de acordo com as atualizações feitas na página wiki.

data/atualizadadoslinhadotempo.sh

Esse script é executado todo mês no dia 1, às 03:01 (GMT) rodando querys no banco ptwiki_p e atualizando os arquivos presentes na pasta ptwikis/static/timeline/data/rawdata/ assim como o arquivo ptwikis/static/timeline/data/linha_data.tsv com os dados referentes ao mês anterior para os datasets listados anteriormente nessa página.

Trabalhos futuros[editar código-fonte]

Criar uma função de visualização que permita a adição dinâmica de datasets secundários que já estejam no ptwikis sem precisar criar uma lisata inicial gigante. Feito (mas pode ficar mais bonito)
Adicionar datasets do wikiprojeto saúde. Feito
Adicionar dataset de edições feitas apenas por humanos. Feito
Adicionar datasets de outros projetos (wikilivros, wikiversidade)

Mantenedores[editar código-fonte]