NCL Eclipse Tutorial Bsico

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 criao de documentos hipermdia em NCL de forma textual. So algumas das funcionalidades providas pelo NCL Eclipse: Colorao de sintaxe; Assistncia de cdigo sensvel ao contexto (autocomplete); Identificao e marcao de erros sintticos e semnticos em documentos NCL. Formatao automtica de cdigo (Ctrl+Shift+F); Viso Outline do documento (em rvore). Execuo do documento Hipermdia (Utilizando o GINGA NCL Emulator)

Instalao
O processo de instalao muito simples e segue o padro da instalao de plug-ins para o Eclipse. Passo 1: Baixe a verso mais recente do endereo: http://laws.deinf.ufma.br/~ncleclipse/download. O arquivo dever ter o nome ncl_eclipse_X.X.X.zip. NOTA: Observe a verso do Eclipse compatvel com o plug-in. Passo 2: Com o arquivo salvo em seu computador copie-o para a pasta plugin 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. Atravs do menu Help->About Eclipse SDK->Plugin Details possvel verificar se o plug-in foi instalado corretamente.

Criao de um novo Projeto

Depois de instalado, para comear a utilizar o NCL Eclipse preciso criar um projeto. Geralmente cria-se um projeto Geral, atravs do menu File->New>Project, o qual abrir a janela da figura abaixo:

Roberto

Pgina 1

1/8/2008

Escolha o projeto selecionado na Figura e clique em next. Escolha um nome para seu projeto e finalize a criao do projeto. Por organizao ideal que todos os arquivos relacionados estejam no mesmo projeto. possvel, entretanto, que o autor possa criar um projeto para bases de conectores e que outros projetos reutilizem este projeto. possvel referenciar outros projetos do mesmo modo que o Eclipse faz com Java.

Criao de um novo documento NCL/XConnector

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

Roberto

Pgina 2

1/8/2008

Dentro da categoria NCL possvel 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

Pgina 3

1/8/2008

Alterando o documento NCL

Para acessar as facilidades disponibilizadas pelo NCL Eclipse: Sugesto de cdigo contextual (Autocomplete) Ao editar o arquivo acessvel atravs de Ctrl+Espao, ou sempre que uma novo caracter < inserido no texto. importante salientar que o autocomplete contextual, s so dadas como opes valores vlidos para nomes de atributos, valores de atributos e filhos de tags. possvel evidenciar o carter contextual do NCL Eclipse na figura abaixo onde, baseado na posio do cursor, so mostrados apenas os filhos vlidos da tag head que podem ser inseridos naquela posioi.

Roberto

Pgina 4

1/8/2008

Autoformatao Acessvel atravs do menu Edit->format ou Ctrl+Shift+F. Formata o documento com tabulaes segundo a hierarquia XML.

Outline View A viso outline permite navegar no documento de forma indireta. Na viso outline uma rvore que representa o documento mostrada, ao clicar em uma tag nesta rvore o editor seleciona a linha referente esta tag no cdigo-fonte. A viso outline acessvel atravs do menu: Window->View>Outline View. Atualmente apenas o identificador dos elementos so mostrados. Em breve, novas informaes sero adicionadas esta viso.

Roberto

Pgina 5

1/8/2008

Validao Toda vez que o arquivo salvo (Ctrl+S), automaticamente o plug-in faz a validao sinttica e semntica do documento. Mostrando na view Problems. Da mesma forma, possvel mostrar esta viso (caso no esteja aparecendo na tela) atravs do menu: Window->View->Problems. Os Erros e Warnings so marcados no documento sublinhados, respectivamente, de vermelho e amarelo.

Roberto

Pgina 6

1/8/2008

Execuo da Apresentao NCL O NCL Eclipse reutiliza o GINGA NCL Emulator verso 1.1.1 para a execuo de apresentaes NCL. Para executar o documento basta clicar com o boto direito sobre o arquivo (na view Package Explorer ou no prprio editor) e depois em Run As > NCL Presentation. P.S.: Caso esteja usando o sistema operacional linux necessrio que o arquivo ncl_eclipse_1.X.X/gingancl-java/gingancl.sh tenha permisso de execuo.

Roberto

Pgina 7

1/8/2008

Mais Informaes: 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

Pgina 8

1/8/2008