Extensão:Deslizador de Revisões

Manual de extensões do MediaWiki

RevisionSlider Estado da versão: estável
Implementação	Interface de usuário
Descrição	Adiciona um deslizador à interface de visualização de difs, facilitando a navegação entre revisões
Autor(es)	Wikimedia Alemanha (WMDE)
Política de compatibilidade	branches de lançamento
MediaWiki	1.25+
Modifica o banco de dados	Não
Licença	GNU GPL (Licença Pública Geral) 2.0 ou superior
Download	Baixar extensão Git [?]: Baixar master do Git navegar pelo repositório (GitHub) histórico de commits repository contributors (GitHub) revisão de código
Hooks usados DifferenceEngineViewHeader GetPreferences
Para traduzir a extensão RevisionSlider, verifique sua disponibilidade no translatewiki.net
Verificar uso e matriz de versões
Problemas	Tarefas em aberto · Relatar um bug

A extensão Deslizador de Revisões adiciona um deslizador à interface de visualização de difs, facilitando a navegação entre revisões.

Instalação

• Baixe e coloque o(s) arquivo(s) num diretório chamado RevisionSlider na sua pasta extensions/.

• Adicione o seguinte código ao final do seu arquivo LocalSettings.php:

  wfLoadExtension( 'RevisionSlider' );
  

•  Concluído – Navegue à página Special:Version em sua wiki para verificar se a instalação da extensão foi bem sucedida.

Uso

	Numa página de difs, o deslizador é ocultado por padrão, e apenas a barra “Navegar pelo histórico” é exibida no topo da página. Clique na barra para expandir o Deslizador de Revisões.
	Uma vez expandido, o Deslizador de Revisões busca dados sobre as revisões e deixa que você navegue por elas e as compare na página de difs.
	Cada barra representa uma revisão da página. As barras na parte superior mostram o crescimento do tamanho da página; as na parte inferior, a redução. Na imagem, a revisão 1 representa conteúdo adicionado, enquanto a revisão 2 representa conteúdo removido.
	Para comparar certas revisões, selecione-as usando os ponteiros amarelo e azul. O ponteiro azul controla a revisão mais recente; o amarelo, a mais antiga. There are several ways to do this: You can drag and drop the knob to the desired position on the slider. You can click on the desired position on the slider line. To select the newer revision, click on the blue line, and for selecting the older revision, click on the yellow line. To indicate which revision you're about to select, a preview of a blue or yellow knob appears and the bar turns blue or yellow. You can click into the bar above the middle line (to select the newer revision) or below the line (to select the older revision). This also gives you a preview of the knob on the middle line. If you move the blue knob to a position left of the yellow knob, the yellow knob is automatically moved along, and vice versa if you move the yellow knob to a position right of the blue knob.
	Use as setas horizontais para navegar pelo histórico de revisões e mostrar as mais antigas ou as mais novas.

Desativar

Se você não estiver usando o Deslizador de Revisões, e também não quiser ver a barra dele no topo da página de difs, você pode desativá-lo ao marcar “Não exibir o Deslizador de Revisões” nas suas preferências, em Aparência > Difs.

Conhecimento técnico

Hooks em JavaScript

O Deslizador de Revisões usa AJAX para atualizar a página de difs quando novas revisões forem feitas. Uma vez que a página tiver carregado wikipage.content e wikipage.diff, os hooks serão ativados. Se o JavaScript dos usuários ou das extensões agir na página, talvez seja necessário fazer o processo de listen neles.

Exemplos

• A extensão Agradecer
• O gadget wikEdDiff

Chamadas de API e busca de dados

A ferramenta apenas faz chamadas à API quando expandida. Os dados sobre as revisões (revision-id, timestamp, user, comment, size e flags) são buscados apenas quando o deslizador está expandido. A ferramenta apenas busca dados para as revisões que estiverem visíveis na tela (num máximo de 500) e os dados sobre revisões adicionais só são carregados quando o usuário navegar pela linha do tempo usando as setas.

Unless expanded, the tool is not doing any API calls. Only when the user expands the slider, it fetches data about revisions (revision-id, timestamp, user, comment, size and flags). The tool only fetches data for revisions that are currently visible on the screen (maximum 500 revisions) and data about additional revisions is only loaded when the user navigates back or forth on the timeline using the arrows.

Contexto

O Deslizador de Revisões é um recurso vindo de um dos principais desejos da lista de desejos da comunidade alemã, desenvolvido pela equipe TCB, da WMDE. É inspirado no gadget revisionjumper, de DerHexer, e baseado num protótipo da equipe da Comunidade Técnica da WMF.

Notas (para o público técnico) sobre problemas de escrita direita-para-esquerda descobertos no desenvolvimento da extensão foram publicados numa página separada.