625 lines
15 KiB
625 lines
15 KiB
13 years ago
|
<?xml version="1.0" encoding="UTF-8" ?>
|
||
|
|
||
|
<sect1 id="quanta-projects-3-2">
|
||
|
<sect1info>
|
||
|
<title>Projects</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>Reviewer</contrib>
|
||
|
</othercredit>
|
||
|
|
||
|
<othercredit role="reviewer">
|
||
|
<firstname>Fabrice</firstname>
|
||
|
<surname>Mous</surname>
|
||
|
<affiliation>
|
||
|
<address><email>fabrice@kde.nl</email></address>
|
||
|
</affiliation>
|
||
|
<contrib>Reviewer</contrib>
|
||
|
</othercredit>
|
||
|
|
||
|
<!-- TRANS:ROLES_OF_TRANSLATORS -->
|
||
|
|
||
|
</authorgroup>
|
||
|
</sect1info>
|
||
|
|
||
|
<title>Projects</title>
|
||
|
|
||
|
<sect2 id="create-new-project-3-2">
|
||
|
<title>New Projects</title>
|
||
|
|
||
|
<para>
|
||
|
The &quantaplus; project wizard
|
||
|
(<menuchoice>
|
||
|
<guimenu>Project</guimenu>
|
||
|
<guimenuitem>New Project</guimenuitem>
|
||
|
</menuchoice>) makes project creation an easy task.
|
||
|
</para>
|
||
|
|
||
|
<mediaobject>
|
||
|
<imageobject>
|
||
|
<imagedata format="PNG" fileref="project-1.png" />
|
||
|
</imageobject>
|
||
|
<caption><para>The Project Wizard.</para></caption>
|
||
|
</mediaobject>
|
||
|
|
||
|
<para>
|
||
|
The fields are pretty straight forward. It is best to fill them in from
|
||
|
top to bottom. Filling in a project name will autocomplete all the
|
||
|
folder structure for the rest of the project. All of the paths and
|
||
|
author information fields can be configured later on clicking
|
||
|
<menuchoice>
|
||
|
<shortcut>
|
||
|
<keycap>F7</keycap>
|
||
|
</shortcut>
|
||
|
<guimenu>Project</guimenu>
|
||
|
<guimenuitem>Project Options</guimenuitem>
|
||
|
</menuchoice>.
|
||
|
</para>
|
||
|
|
||
|
<variablelist>
|
||
|
<title>General Project Settings</title>
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Name</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Here you fill in the name for your project. For example, we will call ours
|
||
|
<quote><literal>foo</literal>.</quote> When you fill in
|
||
|
<guilabel>Name</guilabel>, <guilabel>File</guilabel> is filled out for
|
||
|
you automatically.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guilabel>File</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
This is the name of the &quantaplus; project file. By default, it is the
|
||
|
name of your project, but in lowercase letters and without spaces. It
|
||
|
uses the extension <literal role="extension">webprj</literal> (&pex;
|
||
|
<filename>foo.webprj</filename>). This file is stored in the root of the
|
||
|
project's Main Folder.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term>Server Settings</term>
|
||
|
<listitem>
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term>Protocol</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Here you select the protocol you will be using to access you project. If
|
||
|
your project is on the same machine that you are using Quanta Plus on,
|
||
|
then leave the value at Local. The list of protocols shown here is
|
||
|
dependant of your system setup. Available protocols include SSH, FTP, NFS,
|
||
|
SMB, WebDAV, and many others. The protocol list is powered by &kde;'s
|
||
|
powerful KIOSlave architecture. This framework allows every &kde;
|
||
|
application to easily access remote information as if it is local to the
|
||
|
machine.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term>Host</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Here you fill in the server address of the machine you want to access,
|
||
|
unless you are working through the Local protocol. Either a hostname
|
||
|
(hostname.example.com) or an IP address (127.0.0.1) can go here.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term>User</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
User name for logging onto the remote machine. This is case-sensitive.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term>Password</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Password for logging onto the remote machine. This is case-sensitive
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term>Port</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Leave this field blank to use the default port for the protocol you are
|
||
|
using. You may need to change this depending on your server's
|
||
|
configuration.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
|
||
|
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term>Folder Settings</term>
|
||
|
<listitem>
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term>Main Folder</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
This is the root folder where all of the project files and folders
|
||
|
will be stored.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Templates Folder</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
This is where the templates for this project will be stored. By default,
|
||
|
its path is: <filename class="directory"><replaceable>Main
|
||
|
Folder</replaceable>/templates</filename>; for example <filename
|
||
|
class="directory">/home/johndoe/projects/example_project/templates.
|
||
|
</filename> If you have a common set of files that you use for several
|
||
|
projects, then it may be useful to point this field to it, instead of to
|
||
|
the default.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Toolbars Folder</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
This is where the toolbars for this project will be stored. By default,
|
||
|
it is <filename class="directory"><replaceable>Project destination
|
||
|
</replaceable>/toolbars</filename>. 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>
|
||
|
</variablelist>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
|
||
|
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term>Project Sources</term>
|
||
|
<listitem>
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Add local or remote files</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
This allows you to get files from the local file system. You can choose
|
||
|
multiple files or entire folders.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Use wget to download files from site</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
This option is great if you have static web content that you wish to
|
||
|
download and modify. For server side scripting (&pex; &PHP;, Python,
|
||
|
&etc;.) you will have to get the files another way.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
|
||
|
<variablelist>
|
||
|
<title>Insert Files in Project</title>
|
||
|
<varlistentry>
|
||
|
<term>Insert file from</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Check this if you wish to include files found in the path of the Main
|
||
|
Folder. Leave unchecked when starting a project from scratch.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term>Filters</term>
|
||
|
<listitem>
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term>Insert only markup, script, and image files</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Choosing this option will only insert markup, script, and image files into
|
||
|
your project.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term>Insert files with the following mask</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Choosing this option will display all files and folders within the
|
||
|
Main Folder and allow you to be more specific with your choices.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term>Included files</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
This displays a list of the files in the Main Folder. You can choose
|
||
|
the desired files for inclusion, by checking, or exclusion, by unchecking,
|
||
|
in your project.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
|
||
|
<variablelist>
|
||
|
<title>More Project Settings</title>
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Author</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Insert your name (or alias) here.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Email</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
The address where you would like email regarding this project to go.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term>Project Defaults</term>
|
||
|
<listitem>
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term>Default DTD</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Choose the markup language you will be working with the most within this
|
||
|
project.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term>Default encoding</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Choose the character encoding you wish the files in your project to be
|
||
|
opened and saved with.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Use preview prefix</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Check this to use a prefix for your previews. This allows you to set the
|
||
|
path prefix to something other than your local file system. This is most
|
||
|
useful for pages that contain dynamic content and are dependent on server
|
||
|
processing (like &PHP;, <acronym>JSS</acronym>, 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 &quantaplus;. For example, if
|
||
|
you have the domain <literal>bar.com</literal> and you are editing the
|
||
|
<filename>index.html</filename> page, you could edit it on your remote
|
||
|
machine (<systemitem>foo.bar.com</systemitem>), upload it to the server
|
||
|
and press <keycap>F6</keycap> to see the results from
|
||
|
<systemitem>www.bar.com</systemitem> instead of your local file system.
|
||
|
</para>
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term>Prefix</term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Enter the prefix you wish to use here.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Insert global templates</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
This makes a copy of the global templates in your projects folder tree.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Insert local templates</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
This makes a copy of the local templates in your projects folder tree.
|
||
|
</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 available for change from the
|
||
|
<menuchoice>
|
||
|
<guimenu>Project</guimenu>
|
||
|
<guimenuitem>Project Options</guimenuitem>
|
||
|
</menuchoice>
|
||
|
menu tree on the Network Tab or with the keyboard shortcut
|
||
|
<keycap>F7</keycap>.
|
||
|
</para>
|
||
|
|
||
|
</sect2>
|
||
|
|
||
|
<sect2 id="using-projects-3-2">
|
||
|
<title>Using Projects</title>
|
||
|
|
||
|
<sect3 id="project-files-3-2">
|
||
|
<title>Project Files</title>
|
||
|
|
||
|
<para>
|
||
|
By default &quantaplus; will open the last project accessed when launched.
|
||
|
This behavior is not currently configurable.
|
||
|
</para>
|
||
|
|
||
|
<para>
|
||
|
To open another project, select <guimenuitem>Open</guimenuitem> from the
|
||
|
<guimenu>Project</guimenu> menu or the <guiicon>Open Project</guiicon>
|
||
|
icon on the toolbar. The open project dialog will pop up and allow you to
|
||
|
choose the project you wish. Projects have a <literal
|
||
|
role="extension">webprj</literal> extension.
|
||
|
</para>
|
||
|
|
||
|
<para>
|
||
|
When closing &quantaplus;, your project file will be saved automatically.
|
||
|
You will be asked to save any changes before exiting if &quantaplus;
|
||
|
detects any changed files. This same behavior occurs if you load a new
|
||
|
project.
|
||
|
</para>
|
||
|
|
||
|
</sect3>
|
||
|
|
||
|
<sect3 id="project-tree-view-3-2">
|
||
|
<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 &BDS; click brings up the following menu:</para>
|
||
|
|
||
|
<mediaobject>
|
||
|
<imageobject>
|
||
|
<imagedata fileref="project-tree-view-file-rmb-menu.png" format="PNG" />
|
||
|
</imageobject>
|
||
|
</mediaobject>
|
||
|
|
||
|
<para>
|
||
|
These items are fairly self-explanatory and will be left to the reader
|
||
|
for exploration.
|
||
|
</para>
|
||
|
|
||
|
<para>
|
||
|
Folders are similar but do not contain the <guimenuitem>Open With
|
||
|
</guimenuitem> and <guimenuitem>Open in &quantaplus;</guimenuitem> &BDS;
|
||
|
menu items:
|
||
|
</para>
|
||
|
|
||
|
<mediaobject>
|
||
|
<imageobject>
|
||
|
<imagedata fileref="project-tree-view-dir-rmb-menu.png" format="PNG" />
|
||
|
</imageobject>
|
||
|
</mediaobject>
|
||
|
|
||
|
<para>
|
||
|
These items are left to the reader for exploration as well.
|
||
|
</para>
|
||
|
|
||
|
</sect3>
|
||
|
|
||
|
<sect3 id="upload-project-3-2">
|
||
|
<title>Uploading Projects</title>
|
||
|
|
||
|
<para>
|
||
|
The Upload Projects dialog:
|
||
|
</para>
|
||
|
|
||
|
<mediaobject>
|
||
|
<imageobject>
|
||
|
<imagedata fileref="project-upload-dialog.png" format="PNG" />
|
||
|
</imageobject>
|
||
|
<caption><para>The Upload Projects dialog.</para></caption>
|
||
|
</mediaobject>
|
||
|
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Host</guilabel></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><guilabel>Protocol</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Transfer protocol to use for this upload. Depending on your version of
|
||
|
&kde; this list will vary. At the very least you should be able to choose
|
||
|
from &FTP;, file (&cad; local) and <acronym>NFS</acronym>.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Port</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Port for the transfer. Usually this will not need to be changed unless your
|
||
|
network administrator is hosting a service on a port other than its well
|
||
|
known port.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guilabel>User</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
User name to use for authentication.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Password</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Password to use for authentication.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Keep Password</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Depending on your level of paranoia, this is a time saving feature, or a
|
||
|
danger. Use it at your discretion. The password is kept on disk in plain text.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guilabel>Path</guilabel></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
This is the base path on the remote host that you will be copying files
|
||
|
to.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guibutton>Upload</guibutton></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Start the upload
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guibutton>Cancel</guibutton></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>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guibutton>All</guibutton></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Select all files in your project for upload.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guibutton>Modified</guibutton></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Select all modified files for upload.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guibutton>None</guibutton></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Unselects all files in the list.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guibutton>Invert</guibutton></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Selects/Unselects all files in the list.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guibutton>Expand All</guibutton></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Expands all folders.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guibutton>Collaspe All</guibutton></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Collaspes all folders.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><guibutton>Update All</guibutton></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Refreshes list.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
</variablelist>
|
||
|
</sect3>
|
||
|
</sect2>
|
||
|
</sect1>
|