Extension:RevisionSlider/pt-br

From Linux Web Expert

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
Manual de extensões do MediaWiki
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
Quarterly downloads Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
Public wikis using Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
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

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

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

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