Manual:External editors/Control files/pt-br

Os arquivos de controle estão em formato *.ini: [Seção] Chave = Valor. Isso os torna muito fáceis de ler.

Um princípio muito importante por trás do protocolo é que os arquivos de controle enviados para o aplicativo auxiliar são bem pequenos. O aplicativo auxiliar lida com o download e upload. O que torna relativamente fácil adicionar suporte para o protocolo application/x-external-editor para qualquer motor wiki, uma vez que apenas poucas mudanças têm de ser feitas.

Note que os comentários são indicados por um ponto e vírgula (;) no início de uma linha.

Arquivo de controle edit

[Process] 
Type=[1]
Engine=[2]
Script=[3]
Server=[4]
Path=[5]

[File]
Extension=[6]
URL=[7]
  1. Pode ser "Edit text", "Edit file" ou "Diff text".
  2. Atualmente só pode ser MediaWiki. Por favor me avise se o seu motor wiki suporta o protocolo application/x-external-editor.
  3. Para o MediaWiki, a URL completa para index.php ($wgServer + $wgScript)
  4. Para o MediaWiki, a URL da base do servidor ($wgServer)
  5. Para o MediaWiki, raiz do documento wiki ($wgScriptPath) - é usado para reescrever links de URLs relativos a URLs absolutos para pré-visualizações
  6. Qual deveria ser a extensão do arquivo? Para texto, o MediaWiki usa ".wiki"
  7. Onde é que o recurso pode ser encontrado?

Exemplo de arquivo de controle edit

Arquivo de controle gerado pelo Mediawiki 1.18 ou posterior para esta página:

Versão MediaWiki:
1.18
; You're seeing this file because you're using Mediawiki's External Editor
; feature. This is probably because you selected use external editor
; in your preferences. To edit normally, either disable that preference
; or go to the URL http://www.mediawiki.org/w/index.php?title=Manual:External_editors:_control_files&action=edit&internaledit=true .
; See http://www.mediawiki.org/wiki/Manual:External_editors for details.
[Process]
Type=Edit text
Engine=MediaWiki
Script=http://www.mediawiki.org/w/index.php
Server=http://www.mediawiki.org
Path=/w
Special namespace=Special

[File]
Extension=wiki
URL=http://www.mediawiki.org/w/index.php?title=Manual:External_editors:_control_files&action=edit&internaledit=true


Arquivo de controle gerado pelo Mediawiki 1.16 ou anterior para esta página:

Versão MediaWiki:
1.16
[Process]
Type=Edit text
Engine=MediaWiki
Script=http://www.mediawiki.org/w/index.php
Server=http://www.mediawiki.org
Path=/w
Special namespace=Special

[File]
Extension=wiki
URL=http://www.mediawiki.org/w/index.php?title=Manual:External_editors:_control_files&action=edit&internaledit=true