<sect1 id="quanta-projects">
<title
>Projectos no &quanta;</title>

<sect2 id="create-new-project">
<title
>Projecto Novos</title>

<para
>O assistente de projectos do &quanta; ( <menuchoice
> <guimenu
>Projecto</guimenu
> <guimenuitem
>Novo Projecto</guimenuitem
> </menuchoice
>) torna a criação de projectos uma brincadeira de crianças. </para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-1.png" />
</imageobject>
</mediaobject>
<para
>Os campos são bastante simples e é conveniente preenchê-los de cima para baixo, dado que, ao preencher o nome do projecto, poupar-lhe-á algum trabalho ao preencher toda a estrutura de directoria para o resto do projecto. Contudo, nós somos 'open osurc'e e não lhe limitaremos a utilização deste programa. Todas estas directorias e os campos de informação da autoria, são configuráveis neste ponto e poderão sê-lo de novo na opção <menuchoice
> <shortcut
> <keycap
>F7</keycap
> </shortcut
> <guimenu
>Projecto</guimenu
> <guimenuitem
>Opções do Projecto</guimenuitem
> </menuchoice
> da página Geral.</para>

<variablelist
> <varlistentry
> <term
>Nome do projecto</term
> <listitem
><para
>Este é o nome do seu projecto. Poderá ser tudo o que lhe quiser chamar. Por exmplo, poder-lhe-á chamar "xpto". Assim que preencher este campo, irá reparar que o destino do projecto, o ficheiro de código, os modelos e as barras de ferramentas serão preenchidos com valores por omissão. Todas as directorias deste projecto serão definidas como sendo relativas à directoria pessoal dos utilizadores, onde a directoria de destino será definida como sendo $HOME/&lt;Nome-do-Projecto-em-Minúsculas-sem-Espaços
> (p.ex. a $HOME/xpto/ será a directoria de destino).</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Destino do projecto</term
> <listitem
><para
>Esta é a directoria onde todos os ficheiros do projecto serão gravados. Por omissão, esta será a $HOME/xpto, em que o 'xpto' é o nome do seu projecto com todas as letras minúsculas.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Ficheiro fonte do projecto</term
> <listitem
><para
>Este é o nome do ficheiro de projecto do &quanta;. Por omissão, será o nome do seu projecto em minúsculas e sem espaços com a extensão 'webprj' (p.ex., xpto.webprj). Este ficheiro é gravado na raiz da directoria de destino do projecto.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Modelos de projecto</term
> <listitem
><para
>Esta directoria é onde serão gravados os modelos deste projecto. Por omissão, será a &lt;Destino do projecto
>/templates. Se tiver um conjunto comum de ficheiros que usa para os vários projectos, poderá ser útil apontar para esta em vez de para a predefinida. </para
></listitem
> </varlistentry
> <varlistentry
> <term
>Barras de Ferramentas de Projecto</term
> <listitem
><para
>Esta directoria é onde serão gravadas as barras de ferramentas deste projecto. Por omissão, será a &lt;Destino do projecto
>/toolbars. Se tiver um conjunto comum de barras de ferramentas que usa para os vários projectos, poderá ser útil apontar para esta em vez de para a predefinida.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Autor</term
> <listitem
><para
>Insira aqui o seu nome.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>E-mail</term
> <listitem
><para
>O e-mail para onde deseja que vão as coisas relacionadas com o projecto. Em principio, deve pertencer-lhe.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Código do Projecto</term
> <listitem
><para
> <variablelist
> <varlistentry
> <term
>Adicionar ficheiros locais</term
> <listitem
><para
>Permite-lhe adicionar ficheiros do sistema de ficheiros locais. Pode escolher vários ficheiros e directorias inteiras. A utilização de kioslaves não é permitida.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Usar o wget para obter os ficheiros do 'site'</term
> <listitem
><para
>Esta opção é excelente se desejar obter e modificar conteúdo web estático. Nos os casos de 'scripting' no servidor (tipo PHP, Python, etc.) terá que obter os ficheiros de outra forma.</para
></listitem
> </varlistentry
> </variablelist
> </para
></listitem
> </varlistentry
> </variablelist>

<para
>O último ecrã do assistente de novo projecto tem 3 opções que podem tornar a sua vida mais fácil. Estas opções estão disponíveis para ser alteradas na opção de menu <menuchoice
> <shortcut
> <keycap
>F7</keycap
> </shortcut
> <guimenu
>Projecto</guimenu
> <guimenuitem
>Opções do Projecto</guimenuitem
> </menuchoice
> da página Rede.</para>

