summaryrefslogtreecommitdiffstats
path: root/tde-i18n-fr/docs/kdewebdev/quanta/working-with-quanta.docbook
diff options
context:
space:
mode:
authorTimothy Pearson <kb9vqf@pearsoncomputing.net>2011-11-21 02:23:03 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2011-11-21 02:23:03 -0600
commit9b58d35185905f8334142bf4988cb784e993aea7 (patch)
treef83ec30722464f6e4d23d6e7a40201d7ef5b6bf4 /tde-i18n-fr/docs/kdewebdev/quanta/working-with-quanta.docbook
downloadtde-i18n-9b58d35185905f8334142bf4988cb784e993aea7.tar.gz
tde-i18n-9b58d35185905f8334142bf4988cb784e993aea7.zip
Initial import of extracted KDE i18n tarballs
Diffstat (limited to 'tde-i18n-fr/docs/kdewebdev/quanta/working-with-quanta.docbook')
-rw-r--r--tde-i18n-fr/docs/kdewebdev/quanta/working-with-quanta.docbook565
1 files changed, 565 insertions, 0 deletions
diff --git a/tde-i18n-fr/docs/kdewebdev/quanta/working-with-quanta.docbook b/tde-i18n-fr/docs/kdewebdev/quanta/working-with-quanta.docbook
new file mode 100644
index 00000000000..c1393fb1a75
--- /dev/null
+++ b/tde-i18n-fr/docs/kdewebdev/quanta/working-with-quanta.docbook
@@ -0,0 +1,565 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<chapter id="using-quanta-3-2">
+<chapterinfo>
+<title>Working With...</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>Working With...</title>
+
+<para>
+This chapter describes the parts of &quantaplus; that you will be
+interacting with mostly. These not only make your more productive, but
+they also allow you to customize &quantaplus; to your work-flow.
+</para>
+
+<sect1 id="toolbars-howto-3-2">
+<title>Toolbars</title>
+
+<para>
+As previously mentioned, toolbars in &quantaplus; are primarily managed
+through the <guimenu>Toolbars</guimenu> menu. Usability and creation are
+somewhat different. The creation of toolbars is discussed in a later
+section entitled <quote><link linkend="creating-toolbars-3-2">Creating
+Toolbars</link>.</quote>
+</para>
+
+<para>
+Using toolbars is quite simple. When you click on an icon for a desired
+element or action, one of three possibilities occur: the element is
+inserted (optionally with a closing element); or an element dialog is
+activated, allowing you to fill in the attributes in a dialog box; or,
+lastly, an action is activated and does something nifty for your current
+file or project. If you find yourself doing tedious and redundant typing
+for a particular element, that is not in &quantaplus;, then you can add it.
+See <xref linkend="dtep-intro-3-2" /> for more information.
+</para>
+
+<para>
+A tag dialog looks just like the following:
+
+<mediaobject>
+<imageobject>
+<imagedata fileref="taginputex.png" format="PNG" />
+</imageobject>
+<caption><para>An example of a tag dialog.</para></caption>
+</mediaobject>
+</para>
+
+<para>
+The above image is the dialog for the anchor tag. If you know &XHTML;,
+then you should have noticed that all the attributes that you can use, in
+an anchor element, are available. Notice the tabs above for
+<guilabel>Main</guilabel>, <guilabel>Core and i18n</guilabel>,
+<guilabel>Events</guilabel>, and <guilabel>Focus</guilabel>, they hold
+all of the other attributes, according to their purpose, available to the
+anchor element. All you need do is: fill in the blanks for the attributes
+you want in your anchor, omit the attributes you do not want, and click OK.
+You now have a well formed anchor set down at the current cursor position.
+</para>
+</sect1>
+
+&quanta-projects;
+
+<sect1 id="templates-3-2">
+<title>Templates</title>
+
+<para>
+Templates are basically skeleton documents, code snippets and files to
+link to. &quantaplus; uses templates fundamentally as a standard file
+system with enhanced organization and interfacing. You can copy, move or
+link any repository currently on your system into the templates tree.
+Think of &quantaplus; templates as having roughly the limitations to your
+imagination that your file system has.
+</para>
+
+<para>
+Templates exist in nested folders. There is no limit to how deep you
+can nest them however within any given folder &quantaplus; expects a
+consistent action for the base template type described below. Additionally
+templates allow for pre and post text to be concatenated to non document
+type templates. This facilitates tag creation. The next update after the
+introduction is scheduled to add the ability to pass variables to the text
+such as image size information to assist in tag creation.
+</para>
+
+<para>
+Our goal with templates is to extend them to include multi file <quote>
+concept</quote> templates useful for things like placing an order or
+creating an about section, Ideally this will be a tool for making your
+work more productive and dynamic. An eventual goal is to have a structural
+template design mode to deal with site layout and structure which you
+could use to design and interactively update your sites. If you would like
+to be involved, check out our
+<ulink url="http://quanta.sourceforge.net/main1.php?contfile=needs">help
+wanted</ulink> page.
+</para>
+
+<important>
+<para>
+Some of the templates that ship with &quantaplus; have conditions for
+their usage. Please read carefully the usage statement of conditions at
+the top of each template before you use it.
+</para>
+</important>
+
+<sect2 id="template-types-3-2">
+<title>Template Types</title>
+
+<para>
+Currently templates are limited to being one of the following types of
+objects:
+</para>
+
+<simplelist>
+<member>Document</member>
+<member>Text to insert in a document</member>
+<member>A file to link to form a document</member>
+</simplelist>
+
+<para>
+Documents can be any type of document. Generally you would want to nest
+more specific or diverse documents in subfolders. Here you can make a
+basic framework for what you do and deliver it to your work in an
+organized fashion and realize much better efficiency. Text insertion could
+be anything from a snippet of code to a script or whatever you might wish
+to use. This overlaps the ability to insert text blocks as an action which
+can be triggered from the toolbar. Linked files can be binary, &PHP; class
+libraries or whatever you like.
+</para>
+
+</sect2>
+
+<sect2 id="template-scope-3-2">
+<title>Template Scopes</title>
+
+<para>
+Templates are accessible based upon their established
+<link linkend="quanta-workspaces-3-2">workspace</link> in &quantaplus;
+</para>
+
+</sect2>
+
+<sect2 id="creating-templates-3-2">
+<title>Creating Templates</title>
+
+<para>
+Create a document structure that you love (&XML;, &HTML;, DocBook, &etc;.)
+and click on
+<menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Save as Template</guimenuitem>
+<guimenuitem>Save as Local/Project Template</guimenuitem>
+</menuchoice>.
+</para>
+
+<para>
+Once this is done, you will notice that (even if it is saved as a Project
+template) the template does <emphasis>not</emphasis> show in the project
+tab view. Look into the templates view to find your template under the
+Project templates tab.
+</para>
+
+<para>
+Additionally if you look at your options with the &BDS; you will see
+complete file management tools for creating folders or copying and
+pasting templates from one location to another.
+</para>
+
+</sect2>
+
+<sect2 id="using-templates-with-projects-3-2">
+<title>Using Templates With Projects</title>
+
+<para>
+Project templates allow you to be more tightly focused. You can create
+headers, footers or go dynamic with &PHP; include files and link them.
+Additionally there are some very cool things we took into consideration
+when using templates in projects.
+</para>
+
+<para>
+When creating a project you can opt to copy to your local project all the
+existing global and user templates. Legacy project get default templating
+abilities so nothing is lost You can choose where to locate your template
+files so they can be in your server root and easy to upload or you can
+make them secure to link to below server root which is a very cool trick.
+When linking to a file not in the project templates you will be prompted
+to copy the file to the project templates prior to linking. This will prevent
+broken links on upload. You always have control where you place your
+templates so you can choose to move them. However &quantaplus; does not
+track this so you will need to change links.
+</para>
+
+</sect2>
+
+<sect2 id="managing-templates-3-2">
+<title>Managing Template Behavior</title>
+
+<para>
+Template structure on the template tab is based on the files found in
+<filename class="directory">
+$<envar>KDEDIR</envar>/share/apps/quanta/templates</filename> and
+<filename class="directory">
+$<envar>HOME</envar>/.kde/share/apps/quanta/templates</filename>. Each of
+these folders is specified as one of three types of container:
+</para>
+
+<variablelist>
+<varlistentry>
+<term>files/all</term>
+<listitem>
+<para>
+Binaries and such things that get inserted by their &URL; (&cad; images as
+an <sgmltag class="starttag">img src=/src/url</sgmltag>).
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>text/all</term>
+<listitem>
+<para>
+Text that you can insert into the current &quantaplus; document, such as
+repetitive blocks.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>template/all</term>
+<listitem>
+<para>
+Document templates which you can create new documents from. These open a
+new window in &quantaplus;.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>
+To set the behavior of each folder, &BDS; click in the template view on
+the folder and choose <guimenuitem>Properties</guimenuitem>. The
+following dialog will come up:
+
+<mediaobject>
+<imageobject>
+<imagedata fileref="template-rmb.png" format="PNG" />
+</imageobject>
+<caption><para>Properties dialog.</para></caption>
+</mediaobject>
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Type</guilabel></term>
+
+<listitem>
+<para>
+Drop down box with the three types discussed previously; files, text,
+template. This box will be grayed out if you have the <guilabel>inherit
+parent attribute box</guilabel> checked.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Inherit parent attribute</guilabel> (<sgmltag
+class="starttag">foo</sgmltag>)</term>
+<listitem>
+<para>
+This is checked by default and is fine for all but the top level
+folders in your templates tree. If the top level folder has this
+checked, it will basically deactivate templates for that folder and all
+that aren't explicitly set below it. If this is not a top level folder,
+then the <sgmltag class="starttag">blah</sgmltag> will say something like
+<literal>text/all</literal>. If it says nothing, then chances are that
+you are on a top level folder.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Use pre/post text</guilabel></term>
+<listitem>
+<para>
+Enables pre and post text for templates in this folder. This could be a
+common header/footer for all of your templates for a given project and
+then you copy content templates into that folder and have a complete
+page with the custom header/footer as a starting point.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Pre-text</guilabel></term>
+<listitem>
+<para>
+The actual text to insert before your templates content.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Post-text</guilabel></term>
+<listitem>
+<para>
+The actual text to insert after your templates content.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+</sect1>
+
+<sect1 id="vpl-3-2">
+<sect1info>
+<title><application>Visual Page Layout</application></title>
+<authorgroup>
+<author>
+<firstname>Nicolas</firstname>
+<surname>Deschildre</surname>
+<affiliation>
+<address><email>nicolasdchd@ifrance.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>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</authorgroup>
+</sect1info>
+
+<title><application>Visual Page Layout</application></title>
+
+<sect2 id="vpl-views-3-2">
+<title>&VPL; Modes</title>
+
+<para>
+The <application>Visual Page Layout</application> (&VPL;) editor (also known
+as <acronym>WYSIWYG</acronym> (What You See Is What You Get)) allows you
+to edit a &HTML; or &XHTML; document while seeing the changes on-the-fly.
+Just like your favorite wordprocessor, you can click on your document and
+a cursor will appear, thus enabling you to enter text, insert images,
+apply text decorations, &etc;. &VPL;'s aim is to allow you to create great,
+valid web pages without any knowledge of Internet markup languages.
+</para>
+
+<para>
+&quantaplus; offers two modes: <guilabel>&VPL; Editor</guilabel> and
+<guilabel>&VPL; &amp; Source Editor</guilabel>, which are accesible from
+the <guimenu>View</guimenu> menu. The first replaces the <guilabel>Source
+Editor</guilabel> with the <guilabel>&VPL; Editor</guilabel>, and the
+second splits the editor window into two parts: the <guilabel>Source
+Editor</guilabel> and the <guilabel>&VPL; Editor</guilabel>.
+</para>
+
+<para>
+The <guilabel>&VPL; Editor</guilabel> works like so: It loads a document
+like a normal &HTML; or &XHTML; page and a cursor appears. Then you can
+edit it, and switching back to <guilabel>Source Editor</guilabel>, you see
+that the changes you made on the <guilabel>&VPL; Editor</guilabel> have
+been merged in the <guilabel>Source Editor</guilabel>.
+</para>
+
+<note>
+<para>
+When working in the <guilabel>&VPL; Editor</guilabel> with a document that
+contains &PHP;, you will see a small green icon representing the &PHP;
+code. You cannot directly edit it with the <guilabel>&VPL;
+Editor</guilabel>. To edit &PHP;, you will still need to use the
+<guilabel>Source Editor</guilabel>. There are no plans to change this
+functionility.
+</para>
+</note>
+
+<para>
+The second mode behaves exactly like the first, except that you instantely
+see the impact that your changes have made, either in the <guilabel>Source
+Editor</guilabel> or in the <guilabel>&VPL; Editor</guilabel>, and the
+cursors of the source editor and of the <guilabel>&VPL; Editor</guilabel>
+are synchronized. Pressing <keycap>F9</keycap> loads this mode, but, if
+it is already loaded, it will move the focus from one view to the other,
+while keeping you at the same location of the document.
+</para>
+
+<para>
+The refresh intervals between the <guilabel>&VPL; Editor</guilabel> and
+the <guilabel>Source Editor</guilabel> are configurable. Go to
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Quanta...</guimenuitem>
+</menuchoice>. Select the <guimenu>&VPL; View</guimenu> tab. You can
+choose whether you want to refresh a view only when you click on it or
+automatically. If you choose automatically, then you can choose a refresh
+interval. The general recommendation is: A smaller number for fast
+computers and a bigger number for slower ones.
+</para>
+
+<mediaobject>
+<imageobject>
+<imagedata fileref="vplsourceview.png" format="PNG" />
+</imageobject>
+<caption><para>The <guilabel>&VPL; &amp; Source Editor</guilabel> mode.</para></caption>
+</mediaobject>
+</sect2>
+
+<sect2 id="vpl-editing-3-2">
+<title>&VPL; Editing</title>
+
+<sect3 id="doc-prop-dia-3-2">
+<title>The <guilabel>Document Properties</guilabel> Dialog</title>
+
+<para>
+Now, let's say you want to edit the title of your web page. How do you do
+it? Simply launch
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Document Properties</guimenuitem>
+</menuchoice>. This tool allows the edition of <quote>invisible</quote>
+tags when using the <guilabel>&VPL; Editor</guilabel>. The
+<guilabel>Document Properties</guilabel> dialog is also launched when you
+create a new document while in the <guilabel>&VPL; Editor</guilabel>. This
+is in order to lessen the amount of hand coding you need to perform. With
+it, you can edit:
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Title</guilabel></term>
+<listitem>
+<para>
+The title of the document.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Meta items</guilabel></term>
+<listitem>
+<para>
+Meta tags allow you to store informations about the document itself
+&pex; keywords for the Internet search engines. You can add or remove
+<guilabel>Meta items</guilabel> by pressing the two buttons below,
+and edit them by clicking on the list &pex; put <quote>keywords</quote> on
+the <quote>name</quote> column and <quote>keyword1 keyword2</quote> on the
+<quote>content</quote> column.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>CSS Rules</guilabel></term>
+<listitem>
+<para>
+<guilabel>CSS Rules</guilabel> are the new way to tell your web browser
+how to present the page. You can add or delete the <guilabel>CSS
+Rules</guilabel> by pressing the buttons below. You can also fill the
+fields like the <guilabel>Meta items</guilabel>. The edition of
+<guilabel>CSS Rules</guilabel> is not yet supported.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Link CSS Stylesheet</guilabel></term>
+<listitem>
+<para>
+You can also link an external CSS stylesheet. Simply click on the
+<guilabel>Browse</guilabel> button and select your file.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect3>
+
+<sect3 id="vpl-editor-3-2">
+<title>The <guilabel>&VPL; Editor</guilabel></title>
+
+<para>
+You can use your cursor like you do in a wordprocessor, moving with the
+arrows. It may come that the cursor does not want to go where you want it
+to go (a pesky bug). Selection also works as usual. You can insert text by
+typing and remove text by pressing the &Correction; or delete key.
+</para>
+
+<para>
+Now we come to tag insertion. You can insert images, applets, text
+decorations such as bold and so on by using the same toolbars you use in
+the source editor. Note that the insertion of tags does not remove previous
+identical tags &pex; if you insert an anchor tag around some text, then you
+must remove any other anchor tag around it.
+</para>
+
+<note>
+<para>
+Some toolbar items will be disabled, such as the <guilabel>Table
+Wizard</guilabel> or <guilabel>Quick List Wizard</guilabel>. They will
+work later in &VPL;, but, for this release, you should use the
+<guilabel>Tables</guilabel> or <guilabel>Lists</guilabel> toolbars.
+</para>
+</note>
+
+<para>
+To edit a tag (be it an image, an applet, or whatever), switch to the
+<guilabel>Attribute Tree</guilabel>, accessible via
+<menuchoice>
+<guimenu>View</guimenu>
+<guisubmenu>Tree views</guisubmenu>
+</menuchoice>. Click on the tag you wish to edit, or, if you cannot access
+it, click on an object contained by it. The <guilabel>Attribute
+Tree</guilabel> will show the current tag name as well as a list of all its
+parents and attributes. Currently &VPL; does not support, say,
+&XHTML;+<acronym>MathML</acronym>, but you will see that you can edit
+namespaces via this view. You can simply click on the
+<guilabel>Value</guilabel> field and modify whatever you want. If you want
+to access a parent of the current tag, then select it and the
+<guilabel>Attribute Tree</guilabel> will load it.
+</para>
+
+<para>
+To delete a tag, we will use the <guilabel>Attribute Tree</guilabel>. Have
+you noticed the two little red crosses at the top-right corner? The first one
+deletes only the currently selected tag and, if the &HTML;/&XHTML;
+specification does not allow some childs of the deleted tag to be child of
+the parent tag of the tag set to be deleted, then they are also deleted,
+and so on. The second cross will delete the selected tag as well as all of
+its children, so be careful!
+</para>
+
+</sect3>
+</sect2>
+</sect1>
+</chapter>