Ajuda:Guia de edição/Editor externo

Origem: Wikipédia, a enciclopédia livre.

Muitos editores de texto disponibilizam recursos especiais para editar código-fonte, recursos que se aplicam também à edição de wikis. A funcionalidade mais comum e útil é a colorização de sintaxe, que altera a aparência de trechos com marcações, destacando-os do restante do texto. Abaixo, uma lista de instruções e ligações para arquivos capazes de fazer o Emacs, Vim, jEdit ou Kate editarem marcações da Wikipédia.

Dicas para todos os editores

Se você está usando o Mozilla ou algum derivado do Mozilla, é possível chamar diretamente a partir do browser um editor externo, a fim de editar os arquivos da Wikipédia sem ter que copiar e colar o código entre o editor e o navegador. Vá até http://mozex.mozdev.org e copie o MozEx, um plugin para o Mozilla que te permite editar qualquer área de texto das páginas web dentro de seu editor favorito. porém é necessário o requisito de leitura em inglês no site, para quem tem um pouco de dificuldade em inglês consulte o site http://www.google.com.br/language_tools?hl=pt-BR.

Se você tem familiaridade com Perl e CVS, pode experimentar o módulo "WWW::MediaWiki::Client", que pode ser instalado via CPAN. Ele permite o acesso aos artigos num esquema parecido ao CVS, ou seja, você pode emprestar ("check-out") artigos na Wikipédia, editá-los localmente e então enviá-los de volta ("check in").

Emacs

O suporte à edição de artigos da Wikipédia no Emacs é provido através de um modo de edição (major-mode) chamado wikipedia-mode. Para instruções de como instalar e usar o wikipedia-mode, leia http://en.wikipedia.org/wiki/Wikipedia:Wikipedia-mode.el Copie ele aqui http://www.emacswiki.org/cgi-bin/wiki/download/wikipedia-mode.el

É conveniente, algumas vezes, editar artigos com no modo outline do Emacs, que permite esconder algumas seções do artigo. Isso permite que você, por exemplo, veja apenas os títulos de seções do artigo, escondendo o corpo de texto, ou veja apenas o corpo de texto da seção que está editando. Existem dois meios para fazer isso.

  • O primeiro é o outline-minor-mode, um "minor mode" embutido no Emacs. Esse modo é ativado pelas teclas M-x outline-minor-mode. Pode ser usado em conjunto com o wikipedia-mode. Para maiores informações sobre os vários comandos de outline, consulte a documentação respectiva (C-h f outline-mode).
  • O segundo método consiste em usar uma versão alterada do org-mode, disponível em: http://en.wikipedia.org/upload/c/c7/Org.el É mais fácil de se usar, pois você pode alternar entre os diferentes modos de visualização usando a tecla TAB. Entretanto, não é compatível com o wikipedia-mode. (Instruções para instalação do org-mode acompanham o arquivo.)

Vim

Para dar suporte a edição de artigos da Wikipédia no Vim, copie o arquivo wikipedia.vim dentro do subdiretório "syntax". Por padrão, esse diretório se localiza em "~/.vim/syntax" nos sistemas POSIX (Unix, Linux, etc), e em "C:\Arquivos de Programas\Vim\vimfiles\syntax" no Windows.

Para detectar automaticamente arquivos com a extensão ".wiki", adicione as seguintes linhas ao arquivo ".vim/filetype.vim" (ou "vimfiles\filetype.vim") – crie o arquivo caso ele não exista:

augroup filetypedetect
au BufNewFile,BufRead *.wiki	setf Wikipedia
augroup END

Alternativamente, digite o comando "set syn=Wikipedia" para definir temporariamente a sintaxe do arquivo em edição.

Artigos da Wikipédia geralmente têm quebras de linha somente nos finais do parágrafo, uma situação para a qual o Vim não é pré-configurado. Se você adicionar a seguinte linha ao arquivo ".vimrc" (ou "_vimrc"), vai contornar o problema e tornar mais fácil a edição de arquivos no formato wiki:

set textwidth=0
set linebreak
map <Up> gk
map <Down> gj
imap <Up> <C-O>gk
imap <Down> <C-O>gj

Sinta-se à vontade para editar o arquivo wikipedia.vim e enviar uma versão melhorada.

jEdit

Para o jEdit existe um plugin disponível em http://www.djini.de/software/mwjed/ . Além de fornecer colorização de sintaxe para artigos da Wikipédia, o jEdit permite a comunicação direta com o site da Wikipédia através do plugin "jakarta commons".

Kate

Para o Kate, regras para colorização de sintaxe são disponibilizadas em um arquivo XML, em de:Media:Wikimedia.xml. Ele reconhece marcações e entidades HTML, sequências de controle do wiki, links, títulos de seções, tabelas e marcações <nowiki>.