Wikipedia:Software/Popups de navegação
Origem: Wikipédia, a enciclopédia livre.
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: 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.
Índice |
[editar] 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).
[editar] 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 monobook.js. Isto vai fazer com que seja adicionado o seguinte código ao seu ficheiro .js:
// [[User:Lupin/popups.js]]
document.write('<script type="text/javascript" src="'
+ 'http://en.wikipedia.org/w/index.php?title=User:Lupin/popups.js'
+ '&action=raw&ctype=text/javascript&dontcountme=s"></script>');
Nota: Se utiliza um skin que não o monobook, o ficheiro a ser editado é um dos listados abaixo:
- Classic skin: standard.js
- Cologne Blue: cologneblue.js
- Chick: chick.js
- Simple: simple.js
- Nostalgia: nostalgia.js
- MySkin: myskin.js
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.
[editar] 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.
[editar] Configuração (opcional)
[editar] 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;
}
[editar] 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
document.write('<script type="text/javascript" src="'
+ 'http://en.wikipedia.org/w/index.php?title=User:Lupin/popups.js'
+ '&action=raw&ctype=text/javascript&dontcountme=s"></script>');
simplePopups=true;
popupAdminLinks=true;
|
|
||
| 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.
[editar] 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 '<table>';
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.
[editar] 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.
[editar] Em português
Pode obter uma tradução do interface em português aqui.
[editar] Problemas com navegadores
[editar] 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.
[editar] 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.
[editar] Questões e comentários
Bugs, problemas, sugestões, melhorias favor contactar Lupin (em inglês).
Pode informar sobre páginas cuja Visualização tenha problemas aqui (em inglês).
[editar] Créditos
- en:User:Lupin Autor do script
- en:Wikipedia:Tools/Navigation popups Página original em inglês, contem outros créditos.
