Google Earth Solidário

Validação instantânea de KML

Para usar alguns dos recursos mais avançados do KML (como Região, TimeSpan/TimeStamp e ScreenOverlay, é necessário criar o KML diretamente em um editor de texto. Embora você possa usar um editor de texto básico, como o Bloco de notas (Windows) ou o TextEdit (Mac OS X), eles não fornecem nenhuma verificação de erros. Isso significa que você não verá nenhum erro até tentar abrir o arquivo no Google Earth, e receber um erro de análise.

O jEdit é um editor de texto de código-fonte aberto baseado em Java e que funciona no Windows, no Mac OS X e no Linux. Usando alguns plug-ins adicionais, o jEdit fornece verificação de erros durante a digitação para garantir que seu KML fique bem formado e seja validado frente a um esquema KML oficial. Também é possível usar o plug-in Super Abbreviations para inserir snippets de KML rapidamente. Este tutorial mostrará como configurar o jEdit para a edição de KML, demonstrará alguns de seus recursos de verificação de erros e como usar as abreviações de KML.

Antes de começar

Instale o ambiente de tempo de execução do Java.

Vá para http://www.java.com e clique em Download gratuito do Java.
Instale a última versão de desenvolvimento do jEdit.

Vá para http://www.jedit.org e clique no link Download no canto superior à direita. Certifique-se de instalar a última versão, que é a 4.3pre16 no momento em que este tutorial foi escrito. Não faça o download da versão estável (4.2) que é muito antiga.

Recomendação:
Durante o processo de instalação, você deve desmarcar a opção "Iniciar servidor jEdit automaticamente na inicialização do sistema". Esse recurso não é necessário, e desmarcá-lo evitará que programas desnecessários sejam inicializados em seu computador.
Faça o download do arquivo de abreviações.

kml_superabbrevs.txt: jEdit Super Abbreviations para KML

Os vídeos a seguir mostram como configurar os plug-ins do jEdit para funcionar com arquivos XML e como fazer referência adequadamente ao esquema OGC KML 2.2, para que seus documentos sejam validados enquanto você digita.

Configuração de plug-ins do jEdit para validação de KML (Vídeo)

Instale o jEdit:

No jEdit, clique no menu Plugins > Plugins Manager
Clique na guia Install da janela Plugins Manager
Selecione os seguintes plug-ins:
- XML (Observação: O jEdit selecionará automaticamente os outros plug-ins associados: XercesPlugin, SideKick e ErrorList and Beauty)
- SuperAbbrevs
Clique no botão Install e, quando a instalação for concluída, clique no botão Close
Observação: Se o download do plug-in ficar lento ou não progredir, siga estas etapas: 1) Interrompa o download; 2) Clique no botão Download Options; 3) Clique em Update Mirror List; 4) Escolha um local geográfico próximo a você; 5) Clique em OK; 5) Repita as etapas acima para selecionar e instalar os plug-ins.

Configure os plug-ins:

Clique no menu Plugins > Plugins Options
Clique e expanda a pasta do plug-in SideKick na lista à esquerda
- Selecione General sob SideKick
- Em Auto parse Settings, marque Parse on buffer save
- Marque Parse on keystroke
- Ajuste o controle deslizante After last keystroke, wait (seconds) para 1 segundo. Ajuste esse último para mudar a quantidade de tempo que o jEdit aguarda depois de você terminar de digitar para verificar se há erros no arquivo KML.
Clique e expanda a pasta do plug-in ErrorList na lista à esquerda
- Marque Automatically display on error
- Marque Auto-close on no errors
- Marque Auto-refocus on Text Area
- Marque Show error icons in the gutter
Clique e expanda a pasta do plug-in SuperAbbrevs na lista à esquerda
- Selecione Abbreviations em SuperAbbrevs
- Usando o menu suspenso Select Mode, selecione XML.
- Clique no botão Import normal abbrevs no canto inferior direito
- Clique no botão Import abbrevs, que é o quarto botão, próximo dos botões de mais (+), menos (-) e configurações (ícone de uma chave inglesa).
  Observação: No jEdit 4.3pre16, o botão Import abbrevs pode estar invisível, mas ainda pode ser clicado. Se você não vir o quarto botão à direita dos outros, coloque o mouse sobre o centro do botão Edit Abbreviation (parece com uma chave inglesa sobre um pedaço de papel e pode estar esmaecido). Movimente o mouse horizontalmente para a direita até que um pequeno quadrado cinza apareça sob o mouse, então clique. Isso é mostrado no vídeo.
- Na janela de diálogo Abrir, navegue até onde salvou o arquivo kml_superabbrex.txt. Selecione-o e abra-o.
Clique em OK na janela Plugin Options.

Encaixe os plug-ins na lateral e na parte inferior do jEdit:

Clique no menu Plugins > ErrorList > Error List
- Clique na pequena seta preta apontando para baixo no canto superior esquerdo da janela Error List exibida.
- Selecione Dock at Bottom
- O painel da janela Error List encaixado pode ser expandido ou recolhido clicando no botão Error list na parte inferior.
Clique no menu Plugins > SideKick > SideKick
- Selecione a pequena seta preta e selecione Dock at Left.
- O painel da janela SideKick encaixado também pode ser alterado clicando no botão SideKick à esquerda.

Crie um atalho de teclado para o SuperAbbrevs:

Clique no menu Utilities > Global Options
Clique na opção Shortcuts na lista à esquerda, sob a pasta jEdit.
Selecione Plugins: SupperAbbrevs no menu suspenso Edit Shortcuts na parte superior.
Clique duas vezes na célula "Primary Shortcut" ao lado do comando "Show expansion dialog" na lista.
Crie um atalho de teclado. Eu uso Control-Enter (Command-Enter em Macs)
Observação: O Control-Enter pode já estar sendo usado pelo comando Action Bar. É possível substituir essa atribuição de atalho.
Clique em OK.

Verificação de erros no KML com o jEdit e utilização de Super Abbreviations (vídeo)

Discussão e comentários

Tem alguma dúvida sobre este tutorial? Deseja nos enviar algum comentário? Visite o Grupo de discussão do Google Earth Solidário para discutir isso com outros usuários.

Próximos passos

Gostaria de testar suas novas habilidades? Leia estes outros tutoriais que exigem edição manual de KML: