summaryrefslogtreecommitdiffstats
path: root/tde-i18n-fr/docs/tdewebdev/quanta/fundamentals.docbook
blob: 65038145f672f9a84d9fd5f29441fd8c4963617d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
<?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 &lt;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 (&lt;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>