Wikipédia:Scripts/wikEd

wikEd
Logotipo do wikEd.
Desenvolvedor	Cacycle
Lançamento	26 de Janeiro de 2006
Versão estável	0.9.22 (26 de Janeiro de 2006)
Sistema operacional	n/a
Gênero(s)	Funções avançadas de edição de texto
Licença	Domínio público
Página oficial	User:Cacycle/wikEd

O wikEd (abreviatura de wiki Editor, editor wiki) é um editor de textos avançado integrado à Wikipédia. Este script está disponível na lista de gadgets e é repleto de recursos úteis aos editores regulares e avançados, como realce da sintaxe, verificação do código, recolhimento e expansão de predefinições e referências, exibição das alterações (diffs) e de uma prévia das edições sem precisar recarregar a página, e funções avançadas para localizar e substituir texto. Por favor, consulte a página de ajuda do WikEd para obter mais detalhes sobre a interface. O wikEd funciona na maioria dos navegadores, com exceção do Internet Explorer e do Opera.

Principais funcionalidades

• Destaque da sintaxe do código wiki
• Sistema prático para pesquisa e substituição, com suporte a expressões regulares e a busca progressiva
• Previsão do resultado e exibição das alterações de forma instantânea
• Permite colar, importar e converter para código wiki vários tipos de texto formatado, como os que são obtidos a partir do Microsoft Word ou de páginas da internet
• Abre links e ligações internas por meio de CTRL+Clique
• Opção de edição em tela cheia^(pt-BR) ou ecrã cheio^(pt-PT?) (full screen)
• Permite corrigir vários tipos de erros e problemas com um só clique
• Funciona com qualquer MediaWiki e possui tradução para diversos idiomas

Lista detalhada dos recursos

Para ter uma visão geral das funcionalidades, veja a lista apresentada mais acima.

Consulte também a página de ajuda do WikEd para uma descrição de todos os botões e funções. O wikEd insere os seguintes botões acima da janela de edição:

• Permite colar texto formatado, como os que são obtidos a partir de páginas da internet ou outras páginas wiki, ou do Microsoft Word
• Converte texto formatado em código wiki, incluindo tabelas
• Realce de sintaxe do código wiki, baseado em um verdadeiro parser de código wiki em JavaScript
  • Prévia das imagens inseridas
  • Verificação do código
  • Recolhimento e expansão de predefinições e referências
  • Destaque para diferentes tipos de traços, hífenes e caracteres em branco
• Localizar e substituir
  • Suporta expressões regulares e insensividade a maiúsculas e minúsculas
  • Busca progressiva enquanto se digita o texto
  • Localizar e substituir todas as ocorrências
  • Histórico de buscas e substituições recentes
• Prévia do texto diretamente na página
  • Prévia local instantânea por meio de um script conhecido como "InstaView"
  • Substituição por uma prévia obtida do servidor (usando Ajax)
• Prévia das mudanças (diff) diretamente na página
  • Formato em linha aprimorado (acréscimos e remoções em um fluxo contínuo de texto)
  • Utiliza um script independente do servidor (en:User:Cacycle/diff)
  • Detecta e indica movimentação de blocos de texto
• Histórico inteligente e persistente (entre edições, sessões e janelas) para os sumários de edição
  • Textos de sumário predefinidos e personalizáveis
• Correcção de erros comuns por meio de um só botão:
  • Corrige ligações wiki com redirecionamentos para a página de destino (usa Ajax)
  • Representa os caracteres Unicode por meio dos caracteres reais ou de suas entidades (dependendo do statos do suporte a estes caracteres no navegador)
  • Corrige erros comuns (typos) usando as regras de correção do AutoWikiBrowser
  • Fórmulas matemáticas e químicas
  • Básico - espaçamento e linhas vazias
  • Hífenes e traços
  • Unidades
  • HTML - conversão de código HTML para código wiki (incluindo tabelas)
  • Conversão para maiúsculas da primeira letra de títulos de secções e listas.
• Navegação no artigo: pula para as seções a partir do campo de buscas
• Opção de edição em tela cheia^(pt-BR) ou ecrã cheio^(pt-PT?) (full screen)
• Todos os botões possuem descrição em popup (texto ALT)
• Ordenação por ordem alfabética das linhas e listas
• Ocultamento de marcações para referências (<ref>...</ref>), predefinições ({{..}}), e entidades de caracteres (tais como &nbsp;)
• Completamente personalizável por meio de CSS e opções de configuração
• Seleção inteligente do texto afetado, por exemplo a palavra sob o cursor, a linha atual, ou o parágrafo atual
• Alteração do tamanho da fonte usada no campo de edição
• Compatível com as barras de edição padrão do MediaWiki
• Ativação/desativação dinâmica em um simples clique no botão principal (logotipo próximo ao link "Sair")
• Atualização e instalação automáticas para as novas versões
• Suporte para botões e funções definidas pelo editor
• Pode ser executado nas seguintes páginas: edição normal, carregamento de imagens e edição da lista de páginas vigiadas em forma de texto.
• Exibição de diffs aprimorados nas comparações entre versões das páginas (usa o wikEdDiff)
• Os links internos e externos podem ser abertos em uma nova aba ou nova janela por meio de CTRL+Clique
• Atalhos de teclado para os botões
• Realce da sintaxe de predefinições e funções do analisador sintáctico do MediaWiki, para desenvolvedores de predefinições
• Pode ser instalado como um gadget, um script pessoal, ou um script Greasemonkey
• Funciona com qualquer MediaWiki quanto instalado no navegador como um script Greasemonkey
• Completamente traduzido para vários idiomas
• Desfazer e refazer alterações

