From 84da08d7b7fcda12c85caeb5a10b4903770a6f69 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeaddons@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/ksig/Makefile.am | 2 + doc/ksig/index.docbook | 431 ++++++++++++++++++++++++++++++++++++++++++++++++ doc/ksig/screenshot.png | Bin 0 -> 7692 bytes 3 files changed, 433 insertions(+) create mode 100644 doc/ksig/Makefile.am create mode 100644 doc/ksig/index.docbook create mode 100644 doc/ksig/screenshot.png (limited to 'doc/ksig') diff --git a/doc/ksig/Makefile.am b/doc/ksig/Makefile.am new file mode 100644 index 0000000..1a8064c --- /dev/null +++ b/doc/ksig/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = en +KDE_DOCS = AUTO diff --git a/doc/ksig/index.docbook b/doc/ksig/index.docbook new file mode 100644 index 0000000..85879cf --- /dev/null +++ b/doc/ksig/index.docbook @@ -0,0 +1,431 @@ + +KSig"> + + + + +]> + + + + + +The &ksig; Handbook + + + + +Richard +A. +Johnson + +nixternal@ubuntu.com + + + + + +2006 +Richard A. Johnson + + + +&FDLNotice; + +2007-01-06 +1.01.00 + + + +&ksig; is an application specially designed to manage multiple email signatures +graphically. + + + + +KSig +kdeaddons +signature +kmail +plugin + + + + + + +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 +KMenuUtilities +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 +FileRemove, 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 +SettingsConfigure +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 SettingsConfigure +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 <guilabel>File</guilabel> 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 <guilabel>Edit</guilabel> 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 <guilabel>Settings</guilabel> 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 <guilabel>Help</guilabel> 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; + + + diff --git a/doc/ksig/screenshot.png b/doc/ksig/screenshot.png new file mode 100644 index 0000000..69be819 Binary files /dev/null and b/doc/ksig/screenshot.png differ -- cgit v1.2.1