<sect1 id="quanta-projects">
<title>Projects in &quanta;</title>

<sect2 id="create-new-project">
<title>New Projects</title>

<para>The &quanta; project wizard (
<menuchoice>
<guimenu>Project</guimenu>
<guimenuitem>New Project</guimenuitem>
</menuchoice>) makes project creation a breeze. </para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-1.png" />
</imageobject>
</mediaobject>
<para>The fields are pretty straight forward and are best filled in from top to bottom as filling in the project name will relieve you 
of some effort of typing in all the directory structure for the rest of the project.  However, we're open source and will not limit your 
uses of this program.  All of these paths and author information fields are configurable at this point and later from the <menuchoice>
<shortcut>
<keycap>F7</keycap>
</shortcut>
<guimenu>Project</guimenu>
<guimenuitem>Project Options</guimenuitem>
</menuchoice> menu tree on the General Tab.</para>

<variablelist>
<varlistentry>
<term>Project Name</term>
<listitem><para>This is the name of your project.  Whatever you wish to call it.  For means of example, we'll call ours foo.  As you type
into this field you'll notice that the Project destination, source file, templates and toolbars fields all fill in with default values.
All paths in this project will be set relative to the current users home directory where the destination directory will be set to 
$HOME/&lt;Lower-Case-Project-Name-Without-Spaces> (e.g. $HOME/foo/ is the destination directory).</para></listitem>
</varlistentry>

<varlistentry>
<term>Project destination</term>
<listitem><para>This is the directory where all of the project files will be stored.  By default, this is $HOME/foo where foo is the name of 
your project in all lower case letters.</para></listitem>
</varlistentry>

<varlistentry>
<term>Project source file</term>
<listitem><para>This is the name of the &quanta; project file.  By default it is the name of your project in lower case letters without 
whitespace with the webprj extension (e.g. foo.webprj).  This file is stored in the root of the Project destination directory.</para></listitem>
</varlistentry>

<varlistentry>
<term>Project templates</term>
<listitem><para>This is where the templates for this project will be stored.  By default it is &lt;Project destination>/templates.
If you have a common set of files that you use for several projects, it may be useful to point this there instead of the default.
</para></listitem>
</varlistentry>

<varlistentry>
<term>Project toolbars</term>
<listitem><para>This is where the toolbars for this project will be stored.  By default it is &lt;Project destination>/toolbars.
If you have a common set of toolbars that you use for several projects, it may be useful to point this there instead of the default.</para></listitem>
</varlistentry>

<varlistentry>
<term>Author</term>
<listitem><para>Insert your name (or alias) here.</para></listitem>
</varlistentry>

<varlistentry>
<term>Email</term>
<listitem><para>Email where you'd like things regarding this project to go.  Hopefully, it belongs to you.</para></listitem>
</varlistentry>

<varlistentry>
<term>Project Sources</term>
<listitem><para>
<variablelist>
<varlistentry>
<term>Add local files</term>
<listitem><para>This allows you to get files from the local filesystem. You can choose multiple files or entire directories. 
Use of kio slaves is not allowed.</para></listitem>
</varlistentry>
<varlistentry>
<term>Use wget to download files from site</term>
<listitem><para>This option is great if you have static web content that you wish to download and modify.  For server side scripting 
(a la PHP, Python, etc.) you'll have to get the files another way.</para></listitem>
</varlistentry>
</variablelist>
</para></listitem>
</varlistentry>
</variablelist>

<para>The last screen of the new project wizard has 3 settings that can make your life easier. These settings are avialable for change
from the <menuchoice>
<shortcut>
<keycap>F7</keycap>
</shortcut>
<guimenu>Project</guimenu>
<guimenuitem>Project Options</guimenuitem>
</menuchoice> menu tree on the Network Tab.</para>

<variablelist>
<varlistentry>
<term>Use preview prefix</term>
<listitem><para>This allows you to set the path prefix to something other than your local filesystem.  This is most useful for pages 
that contain dynamic content and are dependent on server processing (like PHP, JSS, Python, etc.).  Simply type in the first portion 
of the address as it exists on that server and the filepath at the end will be complete by quanta.  For example, if you have the 
domain bar.com and you're editng the index.html page, you could edit it on your remote machine (foo.bar.com), upload it to the server 
and press F6 to see the results from www.bar.com instead of your local filesystem.</para></listitem>
</varlistentry>

