Extension:RevisionSlider/pt-br

Manual de extensões do MediaWiki

File:OOjs UI icon advanced-invert.svg RevisionSlider Estado da versão: estável
File:Screenshot Revision slider EN large.png
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	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	1.25+
Modifica o banco de dados	Não
Licença	Nenhuma licença especificada
Download	<translate> Download extension</translate> <translate> Git</translate> [?]: <translate> Download Git master</translate> <translate> browse repository</translate> (GitHub) <translate> commit history</translate> <translate> repository contributors (GitHub)</translate> <translate> code review</translate>
Quarterly downloads
Public wikis using
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

• <translate> [[<tvar name=2>Special:ExtensionDistributor/RevisionSlider/pt-br</tvar>|Download]] and move the extracted <tvar name=name>RevisionSlider/pt-br</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
  <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RevisionSlider%2Fpt-br
• <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>

  wfLoadExtension( 'RevisionSlider/pt-br' );
  

• File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>

Uso

File:Slide0 collapsed.svg	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.
File:RevisionSlider Help Step1.svg	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.
File:RevisionSlider Help Step2.svg	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.
File:RevisionSlider Help Step3.svg	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: É possível arrastar e soltar o ponteiro até a posição desejada no deslizador. Ou, clique na posição desejada na linha do deslizador. Para selecionar a revisão mais recente a ser comparada, clique na linha azul. Para selecionar a antiga, clique na linha amarela. Para indicar qual revisão você estará selecionando se clicar naquela posição, um ponteiro semi-transparente azul ou amarelo aparecerá, e a barra se tornará azul ou amarela. Como terceira opção, você também pode clicar na barra localizada acima da linha (para selecionar a revisão mais nova) ou abaixo da linha (para selecionar a revisão mais antiga). Esse método também faz aparecer um ponteiro semi-transparente na linha para indicar a sua ação. 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.
File:RevisionSlider Help Step4.svg	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 “⧼revisionslider-preference-disable⧽” nas suas preferências, em “Appearance” → “Diffs”.

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 é 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.