summaryrefslogtreecommitdiffstats
path: root/tde-i18n-fr/docs/kdewebdev/quanta/quanta-projects.docbook
blob: 04622854997c2f5d9372928909775c3c41941db2 (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
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
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>