====== Código-fonte do NCL Eclipe ======

O código-fonte do NCL Eclipse é disponibilizado sob licença GPLv2. É possível navegar no código-fonte a partir da página:

  * https://github.com/ncleclipse
===== Baixando o código-fonte =====
Se você pretende desenvolver, será necessário baixar o código do NCL Eclipse. O código-fonte mais atual do NCL Eclipse é disponibilizado por meio de repositórios git.

==== Sobre o Git (com informações do sourceforge.net) ====
Git é uma ferramenta de //Gerenciamento de Código// (em inglês //Source Code Managemente// ou SCM) para desenvolvedores de software que suporta desenvolvimento colaborativo com um time, e possibilita o rastreamento de alteração no código-fonte ao longo do tempo.

Git é usado por desenvolvedores, e usuários avançados que necessitam das últimas alterações no software (antes de serem disponibilizadas como versões estáveis). Usuários de software geralmente não necessitam do git; tipicamente eles irão baixar versões estáveis disponíveis pelo projeto (Se esse é o seu caso, e você não necessita do código-fonte do NCL Eclipse, saiba como instalar versões oficiais na página: [[.install]]).

Desenvolvedores devem se familiarizar com o Git por si próprios, por exemplo lendo a [[http://git-scm.com/documentation|Documentação do Git]].

==== Acesso ao Git do NCL Eclipse ====

<note info>
O NCL Eclipse está dividido logicamente em alguns sub-projetos. Os projetos a seguir são os principais. Se você preferir/necessitar baixar também outros projetos (alguns ainda instáveis) é suficiente trocar o final da URL pelo projeto que deseja. ([[https://github.com/ncleclipse|Veja a lista completa de subprojetos aqui]])
</note>

=== Linha de Comando ===
A partir da linha de comando, é suficiente executar os seguintes comandos para obter o código-fonte do NCL Eclipse:

<code>
$ git clone https://github.com/ncleclipse/ncl30-common.git 
$ git clone https://github.com/ncleclipse/ncl30-validator.git 
$ git clone https://github.com/ncleclipse/ncl30-eclipse.git 
$ git clone https://github.com/ncleclipse/ncl30-quick-reference.git
</code>

=== EGit ===
FIXME Descrever o processo usando o [[www.eclipse.org/egit/‎|EGit]]


===== Configurando o ambiente =====
De posse do código-fonte do NCL Eclipse, a partir de agora só falta configurar os paths do projeto para poder executá-lo:

**Passo 1.** Importe os projetos do ncl-eclipse, baixados anteriormente para o seu workspace atual.

Por exemplo, se você tiver os projetos do git, baixados anteriormente, dentro da pasta do seu workspace:

  SEU_WORKSPACE/ncl30-common
  SEU_WORKSPACE/ncl30-validator
  SEU_WORKSPACE/ncl30-eclipse
  SEU_WORKSPACE/ncl30-quick-reference
  
É possível importar os projeto no Eclipse por meio do menu //File->Import// e escolhendo a opção //General->Existing Projects into Workspace//. Ao selecionar o diretório root como o seu workspace os seguintes projetos devem ser exibidos:

{{ :tuto:import-ncleclipse-projects.png?300 | }}
  
**Passo 2.**  Para o projeto //ncl30-validator//, inclua a biblioteca //Xerces Java// (disponível em http://xerces.apache.org/xerces-j/) no //classpath// destes projetos.

**Passo 3.** Crie //Link Source// entre as dependências
O projeto //ncl30-validator// deve referenciar o projeto //ncl30-common// e o projeto //ncl30-eclipse// deve referenciar os projetos //ncl30-common//, //ncl30-validator// e o //ncl30-helper//. Uma forma de fazer isso é criando um //Link Source// à pasta //src// do outro projeto.

Por exemplo, para criar um //Link Source// do projeto //ncl30-validator// para o //ncl30-common//, por exemplo, clique com o botão direito sobre o projeto //ncl30-validator//, depois em //Properties -> Java Build Path// e selecione a aba //Source//. A seguinte tela será exibida:

{{ :tuto:link-source-config.jpg?direct&400 |  }}

Selecione a pasta //ncl30-validator/ncl30-common// e clique em //Edit//.
Navegue pelo seu sistema de arquivos e escolha a pasta src do projeto //ncl30-common//. Certifique-se que o campo //Folder Name// continuará como //ncl30-common//.

**Repita o processo para os outros projetos fazendo os Link Source necessários e descritos no início deste passo.**

Com isso, todos os erros de compilação devem ter sido resolvidos.
===== Testando o NCL Eclipse =====
Para testar o NCL Eclipse basta clicar com o botão direito sobre o projeto ncl30-eclipse e depois em //Run As -> Eclipse Application//. O ambiente de testes do Eclipse carregará e lá você poderá utilizar o NCL Eclipse como se tivesse instaldo normalmente.