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 código-fonte]Geralmente os Gadgets verificam as seguintes condições:
- 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.
- Gadgets devem ser compatíveis com os principais navegadores, ou seja, não devem terminar por causa de erros.
- Gadgets devem ser funcionais na maioria dos navegadores (compatibilidade entre navegadores), e as exceções devem estar indicadas claramente.
- 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 código-fonte]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 código-fonte]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 código-fonte]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 código-fonte]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 código-fonte]| 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 código-fonte]- MediaWiki:Gadget*, lista de páginas do domínio MediaWiki relacionadas aos Gadgets.
- Especial:Gadgets, lista dos gadgets instalados parecida com a que é mostrada nas preferências, mas possui links para edição.
- MediaWiki Discussão:Gadgets-definition, discussão sobre detalhes técnicos sobre como fazer e manter os gadgets.
- Wikipedia:WikiProject User scripts, na Wikipédia inglesa.
- mw:Extension:Gadgets, a página sobre a extensão do Mediawiki