<sect1 id="quanta-projects">
<title
>Proyectos en &quanta;</title>

<sect2 id="create-new-project">
<title
>Proyectos nuevos</title>

<para
>El asistente de proyectos de &quanta; ( <menuchoice
> <guimenu
>Proyecto</guimenu
> <guimenuitem
>Nuevo proyecto</guimenuitem
> </menuchoice
>) hace de la creación de un proyecto algo muy sencillo. </para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-1.png" />
</imageobject>
</mediaobject>
<para
>Los campos son bastante simples y se rellenan mejor de arriba a abajo, ya que al rellenar el nombre del proyecto le evitará teclear toda la estructura de directorios para el resto del proyecto. Sin embargo, somos código libre y esto no limita sus usos a este programa. Todas estas rutas y los campos de información del autor se configuran en este punto y más tarde desde el árbos de menús en <menuchoice
> <shortcut
> <keycap
>F7</keycap
> </shortcut
> <guimenu
>Proyecto</guimenu
> <guimenuitem
>Opciones del proyecto</guimenuitem
> </menuchoice
> en la pestaña General.</para>

<variablelist
> <varlistentry
> <term
>Nombre del proyecto</term
> <listitem
><para
>Este es el nombre de su proyecto. Llámelo como quiera. Por ejemplo, llamaremos al nuestro ejemplo. Mientras teclea esto en este campo, se dará cuenta de que se va rellenando los campos Destino del proyecto, archivo fuente, plantillas y barras de herramientas con los valores predeterminados. Todas las rutas de este proyecto son relativas al directorio personal de los usuarios, donde el directorio de destino se pone a $HOME/&lt;nombre-del-proyecto-en-minúsculas-sin-espacios&gt; (por ejemplo, $HOME/ejemplo/ sería el directorio destino).</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Destino del proyecto</term
> <listitem
><para
>Este es el directorio donde se guardarán todos los archivos del proyecto. Por defecto, este será $HOME/ejemplo si ejemplo es el nombre de su proyecto con todas las letras en minúsculas.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Archivo fuente del proyecto</term
> <listitem
><para
>Este es el nombre del archivo del proyecto de &quanta;. Por defecto, es el nombre de su proyecto en minúsculas, sin espacios y con la extensión webprj (por ejemplo, ejemplo.webprj). Este archivo se guarda en el directorio raíz de destino del proyecto.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Plantillas del proyecto</term
> <listitem
><para
>Aquí es donde se guardan las plantillas para este proyecto. Por defecto, es &lt;Destino del proyecto&gt;/templates. Si tiene un conjunto común de archivos que usa en varios proyectos, puede ser útil apuntar este directorio allí en lugar del predeterminado. </para
></listitem
> </varlistentry
> <varlistentry
> <term
>Barras de herramientas del proyecto</term
> <listitem
><para
>Aquí es donde se guardan las barras de herramientas para este proyecto. Por defecto, es &lt;Destino del proyecto&gt;/toolbars. Si tiene un conjunto de barras de herramientas comunes que utiliza en varios proyectos, puede ser útil que apunte este directorio allí en lugar del predeterminado.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Autor</term
> <listitem
><para
>Inserte su nombre (o apodo) aquí.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Email</term
> <listitem
><para
>Correo electrónico al que le quiera que le manden las cosas relacionadas con este proyecto. Normalmente, será a usted.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Fuentes del proyecto</term
> <listitem
><para
> <variablelist
> <varlistentry
> <term
>Añadir archivos locales</term
> <listitem
><para
>Esto le permite añadir archivos del sistema de archivos local. Puede elegir múltiples archivos o directorios completos. No se permite usar esclavos kio.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Usar wget para descargar los archivos del sitio</term
> <listitem
><para
>Esta opción es muy buena si tiene una web de contenido estático que quiere descargar y modificar. Para scripts de servidor (como PHP, python, etc.) tendrá que recoger los archivos de otra manera.</para
></listitem
> </varlistentry
> </variablelist
> </para
></listitem
> </varlistentry
> </variablelist>

<para
>La última pantalla del asistente de proyectos nuevos tiene 3 preferencias que pueden hacer su vida más fácil. Estas preferencias las puede cambiar desde el árbol de menú <menuchoice
> <shortcut
> <keycap
>F7</keycap
> </shortcut
> <guimenu
>Proyecto</guimenu
> <guimenuitem
>Opciones del proyecto</guimenuitem
> </menuchoice
> en la pestaña Red.</para>

