Mostrar código-fonte de Testwiki:Scripts/Botões extra de edição

{{Aviso genérico|1=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!<hr> <font color="Gray">''O conteúdo desta página se encontra arquivada!''</font>}}

:'''Nota''': este script só funciona com a versão antiga da barra de edições.
[[Ficheiro:Toolbar2.JPG|thumb|350px|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 ==
Os botões extra de edição são normalmente testados em:
* [[Firefox]] (Windows XP SP2)
* [[Internet Explorer|Internet Explorer 7]] (Windows XP SP2)
* [[Opera]] (Windows XP SP2)
* [[Safari (navegador)|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 ==
Para obter botões extra de edição, faça o seguinte:
# Na [[Especial:Preferências#mw-prefsection-gadgets|lista de "Gadgets" nas suas preferências]], ative a opção:
#* {{int:Gadget-Extra-Editbuttons}}
# Na seção "[[Especial:Preferências#mw-prefsection-editing|{{int:prefs-editing}}]]", desative a opção
#* {{int:wikieditor-toolbar-preference}}
Caso você queira personalizar ainda mais o conjunto de botões da barra de ferramentas, coloque o código seguinte no seu [[Special:Mypage/common.js|common.js]] e modifique-o de acordo com sua necessidade:
<syntaxhighlight lang="javascript">
// 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;
</syntaxhighlight>

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:
* <code>XEBOrder</code> especifica que botões são mostrados e qual a ordem destes.
* <code>rmEditButtons</code> lista os botões padrão a serem removidos.
* <code>myButtons</code> 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 ==
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 (<code>rmEditButtons</code>)) e os botões extras (cujos códigos são alfanuméricos (<code>XEBOrder</code>)) podem ser removidos. Usando a opção <code>XEBOrder</code> você pode escolher a ordem em que os botões aparecerão no painel.

{| border='1' class="wikitable sortable" 
|+ Lista completa de botões de edição
!| Ícone || Nome || Código || Comentário / O que mostra quando está editando
|-
| [[Image:Bold icon.png]]  || Negrito || 0 || <nowiki>'''texto a negrito'''</nowiki>
|- 
| [[Image:Italic icon.png]]  || Itálico || 1 || <nowiki>''Texto em itálico''</nowiki>
|- 
| [[Image:Button_link.png]]  || Ligação interna || 2 || <nowiki>[[Título da ligação]]</nowiki>
|- 
| [[Image:External link icon.png]]  || Ligação externa || 3 || <nowiki>[http://www.wikimedia.org ligação externa]</nowiki>
|- 
| [[Image:Headline icon.png]]  || Seção de nível 2 || 4 || <nowiki>
== Texto de cabeçalho ==
</nowiki>
|- 
| [[Image:Image icon.png]]  || Imagem anexa || 5 || <nowiki>[[Imagem:Examplo.jpg]]</nowiki>
|- 
| [[Image:Media icon.png]]  || Liga arquivo de mídia || 6 || <nowiki>[[Media:Example.ogg]]</nowiki>
|- 
| [[Image:Math icon.png]]  || Fórmula Matemática  || 7 || <nowiki><math>Inserir fórmula aqui</math></nowiki>
|- 
| [[Image:Nowiki icon.png]]  || Ignorar formato wiki || 8 || <nowiki><nowiki>Inserir texto não-formatado aqui</nowiki></nowiki>
|- 
| [[Image:Signature icon.png]]  || Assinatura || 9 || <nowiki>-- ~~~~</nowiki>
|- 
| [[Image:H-line icon.png]]  || Linha Horizontal || 10 || <nowiki>----</nowiki>
|- 
| [[Image:Button_redirect.png]]  || Redireccionar página ||A || <nowiki>#REDIRECT [[Título da ligação]]</nowiki> 
|- 
| [[Image:Button_small.png]]  || Texto em tamanho pequeno ||B||<nowiki><small>Inserir texto não-formatado aqui</small></nowiki> 
|- 
| [[Image:Button_big.png]]  || Texto em tamanho grande ||C|| <nowiki><big>Inserir texto não-formatado aqui</big></nowiki>
|- 
| [[Image:Button_sup_letter.png]]  || Texto sobrescrito ||D|| <nowiki><sup>Inserir texto não-formatado aqui</sup></nowiki>
|- 
| [[Image:Button_sub_letter.png]]  || Texto subscrito ||D1 || <nowiki><sub>Inserir texto não-formatado aqui</sub></nowiki>
|- 
| [[Image:Button_strike.png]]  || Texto riscado ||E|| <nowiki><s>Inserir texto não-formatado aqui</s></nowiki> 
|- 
| [[Image:Button_underline.png]]  || Texto sublinhado ||F|| <nowiki><u>Inserir texto não-formatado aqui</u></nowiki>
|- 
| [[Image:Btn_toolbar_liste.png]]  || Lista normal ||FS || <nowiki>* Elemento 1</nowiki><br /> 
<nowiki>* Elemento 2</nowiki><br />   
<nowiki>* Elemento 3</nowiki><br />
|- 
| [[Image:Btn_toolbar_enum.png]]  || Numeração ||G ||  <nowiki># Elemento 1</nowiki><br /> 
<nowiki># Elemento 2</nowiki><br />   
<nowiki># Elemento 3</nowiki><br />
|- 
| [[Image:Button_definition_list.png]]  || Insertir lista de definições ||H || <nowiki>; Definição</nowiki><br /><nowiki>: Item 1</nowiki><br /> 
<nowiki>: Item 2</nowiki><br />   
<nowiki>: Item 3</nowiki><br />
|- 
| [[Image:Button_blockquote.png]] || Bloco de texto citado ||I1 || <nowiki><blockquote style="border: 1px solid blue; padding: 2em;">
Inserir texto não-formatado aqui
</blockquote></nowiki> 
|- 
| [[Image:Button_multicol.png]]  || Texto em colunas ||I2||
<nowiki><div style="-moz-column-count:2; -webkit-column-count:2; column-count:2;">
Inserir texto não-formatado aqui
</div></nowiki>
|- 
| [[Image:Button_Lettrine_S.png]]  || Texto colorido e formatado ||J1|| <nowiki><font face="Old English Text MT" size="2" color="red">Inserir texto não-formatado aqui</font></nowiki>
|- 
| [[Image:Button_array.png]]  || Inserir tabela ||J2|| 
Mostra uma [[Wikipedia:Software/Scripts/Botões extra de edição#Popups|popup]] que premite configurar a tabela antes de inserir.
|- 
| [[Image:Btn_toolbar_gallery.png]]  || Galeria de imagens ||K|| 
<nowiki><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></nowiki><br />
|- 
| [[Image:Button_quotes.png]]  || Citação ||L || 
<nowiki>{{quote2|Inserir citação aqui|nome do autor}}</nowiki>
|- 
| [[Image:Button_miss_signature.png]]  || Referir um usuário que não assinou ||M|| <nowiki>{{não assinou|Utilizador ou IP|~~~~}}</nowiki>
|- 
| [[Image:Button_sub_link.png]]  || Ligação interna com sublink ||N || <nowiki>[[Título da ligação#Sublink]]</nowiki> 
|- 
| [[Image:Button_comment.png]]  || Comentário oculto ||O || <nowiki><!-- Comentário --></nowiki> 
|- 
| [[Image:Button_headline2.png]]  || Seção de nível 3 ||P || <nowiki>=== Texto de cabeçalho ===</nowiki> 
|- 
| [[Image:Button_city_silhouette.png]]  || Imagem panorâmica ||P1|| <nowiki>{{Panorama|Skyline-New-York-City.jpg|2000px|Vista de [[Manhattan]]}}</nowiki>
|- 
| [[Image:Button_mysignature.png]]  || Assinatura Extra ||Q|| <nowiki>~~~~</nowiki>
|- 
| [[Image:Button_enter.png]]  || Quebra de linha ||R || <nowiki><br /></nowiki>
|- 
| [[Image:Button_see_also.png]]  || Ver também ||R1|| <nowiki>=={{Ver também}}==</nowiki>
|-
| [[Image:Button_recherche_ip.png]] || Ligação externa (predefinição) || R2 || <nowiki>=={{Ligações externas}}==</nowiki> 
|- 
| [[Image:Button_references.png]] || Notas e Referências||R3 || <nowiki>{{ref-section|Notas e Referências}}</nowiki> 
|- 
| [[Image:Button_category_link.png]]  || Categorizar página ||R4|| <nowiki>[[Categoria:Nome da categoria]]
[[Categoria:!Scripts]]</nowiki>
|- 
| [[Image:Button_code.png]]  || Texto em código-fonte ||S || <nowiki><code>Inserir texto não-formatado aqui</code></nowiki>
|- 
| [[Image:Button_reflink.png]]  || Inserir referência material ||T || <nowiki><ref></ref></nowiki>
|- 
| [[Image:Button_mini_stub.png]]  || Marcar como mínimo ||TS || <nowiki>{{mínimo sobre|Título da ligação}}</nowiki>
|- 
| [[Image:Button_stub.png]]  || Marcar como esboço ||TC||<nowiki>{{esboço-tema}}</nowiki>
|- 
| [[Image:Button_preview.png]]  || Marcar para revisão ||TE ||Insere a predefinição {{tl|revisão}} com data automatizada.
|- 
| [[Image:Button_wikification.png]]  || Marcar para wikificar ||TR|| 
Insere a predefinição {{tl|wikificação}} com data automatizada.
|- 
| [[Image:Button_broom.png]]  || Marcar para reciclar ||T1 || Insere a predefinição {{tl|reciclar}} com data automatizada. 
|- 
| [[Image:Button_no_neutral.png]]  || Marcar para parcial ||TL || Insere a predefinição {{tl|parcial}} com data automatizada.
|- 
| [[Image:Button_question.png]]  || Marcar como controverso ||U || <nowiki>{{controverso}}</nowiki>
|- 
| [[Image:Button_info.png]]  || Marcar para corrigir ||V || <nowiki>{{corrigir}}</nowiki>
|- 
| [[Image:Button_breve.png]]  || Pedir tradução ||W || <nowiki>{{traduzir}}</nowiki>
|- 
| [[Image:Button_merge_articles.png]]  || Propor fusão ||X || <nowiki>{{fusão|Título da ligação}}</nowiki>
|- 
| [[Image:Button_ER.png]]  || Propor Eliminação Rápida ||Y1 || <nowiki>{{ER|lista|~~~~}}</nowiki>
|- 
| [[Image:Button_plantilla.png]]  || Adicionar predefinição ||Y2 || <nowiki>{{Nome da predefinição}}</nowiki> 
|- 
| [[Image:Button_user.png]] || Referir um usuário ou IP || Z || <nowiki>{{Usuário2|Nome do usuário ou IP}}</nowiki> 
|- 
| [[Image:Button_advanced_image.png]] || Imagem Avançada ||AI || Mostra uma [[Wikipedia:Software/Scripts/Botões extra de edição#Popups|popup]] que simplifica todo o processo de "[[Ajuda:Guia de edição/Como usar imagens|como usar imagens]]".
|-
| [[Image:Button Globe.png]] || Coordenadas geográficas || GEO ||  Mostra uma [[Wikipedia:Software/Scripts/Botões extra de edição#Popups|popup]] que permite escolher as [[coordenadas geográficas]], o tipo do lugar (Cidade, montanha ...) adicionando uma predefinição de coordenadas.
|- 
| [[Image:Button_talk.png]] || Mensagens predefinidas para usuários ||TALK || Mostra uma [[Wikipedia:Software/Scripts/Botões extra de edição#Popups|popup]] que permite adicionar mensagens predefinidas à sua escolha.
|-
| [[Image:Button_align_left.png]]  || Texto para o lado esquerdo ||LT|| <nowiki><div style="text-align: left;">Inserir texto não-formatado aqui</div></nowiki>
|-
| [[Image:Button_center.png]]  || Texto centralizado ||CT|| <nowiki><div style="text-align: center;">Inserir texto não-formatado aqui</div></nowiki>
|-
| [[Image:Button_align_right.png]]  || Texto para o lado direito ||RT|| <nowiki><div style="text-align: right;">Inserir texto não-formatado aqui</div></nowiki>
|- 
| [[Image:Button_headline3.png]]  || Seção de nível 4 ||Q1|| <nowiki>==== Texto de cabeçalho ====</nowiki> 
|-
| [[Image:Button_shifting.png]]  || Tabulação ||TB|| <nowiki>::</nowiki> 
|-
| [[Image:Tt_icon.png]]  || Texto de teletipo ||TT|| <nowiki><tt>Inserir texto não-formatado aqui</tt></nowiki> 
|-
| [[Image:Button_desambig.png]]  || Criar página de desambiguação ||DE|| Cria uma página com a predefinição {{tl|desambiguação}}.
|-
| [[Image:Buttonrefvs8.png]]  || Lista combinada || LC || <nowiki>* Elemento 1</nowiki><br />
<nowiki>*# Elemento 1.1</nowiki><br />
<nowiki>*# Elemento 1.2</nowiki><br />
<nowiki>*# Elemento 1.3</nowiki><br />
<nowiki>*#* Elemento 1.1.1.</nowiki>
|-
| [[Image:Button_Link_DifferentName.png]]  || Ligação interna com nome difente ||LN || <nowiki>[[Título da ligação|Nome diferente]]</nowiki>
|-
| [[Image:Button_pre.png]]  || Mostrar o código wiki (preservando as quebras de linha) || S1 ||<nowiki><pre>Inserir texto não-formatado aqui</pre></nowiki> 
|-
| [[Image:Button_template_tl.png]]  || Mostrar código da predefinição || Y3 ||<nowiki><pre>{{tl|Nome da predefinição}}</pre></nowiki>
|-
| [[Image:Button_poeme.png]]  || Poema || PO ||<nowiki><poem>Inserir texto não-formatado aqui</poem></nowiki>
|-
|}


=== Configurando o layout: XEBOrder ===
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 <code>XEBOrder</code> como você vê no exemplo:

<pre>
XEBOrder="A,B,C,E,G,I1,I2,R1,R2,R4,T1,Y1,Y2,Z,AI,N";
</pre>

=== Removendo botões: rmEditButtons ===
<code>rmEditButtons</code> 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:

<pre>
rmEditButtons=[0,2]
</pre>

irá remover os botões 0 e 2 do seu painel.

<pre>
rmEditButtons=['all']
</pre>

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.

<code>rmEditButtons</code> podem remover botões da Wikipédia permitindo organizá-los usando o <code>XEBOrder</code> 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 <code>XEBOrder</code>, assim eles não aparecerão no seu painel.

=== Botões padrão da Wikipédia ===
[[Imagem:Toolbar.PNG|thumb|right|200px|Botões padrão da Wikipédia]]
O software da Wikipédia usa 11 botões padrão, na [[Wikipédia]] de [[língua inglesa|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 <code>rmEditButtons</code> para que a Wikipédia não o mostre. E assim você pode customizar o painel.

=== Criando botões: myButtons ===
XEB pode trabalhar com botões criados pelo usuário. Para fazê-lo, você pode defini-los em <code>myButtons</code> no [[Special:Mypage/monobook.js|seu monobook.js]]. O formato dos botões é:

<pre>
myButtons={'CODE1':['url1','Tooltip1','Before1','After1','Text1'],
           'CODE2':['url2','Tooltip2','Before2','After2','Text2']};
</pre>

Sendo que:

* <code>CODE</code> é o código do botão. Você deve colocá-lo no seu <code>XEBOrder</code> 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.
* <code>URL</code> é 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 http://upload.wikimedia.org/wikipedia/commons/f/f0/Bouton_Vandale0.png] em vez de [http://commons.wikimedia.org/wiki/Image:Bouton_Vandale0.png http://commons.wikimedia.org/wiki/Image:Bouton_Vandale0.png]
* <code>ToolTip</code> é a legenda que irá aparecer quando movimenta o mouse (rato) em cima dos botão.
* <code>Before</code> é o texto que é inserido antes da localização do cursor.
* <code>After</code> é o texto que é inserido após a localização do cursor.
* <code>Text</code> é o texto que será inserido entre "Before" e "After".
* As imagens para serem usados nos botões podem ser encontradas [[commons:Mediawiki edit toolbar|aqui]].

Exemplo de dois botões extras:
<pre>
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']};
</pre>

== Popups ==
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.

{| class="wikitable"  
|+ As popups avançadas atualmente disponíneis são:
! Código
! Ícone
! Descrição
! Comentário
|-
| AI
| [[Image:Button_advanced_image.png]]
| 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 (<code>px</code>);
*Escrever a legenda.
|-
| J2
| [[Image:Button_array.png]]
| 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
| [[Image:Button_reflink.png]]
| Inserir referência material
| Permite o usuário escolher:
*O nome da referência;
*O texto da referência.
|-
| GEO
| [[Image:Button Globe.png]]
| 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 ===
Para configurar as popups não tem mistério pois é de fácil configuração usando os seguintes códigos:
*<code>XEBPopups</code>: Permite o usuário ativar ou desativar as popups. Para ativar, digite <code>true</code> e para desativar, digite <code>false</code>. A opção que vem como padrão é <code>true</code>;
*<code>XEBExtendEditSummary</code>: Permite o usuário ativar ou desativar o sumário automático ao inserir o código. Para ativar, digite <code>true</code> e para desativar, digite <code>false</code>. A opção que vem como padrão é <code>true</code>;
*<code>XEBHideDelay</code>: 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 <code>XEBHideDelay=3.5</code> 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 é <code>1.0</code>.

==Ver também==
* [[Ajuda:Guia de edição/Menus e ferramentas/Botão de edição|Botão de edição]]

[[Categoria:!Scripts|Botões extra de edição]]

[[de:Wikipedia:Helferlein/Extra-Editbuttons]]
[[en:User:MarkS/Extra edit buttons]]
[[es:Usuario:Axxgreazz/Monobook-Suite/Botonera]]