Wikilivros:Gadgets dos livros

O script que habilita o uso deste recurso faz parte do MediaWiki:Common.js, e é carregado para todos os usuários.

O recurso permite que os autores de wikilivros definam gadgets para seus livros, nos quais podem ser colocados scripts (em Javascript) e folhas de estilos (CSS) para serem usadas ao longo de todos os módulos que compõe determinado livro.

Possíveis aplicações

Há várias situações em que um autor pode preferir definir scripts e folhas de estilos para o livro que está escrevendo. Algumas aplicações são as seguiontes:

Justificar todos os parágrafos em um livro.
Indentar todos os parágrafos de um livro;
Alterar a cor de todos os links de um livro (ou ainda, somente aqueles que apontam para determinada página);
Alterar a cor dos links conforme o wikiprojeto para o qual apontam;
Economizar no tamanho das páginas que usam predefinições onde aparecem muito código que serve apenas para formatação;
(Mais difícil de fazer mas também possível:) Criar scripts para fornecer ferramentas específicas para certos livros (por exemplo, um script para navegação automática similar à atual predefinição:AutoNav, mas que pode ser bem mais econômico e prático de fazer para livros grandes);

Uso dos recursos existentes

Não é preciso fazer nada para acessar os aprimoramentos já existentes para cada livro, pois como o script está habilitado por padrão, todos os livros do projeto para os quais tenham sido criadas páginas de Javascript ou CSS específicas serão visualizados com essas funcionalidades.

As páginas contendo as folhas de estilo que ajudam na formatação dos livros ficam disponíveis no espaço nominal "MediaWiki", sob um nome da forma MediaWiki:Livros/Nome do livro.css. Os scripts, por sua vez, podem ser encontrados nas páginas do tipo MediaWiki:Livros/Nome do livro.js.

Por segurança, as páginas deste espaço nominal estão bloqueadas por padrão, então para que seja criada uma página com o código para o seu livro, você deve fazer o pedido a um dos adminstradores do Wikilivros. Para poder esboçar seus próprios gadgets para algum livro do projeto, basta utilizar subpáginas da sua página de usuário.

As páginas contendo as folhas de estilo definidas por um usuário para alterar a formatação dos seus livros favoritos ficam disponíveis nas subpáginas deste usuário, sob um nome da forma Usuário:Nome/Livros personalizados/Nome do livro.css. Os scripts, por sua vez, podem ser encontrados nas páginas do tipo Usuário:Nome/Livros personalizados/Nome do livro.js. A lista a seguir mostra todos os gadgets dos livros existentes:

Lista de páginas começando com o prefixo "MediaWiki:Livros"

(editar predefinição)

Criando gadgets para um livro

Por segurança, as páginas do espaço nominal MediaWiki (onde estão os scripts e as folhas de estilo definidas pelos autores dos livros, usadas pelo gadget Livros) ficam bloqueadas, e só podem ser editadas pelos adminstradores do projeto. Sendo assim, para que um autor crie uma destas páginas com o código que será usado em seu livro, ele precisa pedir a um administrador.

No entanto, antes de fazer o pedido, os autores podem fazer tantos testes quantos forem necessários usando as suas subpáginas. Deste modo, se for cometido algum erro ao elaborar o código, ele só estará afetando o próprio autor. Então, depois de ter certeza de que está tudo funcionando como desejado, o autor pode solicitar a um dos administradores para mover o código criado para a página do espaço nominal MediaWiki (onde passará a ter efeito para os demais usuários que estiverem com o gadget "Livros" habilitado).

Veja também

Wikilivros:Gadgets/Links para gadgets dos livros - Exibe alguns links adicionais que facilitam a navegação entre um livro específico e seus gadget.