# The &ksig; Handbook

## Introduction

&ksig; is a graphical tool for keeping track of many different email signatures. The signatures themselves can be edited through &ksig;'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;.

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.

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.

Please report any problems or feature requests to the &kde; mailing lists.

## Using &ksig;

Go to KMenu Utilities PIM&ksig; Signature Editor

Here's a screenshot of &ksig; Screenshot

### Creating a new signature

To create a new signature, go to &Ctrl;N File New . This will create an <empty signature> in the Signatures section. Left click the <empty signature> and in the bottom section type in your new signature.

#### Signature example

    Mr. Konqi
    konqi@kde.org
    http://www.kde.org

Once you have completed your signature, save it by going to &Ctrl;S File Save , or by pressing the Save button (floppy disc icon).

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.

### Deleting a signature

To remove a signature first select the signature that you want to remove and then click File Remove, or by clicking the Remove button with the red x icon in the toolbar.

### Adding daily signatures to &kmail;

Adding a daily signature is pretty straight forward. Open &kmail; by pressing &Alt;F2. Enter `kmail` in the text box and then press Run. Once inside &kmail;, go to Settings Configure KMail.... In the Identities selection, highlight the identity to add the signature to and then press the Modify... button on the right-hand side of the window. Select the Signature tab. Check the Enable signature box. From the Obtain signature text from drop down, select Output of Command. In the Specify command text box, enter `ksig --daily` and then press the OK button.

### Adding random signatures to &kmail;

Adding a random signature, just like the daily signature, is pretty straight forward. Open &kmail; by pressing &Alt;F2. Enter `kmail` in the text box and then press Run. Once inside &kmail;, go to Settings Configure KMail.... In the Identities selection, highlight the identity to add the signature to and then press the Modify... button on the right-hand side of the window. Select the Signature tab. Check the Enable signature box. From the Obtain signature text from drop down, select Output of Command. In the Specify command text box, enter `ksig --random` and then press the OK button.

## Command Reference

### The File Menu

&Ctrl;N File New

- Creates a new signature.

&Ctrl;S File Save

- Saves the signature.

File Remove

- Removes a signature.

&Ctrl;Q File Quit

- Quits &ksig;.

### The Edit Menu

&Ctrl;X Edit Cut

- Cuts the current selection.

&Ctrl;C Edit Copy

- Copies the current selection.

&Ctrl;V Edit Paste

- Pastes the current &klipper; content.

Edit Clear

- Clears the current selection.

### The Settings Menu

Settings Toolbars

- Toggles whether the Main Toolbar (&ksig;) or the Search Toolbar (&ksig;) is displayed.

Settings Show/Hide Statusbar

- Toggles whether the status bar is displayed.

Settings Edit Standard Header

- Edits the Standard signature header.

Settings Edit Standard Footer

- Edits the Standard signature footer.

Settings Configure Shortcuts...

- Displays the Configure Shortcuts 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 Custom button lets you choose which specific key to use. Just press the new key or key combo.

Settings Configure Toolbars...

- Displays a &kde; standard dialog where you can configure the toolbar icons.

### The Help Menu

&help.menu.documentation;

## Credits and License

&ksig;

Program copyright 2002 &Scott.Wheeler; &Scott.Wheeler.mail;

Documentation Copyright © 2006 Richard A. Johnson nixternal@ubuntu.com

&underFDL; &underGPL;

## Installation

### How to obtain &ksig;

&install.intro.documentation;

### Requirements

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.

### Compilation and Installation

&install.compile.documentation;
&documentation.index;