<variablelist
> <varlistentry
> <term
>Usar o prefixo da antevisão</term
> <listitem
><para
>Isto permite-lhe definir o prefixo da directoria para outra coisa que não o seu sistema de ficheiros local. Isto é mais útil para as páginas que possuem conteúdo dinâmico e que estão dependentes do processamento do servidor (como o PHP, o JSS, Python, etc.). Basta indicar a primeira parte do endereço tal como existe nesse servidor, para que a directoria no fim seja completa pelo &quanta;. Por exemplo, se tiver o domínio bar.com e se estiver a editar a página index.html, poderá editá-la na sua máquina remota (foo.bar.com), enviá-la para o servidor e carregar em F6 para ver os resultados em www.bar.com em vez de ser no seu sistema de ficheiros local.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Inserir os modelos globais</term
> <listitem
><para
>Isto cria uma cópia dos modelos globais na sua árvore de directorias do projecto.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Inserir os modelos locais</term
> <listitem
><para
>Isto cria uma cópia dos modelos locais na sua árvore de directorias do projecto.</para
></listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2 id="using-projects">
<title
>Como utilizar projectos</title>
<sect3 id="project-files">
<sect3info>
<author
> <firstname
>Robert</firstname
> <surname
>Nickel</surname
> </author>
</sect3info>
<title
>Ficheiros do projecto</title>
<para
>Por omissão, o &quanta; irá abrir o último projecto acedido quando for lançado. Este comportamento não é configurável neste momento.</para>
<para
>Para abrir outro projecto, seleccione Abrir no menu Projecto ou o ícone Abrir Projecto na barra de ferramentas. A janela de abertura de um projecto irá aparecer para permitir ao utilizador seleccionar o projecto que desejar. Os projectos têm uma extensão 'webprj'.</para>
<para
>Ao fechar o &quanta;, o seu ficheiro de projecto será gravado automaticamente. Ser-lhe-á pedido para gravar as modificações antes de sair se o &quanta; detectar ficheiros alterados. Este mesmo comportamento acontece se abrir um novo projecto.</para>
</sect3>

<sect3 id="project-tree-view">
<sect3info>
<author
> <firstname
>Robert</firstname
> <surname
>Nickel</surname
> </author>
</sect3info>
<title
>A Vista da Árvore do Projecto</title>
<para
>A árvore do projecto dá-lhe um acesso organizado aos ficheiros no seu projecto. Aqui é onde poderá gerir os ficheiros no projecto actual.</para>
<para
>No caso dos ficheiros, ao carregar neles com o botão direito do rato, fará aparecer o seguinte menu:</para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-tree-view-file-rmb-menu.png" />
</imageobject>
</mediaobject>
<para
>Estes itens são relativamente simples e serão deixados para o leitor explorar.</para>
<para
>As directorias comportam-se de forma semelhante e só não têm os itens de menu Abrir e Abrir no &quanta;:</para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-tree-view-dir-rmb-menu.png" />
</imageobject>
</mediaobject>
<para
>Estes itens também são deixados para o utilizador experimentar.</para>

</sect3>

<sect3 id="upload-project">
<sect3info>
<author
> <firstname
>Robert</firstname
> <surname
>Nickel</surname
> </author>
</sect3info>
<title
>Enviar Projectos</title>
<para
>A janela de enviar projectos:</para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-upload-dialog.png" />
</imageobject>
</mediaobject>

<variablelist
> <varlistentry
> <term
>Máquina</term
> <listitem
><para
>Este é o nome do servidor para o qual vai copiar os ficheiros. Tanto poderá ser o nome completo com o domínio como um endereço IP.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Protocolo</term
> <listitem
><para
>O protocolo de transferência a usar para este envio. Dependendo da sua versão do KDE e se carregou os 'kio slaves' extra, esta lista poderá variar. No mínimo dos mínimos, deverá poder escolhe entre 'ftp', 'file' e 'nfs'.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Localização</term
> <listitem
><para
>Esta é a directoria de base na máquina remota para a qual irá copiar os ficheiros.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Porto</term
> <listitem
><para
>O porto da transferência. Normalmente, não terá de preencher este campo a menos que o seu administrador de rede esteja a fornecer um serviço num porto diferente do que é usado normalmente.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Utilizador/Senha</term
> <listitem
><para
>O nome do utilizador a usar na autenticação.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Manter a Senha</term
> <listitem
><para
>Dependendo do seu nível de segurança, esta poderá ser uma funcionalidade boa ou má. Use-a de acordo com o seu critério. Se estiver interessado, a senha é mantida em formato legível.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Botão tudo:</term
> <listitem
><para
>Selecciona todos os ficheiros do seu projecto para envio.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Botão modificados:</term
> <listitem
><para
>Seleccionada todos os ficheiros modificados para envio.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Botão limpar:</term
> <listitem
><para
>Desselecciona todos os ficheiros da lista.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Botão enviar</term
> <listitem
><para
>Envia os ficheiros.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Botão cancelar</term
> <listitem
><para
>Cancela a transferência se estiver a decorrer ou sai simplesmente da janela se mudar de ideias antes de começar a transferência. </para
></listitem
> </varlistentry
> </variablelist>
</sect3>

</sect2>

</sect1>

