Ajuda:Guia de edição/Editar com um editor externo

Origem: Wikinotícias, a fonte de notícias livre.
Saltar para a navegação Saltar para a pesquisa
Nível básico
Nível médio
Nível avançado
Outros guias
Livro de estilo
Dicas e truques
Guia de eliminação
FAQ de edição


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 Wikinotícias.

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 Wikinotícias 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.

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 Wikinotícias, editá-los localmente e então enviá-los de volta ("check in").

Emacs

O suporte à edição de artigos da Wikinotícias 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 [1] Copie ele aqui [2]

É 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: [3]. É 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 Wikinotícias 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 Wikinews
augroup END

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

Artigos da Wikinotícias 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/wikipedia/ . Além de fornecer colorização de sintaxe para artigos da Wikinotícias, o jEdit permite a comunicação direta com o site da Wikinotícias 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>.