You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
372 lines
11 KiB
372 lines
11 KiB
<?xml version="1.0" encoding="UTF-8" ?>
|
|
|
|
<chapter id="fundamentals-3-2">
|
|
<chapterinfo>
|
|
<title>The Fundamentals of &quantaplus;</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>
|
|
</chapterinfo>
|
|
|
|
<title>The Fundamentals of &quantaplus;</title>
|
|
|
|
<para>
|
|
Within &quantaplus; there are serveral key concepts. To understand and
|
|
take advantage of &quantaplus;, you must first learn these concepts, the
|
|
fundamentals. This chapter will explain and show you these concepts, without
|
|
which &quantaplus; would be primative.
|
|
</para>
|
|
|
|
<sect1 id="quanta-workspaces-3-2">
|
|
<title>The Workspace</title>
|
|
|
|
<para>
|
|
&quantaplus; divides the workspace into three scopes: Global, Local, and
|
|
Project. These distinctions affect various components in &quantaplus;.
|
|
</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>Global</term>
|
|
<listitem>
|
|
<para>
|
|
Global items are available to anyone that uses &quantaplus;. From toolbars
|
|
to actions, everything marked as global is stored in the common
|
|
&quantaplus; folder structure. This has the effect of allowing a group
|
|
of admins to save certain toolbars, actions, and templates in the global
|
|
tree, which can then be used to keep a multi-user installation of
|
|
&quantaplus; common to everyone on the system.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>Local</term>
|
|
<listitem>
|
|
<para>
|
|
Local items make up a single user's personal collection of web development
|
|
resources. These items are made up of a user's templates and toolbars.
|
|
Local items are stored in a user's home folder. This makes all of the
|
|
user's Local items available for personal use at instance.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>Project</term>
|
|
<listitem>
|
|
<para>
|
|
Project items are are only available to a particular project. These can
|
|
be anything from a &CSS; template to a toolbar with custom actions
|
|
which perform a special task on a project's files. Simply put, this is
|
|
the most limited scope. All of the items saved in the project workspace
|
|
will be saved in the project's folder tree, allowing you to share your
|
|
specialized tools and templates with whomever else you share your
|
|
project with.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="mdi-interface-3-2">
|
|
<title>The Multi-Document Interface</title>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="quantamdi.png" format="PNG" />
|
|
</imageobject>
|
|
<caption><para>&quantaplus; editing the document you are now reading.</para></caption>
|
|
</mediaobject>
|
|
|
|
<para>
|
|
&quantaplus;' &MDI; is broken down to three main parts: the editor window,
|
|
the Quick Info Tabs, and the toolbars. Please see <xref linkend="editor-3-2" />,
|
|
<xref linkend="qit-3-2" />, and <xref linkend="toolbars-3-2" /> for more
|
|
information on these parts.
|
|
</para>
|
|
|
|
<sect2 id="editor-3-2">
|
|
<title>The Editor Window</title>
|
|
|
|
<para>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="quantamdi-editor.png" format="PNG" />
|
|
</imageobject>
|
|
<caption><para>&quantaplus;' editor window.</para></caption>
|
|
</mediaobject>
|
|
</para>
|
|
|
|
<para>
|
|
&quantaplus;' editor window allows for multiple files to be opened at the
|
|
same time. When just one file is open, the document fills the entire
|
|
editor window. As soon as a second document is opened, a small amount of
|
|
space is taken from the bottom of the editor window to allow for tabs to
|
|
be displayed with the filenames and a status icon. (The above picture shows
|
|
a <guiicon>floppy</guiicon> icon beside the filename, indicating that the
|
|
file has been modified and should be saved.)
|
|
</para>
|
|
|
|
<para>
|
|
At the top of the editor window is the editor toolbar set. Currently,
|
|
&quantaplus; defaults to &HTML; 4.01 Transitional, which has a default set
|
|
of toolbars that are loaded. As &quantaplus; progresses, the toolbars will
|
|
be updated to meet the needs of users and to make use of newer features.
|
|
</para>
|
|
|
|
<para>
|
|
Toolbar usage is pretty straight forward. If you want to insert a basic
|
|
tag, like <u>, into your document, then you can click on the icon that
|
|
represents the tag. Now you can insert your data for the tag you have just
|
|
inserted. If you wish to insert a tag that requires certain attributes
|
|
(like an anchor), then you will get a dialog box with the various fields for
|
|
you to fill in.
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="taginputex.png" format="PNG" />
|
|
</imageobject>
|
|
<caption><para>The anchor (<a>) dialog.</para></caption>
|
|
</mediaobject>
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 id="qit-3-2">
|
|
<title>The Quick Info Trees</title>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="quantamdi-treeview.png" format="PNG" />
|
|
</imageobject>
|
|
<caption><para>The Quick Info Trees.</para></caption>
|
|
</mediaobject>
|
|
|
|
<para>
|
|
The Quick Info Trees (&QIT;) allow you to navigate, open, and gather
|
|
information in &quantaplus;. Its tabbed format presents you with the Files, Project,
|
|
Templates, Document Structure, Scripts, Attribute, and Documentation Trees.
|
|
</para>
|
|
|
|
<variablelist id="qit-parts">
|
|
<title>&QIT; Explained</title>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
Files Tree
|
|
<inlinemediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="ftab.png" format="PNG" />
|
|
</imageobject>
|
|
</inlinemediaobject>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This is where you can browse your entire file system. You are presented
|
|
with two top-level roots of the file system. The first is your home folder
|
|
and the second is /. Use these to find existing files on your machine that
|
|
you would like to edit or add to an active project. &BDS; clicking on a file
|
|
in this view gives you several options for managing the selected file and,
|
|
also, allows you to insert the file into an active project, if any, or
|
|
toggle the view between tree and list.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>Project Tree
|
|
<inlinemediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="ptab.png" format="PNG" />
|
|
</imageobject>
|
|
</inlinemediaobject>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
<link linkend="quanta-projects-3-2">Project management</link> is one of the
|
|
many powerful tools that &quantaplus; offers. This tab displays all files
|
|
within your project and allows you to manage the files within the project
|
|
through the use of &BDS; clicking. Actions, such as add, remove, upload,
|
|
or delete files entirely from the disk, can be performed through this menu.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>Templates Tree
|
|
<inlinemediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="ttab.png" format="PNG" />
|
|
</imageobject>
|
|
</inlinemediaobject>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Another feature of &quantaplus; is templates. Templates can be anything
|
|
you would like. Images, code snippets, an entire web page, et cetera. It
|
|
is entirely up to you.
|
|
</para>
|
|
|
|
<para>
|
|
Templates are sorted into three categories, which are based on their scope
|
|
and the context they are being used. These scopes are carried over from
|
|
&quantaplus;' workspace. Global templates are usable all times, local
|
|
templates are usable to the current user, and project templates
|
|
are usable only within their specified project. More on templates can be
|
|
found in <xref linkend="templates-3-2" />.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>Scripts Tree
|
|
<inlinemediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="exec.png" format="PNG" />
|
|
</imageobject>
|
|
</inlinemediaobject>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Here you will find information about the various scripts available for use
|
|
by you. The Global, Local, and Project concept allows here as well. By
|
|
&BGS; clicking the entries, you gain access to all the available
|
|
information about the script. And &BDS; clicking allows you to perform a
|
|
few actions, such as running the script, editing the script, and emailing
|
|
the script, for example.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>Document Structure Tree
|
|
<inlinemediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="view_sidetree.png" format="PNG" />
|
|
</imageobject>
|
|
</inlinemediaobject>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This tab displays the parser's internal representation of your document.
|
|
By &BGS; clicking on a element, your cursor will taken to the element's
|
|
position in the document. By &BDS; clicking on an element, you are
|
|
presented with a number of actions that deal with navigating and updating
|
|
the tree.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>Attribute Tree
|
|
<inlinemediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="tag_misc.png" format="PNG" />
|
|
</imageobject>
|
|
</inlinemediaobject>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This tree appears below all the other &QIT;s. Within it you can quickly
|
|
edit attributes and namespaces. The content-focused entry system
|
|
allows you to modify all the available attributes with little more than a
|
|
few clicks of the mouse.
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="attribute_tree.png" format="PNG" />
|
|
</imageobject>
|
|
<caption><para>Attribute Tree</para></caption>
|
|
</mediaobject>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>Documentation Tree
|
|
<inlinemediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="contents2.png" format="PNG" />
|
|
</imageobject>
|
|
</inlinemediaobject>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Here you can find complete documentation on web technologies to aid your
|
|
development. You can download pre-packaged documentation for &quantaplus;
|
|
at <ulink url="http://quanta.sourceforge.net/docs.html">&quantaplus;'
|
|
documentation site</ulink>, you can <link
|
|
linkend="creating-quanta-docs-3-2">create your own documentation</link>,
|
|
and, by adding a folder named "doc" to a project, you can add, edit,
|
|
and view project-specific documentation.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</sect2>
|
|
|
|
<sect2 id="toolbars-3-2">
|
|
<title>The Toolbars</title>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="toolbars.png" format="PNG" />
|
|
</imageobject>
|
|
<caption><para>&quantaplus;' &HTML; toolbars.</para></caption>
|
|
</mediaobject>
|
|
|
|
<para>
|
|
&quantaplus;' toolbars have been extended greatly and are easy to
|
|
understand. You click on the button and you get an associated action from
|
|
that button. The beautiful part about toolbars is that you can define your
|
|
own actions graphically within &quantaplus;.
|
|
</para>
|
|
|
|
<para>
|
|
Managing toolbars in &quantaplus; is easy. By selecting the <guimenu>
|
|
Toolbars</guimenu> menu, you have the options to load, save, add, and
|
|
email toolbars. When you choose to load a toolbar, you may choose from one
|
|
of the three <link linkend="quanta-workspaces-3-2">workspaces</link> in
|
|
&quantaplus;. When saving a newly created toolbar, you can save it in the
|
|
local scope or within a project's scope. If you would like to make a new
|
|
toolbar available in the global scope, ask your admin to place it in
|
|
&quantaplus;' global toolbar folder.
|
|
</para>
|
|
|
|
<para>
|
|
Another feature of &quantaplus; is the ability to email your toolbars.
|
|
&quantaplus; sends the toolbar as a gzipped tar archive through &kmail;.
|
|
If you receive a toolbar in email, then you can save (and load) it into
|
|
&quantaplus; like any other toolbar!
|
|
</para>
|
|
</sect2>
|
|
</sect1>
|
|
</chapter>
|