Wikipédia:Scripts/Botões extra de edição

Atenção: Estes botões extras não são mais usados, pelo vector não aceitar mais o código! Este script só funciona com a versão antiga da barra de edições!

O conteúdo desta página se encontra arquivada!

Nota: este script só funciona com a versão antiga da barra de edições.

Os botões como aparecem na Wikipédia em Inglês

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.

Lista completa de botões de edição
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 * Elemento 3
Numeração	G	# Elemento 1 # Elemento 2 # Elemento 3
Insertir lista de definições	H	; Definição : Item 1 : Item 2 : Item 3
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 # Elemento 1.2 # Elemento 1.3 #* Elemento 1.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 seu XEBOrder 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.png
ToolTip é 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.

As popups avançadas atualmente disponíneis são:
Código	Descrição	Comentário
AI	Imagem Avançada	Permite o usuário escolher: O arquivo/ficheiro de imagem; O tipo da imagem se é Moldura (thumb), com borda (border), etc.; A posição da imagem (Esquerda, direita ou centro); O tamanho da imagem em pixels (`px`); Escrever a legenda.
J2	Inserir tabela	Permite o usuário escolher: Com título ou sem título; O número de colunas; O número de linhas; Se é sorteável ou não.
T	Inserir referência material	Permite o usuário escolher: O nome da referência; O texto da referência.
GEO	Coordenadas geográficas	Permite o usuário escolher: A Latitude e a Longitude que pode ser em graus, horas, minutos e segundos; A região da localidade; O tipo da localização (País, Estado, cidade, etc.);

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, digite true e para desativar, digite false. 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, digite true e para desativar, digite false. 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ção XEBHideDelay=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.

Ver também[editar código-fonte]

Botão de edição