<?xml version="1.0" encoding="UTF-8" ?>

<sect1 id="quanta-projects-3-2">
<sect1info>
<title
>Projectos</title>
<authorgroup>
<author
><firstname
>Robert</firstname
> <surname
>Nickel</surname
> <affiliation
> <address
><email
>robert@artnickel.com</email
></address>
</affiliation>
</author>

<othercredit role="reviewer"
><firstname
>Christopher</firstname
> <surname
>Hornbaker</surname
> <affiliation
> <address
><email
>chrishornbaker@earthlink.net</email
></address>
</affiliation>
<contrib
>Revisão</contrib>
</othercredit>

<othercredit role="reviewer"
><firstname
>Fabrice</firstname
> <surname
>Mous</surname
> <affiliation
> <address
><email
>fabrice@kde.nl</email
></address>
</affiliation>
<contrib
>Revisão</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Pedro</firstname
><surname
>Morais</surname
><affiliation
><address
><email
>morais@kde.org</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 

</authorgroup>
</sect1info>

<title
>Projectos</title>

<sect2 id="create-new-project-3-2">
<title
>Projectos 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 tarefa fácil. </para>

<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-1.png"/>
</imageobject>
<caption
><para
>O Assistente de Projectos.</para
></caption>
</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. 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
>. </para>

<variablelist>
<title
>Configuração Geral do Projecto</title>
<varlistentry>
<term
><guilabel
>Nome</guilabel
></term>
<listitem>
<para
>Aqui você preencher o nome do seu projecto. Por exemplo, iremos chamar ao nosso o <quote
><literal
>teste</literal
>.</quote
> Quando você preencher o <guilabel
>Nome</guilabel
>, o <guilabel
>Ficheiro</guilabel
> é preenchido para si automaticamente. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ficheiro</guilabel
></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 <literal role="extension"
>webprj</literal
> (p.ex., <filename
>xpto.webprj</filename
>). Este ficheiro é gravado no topo da Pasta Principal do projecto. </para>
</listitem>
</varlistentry>
</variablelist>

<variablelist>
<varlistentry>
<term
>Configuração do Servidor</term>
<listitem>
<variablelist>
<varlistentry>
<term
>Protocolo</term>
<listitem>
<para
>Aqui você selecciona o protocolo que irá usar para aceder ao seu projecto. Se o seu projecto estiver na mesma máquina na qual está a usar o &quantaplus;, então deixe o valor como Local. A lista de protocolos aqui mostrada é dependente da configuração do seu sistema. Os protocolos disponíveis incluem o SSH, o FTP, o NFS, o SMB, o WebDAV, entre muitos outros. A lista de protocols é oferecida pela arquitectura poderosa do &kde; que são os KIOSlaves. Esta plataforma permite a todas as aplicações do &kde; aceder facilmente às informações remotas como se estivesse local na máquina. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Servidor</term>
<listitem>
<para
>Aqui você preenche o endereço da máquina servidora à qual deseja aceder, a menos que esteja a trabalhar com o protocolo Local. Poderá introduzir tanto um nome de máquina (maquina.exemplo.com) como um endereço IP (127.0.0.1). </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Utilizador</term>
<listitem>
<para
>O nome do utilizador usado para se autenticar na máquina remota. Isto faz distinção de maiúsculas ou minúsculas. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Senha</term>
<listitem>
<para
>Senha para efectuar a ligação na máquina remota. A capitalização é importante. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Porto</term>
<listitem>
<para
>Deixe este campo em branco se quiser usar o porto predefinido para o protocolo que está a usar. Poderá ter de alterar isto, dependendo da configuração do seu servidor. </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>


<variablelist>
<varlistentry>
<term
>Configuração da Pasta</term>
<listitem>
<variablelist>
<varlistentry>
<term
>Pasta Principal</term>
<listitem>
<para
>Esta é a pasta de topo onde todos os ficheiros e pastas do projecto ficarão guardados. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Pasta de Modelos</guilabel
></term>
<listitem>
<para
>Aqui é onde os modelos deste projecto serão guardados. Por omissão, a sua localização é: <filename class="directory"
><replaceable
>Pasta Principal</replaceable
>/templates</filename
>; por exemplo <filename class="directory"
>/home/ze/projectos/project_exemplo/templates. </filename
> Se você tiver um conjunto comum de ficheiros que você utiliza para os vários projectos, então poderá ser útil apontar este ficheiro para ele, em vez de ser para o local predefinido. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Pasta de Barras de Ferramentas</guilabel
></term>
<listitem>
<para
>Aqui é onde serão gravadas as barras de ferramentas deste projecto. Por omissão, será a <filename class="directory"
><replaceable
>Destino do projecto </replaceable
>/toolbars</filename
>. 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>
</variablelist>
</listitem>
</varlistentry>
</variablelist>