<varlistentry>
<term>Insert global templates</term>
<listitem><para>This makes a copy of the global templates in your projects directory tree.</para></listitem>
</varlistentry>

<varlistentry>
<term>Insert local templates</term>
<listitem><para>This makes a copy of the local templates in your projects directory tree.</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="using-projects">
<title>Using projects</title>
<sect3 id="project-files">
<sect3info>
<author>
<firstname>Robert</firstname>
<surname>Nickel</surname>
</author>
</sect3info>
<title>Project files</title>
<para>By default &quanta; will open the last project accessed when launched.  This behavior is not currently configurable.</para>
<para>To open another project, select Open from the Project menu or the Open Project icon on the toolbar. The open project dialog
will pop up and allow you to choose the project you wish.  Projects have a webprj extension.</para>
<para>When closing &quanta;, your project file will be saved automatically. You will be asked to save any changes before exiting if &quanta;
detects any changed files. This same behavior occurs if you load a new project.</para>
</sect3>

<sect3 id="project-tree-view">
<sect3info>
<author>
<firstname>Robert</firstname>
<surname>Nickel</surname>
</author>
</sect3info>
<title>The Project Tree View</title>
<para>The project tree view gives you uncluttered access to the files in your project. This is where you manage the files in the
current project.</para>
<para>For files, a right mouse button (RMB) click brings up the following menu:</para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-tree-view-file-rmb-menu.png" />
</imageobject>
</mediaobject>
<para>These items are fairly self-explanatory and will be left to the reader for exploration.</para>
<para>Directories are similar and are just missing the Open with and Open in &quanta; RMB menu items:</para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-tree-view-dir-rmb-menu.png" />
</imageobject>
</mediaobject>
<para>These items are left to the reader for exploration as well.</para>

</sect3>

<sect3 id="upload-project">
<sect3info>
<author>
<firstname>Robert</firstname>
<surname>Nickel</surname>
</author>
</sect3info>
<title>Uploading Projects</title>
<para>The upload projects dialog:</para>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="project-upload-dialog.png" />
</imageobject>
</mediaobject>

<variablelist>
<varlistentry>
<term>Host</term>
<listitem><para>This is the hostname of the server your copying the files to.  Either fully qualified domain name, or an ip address will 
work.</para></listitem>
</varlistentry>

<varlistentry>
<term>Protocol</term>
<listitem><para>Transfer protocol to use for this upload.  Depending on your version of KDE and whether you've downloaded extra kio slaves, 
this list will vary.  At the very least you should be able to choose from ftp, file and nfs.</para></listitem>
</varlistentry>

<varlistentry>
<term>Path</term>
<listitem><para>This is the base path on the remote host that you will be copying files to.</para></listitem>
</varlistentry>

<varlistentry>
<term>Port</term>
<listitem><para>Port for the transfer.  Usually this won't need to be bothered unless your network administrator is hosting a service on 
a port other than it's well known port.</para></listitem>
</varlistentry>

<varlistentry>
<term>User/Password</term>
<listitem><para>User name to use for authentication.  If you're using Linux and I need to explain this to you, send me an email for your 
slap! ;-)</para></listitem>
</varlistentry>

<varlistentry>
<term>Keep Password</term>
<listitem><para>Depending on your level of paranoia, this is a good or bad feature.  Use it at your discretion.  FYI, the password is kept 
??? and is clear text.</para></listitem>
</varlistentry>

<varlistentry>
<term>All button</term>
<listitem><para>Select all files in your project for upload.</para></listitem>
</varlistentry>

<varlistentry>
<term>Modified button</term>
<listitem><para>Select all modified files for upload.</para></listitem>
</varlistentry>

<varlistentry>
<term>Clear button</term>
<listitem><para>Unselects all files in the list.</para></listitem>
</varlistentry>

<varlistentry>
<term>Upload button</term>
<listitem><para>Duh!  Beam 'em up Scotty.</para></listitem>
</varlistentry>

<varlistentry>
<term>Cancel button</term>
<listitem><para>This will abort your transfer in progress or just exit out of the dialog if you change your mind before starting the upload.
</para></listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>

</sect1>
