|
** 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 [[Special:Userlogin |criar uma]] e fazer ''log in''.
O próximo passo é adicionar '''<nowiki>{{</nowiki>subst:[[Template:navpop|navpop]]}}''' à [[Special:Mypage/common.js|sua página common.js]]. Isto vai fazer com que seja adicionado o seguinte código a sua página de ''scripts'' globais:
<br clear=all />
<source lang="Javascript">
// [[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');
</source>
'''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:
* Vector: [[Special:Mypage/vector.js|vector.js]]
* Monobook: [[Special:Mypage/monobook.js|monobook.js]]
* Classic skin: [[Special:Mypage/standard.js|standard.js]]
* Cologne Blue: [[Special:Mypage/cologneblue.js|cologneblue.js]]
* Chick: [[Special:Mypage/chick.js|chick.js]]
* Simple: [[Special:Mypage/simple.js|simple.js]]
* Nostalgia: [[Special:Mypage/nostalgia.js|nostalgia.js]]
* MySkin: [[Special:Mypage/myskin.js|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.
== 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 é [[Especial:Mypage/monobook.css|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.
<source lang="CSS">
.navpopup {
background-color: #FFBE20 !important;
font-family: serif !important;
color: #404 !important;
font-size: medium !important;
}
</source>
=== Opções ===
Existem algumas opções que podem ser configuradas. Para fazê-lo, edite o seu ficheiro javascript (como [[Special:Mypage/monobook.js|monobook.js]]) e adicione uma linha no formato: <tt>''opção'' = ''valor'';</tt>
Onde <tt>''opção''</tt> e <tt>''valor''</tt> 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:
<source lang="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;
</source>
{| class="wikitable" cellpadding="4" border="1"
|colspan=3|<center>'''Opções de configuração (lista incompleta)'''</center>
|-
!Opção
!Valor*
!Descrição
|-
|<tt>popupDelay</tt>
|Decimal, '''0.5'''
|Número de segundos antes de aparecer o popup.
|-
|<tt>simplePopups</tt>
|<tt>true</tt>, '''<tt>false</tt>'''
|Se está interessado apenas nas ligações ou se acha que a largura de banda consumida é demasiado grande, configurar como <tt>true</tt>. Não serão descarregados quaisquer dados e os popups conterão apenas ligações.
|-
|<tt>popupStructure</tt>
|<tt>'original'</tt>, <tt>'fancy'</tt>, <tt>'fancy2'</tt>, <tt>''''menus''''</tt>, <tt>'shortmenus'</tt>, <tt>'lite'</tt>
|Selecciona a estrutura dos popups. O valor <tt>'original'</tt>, é utilizado por defeito se <tt>simplePopups=true</tt> (ou no caso do seu navegador não suportar menus) e contem todos as ligações de navegação no próprio popup; <tt>'fancy'</tt> e <tt>'fancy2'</tt> são variações do primeiro caso. O valor <tt>'menus'</tt>, valor por defeito se o valor para <tt>simplePopups</tt> é diferente de <tt>true</tt>, 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 <tt>shortmenus</tt> é uma versão mais aligeirada do valor <tt>'menus'</tt>, com menos ligações. Finalmente, <tt>nostalgia</tt> é uma estrutura simples sem menus e <tt>lite</tt> é 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 <tt>popupStructure='fancy';</tt>). No navegador Opera funciona apenas a opção <tt>'original'</tt> pois não suporta menus.
|-
|<tt>popupActionsMenu</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Ao usar menus pode ter-se a ligação do título do popup a gerar um menu (se o valor for <tt>false</tt>) ou um menu de “acções” separado (se o valor for <tt>true</tt>, o valor por defeito).
|-
|<tt>popupImages</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Se o valor é <tt>false</tt> as imagens não são mostradas.
|-
|<tt>popupAdminLinks</tt>
|<tt>true</tt>, '''<tt>false</tt>'''
|Se o valor é <tt>true</tt> surgem nos popups ligações para acções permitidas a administradores (bloqueios, apagar páginas, (des)proteger páginas).
|-
|<tt>popupShortcutKeys</tt>
|<tt>true</tt>, '''<tt>false</tt>'''
|Se o valor é <tt>true</tt> é 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 <tt>e Control-Enter</tt>. Pressionando Esc deverá fechar o popup.
|-
|<tt>popupDragging</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Se o valor é <tt>true</tt> é possível arrastar o popup por toda a janela do navegador.
|-
|<tt>popupFixRedirs</tt>
|<tt>true</tt>, '''<tt>false</tt>'''
|Se o valor é <tt>true</tt> é possível “corrigir” automaticamente ligações para páginas de redireccionamento clicando na ligação “Redirects”.
|-
|<tt>popupRedirAutoClick</tt>
|'''<tt>'wpSave'</tt>''', <tt>'wpPreview'</tt>, <tt>'wpDiff'</tt>
|O botão que é pressionado automaticamente quando corrige redireccionamentos.
|-
|<tt>popupFixDabs</tt>
|<tt>true</tt>, '''<tt>false</tt>'''
|Semelhante a <tt>popupFixRedirs</tt>- mas para páginas de desambiguação.
|-
|<tt>popupNavLinks</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Se o valor é <tt>true</tt> são mostradas as ligações de navegação; se o valor for <tt>false</tt> elas são omitidas.
|-
|<tt>popupLastEditLink</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Se os popups devem ter uma ligação para a última edição..
|-
|<tt>popupHistoricalLinks</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|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 <tt>true</tt>, caso contrário obtêm-se as mesmas ligações que numa ligação normal.
|-
|<tt>popupPreviews</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Se o valor é <tt>true</tt> e se não seleccionou <tt>simplePopups</tt>, é mostrada uma Visualização da primeira parte do artigo. Se o valor for <tt>false</tt> não é mostrada Visualização.
|-
|<tt>popupSummaryData</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Se o valor for <tt>true</tt> é mostrado o sumário para a página alvo.
|-
|<tt>popupLastModified</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Se o valor for <tt>true</tt> é 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.
|-
|<tt>popupOnlyArticleLinks</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Se o valor for <tt>true</tt> apenas são gerados popups para as ligações no artigo.
|-
|<tt>imagePopupsForImages</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Por defeito é mostrada uma visualização de imagens ao colocar o ponteiro do rato sobre imagens mesmo que visíveis. Se o valor for <tt>false</tt> isto não acontece.
|-
|<tt>popupMaxWidth</tt>
|'''350''', um nº inteiro, <tt>false</tt>
|Largura máxima dos popups em pifeis. Se o valor for <tt>false</tt>, o popup expandir-se-á de forma a acomodar o conteúdo.
|-
|<tt>popupInitialWidth</tt>
|Um nº inteiro, '''<tt>false</tt>'''
|A largura inicial dos popups em pifeis. Se o valor for <tt>false</tt>, o tamanho inicial do popup será o necessário para acomodar o conteúdo inicial do popup.
|-
|<tt>popupEditCounterTool</tt>
|'''"kate"''', "interiot"
|Selecciona o contador de edições entre a ''Kate's tool'' e a ''Interiot's tool''.
|-
|colspan=3|'''Sumários de edição'''
|-
|<tt>popuVisualizartSummary</tt>
|''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.
|-
|<tt>popupFixRedirsSummary</tt>
|''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.
|-
|<tt>popupFixDabsSummary</tt>
|''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.
|-
|colspan=3|'''Opções de Visualização'''
|-
|<tt>popupPreviewKillTemplates</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Se o valor for <tt>true</tt>, as pré-definições num artigo são eliminadas das visualizações; no caso contrário, são mostradas como código Wiki.
|-
|<tt>popupPreviewRawTemplates</tt>
|<tt>true</tt>, '''<tt>false</tt>'''
|Se o valor for <tt>true</tt>, 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.
|-
|<tt>popupPreviewFirstParOnly</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Se o valor for <tt>true</tt>, a Visualização restringe-se apenas ao primeiro parágrafo do artigo.
|-
|<tt>popupMaxPreviewSentences</tt>
|um nº inteiro, '''4'''
|O número máximo de frases a extrair de algo próximo do princípio do artigo.
|-
|<tt>popupMaxPreviewCharacters</tt>
|um nº inteiro, '''600'''
| O número máximo de caracteres a extrair de algo próximo do princípio do artigo.
|-
|colspan=3|'''Opções técnicas'''
|-
|<tt>popupNavLinkSeparator</tt>
|''string'', <br>'''<tt><nowiki>' &sdot; '</nowiki></tt>'''
|HTML inserido entre ligações de navegação. Por defeito o valor é <tt>' &bull; '</tt> para o [[Konqueror]] e <tt>' &#183; '</tt> para navegadores Microsoft.
|-
|<tt>popupAppendRedirNavLinks</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Se o valor for <tt>true</tt> é gerado um novo conjunto de ligações de navegação para os alvos de redireccionamentos; se o valor for <tt>false</tt>, é 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 <tt>popupNavLinks</tt> for <tt>false</tt>.
|-
|<tt>removeTitles</tt>
|'''<tt>true</tt>''', <tt>false</tt>
|Os títulos das ligações são movidos para a ligação principal do popup se o valor for <tt>true</tt>.
|-
|colspan=3|'''Opções experimentais'''
|-
|colspan=3|As opções seguintes não foram suficientemente testadas e/ou não estão ainda documentadas: <tt>popupCookies</tt>, <tt>popupExtraUserMenu</tt>, <tt>popupLinksNewWindow</tt>, <tt>popupHistoryLimit</tt>, <tt>popupDiffDatePrinter</tt>, <tt>popupExtendedRevertSummary</tt>, <tt>popupTimeOffset</tt>, <tt>popupPreviewCutHeadings</tt>
|}
<nowiki>*</nowiki>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) <tt>extraPopupFilters</tt> 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:
<source lang="Javascript">
// iniciar a matriz – fazer isto apenas uma vez
extraPopupFilters=[];
// definir a função
function popupFilterHtmlTable (wikiText) {
if (/<table/i.test(wikiText)) return '&lt;table&gt;';
else return '';
};
// adicionar a função à matriz (pode-se repetir isto para várias funções) extraPopupFilters.push(popupFilterHtmlTable);
</source>
Assim, quando for gerado um popup para uma página contendo uma tabela HTML, deverá aparecer <table> no popup.
== Traduções ==
Clique [[:en: Wikipedia:Tools/Navigation_popups/Translation|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 [[Usuário:João Sousa/strings-pt.js|aqui]].
== Problemas com navegadores ==
[[Categoria:!Scripts]]
[[eo:Vikipedio:Aldonaĵoj/Naviga saltofenestro]]
[[ms:Wikipedia:Peralatan/Navigation popups]]
| 