summaryrefslogtreecommitdiffstats
path: root/tde-i18n-fr/docs/tdewebdev/quanta/quanta-projects.docbook
diff options
context:
space:
mode:
Diffstat (limited to 'tde-i18n-fr/docs/tdewebdev/quanta/quanta-projects.docbook')
-rw-r--r--tde-i18n-fr/docs/tdewebdev/quanta/quanta-projects.docbook624
1 files changed, 624 insertions, 0 deletions
diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/quanta-projects.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/quanta-projects.docbook
new file mode 100644
index 00000000000..04622854997
--- /dev/null
+++ b/tde-i18n-fr/docs/tdewebdev/quanta/quanta-projects.docbook
@@ -0,0 +1,624 @@
+<?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>