summaryrefslogtreecommitdiffstats
path: root/doc/ksig/index.docbook
blob: e2e442fff7e712b1001e42f58385e82cf83cc032 (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
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
  <!ENTITY ksig "<application>KSig</application>">
  <!ENTITY kappname "&ksig;">
  <!ENTITY package "tdeaddons">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>
<book lang="&language;">

<!-- This header contains all of the meta-information for the document such
as Authors, publish date, the abstract, and Keywords -->

<bookinfo>
<title>The &ksig; Handbook</title>

<authorgroup>
<author>
<personname>
<firstname>Richard</firstname>
<othername>A.</othername>
<surname>Johnson</surname>
</personname>
<email>nixternal@ubuntu.com</email>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<copyright>
<year>2006</year>
<holder>Richard A. Johnson</holder>
</copyright>
<!-- Translators: put here the copyright notice of the translation -->

<legalnotice>&FDLNotice;</legalnotice>

<date>2007-01-06</date>
<releaseinfo>1.01.00</releaseinfo>

<abstract>
<para>
&ksig; is an application specially designed to manage multiple email signatures
graphically.
</para>
</abstract>

<keywordset>
<keyword>KSig</keyword>
<keyword>tdeaddons</keyword>
<keyword>signature</keyword>
<keyword>kmail</keyword>
<keyword>plugin</keyword>
</keywordset>

</bookinfo>

<!-- CHAPTER: INTRODUCTION -->
<chapter id="introduction">
<title>Introduction</title>
<para>
&ksig; is a graphical tool for keeping track of many different email signatures.
The signatures themselves can be edited through &ksig;&apos;s graphical user
interface. A command-line interface is then available for generating random or
daily signatures from a list. The command-line interface makes a suitable plugin
for generating signatures in external mail clients such as &kmail;.
</para>
<para>
Random signatures will pull signatures from the &ksig; signature file randomly.
You can make every email more exiciting and uniqe than the previous by creating
multiple signatures with varying quotes, styles, and information.
</para>
<para>
Daily signatures will pull signatures from the &ksig; signature file only using
one signature for an entire day. Every day will provide a different signature,
and just like the random signatures provide uniqueness to your emails.
</para>
<para>
 Please report any problems or feature requests to the &kde; mailing lists.
</para>
</chapter>

<chapter id="using-ksig">
<title>Using &ksig;</title>
<para>
Go to
<menuchoice><guimenu>KMenu</guimenu><guisubmenu>Utilities</guisubmenu>
<guisubmenu>PIM</guisubmenu><guimenuitem>&ksig; Signature Editor</guimenuitem></menuchoice></para>

<para>
<screenshot>
<screeninfo>Here's a screenshot of &ksig;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="screenshot.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Screenshot</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<sect1 id="ksig-newsig">
<title>Creating a new signature</title>
<para>To create a new signature, go to <menuchoice> <shortcut> <keycombo
action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut>
<guimenu>File</guimenu>
<guimenuitem>New</guimenuitem> </menuchoice>. This will create an
<guilabel>&lt;empty signature&gt;</guilabel> in the
<guilabel>Signatures</guilabel> section. <mousebutton>Left</mousebutton> click
the &lt;empty signature&gt; and in the bottom section type in your new
signature.
<example>
<title>Signature example</title>
<screen>
Mr. Konqi
konqi@kde.org
http://www.kde.org
</screen>
</example>
Once you have completed your signature, save it by going to <menuchoice>
<shortcut> <keycombo
action="simul">&Ctrl;<keycap>S</keycap></keycombo> </shortcut>
<guimenu>File</guimenu>
<guimenuitem>Save</guimenuitem> </menuchoice>, or by pressing the
<guibutton>Save</guibutton> button (floppy disc icon).
</para>

<para>You can create as many signatures as you would like. Doing so provides you
with a list of signatures to use in email applications such as &kmail;, so no
matter how informal or professional you need to be, there will always be an
available signature.</para>

</sect1>

<sect1 id="ksig-delsig">
<title>Deleting a signature</title>
<para>To remove a signature first select the signature that you want to remove
and then click
<menuchoice><guimenu>File</guimenu><guimenuitem>Remove</guimenuitem></menuchoice
>, or by clicking the <guibutton>Remove</guibutton> button with the red x icon in the
toolbar.
</para>
</sect1>

<sect1 id="ksig-kmail-daily">
<title>Adding daily signatures to &kmail;</title>
<para>Adding a daily signature is pretty straight forward. Open &kmail; by
pressing  <keycombo>&Alt;<keycap>F2</keycap></keycombo>. Enter
<command>kmail</command> in the text box and then press
<guibutton>Run</guibutton>. Once inside &kmail;, go to
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
KMail...</guimenuitem></menuchoice>. In the <guilabel>Identities</guilabel>
selection, highlight the identity to add the signature to and then press the
<guibutton>Modify...</guibutton> button on the right-hand side of the window. Select
the <guilabel>Signature</guilabel> tab. Check the <guilabel>Enable
signature</guilabel> box. From the <guilabel>Obtain signature text
from</guilabel> drop down, select <guimenuitem>Output of Command</guimenuitem>.
In the <guilabel>Specify command</guilabel> text box, enter <command>ksig
--daily</command> and then press the <guibutton>OK</guibutton> button.
</para>
</sect1>

<sect1 id="ksig-kmail-random">
<title>Adding random signatures to &kmail;</title>
<para>Adding a random signature, just like the daily signature, is pretty
straight forward. Open &kmail; by pressing
<keycombo>&Alt;<keycap>F2</keycap></keycombo>. Enter <command>kmail</command> in
the text box and then press <guibutton>Run</guibutton>. Once inside &kmail;, go
to <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
KMail...</guimenuitem></menuchoice>. In the <guilabel>Identities</guilabel>
selection, highlight the identity to add the signature to and then press the
<guibutton>Modify...</guibutton> button on the right-hand side of the window. Select
the <guilabel>Signature</guilabel> tab. Check the <guilabel>Enable
signature</guilabel> box. From the <guilabel>Obtain signature text
from</guilabel> drop down, select <guimenuitem>Output of Command</guimenuitem>.
In the <guilabel>Specify command</guilabel> text box, enter <command>ksig
--random</command> and then press the <guibutton>OK</guibutton> button.
</para>
</sect1>
</chapter>

<chapter id="commands">
<title>Command Reference</title>

<!-- (OPTIONAL, BUT RECOMMENDED) This chapter should list all of the
application windows and their menubar and toolbar commands for easy reference.
Also include any keys that have a special function but have no equivalent in the
menus or toolbars. This may not be necessary for small apps or apps with no tool
or menu bars. -->

<sect1 id="filemenu">
<title>The <guilabel>File</guilabel> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice> <shortcut> <keycombo
action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut>
<guimenu>File</guimenu>
<guimenuitem>New</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Creates a new signature.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <shortcut> <keycombo
action="simul">&Ctrl;<keycap>S</keycap></keycombo> </shortcut>
<guimenu>File</guimenu>
<guimenuitem>Save</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Saves the signature.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Remove</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Removes a signature.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <shortcut> <keycombo
action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut>
<guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Quits &ksig;.</action></para>
</listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="editmenu">
<title>The <guilabel>Edit</guilabel> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice> <shortcut> <keycombo
action="simul">&Ctrl;<keycap>X</keycap></keycombo> </shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Cut</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Cuts the current selection.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <shortcut> <keycombo
action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Copy</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Copies the current selection.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <shortcut> <keycombo
action="simul">&Ctrl;<keycap>V</keycap></keycombo> </shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Paste</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Pastes the current &klipper; content.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Clear</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Clears the current selection.</action></para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="settingsmenu">
<title>The <guilabel>Settings</guilabel> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Toolbars</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Toggles whether the <guimenuitem>Main Toolbar
(&ksig;)</guimenuitem> or the <guimenuitem>Search Toolbar (&ksig;)</guimenuitem>
is displayed.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show/Hide Statusbar</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Toggles whether the status bar is displayed.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Edit Standard Header</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Edits the <guilabel>Standard signature
header.</guilabel></action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Edit Standard Footer</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Edits the <guilabel>Standard signature
footer.</guilabel></action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Shortcuts...</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Displays the <guilabel>Configure Shortcuts</guilabel> dialog box.
This lets you choose shortcut keys for various menu items. To change a shortcut,
select an action from the list, and then choose which keystroke to use. Clicking
on the bottom right <guibutton>Custom</guibutton> button lets you choose which
specific key to use. Just press the new key or key combo.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Toolbars...</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Displays a &kde; standard dialog where you can configure the
toolbar icons.</action></para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="helpmenu">
<title>The <guilabel>Help</guilabel> Menu</title>

&help.menu.documentation;

</sect1>
</chapter>

<chapter id="credits">
<title>Credits and License</title>

<para>
&ksig;
</para>
<para>
Program copyright 2002 &Scott.Wheeler; &Scott.Wheeler.mail;
</para>

<para>
Documentation Copyright &copy; 2006 Richard A. Johnson
<email>nixternal@ubuntu.com</email>
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;               <!-- FDL: do not remove -->

&underGPL;        	 <!-- GPL License -->

</chapter>

<appendix id="installation">
<title>Installation</title>

<sect1 id="getting-kapp">
<title>How to obtain &ksig;</title>

&install.intro.documentation;

</sect1>

<sect1 id="requirements">
<title>Requirements</title>

<para>
In order to successfully use &ksig;, you need &kde; 3.5. To apply a signature to
your emails you will also need a client such as &kmail; or any other client that
can obtain the signature text from the output of a command.
</para>

</sect1>

<sect1 id="compilation">
<title>Compilation and Installation</title>

&install.compile.documentation;

</sect1>


</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->