Wikipédia:Software/Popups de navegação

Origem: Wikipédia, a enciclopédia livre.
Ir para: navegação, pesquisa
Popup-preview.png

Os popups de navegação (navigation popups) fornecem um acesso fácil a várias funções da Wikipédia por meio de popups que aparecem quando se coloca o ponteiro do rato (mouse) sobre ligações (links).

  • Instalação rápida: Entre em Especial:Preferências e clique na aba "Gadgets", ative a caixa "Pop-ups de navegação" e salve.
  • Outro método de instalação: adicionar {{subst:navpop}} ao seu monobook.js (ou ficheiro equivalente se usar um skin diferente. Importante: repare que é monobook e não Monobook). Ver abaixo para instruções de instalação completas.

Características

  • Visualizar a primeira parte do texto do artigo.
  • Visualizar imagens a partir de ligações de imagens.
  • Visualizar a primeira imagem de cada artigo.
  • Visualizar diffs na lista de artigos vigiados, historia e mudanças relacionadas.
  • Visualizar wikiligações seleccionadas durante a edição (use o rato para seleccionar uma wikiligação).
  • Reversão de vandalismos com um só clique a partir do histórico do artigo (ver imagem).
  • Informação sobre redirecionamentos, esboços e páginas de desambiguação.
  • Fornece informação sobre uma dada página relativamente ao tamanho, número de ligações, número de imagens, número de categorias e idade da página.
  • Deverá funcionar em todas as wikis da Wikimedia.
  • Acesso via um só clique a:
    • editar página
    • contribuições do usuário
    • Interiot's tool (contador de edições)
    • enviar email ao usuário
    • história
    • interessar-se ou desinteressar-se
    • ver ou editar página de discussão
    • artigos afluentes
    • mudanças relacionadas
    • para administradores, proteger e desproteger, apagar e bloquear usuário
    • registo de usuário e registo de bloqueio
    • listar subpáginas de páginas de usuário
    • Busca na Wikipedia, global Wikipedia search e busca no Google
    • Teclas de atalho (opcional)
    • Reparar automaticamente ligações por forma a evitar redireccionamentos e páginas de desambiguação (opcional).

Instalação

É necessário ser um usuário registado para instalar e utilizar os popups de navegação. Se não tiver uma conta de usuário terá que criar uma e fazer log in.

O próximo passo é adicionar {{subst:navpop}} à sua página common.js. Isto vai fazer com que seja adicionado o seguinte código a sua página de scripts globais:

// [[User:Lupin/popups.js]] 
 mw.loader.load ('//en.wikipedia.org/w/index.php?title=User:Lupin/popups.js&action=raw&ctype=text/javascript&smaxage=21600&maxage=86400');

Nota: Se quiser que o script funcione apenas quando usar um skin específico (em vez de funcionar sempre), a página a ser editada é um dos listados abaixo:

Após gravar a página, proceda ao esvaziamento da cache do seu navegador de Internet (prima SHIFT enquanto a página recarrega). Partindo do princípio de que o javascript está activo no seu navegador, deverá surgir um popup, sempre que colocar o ponteiro do rato sobre uma ligação interna na Wikipédia.

Para instalar o script no commons ou no wikcionário repita este procedimento nessas wikis.

Para desinstalar o script, apague as linhas referidas acima da mesma página e esvazie a cache do seu navegador.

Guia de utilização

Esta ferramenta gera dicas quando se coloca o ponteiro do rato sobre ligações activas e imagens,

Muitas das funções mais importantes podem ser utilizadas a partir da lista de artigos vigiados:

  • coloque o ponteiro do rato sobre uma ligação diff para ver um sumário da alteração produzida pela edição efectuada.
  • coloque o ponteiro do rato sobre uma ligação para uma versão do artigo para ver um curto excerto dessa versão.

Deverão estar ainda disponíveis algumas ligações de navegação que dão acesso a muitas outras funções como reversão com um só clique, edição do artigo e outras. Estas poderão surgir no próprio popup ou estar escondidas num menu “actions”, dependendo do seu navegador e das suas definições pessoais.

Em artigos normais:

  • colocando o ponteiro do rato sobre as ligações chama um excerto do artigo correspondente, colocar o ponteiro do rato sobre “actions” para aceder a mais comandos.
  • se mantiver SHIFT pressionado pode arrastar o popup.

Configuração (opcional)

Alterar a aparência dos popups

Editando o seu ficheiro CSS, pode alterar o aspecto dos popups. O seu ficheiro CSS tem exactamente o mesmo nome que o seu ficheiro javascript, mas termina em css em lugar de js. Para a maioria das pessoas o ficheiro a editar é monobook.css.

Aqui encontra um exemplo que confere aos popups um tom laranja, com bordadura alterando também o tipo de letra utilizado. Trata-se de um exemplo que confere uma aparência um tanto esquisita às janelas, mas que mostra o que pode ser feito, se estiver disposto a isso.