<variablelist
> <varlistentry
> <term
>Usar prefijos de vista preliminar</term
> <listitem
><para
>Esto le permite poner el prefijo de la ruta o algún otro en lugar de su sistema de ficheros local. Esto es más útil para páginas que tienen contenido dinámico y son dependientes del procesamiento en el servidor (como PHP, JSS, python, etc.). Simplemente, teclee la primera parte de la dirección tal y como existe en ese servidor y la ruta al archivo al final la completará quanta. Por ejemplo, si tiene el dominio algo.com y está editando la página index.html, puede editarla en su máquina remota (ejemplo.algo.com), subirla al servidor y pulsar F6 para ver los resultados en www.algo.com en lugar de en su sistema de archivos local.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Insertar plantillas globales</term
> <listitem
><para
>Esto copia las plantillas globales en su árbol de directorios de proyectos.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Insertar plantillas locales</term
> <listitem
><para
>Esto hace una copia de las plantillas locales en su árbol de directorios de proyectos.</para
></listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2 id="using-projects">
<title
>Usando los proyectos</title>
<sect3 id="project-files">
<sect3info>
<author
> <firstname
>Robert</firstname
> <surname
>Nickel</surname
> </author>
</sect3info>
<title
>Archivos de proyecto</title>
<para
>Por defecto, &quanta; abrirá el último proyecto al que se accedió al ser lanzado. Por ahora, este comportamiento no es configurable.</para>
<para
>Para abrir otro proyecto, seleccione Abrir del menú Proyecto o el icono Abrir proyecto de la barra de herramientas. Se mostrará el cuadro de diálogo para abrir proyectos y le permitirá seleccionar el proyecto que desee. Los proyectos tienen una extensión webprj.</para>
<para
>Al cerrar &quanta;, se guardará automáticamente su archivo de proyecto. Se le pedirá que guarde cualquier cambio antes de salir si &quanta; detecta un cambio en cualquier archivo. Esto mismo ocurre si carga un proyecto nuevo.</para>
</sect3>

<sect3 id="project-tree-view">
<sect3info>
<author
> <firstname
>Robert</firstname
> <surname
>Nickel</surname
> </author>
</sect3info>
<title
>La vista de árbol del proyecto</title>
<para
>La vista de árbol del proyecto le da un acceso ilimitado a los archivos de su proyecto. Aquí es donde gestiona los archivos de su proyecto actual.</para>
<para
>Para los archivos, un clic del botón derecho (&RMB;) hace surgir el siguiente menú:</para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-tree-view-file-rmb-menu.png" />
</imageobject>
</mediaobject>
<para
>Estos elementos son autoexplicativo y se le deja al lector la parte de la exploración.</para>
<para
>Los directorios son similares y sólo se diferencian en los elementos del menú Abrir con y Abrir en &quanta;:</para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-tree-view-dir-rmb-menu.png" />
</imageobject>
</mediaobject>
<para
>Estos elementos también se dejan para que el lector los explore.</para>

</sect3>

<sect3 id="upload-project">
<sect3info>
<author
> <firstname
>Robert</firstname
> <surname
>Nickel</surname
> </author>
</sect3info>
<title
>Subiendo proyectos</title>
<para
>El diálogo de subida de proyectos:</para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-upload-dialog.png" />
</imageobject>
</mediaobject>

<variablelist
> <varlistentry
> <term
>Máquina</term
> <listitem
><para
>Este es el nombre del servidor al que está copiando los archivos. Puede ser o un nombre de dominio plenamente cualificado o una dirección IP.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Protocolo</term
> <listitem
><para
>Protocolo de transferencia para utilizar en esta subida. Según su versión de KDE y si ha descargado esclavos kio extra, esta lista puede variar. En el caso mínimo, debería poder elegir entre ftp, file y nfs.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Ruta</term
> <listitem
><para
>Esta es la ruta base en la máquina remota a la que va a copiar los archivos.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Puerto</term
> <listitem
><para
>Puerto para la transferencia. Normalmente, no se tiene que preocupar por esto a no ser que el administrador de su red esté alojando un servicio en un puerto distinto al estándar.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Usuario/Contraseña</term
> <listitem
><para
>Nombre de usuario para la autentificación. Si es usuario de Linux y necesita que le explique esto, mándeme un correo por listo ;-)</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Mantener la contraseña</term
> <listitem
><para
>Según su nivel de paranoia, esta es una característica buena o mala. Úsela según le parezca. ¿Cómo se guarda la contraseña? En texto plano.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Botón todo</term
> <listitem
><para
>Selecciona para subir todos los archivos de su proyecto.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Botón modificado</term
> <listitem
><para
>Selecciona para subir todos los archivos modificados.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Botón limpiar</term
> <listitem
><para
>Deselecciona todos los archivos de la lista.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Botón subir</term
> <listitem
><para
>¡Oh! Vamos allá, Scotty.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Botón cancelar</term
> <listitem
><para
>Esto detendrá su transferencia en progreso o simplemente saldrá del diálogo si cambia de idea antes de empezar la subida. </para
></listitem
> </varlistentry
> </variablelist>
</sect3>

</sect2>

</sect1>

