NCL Eclipse – Tutorial Básico

O NCL Eclipse é um editor XML/NCL (www.ncl.org) desenvolvido como um

plug-in para a plataforma Eclipse (www.eclipse.org). Seu principal objetivo é
facilitar a criação de documentos hipermídia em NCL de forma textual. São
algumas das funcionalidades providas pelo NCL Eclipse:

• Coloração de sintaxe;
• Assistência de código sensível ao contexto (autocomplete);
• Identificação e marcação de erros sintáticos e semânticos em
documentos NCL.
• Formatação automática de código (Ctrl+Shift+F);
• Visão Outline do documento (em árvore).
• Execução do documento Hipermídia (Utilizando o GINGA NCL Emulator)

Instalação
O processo de instalação é muito simples e segue o padrão da instalação de
plug-ins para o Eclipse.

Passo 1: Baixe a versão mais recente do endereço:

http://laws.deinf.ufma.br/~ncleclipse/download.

O arquivo deverá ter o nome ncl_eclipse_X.X.X.zip.

NOTA: Observe a versão do Eclipse compatível com o plug-in.

Passo 2: Com o arquivo salvo em seu computador copie-o para a pasta plug-
in do seu Eclipse. E descompacte-o nesta pasta. Deverá ser criada uma nova
pasta com nome ncl_eclipse_1.X.X

Passo 3: Basta reiniciar o Eclipse que o plug-in já deverá estar instalado e

pronto para o uso.

Através do menu Help->About Eclipse SDK->Plugin Details é possível verificar se

o plug-in foi instalado corretamente.

Criação de um novo Projeto

Depois de instalado, para começar a utilizar o NCL Eclipse é preciso criar um
projeto. Geralmente cria-se um projeto Geral, através do menu File->New-
>Project, o qual abrirá a janela da figura abaixo:

Roberto Página 1 1/8/2008

Escolha o projeto selecionado na Figura e clique em next. Escolha um nome
para seu projeto e finalize a criação do projeto.

Por organização é ideal que todos os arquivos relacionados estejam no

mesmo projeto. É possível, entretanto, que o autor possa criar um projeto para
bases de conectores e que outros projetos reutilizem este projeto. É possível
referenciar outros projetos do mesmo modo que o Eclipse faz com Java.

Criação de um novo documento NCL/XConnector

Para criar um novo documento NCL ou XConnector (base de conectores),
clique com o botão direito sobre o projeto que acabou de criar e em New-
>Other. A tela de seleção de wizards, abaixo, será mostrada:

Roberto Página 2 1/8/2008

Dentro da categoria NCL é possível escolher entre Connector Base Document
e NCL Document. Escolha uma e clique em next. Preencha o nome do arquivo
e clique em finish. Um novo documento dentro do projeto será criado.

A figura abaixo mostra um documento criado a partir do wizard NCL

Document.

Roberto Página 3 1/8/2008

Alterando o documento NCL
Para acessar as facilidades disponibilizadas pelo NCL Eclipse:

Sugestão de código contextual (Autocomplete)

Ao editar o arquivo é acessível através de Ctrl+Espaço, ou sempre que uma

novo caracter < é inserido no texto. É importante salientar que o autocomplete
é contextual, só são dadas como opções valores válidos para nomes de
atributos, valores de atributos e filhos de tags.

É possível evidenciar o caráter contextual do NCL Eclipse na figura abaixo

onde, baseado na posição do cursor, são mostrados apenas os filhos válidos
da tag head que podem ser inseridos naquela posiçãoi.

Roberto Página 4 1/8/2008

Autoformatação

Acessível através do menu Edit->format ou Ctrl+Shift+F. Formata o documento

com tabulações segundo a hierarquia XML.

Outline View

A visão outline permite navegar no documento de forma indireta. Na visão

outline uma árvore que representa o documento é mostrada, ao clicar em
uma tag nesta árvore o editor seleciona a linha referente à esta tag no
código-fonte. A visão outline é acessível através do menu: Window->View-
>Outline View. Atualmente apenas o identificador dos elementos são
mostrados. Em breve, novas informações serão adicionadas à esta visão.

Roberto Página 5 1/8/2008

Validação

Toda vez que o arquivo é salvo (Ctrl+S), automaticamente o plug-in faz a

validação sintática e semântica do documento. Mostrando na view Problems.
Da mesma forma, é possível mostrar esta visão (caso não esteja aparecendo
na tela) através do menu: Window->View->Problems. Os Erros e Warnings são
marcados no documento sublinhados, respectivamente, de vermelho e
amarelo.

Roberto Página 6 1/8/2008

Execução da Apresentação NCL

O NCL Eclipse reutiliza o GINGA NCL Emulator versão 1.1.1 para a execução de
apresentações NCL. Para executar o documento basta clicar com o botão
direito sobre o arquivo (na view Package Explorer ou no próprio editor) e
depois em Run As > NCL Presentation.

P.S.: Caso esteja usando o sistema operacional linux é necessário que o

arquivo ncl_eclipse_1.X.X/gingancl-java/gingancl.sh tenha permissão de
execução.

Roberto Página 7 1/8/2008

Mais Informações:

ncleclipse@laws.deinf.ufma.br

http://laws.deinf.ufma.br/~ncleclipse

Copyright - direitos autorais

O NCL Eclipse é de propriedade do Laboratory of

Advanced Web Systems. Em breve será
disponibilizado como software livre.

Roberto Página 8 1/8/2008