.navpopup { 
  background-color: #FFBE20  !important;
  font-family:      serif    !important;
  color:            #404     !important;
  font-size:        medium   !important;
}

Opções

Existem algumas opções que podem ser configuradas. Para fazê-lo, edite o seu ficheiro javascript (como monobook.js) e adicione uma linha no formato: opção = valor;

Onde opção e valor são escolhidos da tabela abaixo. Por exemplo, para evitar todas as descargas de dados e activar ligações de admin, é necessário algo parecido com isto no seu ficheiro javascript:

// [[User:Lupin/popups.js]] – favor incluir esta linha 
 mw.loader.load ('//en.wikipedia.org/w/index.php?title=User:Lupin/popups.js&action=raw&ctype=text/javascript&smaxage=21600&maxage=86400');
 
simplePopups=true;
popupAdminLinks=true;
Opções de configuração (lista incompleta)
Opção Valor* Descrição
popupDelay Decimal, 0.5 Número de segundos antes de aparecer o popup.
simplePopups true, false Se está interessado apenas nas ligações ou se acha que a largura de banda consumida é demasiado grande, configurar como true. Não serão descarregados quaisquer dados e os popups conterão apenas ligações.
popupStructure 'original', 'fancy', 'fancy2', 'menus', 'shortmenus', 'lite' Selecciona a estrutura dos popups. O valor 'original', é utilizado por defeito se simplePopups=true (ou no caso do seu navegador não suportar menus) e contem todos as ligações de navegação no próprio popup; 'fancy' e 'fancy2' são variações do primeiro caso. O valor 'menus', valor por defeito se o valor para simplePopups é diferente de true, coloca as ligações de navegação em menus popup que surgem quando se coloca o rato sobre ligações que não a do título do popup. O valor shortmenus é uma versão mais aligeirada do valor 'menus', com menos ligações. Finalmente, nostalgia é uma estrutura simples sem menus e lite é uma estrutura muito simples, apenas com Visualização e sem ligações de navegação. Note que para configurar esta opção terá de incluir as plicas, (por exemplo popupStructure='fancy';). No navegador Opera funciona apenas a opção 'original' pois não suporta menus.
popupActionsMenu true, false Ao usar menus pode ter-se a ligação do título do popup a gerar um menu (se o valor for false) ou um menu de “acções” separado (se o valor for true, o valor por defeito).
popupImages true, false Se o valor é false as imagens não são mostradas.
popupAdminLinks true, false Se o valor é true surgem nos popups ligações para acções permitidas a administradores (bloqueios, apagar páginas, (des)proteger páginas).
popupShortcutKeys true, false Se o valor é true é possível seleccionar ligações nos menus rapidamente através de teclas de atalho. Ao passar o ponteiro do rato sobre uma ligação com tecla de atalho associada, esta torna-se visível. Como exemplo, no Opera e no Firefox, para editar rapidamente um artigo numa nova janela, pode-se utilizar e Control-Enter. Pressionando Esc deverá fechar o popup.
popupDragging true, false Se o valor é true é possível arrastar o popup por toda a janela do navegador.
popupFixRedirs true, false Se o valor é true é possível “corrigir” automaticamente ligações para páginas de redireccionamento clicando na ligação “Redirects”.
popupRedirAutoClick 'wpSave', 'wpPreview', 'wpDiff' O botão que é pressionado automaticamente quando corrige redireccionamentos.
popupFixDabs true, false Semelhante a popupFixRedirs- mas para páginas de desambiguação.
popupNavLinks true, false Se o valor é true são mostradas as ligações de navegação; se o valor for false elas são omitidas.
popupLastEditLink true, false Se os popups devem ter uma ligação para a última edição..
popupHistoricalLinks true, false Ao colocar o ponteiro do rato sobre uma ligação diff ou para uma revisão antiga são geradas novas ligações no popup se o valor for true, caso contrário obtêm-se as mesmas ligações que numa ligação normal.
popupPreviews true, false Se o valor é true e se não seleccionou simplePopups, é mostrada uma Visualização da primeira parte do artigo. Se o valor for false não é mostrada Visualização.
popupSummaryData true, false Se o valor for true é mostrado o sumário para a página alvo.
popupLastModified true, false Se o valor for true é mostrada a idade da página no sumário. A idade da página é o tempo que passou desde a última vez que foi editada.
popupOnlyArticleLinks true, false Se o valor for true apenas são gerados popups para as ligações no artigo.
imagePopupsForImages true, false Por defeito é mostrada uma visualização de imagens ao colocar o ponteiro do rato sobre imagens mesmo que visíveis. Se o valor for false isto não acontece.
popupMaxWidth 350, um nº inteiro, false Largura máxima dos popups em pifeis. Se o valor for false, o popup expandir-se-á de forma a acomodar o conteúdo.
popupInitialWidth Um nº inteiro, false A largura inicial dos popups em pifeis. Se o valor for false, o tamanho inicial do popup será o necessário para acomodar o conteúdo inicial do popup.
popupEditCounterTool "kate", "interiot" Selecciona o contador de edições entre a Kate's tool e a Interiot's tool.
Sumários de edição
popuVisualizartSummary string Sumário utilizado quando se reverte uma página sem utilizar um query para obter informação sobre a revisão. O primeiro '%s' na string é substituído pela ID da revisão para a qual a página está a ser revertida.
popupFixRedirsSummary string O sumário utilizado quando reparam redireccionamentos. O primeiro '%s' que surge na string é substituído pela página de redireccionamento e o segundo '%s' pela página alvo.
popupFixDabsSummary string O sumário utilizado quando se procede à desambiguação de ligações. O primeiro '%s' que surge na string é substituído pela página de desambiguação e o segundo '%s' pela página alvo.
Opções de Visualização
popupPreviewKillTemplates true, false Se o valor for true, as pré-definições num artigo são eliminadas das visualizações; no caso contrário, são mostradas como código Wiki.
popupPreviewRawTemplates true, false Se o valor for true, as páginas do namespace pré-definição são visualizadas como código Wiki. Caso contrário é feita uma tentativa de reprodução das mesmas.
popupPreviewFirstParOnly true, false Se o valor for true, a Visualização restringe-se apenas ao primeiro parágrafo do artigo.
popupMaxPreviewSentences um nº inteiro, 4 O número máximo de frases a extrair de algo próximo do princípio do artigo.
popupMaxPreviewCharacters um nº inteiro, 600 O número máximo de caracteres a extrair de algo próximo do princípio do artigo.
Opções técnicas
popupNavLinkSeparator string,
' ⋅ '
HTML inserido entre ligações de navegação. Por defeito o valor é ' • ' para o Konqueror e ' · ' para navegadores Microsoft.
popupAppendRedirNavLinks true, false Se o valor for true é gerado um novo conjunto de ligações de navegação para os alvos de redireccionamentos; se o valor for false, é gerado um aviso sobre o redireccionamento mas não são geradas ligações de navegação. Esta opção não produz qualquer efeito se o valor para popupNavLinks for false.
removeTitles true, false Os títulos das ligações são movidos para a ligação principal do popup se o valor for true.
Opções experimentais
As opções seguintes não foram suficientemente testadas e/ou não estão ainda documentadas: popupCookies, popupExtraUserMenu, popupLinksNewWindow, popupHistoryLimit, popupDiffDatePrinter, popupExtendedRevertSummary, popupTimeOffset, popupPreviewCutHeadings