<variablelist>
<varlistentry>
<term
>Código do Projecto</term>
<listitem>
<variablelist>
<varlistentry>
<term
><guilabel
>Adicionar ficheiros locais ou remotos</guilabel
></term>
<listitem>
<para
>Isto permite-lhe adicionar ficheiros do sistema de ficheiros locais. Pode escolher vários ficheiros e directorias inteiras. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Usar o wget para obter os ficheiros do 'site'</guilabel
></term>
<listitem>
<para
>Esta opção é excelente se desejar obter e modificar conteúdo web estático. Nos os casos do 'scripting' no servidor (tipo &PHP;, Python, etc.) terá que obter os ficheiros de outra forma. </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>

<variablelist>
<title
>Inserir os Ficheiros no Projecto</title>
<varlistentry>
<term
>Inserir ficheiro de</term>
<listitem>
<para
>Assinale isto se quiser incluir os ficheiros encontrados na localização da Pasta Principal. Deixe desligado se estiver a começar um projecto do zero. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Filtros</term>
<listitem>
<variablelist>
<varlistentry>
<term
>Inserir para ficheiros de marcas, 'script' e imagem</term>
<listitem>
<para
>Se escolher esta opção só irá adicionar ficheiros de formatação, 'scripts' e imagens no seu projecto. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Inserir ficheiros com a seguinte máscara</term>
<listitem>
<para
>Se escolher esta opção irá mostrar todos os ficheiros e pastas da Pasta Principal e permitir-lhe-á ser mais específico com as suas opções. </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term
>Ficheiros incluídos</term>
<listitem>
<para
>Isto mostra uma lista dos ficheiros na Pasta Principal. Você poderá escolher os ficheiros desejados a serem incluídos, se os assinalar, ou excluídos, se os desligar, no seu projecto. </para>
</listitem>
</varlistentry>
</variablelist>

<variablelist>
<title
>Mais Configurações do Projecto</title>
<varlistentry>
<term
><guilabel
>Autor</guilabel
></term>
<listitem>
<para
>Insira aqui o seu nome. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>E-mail</guilabel
></term>
<listitem>
<para
>O e-mail para onde deseja que vão as coisas relacionadas com o projecto. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Predefinições do Projecto</term>
<listitem>
<variablelist>
<varlistentry>
<term
>DTD por Omissão</term>
<listitem>
<para
>Escolha a linguagem de formatação com que irá trabalhar mais neste projecto. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Codificação por omissão</term>
<listitem>
<para
>Escolha a codificação de caracteres que deseja para os ficheiros no seu projecto ao abri-los e gravá-los. </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Usar o prefixo da antevisão</guilabel
></term>
<listitem>
<para
>Assinale esta opção para usar um prefixo para as suas antevisões. Isto permite-lhe definir o prefixo da pasta 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 <acronym
>JSS</acronym
>, o Python, &etc;.). Basta indicar a primeira parte do endereço tal como existe nesse servidor, para que a pasta no fim seja completa pelo &quantaplus;. Por exemplo, se tiver o domínio <literal
>bar.com</literal
> e se estiver a editar a página <filename
>index.html</filename
>, poderá editá-la na sua máquina remota (<systemitem
>foo.bar.com</systemitem
>), enviá-la para o servidor e carregar em <keycap
>F6</keycap
> para ver os resultados em <systemitem
>www.bar.com</systemitem
> em vez de ser no seu sistema de ficheiros local. </para>
<variablelist>
<varlistentry>
<term
>Prefixo</term>
<listitem>
<para
>Indique aqui o prefixo que deseja utilizar. </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Inserir os modelos globais</guilabel
></term>
<listitem>
<para
>Isto cria uma cópia dos modelos globais na sua árvore de pastas do projecto. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Inserir os modelos locais</guilabel
></term>
<listitem>
<para
>Isto cria uma cópia dos modelos locais na sua árvore de pastas do projecto. </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
> <guimenu
>Projecto</guimenu
> <guimenuitem
>Opções do Projecto</guimenuitem
> </menuchoice
> da página Rede ou com o atalho de teclado <keycap
>F7</keycap
>. </para>

