Extensão:Deslizador de Revisões
 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 |
Lançamentos de snapshot junto com o MediaWiki. A master não é retrocompatível. |
| MediaWiki | 1.25+ |
| Modifica o banco de dados |
Não |
| Licença | GNU GPL (Licença Pública Geral) 2.0 ou superior |
| Download | |
| Para traduzir a extensão RevisionSlider, verifique sua disponibilidade no translatewiki.net | |
| 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 mova a pasta extraída
RevisionSliderao seu diretórioextensions/.
Desenvolvedores e colaboradores de código, por outro lado, deverão instalar a extensão a partir do Git, usando:cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RevisionSlider
- 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. |
 |
Para selecionar as revisões a serem comparadas, use os ponteiros amarelo e azul. O ponteiro azul controla a revisão mais recente; o amarelo, a mais antiga. Há várias formas de se fazer isso:
No caso do ponteiro azul ser movido para uma posição à esquerda do amarelo, o ponteiro amarelo também será movido para a esquerda. O contrário também é verdadeiro caso você mova o ponteiro amarelo à direita do azul. |
 |
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” → “Diferenças”.
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: phab:rETHA0b241d4d296f488dc7d3a1f4260aa0e426b2d7f5#1493b925
- O gadget wikEdDiff na Wikipédia em inglês: https://en.wikipedia.org/w/index.php?diff=741585034&oldid=630494053&title=User:Cacycle/wikEdDiff.js
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.
Contexto
O Deslizador de Revisões[1] é um recurso vindo de um dos principais desejos da lista de desejos da comunidade alemã[2] 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.
Referências
| Esta extensão está sendo usada(o) por um ou mais projetos da Wikimedia. Isto significa que, provavelmente, a extensão é estável e funciona bem o suficiente para ser utilizada(o) em sites da web de alto tráfego. Procure pelo nome dessa extensão nos arquivos de configuração CommonSettings.php e InitialiseSettings.php da Wikimedia para verificar onde ela foi instalada. Uma lista completa das extensões instaladas numa wiki em particular podem ser visualizadas na página Special:Version da wiki. |
| Esta extensão está incluída nas seguintes fazendas/hospedagens (farms/hosts) e/ou pacotes wiki: Esta não é uma lista autoritativa (oficial). Algumas fazendas/hospedagens (farms/hosts) e/ou pacotes wiki podem conter esta extensão mesmo que não estejam listados aqui. Sempre verifique com suas fazendas/hospedagens (farms/hosts) ou pacotes wiki para confirmar. |