Instalação

Pré-requisitos

• Conta de usuário na Wikipédia;
• Navegador baseado em Gecko (Firefox e SeaMonkey) ou WebKit (Safari e Chrome);
• Computador não muito "lento", caso contrário a edição de artigos poderá ser igualmente bastante morosa.

Para instalar o WikEd, aceda à lista de gadgets (também disponível a partir do link para a página de preferências, que é mostrado no menu superior de todas as páginas) e depois clique na aba "Gadgets". Selecione a caixa onde diz WikEd e grave (salve) as preferências. Poderá ter de limpar a cache do navegador. Após isso irá aparecer um botão no canto superior direito no qual pode ativar e desativar o WikEd. Só verá o WikEd em funcionamento ao editar uma página da Wikipédia.

Problemas

• Não usar o botão para retroceder do navegador (browser) depois de gravar uma página. Use sempre a aba "editar" para editar a página actual. Caso contrário, as alterações que fizer poderão desaparecer.
• O wikEd é um programa complexo, extenso e por vezes lento. Se estiver a usar um computador antigo ou a editar um artigo longo, pode desactivar o wikEd clicando no botão
• O wikEd baseia-se num editor interno do navegador, o que acarreta alguns inconvenientes:
  • Ao colar texto HTML de páginas da web, os parágrafos ficam com quebras de linha, antes e depois do texto colado. Pode desactivar temporariamente o wikEd ao clicar no botão e remover as quebras de linha manualmente.
  • O destaque da sintaxe do texto acabado de introduzir não é automático. Terá de ser feito manualmente clicando no botão
  • Devido a um bug do navegador Mozilla, por vezes o cursor desloca-se para o início, ao editar texto colado.
  • Deve usar com muita precaução os botões de cor violeta que se destinam a vários tipos de correcções automáticas. É aconselhável seleccionar o mínimo de texto ao usar estas ferramentas e deve verificar sempre as alterações com o botão de previsão rápida . Em certos casos, poderá danificar o conteúdo do artigo. O único botão seguro é o de correcção Unicode
  • O navegador Mozilla substitui tabulações (tabs) por vários espaços em branco ao colar texto com tabulações na janela de edição. Para contornar este problema, desactive o wikEd ao colar o texto com tabulações.

Incompatibilidades

De uma forma geral, o wikEd é incompatível com scripts ou extensões que se baseiam ou alteram a janela de edição. Há no entanto a possibilidade dos scripts funcionarem caso o wikEd seja desactivado clicando no botão (disponível no canto superior direito em todas as páginas e na parte inferior direita da caixa de edição).

Alguns scripts incompatíveis com o WikEd:

• en:User:Zocky/Search Box - este script não funciona.
• en:User:Pilaf/Live Preview - apenas funciona através dos botões de previsão do wikEd.
• en:User:Pilaf/InstaView - a integração no wikEd está a ser desenvolvida.
• en:User:Topaz/Wikiscripts (script sectionsplitter) - o conteúdo da janela de edição desaparece.

Personalização

O wikEd permite a personalização de várias características, incluindo esquemas de côr e textos. Para isso escreva o código correspondente na página do seu monobook.js. As variáveis que podem ser personalizadas encontram-se na página en:User:Cacycle/wikEd.js. Todas as variáveis contêm os caracteres '||' de forma similar a:

// initial font size of edit window (percentage)
var wikEdFontSize = wikEdFontSize || 100;.

O código personalizado deve ser colocado antes do código de instalação do wikEd, ou seja, antes do seguinte comentário no código:

// instalar o [[:en:User:Cacycle/wikEd]].

Exemplos

Descrição	Exemplo de código personalizado
Cor e estilo da fonte do destaque da sintaxe	var wikEdFrameCSS = []; wikEdFrameCSS['.wikEdLinkName'] = 'color: #00a000; font-weight: bold;';
Imagem de um botão	var wikEdImage = []; wikEdImage['logo'] = '6/67/outra_imagem.png';
Número de itens no histórico (pré-definido:10)	var wikEdHistoryLength = []; wikEdHistoryLength['find'] = 15; wikEdHistoryLength['replace'] = 15; wikEdHistoryLength['summary'] = 20;
Alterar o texto automático dos sumários (se o botão estiver activo)	var wikEdSummaryUsing = '…ainda a usar o wikEd';
Cor de fundo dos botões	var wikEdMainCSS = []; nbsp;wikEdMainCSS['.wikEdButton'] = background: blue;';
Mensagens do sumário de edição:	wikEdComboPresetOptions = []; wikEdComboPresetOptions['summary'] = [ nbsp;'reformulação da informação', '+iw +cat +wikificar', 'comentário', nbsp;'correcções ortográficas', 'retirando spam', 'reversão', nbsp;'formatação do texto', '+predefinição', '{wikEdUsing}' ];
Desactivar os botões de edição pré-definidos	var wikEdShowToolbar = false;
Activar o botão código-fonte para mostrar o código-fonte de conteúdo colado ou do destaque do texto da sintaxe	var wikEdShowSourceButton = true;

Ver também

• Wikipédia:Software
• Wikipédia:Software/Scripts/wikEd/ajuda