Wikilivros:Gadgets

Um Gadget do Wikilvros é um trecho de Javascript e/ou CSS que pode ser habilitado ou desabilitado pelos colaboradores do projeto através de um clique na opção correspondente exibida em suas preferências. A criação de Gadgets é possível graças a extensão do MediaWiki documentada na página Extension:Gadgets.

Considerações gerais sobre os Gadgets

editar

Geralmente os Gadgets verificam as seguintes condições:

  1. Gadgets devem funcionar a partir do momento em que são habilitados, sem a necessidade de qualquer configuração. Eles podem eventualmente ser configuráveis através dos scripts e folhas de estilo pessoais de cada colaborador (monobook.js, etc...), embora seja esperado que funcionem sem exigir configurações adicionais.
  2. Gadgets devem ser compatíveis com os principais navegadores, ou seja, não devem terminar por causa de erros.
  3. Gadgets devem ser funcionais na maioria dos navegadores (compatibilidade entre navegadores), e as exceções devem estar indicadas claramente.
  4. Quando um Gadget funciona apenas em alguns temas do MediaWiki, isto deve ser indicado explicitamente uma vez que seja identificada a incompatibilidade com determinados temas.

Propostas

editar

Os colaboradores do Wikilivros podem propor e discutir a adição de outros gadgets à lista existente nas preferências. As sugestões podem ser deixadas abaixo. Caso você conheça algum gadget que está disponível em outros projetos da Wikimedia Foundation e acredita que ele também pode ser útil aos colaboradores do Wikilivros, sinta-se a vontade para fazer uma indicação. Você pode encontrar alguns scripts em páginas similares a WikiProject User scripts, da Wikipédia inglesa, ou simplesmente consultando as opções exibidas na guia Gadgets da sua página de preferências nos diversos wikiprojetos.

Instalação de novos Gadgets

editar

Novos gadgets podem ser instalados pelos administradores depois que isso for discutido com a comunidade. O procedimento é o seguinte:

  • Cria-se uma página como MediaWiki:Gadget-nomedoscript.js, contendo um cabeçalho que descreva o script e o seu código fonte propriamente dito.
  • Opcionalmente, cria-se uma folha de estilos sob o nome MediaWiki:Gadget-nomedoscript.css
  • Adiciona-se uma {{Descrição do gadget}} na página MediaWiki:Gadget-nomedoscript, indicando uma página com a documentação do script e se necessário, quaisquer exigências quanto aos navegadores ou os temas para os quais o recurso funciona. Aqui, o nomedoscript deve começar com uma letra (ASCII) e só pode conter letras não acentuadas (ASCII), números e espaços. Portanto não use acentos neste nome.
  • Identifique na página MediaWiki:Gadgets-definition qual a seção adequada para o novo gadget e adicione
    * nomedoscript|nomedoscript.js[|nomedoscript.css|outroscript.js|...]
  • Atualize a tabela de gadgets instalados disponível a seguir.

Depois disso, o novo recurso deverá estar aparecer na página Especial:Gadgets (e consequentemente na página de preferências) .

Comentários

editar

Para deixar observações e avisos ao criar as descrições dos gadgets, pode-se usar uma das seguintes formas:

  • Com tags noiclude (visível na página de descrição, com links): <noinclude> comentário </noinclude>;
  • Com comentários em HTML (visível apenas no código fonte): <!-- comentário -->.

Comentários criados desta maneira serão descartados automaticamente durante o processo de criação da página.

Exemplo de cabeçalho

editar

Ao criar uma página contendo scripts ou folhas de estilo para os gadgets do Wikilivros, adicione um cabeçalho como o que segue:

/*  _____________________________________________________________________________
 * |                                                                             |
 * |                    === AVISO: ARQUIVO DE GADGET GLOBAL ===                  |
 * |            Alterações a esta página afetarão vários colaboradores           |
 * |            Por favor discuta alterações na página de discussão ou           |
 * |                    em [[Wikilivros:Gadgets]] antes de editar.               |
 * |_____________________________________________________________________________|
 *
 * Importado da versão XXXX de DATA do [[PROJETO:IDIOMA:ORIGEM DO SCRIPT]]
 * BREVE DESCRIÇÃO, veja [[PÁGINA DE AJUDA SOBRE O SCRIPT]]
 */

