Wikipédia:Scripts/Botões extra de edição
- Nota: este script só funciona com a versão antiga da barra de edições.
Os botões extra de edição permitem a um usuário mudar os botões que se encontram no topo da caixa de edição. As principais características do script são:
- Adição de botões à barra de ferramentas. Os botões extra disponibilizam uma grande quantidade de botões adicionais. A simples inclusão do script adicionará um conjunto de botões à sua barra de edição.
- Opção de modificar a ordem dos botões.
- Opção de remover botões padrão.
- Opção de incluir botões definidos pelo usuário.
- Caixas de diálogo popup que permitem modificar facilmente o código utilizado.
Navegadores compatíveis
[editar código-fonte]Os botões extra de edição são normalmente testados em:
- Firefox (Windows XP SP2)
- Internet Explorer 7 (Windows XP SP2)
- Opera (Windows XP SP2)
- Safari (Windows) v3.0.1 e posteriores.
Normalmente, o código é ligeiramente modificado para que funcione nestes navegadores web.
Por vezes, é também testado em:
- SeaMonkey (Windows XP SP2)
- Firefox em Linux (Ubuntu).
- Konqueror (Ubuntu)
- Versões antigas de Internet Explorer.
Instalação
[editar código-fonte]Para obter botões extra de edição, faça o seguinte:
- Na lista de "Gadgets" nas suas preferências, ative a opção:
- Botões extras: Incluir mais botões na barra de ferramentas de edição antiga (desabilitado no momento) [documentação | exemplo | comentários]
- Na seção "Edição", desative a opção
- Ativar a barra de ferramentas de edição
Caso você queira personalizar ainda mais o conjunto de botões da barra de ferramentas, coloque o código seguinte no seu common.js e modifique-o de acordo com sua necessidade:
// Configuração personalizada para o script que inclui botões extras de edição
window.XEBOrder = 'A,B,C,D,D1,E,F,J1,J2,K,M,N,O,P,P1,Q,R,R1,R2,R3,R4,S,T,TS,TC,TE,TR,T1,TL,U,V,W,X,Y1,Y2,Z,AI,GEO,TALK';
window.rmEditButtons = ['all'];
window.myButtons = [];
window.XEBPopups = true;
window.XEBExtendEditSummary = true;
window.XEBHideDelay = 3.0;
Após isto, refresque a cache (seleccione SHIFT + Atualizar/Recarregar no seu navegador) e aparecerão os novos botões na sua barra de ferramentas. Não é necessário editar mais nada; se após algum tempo desejar alterar os botões disponíveis ou a sua ordem, então leia por favor as instruções abaixo.
Notas:
XEBOrder
especifica que botões são mostrados e qual a ordem destes.rmEditButtons
lista os botões padrão a serem removidos.myButtons
lista botões extra que você deseje utilizar junto com os disponíveis.
Se você não deseja adicionar uma ou mais variáveis ao seu monobook.js, os botões extra de edição ainda assim funcionarão.
Os botões
[editar código-fonte]Os botões extras de edição incluem os botões listados abaixo. Aqueles marcados como padrão (cujos códigos são números (rmEditButtons
)) e os botões extras (cujos códigos são alfanuméricos (XEBOrder
)) podem ser removidos. Usando a opção XEBOrder
você pode escolher a ordem em que os botões aparecerão no painel.
Ícone | Nome | Código | Comentário / O que mostra quando está editando |
---|---|---|---|
Negrito | 0 | '''texto a negrito''' | |
Itálico | 1 | ''Texto em itálico'' | |
Ligação interna | 2 | [[Título da ligação]] | |
Ligação externa | 3 | [http://www.wikimedia.org ligação externa] | |
Seção de nível 2 | 4 | == Texto de cabeçalho == | |
Imagem anexa | 5 | [[Imagem:Examplo.jpg]] | |
Liga arquivo de mídia | 6 | [[Media:Example.ogg]] | |
Fórmula Matemática | 7 | <math>Inserir fórmula aqui</math> | |
Ignorar formato wiki | 8 | <nowiki>Inserir texto não-formatado aqui</nowiki> | |
Assinatura | 9 | -- ~~~~ | |
Linha Horizontal | 10 | ---- | |
Redireccionar página | A | #REDIRECT [[Título da ligação]] | |
Texto em tamanho pequeno | B | <small>Inserir texto não-formatado aqui</small> | |
Texto em tamanho grande | C | <big>Inserir texto não-formatado aqui</big> | |
Texto sobrescrito | D | <sup>Inserir texto não-formatado aqui</sup> | |
Texto subscrito | D1 | <sub>Inserir texto não-formatado aqui</sub> | |
Texto riscado | E | <s>Inserir texto não-formatado aqui</s> | |
Texto sublinhado | F | <u>Inserir texto não-formatado aqui</u> | |
Lista normal | FS | * Elemento 1 * Elemento 2 | |
Numeração | G | # Elemento 1 # Elemento 2 | |
Insertir lista de definições | H | ; Definição : Item 1 : Item 2 | |
Bloco de texto citado | I1 | <blockquote style="border: 1px solid blue; padding: 2em;"> Inserir texto não-formatado aqui </blockquote> | |
Texto em colunas | I2 |
<div style="-moz-column-count:2; -webkit-column-count:2; column-count:2;"> Inserir texto não-formatado aqui </div> | |
Texto colorido e formatado | J1 | <font face="Old English Text MT" size="2" color="red">Inserir texto não-formatado aqui</font> | |
Inserir tabela | J2 |
Mostra uma popup que premite configurar a tabela antes de inserir. | |
Galeria de imagens | K |
<gallery>
Imagem:Air.canada.b767-300.c-ggfj.2.jpg|[[Avião]]
Imagem:Mona Lisa.jpg|[[Mona Lisa]]
Imagem:Albert Einstein Head.jpg|[[Albert Einstein ]]
</gallery> | |
Citação | L |
{{quote2|Inserir citação aqui|nome do autor}} | |
Referir um usuário que não assinou | M | {{não assinou|Utilizador ou IP|~~~~}} | |
Ligação interna com sublink | N | [[Título da ligação#Sublink]] | |
Comentário oculto | O | <!-- Comentário --> | |
Seção de nível 3 | P | === Texto de cabeçalho === | |
Imagem panorâmica | P1 | {{Panorama|Skyline-New-York-City.jpg|2000px|Vista de [[Manhattan]]}} | |
Assinatura Extra | Q | ~~~~ | |
Quebra de linha | R | <br /> | |
Ver também | R1 | =={{Ver também}}== | |
Ligação externa (predefinição) | R2 | =={{Ligações externas}}== | |
Notas e Referências | R3 | {{ref-section|Notas e Referências}} | |
Categorizar página | R4 | [[Categoria:Nome da categoria]] [[Categoria:!Scripts]] | |
Texto em código-fonte | S | <code>Inserir texto não-formatado aqui</code> | |
Inserir referência material | T | <ref></ref> | |
Marcar como mínimo | TS | {{mínimo sobre|Título da ligação}} | |
Marcar como esboço | TC | {{esboço-tema}} | |
Marcar para revisão | TE | Insere a predefinição {{revisão}} com data automatizada. | |
Marcar para wikificar | TR |
Insere a predefinição {{wikificação}} com data automatizada. | |
Marcar para reciclar | T1 | Insere a predefinição {{reciclar}} com data automatizada. | |
Marcar para parcial | TL | Insere a predefinição {{parcial}} com data automatizada. | |
Marcar como controverso | U | {{controverso}} | |
Marcar para corrigir | V | {{corrigir}} | |
Pedir tradução | W | {{traduzir}} | |
Propor fusão | X | {{fusão|Título da ligação}} | |
Propor Eliminação Rápida | Y1 | {{ER|lista|~~~~}} | |
Adicionar predefinição | Y2 | {{Nome da predefinição}} | |
Referir um usuário ou IP | Z | {{Usuário2|Nome do usuário ou IP}} | |
Imagem Avançada | AI | Mostra uma popup que simplifica todo o processo de "como usar imagens". | |
Coordenadas geográficas | GEO | Mostra uma popup que permite escolher as coordenadas geográficas, o tipo do lugar (Cidade, montanha ...) adicionando uma predefinição de coordenadas. | |
Mensagens predefinidas para usuários | TALK | Mostra uma popup que permite adicionar mensagens predefinidas à sua escolha. | |
Texto para o lado esquerdo | LT | <div style="text-align: left;">Inserir texto não-formatado aqui</div> | |
Texto centralizado | CT | <div style="text-align: center;">Inserir texto não-formatado aqui</div> | |
Texto para o lado direito | RT | <div style="text-align: right;">Inserir texto não-formatado aqui</div> | |
Seção de nível 4 | Q1 | ==== Texto de cabeçalho ==== | |
Tabulação | TB | :: | |
Texto de teletipo | TT | <tt>Inserir texto não-formatado aqui</tt> | |
Criar página de desambiguação | DE | Cria uma página com a predefinição {{desambiguação}}. | |
Lista combinada | LC | * Elemento 1 *# Elemento 1.1 | |
Ligação interna com nome difente | LN | [[Título da ligação|Nome diferente]] | |
Mostrar o código wiki (preservando as quebras de linha) | S1 | <pre>Inserir texto não-formatado aqui</pre> | |
Mostrar código da predefinição | Y3 | <pre>{{tl|Nome da predefinição}}</pre> | |
Poema | PO | <poem>Inserir texto não-formatado aqui</poem> |
Configurando o layout: XEBOrder
[editar código-fonte]XEB mostra os botões padrão na ordem que são listados automaticamente.
Você pode trocar a ordem em que os botões são mostrados no painel de edição por criar uma ordem de botões separada por vírgula (,) na opção XEBOrder
como você vê no exemplo:
XEBOrder="A,B,C,E,G,I1,I2,R1,R2,R4,T1,Y1,Y2,Z,AI,N";
Removendo botões: rmEditButtons
[editar código-fonte]rmEditButtons
lista os botões que são removidos no painel de edição. Neste você usa para remover apenas os botões originais da Wikipédia lusófona. No exemplo:
rmEditButtons=[0,2]
irá remover os botões 0 e 2 do seu painel.
rmEditButtons=['all']
Todos os botões irão permanecer no seu painel, isto significa que todos os botões podem ser removidos do seu painel. Você pode usar esta opção para ativar ou desativar no seu painel de edição.
rmEditButtons
podem remover botões da Wikipédia permitindo organizá-los usando o XEBOrder
na ordem que você quiser. Esses botões são numerados na forma que você possa organizá-los. Se você deseja remover botões padrão dos botões extra de edição basta removê-los do XEBOrder
, assim eles não aparecerão no seu painel.
Botões padrão da Wikipédia
[editar código-fonte]O software da Wikipédia usa 11 botões padrão, na Wikipédia de lingua inglesa usa mais 11 botões extras. Esses 22 botões são padrão para todos os usuários. XEB permite o acesso para esses botões em que cada botão é um número (Negrito é 0, Itálico é 1 ...). Você pode usar esses códigos de duas maneiras: (i) você pode incluir para aparecer no seu painel, (ii) você pode usar em rmEditButtons
para que a Wikipédia não o mostre. E assim você pode customizar o painel.
Criando botões: myButtons
[editar código-fonte]XEB pode trabalhar com botões criados pelo usuário. Para fazê-lo, você pode defini-los em myButtons
no seu monobook.js. O formato dos botões é:
myButtons={'CODE1':['url1','Tooltip1','Before1','After1','Text1'], 'CODE2':['url2','Tooltip2','Before2','After2','Text2']};
Sendo que:
CODE
é o código do botão. Você deve colocá-lo no seuXEBOrder
para que apareça no painel. Você pode adicionar mais desde que você reinicie o código para introduzi-lo no XEB. Estes códigos devem ser feitos em letra maiúscula.URL
é a URL da imagem do botão. Você deve introduzir o URL da imagem sozinho, e não a página de Wikimedia que descreve o botão, assim usa: *http://upload.wikimedia.org/wikipedia/commons/f/f0/Bouton_Vandale0.png em vez de http://commons.wikimedia.org/wiki/Image:Bouton_Vandale0.pngToolTip
é a legenda que irá aparecer quando movimenta o mouse (rato) em cima dos botão.Before
é o texto que é inserido antes da localização do cursor.After
é o texto que é inserido após a localização do cursor.Text
é o texto que será inserido entre "Before" e "After".- As imagens para serem usados nos botões podem ser encontradas aqui.
Exemplo de dois botões extras:
myButtons={'ZZ':['http://upload.wikimedia.org/wikipedia/commons/e/e9/Button_headline2.png','Mark Test','Before','After','Middle'], 'ZA':['http://upload.wikimedia.org/wikipedia/commons/1/13/Button_enter.png','Mark2 Test','111','333','222']};
Popups
[editar código-fonte]As popups permitem que os usuários façam edições avançadas com apenas um clique gerando um código ao clicar no botão "Inserir" e uma apenas para mensagens.
- Nota: Todas as popups têm um tempo limitado de permanência ao retirar o mouse/rato de cima dele e possue também um sumário automático que aparece ao inserir o código.
Configuração
[editar código-fonte]Para configurar as popups não tem mistério pois é de fácil configuração usando os seguintes códigos:
XEBPopups
: Permite o usuário ativar ou desativar as popups. Para ativar, digitetrue
e para desativar, digitefalse
. A opção que vem como padrão étrue
;XEBExtendEditSummary
: Permite o usuário ativar ou desativar o sumário automático ao inserir o código. Para ativar, digitetrue
e para desativar, digitefalse
. A opção que vem como padrão étrue
;XEBHideDelay
: Permite o usuário escolher o tempo de permanência das popups quando o mouse/rato for retirado das popups. O tempo configurado aparece em segundos (um exemplo é se você escolhe a seguinte opçãoXEBHideDelay=3.5
a popup permanecerá durante 3 segundos e meio ativo ao retirar o mouse/rato de cima da popup. O tempo que vem como padrão é1.0
.