</sect2>

<sect2 id="using-projects-3-2">
<title
>Usar os Projectos</title>

<sect3 id="project-files-3-2">
<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 <guimenuitem
>Abrir</guimenuitem
> no menu <guimenu
>Projecto</guimenu
> ou o ícone <guiicon
>Abrir Projecto</guiicon
> 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 <literal role="extension"
>webprj</literal
>. </para>

<para
>Ao fechar o &quantaplus;, o seu ficheiro de projecto será gravado automaticamente. Ser-lhe-á pedido para gravar as modificações antes de sair se o &quantaplus; detectar ficheiros alterados. Este mesmo comportamento acontece se abrir um novo projecto. </para>

</sect3>

<sect3 id="project-tree-view-3-2">
<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 &RMB; fará aparecer o seguinte menu:</para>

<mediaobject>
<imageobject>
<imagedata fileref="project-tree-view-file-rmb-menu.png" format="PNG"/>
</imageobject>
</mediaobject>

<para
>Estes itens são relativamente simples e serão deixados para o leitor explorar. </para>

<para
>As pastas comportam-se de forma semelhante e só não têm os itens de menu <guimenuitem
>Abrir</guimenuitem
> e <guimenuitem
>Abrir no &quantaplus;</guimenuitem
> do menu do &RMB;: </para>

<mediaobject>
<imageobject>
<imagedata fileref="project-tree-view-dir-rmb-menu.png" format="PNG"/>
</imageobject>
</mediaobject>

<para
>Estes itens também são deixados para o utilizador experimentar. </para>

</sect3>

<sect3 id="upload-project-3-2">
<title
>Enviar Projectos</title>

<para
>A janela de Enviar Projectos: </para>

<mediaobject>
<imageobject>
<imagedata fileref="project-upload-dialog.png" format="PNG"/>
</imageobject>
<caption
><para
>A janela de Enviar Projectos.</para
></caption>
</mediaobject>

<variablelist>
<varlistentry>
<term
><guilabel
>Máquina</guilabel
></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
><guilabel
>Protocolo</guilabel
></term>
<listitem>
<para
>O protocolo de transferência a usar para este envio. Dependendo da sua versão do &kde;, esta lista poderá variar. No mínimo dos mínimos, deverá poder escolhe entre &FTP;, 'file' (&ie;, localmente) e <acronym
>nfs</acronym
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Porto</guilabel
></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
><guilabel
>Utilizador</guilabel
></term>
<listitem>
<para
>Nome de utilizador para autenticação. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Senha</guilabel
></term>
<listitem>
<para
>Senha a utilizar para autenticação. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Manter a Senha</guilabel
></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. A senha é mantida em formato legível. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Localização</guilabel
></term>
<listitem>
<para
>Esta é a directoria de base na máquina remota para a qual irá copiar os ficheiros. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Enviar</guibutton
></term>
<listitem>
<para
>Iniciar o envio </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Cancelar</guibutton
></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>

<varlistentry>
<term
><guibutton
>Tudo</guibutton
></term>
<listitem>
<para
>Selecciona todos os ficheiros do seu projecto para envio. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Modificados</guibutton
></term>
<listitem>
<para
>Seleccionada todos os ficheiros modificados para envio. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Nenhum</guibutton
></term>
<listitem>
<para
>Deselecciona todos os ficheiros da lista. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Inverter</guibutton
></term>
<listitem>
<para
>Selecciona/deselecciona todos os ficheiros da lista. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Expandir Todas</guibutton
></term>
<listitem>
<para
>Expande todas as pastas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Fechar Todas</guibutton
></term>
<listitem>
<para
>Fecha todas as pastas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Actualizar Tudo</guibutton
></term>
<listitem>
<para
>Actualizar a lista. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>
</sect2>
</sect1>
