Saltar para o conteúdo

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

Origem: Wikipédia, a enciclopédia livre.
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.
[editar código-fonte]

Os botões extra de edição são normalmente testados em:

Normalmente, o código é ligeiramente modificado para que funcione nestes navegadores web.

Por vezes, é também testado em:

Instalação

[editar código-fonte]

Para obter botões extra de edição, faça o seguinte:

  1. Na lista de "Gadgets" nas suas preferências, ative a opção:
  2. 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 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
Í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
* 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]
Botões padrão da Wikipédia

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']};

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 Ícone 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.