*Os valores utilizados por defeito estão a negrito.

Personalização avançada

Podem definir-se filtros personalizados para artigos. Não são mais que funções de javascript que são executadas após terem sido geradas as estatísticas da página, e o seu resultado é anexado (como HTML) a essa parte do popup. (Nota: se simplePopups=true ou popupSummaryData=false não será mostrado qualquer resultado).

A forma de obter esta configuração consiste em escrever uma função filtro que aceita uma string (o código wiki do artigo) como entrada, e que produz um fragmento de HTML. Repetir o processo para tantos filtros quantos sejam necessários e depois criar uma matriz (array) extraPopupFilters que contenha todas as funções, na ordem em que se deseja que elas sejam executadas.

Como exemplo, digamos que deseja ser avisado cada vez que o código wiki de um artigo contenha uma tabela escrita usando tags HTML em vez de código wiki. Uma maneira de conseguir isto consiste em adicionar o seguinte ao seu ficheiro javascript de usuário:

// iniciar a matriz – fazer isto apenas uma vez
extraPopupFilters=[];
 
// definir a função
function popupFilterHtmlTable (wikiText) {
  if (/<table/i.test(wikiText)) return '&amp;lt;table&amp;gt;';
  else return '';
};
 
// adicionar a função à matriz (pode-se repetir isto para várias funções) extraPopupFilters.push(popupFilterHtmlTable);

Assim, quando for gerado um popup para uma página contendo uma tabela HTML, deverá aparecer <table> no popup.

Traduções

Clique aqui (em inglês) para ver traduções da interface do script e desta página em outras línguas. Encontrará também instruções para criar a sua própria tradução.

Em português

Pode obter uma tradução do interface em português aqui.

Problemas com navegadores

Safari

Alguns utilizadores descobriram que o navegador Safari falha muitas vezes quando executa este script.

As versões actuais do Safari têm bugs que não permitem que os menus funcionem correctamente. Utilizando Webkit nightly build devem conseguir-se menus que funcionem correctamente.

Opera

As versões mais antigas do Opera não permitem que os menus funcionem correctamente. As versões mais recentes (9.0 ou mais recente) devem apresentar menus funcionais, apesar de ainda poderem ocorrer alguns problemas, como menus não carregados correctamente ou que não desaparecem depois de afastar o ponteiro do rato.

Questões e comentários

Bugs, problemas, sugestões, melhorias favor comentar na página de discussão da Wikipédia inglesa Wikipedia talk:Tools/Navigation popups (em inglês).

Pode informar sobre páginas cuja Visualização tenha problemas aqui (em inglês).

Créditos