Gadgets instalados no momento

editar
Descrição Script:
Página, fonte, quem mantém
Gadget:
Versão, descrição, Script, CSS
Interface
Histórico resumido: Resume o histórico das páginas, agrupando as edições de um mesmo usuário e abreviando o nome das ligações mais comuns. [comentários] w:en:User:Alex Smotrov Histórico resumido.js
Purgar: Adiciona ao topo da página um botão para purgar o cache da página. [comentários] User:Helder.wiki purgetab.js
IRC: Torna possível o uso de uma predefinição para se conectar ao canal de IRC do Wikilivros. [comentários] User:Helder.wiki IRC.js
Links para gadgets dos livros: Exibe links para facilitar a navegação entre um livro e seus gadgets (globais e pessoais) [documentação / comentários] User:Helder.wiki Links para gadgets dos livros.js
⧼Gadget-FiltroListas⧽ w:en:User:Splarka, & commons:User:Lupo Filtro para listas.js
Edição
Botões extras: Acrescenta alguns botões acima da caixa de edição. [comentários] w:en:User:MarkS Botões extras.js
⧼Gadget-HotCat⧽ commons:user:Magnus Manske HotCat.js
Localizar e substituir: Adiciona à janela de edição o recurso de localizar e substituir texto. Também permite alternar entre maiúsculas e minúsculas: TEXTO → texto → Texto. [comentários] w:en:User:Zocky Localizar e substituir.js
AjaxPrev: Adiciona novos botões para prever o resultado de uma edição sem precisar recarregar a página toda (usa AJAX). Também fornece outra opção para mostrar diferenças. Em ambos os casos, mantém o histórico de uso do (Ctrl-Z) e a posição do cursor. [documentação / comentários] w:en:User:Alex Smotrov Wikilivros:Gadgets/ajaxPrev, ajaxPreview.js, ajaxPreview.css
WikEd: Editor com funções avançadas (funciona com Firefox, Mozilla, SeaMonkey, Safari ou Chrome) [documentação / comentários] w:en:User:Cacycle wikEd.js
Navegação
Busca aprimorada: Acrescenta 3 menus na página Especial:Busca, permitindo escolher o wikiprojeto, o idioma e o mecanismo de busca utilizado na pesquisa. [comentários] User:Helder.wiki Busca aprimorada.js, externalsearch.js
Busca nos livros: Adiciona botão para realizar uma busca dentro do livro atual. (somente Monobook) [comentários] User:Helder.wiki Busca nos livros.js
Popups de navegação: Exibe uma previsão das páginas e funções de edição ao passar o mouse sobre uma ligação. [documentação / comentários] User:Helder.wiki popups.js, popups.css, w:en:MediaWiki:Gadget-popups.js
⧼Gadget-Navegacao automatica⧽ User:Helder.wiki Navegação automática.js, Navegação automática.css, mw:Special:Code/MediaWiki/65014
Simplificação dos títulos: Exibe "Capítulo" em vez de "Livro/Capítulo", tanto na página de cada um dos capítulos quanto na categoria do livro. [comentários] User:Helder.wiki Títulos simples.js, Títulos simples.css
Conversor de Idiomas: Inclui menus no topo das páginas para permitir a conversão do texto para a variante ou idioma local preferido pelo leitor. (atualmente em beta) [documentação / comentários] User:Helder.wiki LanguageConverter.js, LanguageConverter.css
Bibliotecas e compatibilidade
Compatibilizar: Funções de compatibilidade para executar usando o novo tema Vector os scripts que foram testados apenas no tema Monobook. (somente Vector) [comentários] w:en:User:TheDJ, w:en:User:Amalthea & w:en:User:Liangent vectorskin-thunks.js
Para usuários com permissões extras
AJAX sysop: Este script irá listar as subpáginas e páginas de discussão no formulário para exclusão de páginas. Ele também fornece fácil acesso ao bot rollback. (para administradores) [documentação / comentários] meta:User:Pathoschild meta:User:Pathoschild/Scripts/Ajax sysop, Informação adicional.js

Veja também

editar