From 460c52653ab0dcca6f19a4f492ed2c5e4e963ab0 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/kdepim@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/knode/Makefile.am | 9 + doc/knode/commands.docbook | 1890 +++++++++++++++++++++++ doc/knode/credits.docbook | 55 + doc/knode/eyes.png | Bin 0 -> 140 bytes doc/knode/faq.docbook | 189 +++ doc/knode/gloss.docbook | 257 +++ doc/knode/greyball.png | Bin 0 -> 181 bytes doc/knode/greyballchk.png | Bin 0 -> 219 bytes doc/knode/index.docbook | 130 ++ doc/knode/install.docbook | 54 + doc/knode/introduction.docbook | 56 + doc/knode/journey.docbook | 530 +++++++ doc/knode/knode-cleanup.png | Bin 0 -> 19537 bytes doc/knode/knode-colors-fonts.png | Bin 0 -> 23760 bytes doc/knode/knode-composer-attachments.png | Bin 0 -> 27665 bytes doc/knode/knode-composer-settings.png | Bin 0 -> 23566 bytes doc/knode/knode-edit-filter.png | Bin 0 -> 16449 bytes doc/knode/knode-edit-header1.png | Bin 0 -> 9364 bytes doc/knode/knode-edit-header2.png | Bin 0 -> 9490 bytes doc/knode/knode-filters.png | Bin 0 -> 34596 bytes doc/knode/knode-followup.png | Bin 0 -> 21113 bytes doc/knode/knode-header-settings.png | Bin 0 -> 24015 bytes doc/knode/knode-identity.png | Bin 0 -> 24099 bytes doc/knode/knode-mail-account.png | Bin 0 -> 17420 bytes doc/knode/knode-new-article.png | Bin 0 -> 20641 bytes doc/knode/knode-news-account.png | Bin 0 -> 11104 bytes doc/knode/knode-post-settings.png | Bin 0 -> 25790 bytes doc/knode/knode-read-news-appearance-dialog.png | Bin 0 -> 29498 bytes doc/knode/knode-read-news-settings.png | Bin 0 -> 25953 bytes doc/knode/knode-reply.png | Bin 0 -> 19592 bytes doc/knode/knode-rule-editor.png | Bin 0 -> 16638 bytes doc/knode/knode-search.png | Bin 0 -> 16101 bytes doc/knode/knode-start.png | Bin 0 -> 24388 bytes doc/knode/knode-subscribe.png | Bin 0 -> 15885 bytes doc/knode/knode-views.png | Bin 0 -> 38641 bytes doc/knode/more.docbook | 134 ++ doc/knode/newsubs.png | Bin 0 -> 193 bytes doc/knode/redball.png | Bin 0 -> 191 bytes doc/knode/redballchk.png | Bin 0 -> 211 bytes doc/knode/using-firststart.docbook | 1859 ++++++++++++++++++++++ doc/knode/using-morefeatures.docbook | 855 ++++++++++ doc/knode/using-subscribing.docbook | 1367 ++++++++++++++++ 42 files changed, 7385 insertions(+) create mode 100644 doc/knode/Makefile.am create mode 100644 doc/knode/commands.docbook create mode 100644 doc/knode/credits.docbook create mode 100644 doc/knode/eyes.png create mode 100644 doc/knode/faq.docbook create mode 100644 doc/knode/gloss.docbook create mode 100644 doc/knode/greyball.png create mode 100644 doc/knode/greyballchk.png create mode 100644 doc/knode/index.docbook create mode 100644 doc/knode/install.docbook create mode 100644 doc/knode/introduction.docbook create mode 100644 doc/knode/journey.docbook create mode 100644 doc/knode/knode-cleanup.png create mode 100644 doc/knode/knode-colors-fonts.png create mode 100644 doc/knode/knode-composer-attachments.png create mode 100644 doc/knode/knode-composer-settings.png create mode 100644 doc/knode/knode-edit-filter.png create mode 100644 doc/knode/knode-edit-header1.png create mode 100644 doc/knode/knode-edit-header2.png create mode 100644 doc/knode/knode-filters.png create mode 100644 doc/knode/knode-followup.png create mode 100644 doc/knode/knode-header-settings.png create mode 100644 doc/knode/knode-identity.png create mode 100644 doc/knode/knode-mail-account.png create mode 100644 doc/knode/knode-new-article.png create mode 100644 doc/knode/knode-news-account.png create mode 100644 doc/knode/knode-post-settings.png create mode 100644 doc/knode/knode-read-news-appearance-dialog.png create mode 100644 doc/knode/knode-read-news-settings.png create mode 100644 doc/knode/knode-reply.png create mode 100644 doc/knode/knode-rule-editor.png create mode 100644 doc/knode/knode-search.png create mode 100644 doc/knode/knode-start.png create mode 100644 doc/knode/knode-subscribe.png create mode 100644 doc/knode/knode-views.png create mode 100644 doc/knode/more.docbook create mode 100644 doc/knode/newsubs.png create mode 100644 doc/knode/redball.png create mode 100644 doc/knode/redballchk.png create mode 100644 doc/knode/using-firststart.docbook create mode 100644 doc/knode/using-morefeatures.docbook create mode 100644 doc/knode/using-subscribing.docbook (limited to 'doc/knode') diff --git a/doc/knode/Makefile.am b/doc/knode/Makefile.am new file mode 100644 index 000000000..692f3ff3a --- /dev/null +++ b/doc/knode/Makefile.am @@ -0,0 +1,9 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + +# $(srcdir)/translation.po: $(srcdir)/german_original.docbook +# xml2pot $(srcdir)/german_original.docbook > german.pot +# msgmerge -o $(srcdir)/translation.po $(srcdir)/translation.po german.pot +# rm german.pot + diff --git a/doc/knode/commands.docbook b/doc/knode/commands.docbook new file mode 100644 index 000000000..47a96ffe1 --- /dev/null +++ b/doc/knode/commands.docbook @@ -0,0 +1,1890 @@ + + + +Command reference + +The following keybindings assume you did not change the default +settings. + + +The main &knode; window + + +The <guimenu>File</guimenu> menu + + + + + + +&Ctrl;S + +File +Save As... + + + + + +Saves the selected article in a file. + + + + + + + +&Ctrl;P + + +File +Print... + + + + + +Prints the selected article. + + + + + + + +File +Send Pending Messages + + + + + +The messages in the Outbox folder are sent. + + + + + + + +File +Stop Network + + + + + +Disconnects the current connection to a newsserver. + + + + + + + +&Ctrl;Q + +File +Quit + + + + + +Quits &knode;. + + + + + + + + + +The <guimenu>Edit</guimenu> menu + + + + + + +&Ctrl;C + + +Edit +Copy + + + + + +Copy the selected text to the clipboard. + + + + + + +&Ctrl;A +Edit +Select All + + + + + +Selects the whole article. + + + + + + + +F4Edit +Search Articles... + + + + + +Opens the Search for Articles dialog box for searching in the active group. + + + + + + + +&Ctrl;F + + +Edit +Find in Article... + + + + +To be written + + + + + + +Edit +Fetch Article with ID... + + + + + +Enables the download of an article with a specified article-ID. + + + + + + + + + +The <guimenu>View</guimenu> menu + + + + + + + +View +Show/Hide Threads + + + + +When this is activated, &knode; shows discussions as a tree view in the article view. + + + + + +View +Expand All Threads + + + + +When this is activated, &knode; shows the complete threads; this is +only functional when Show threads +is active. + + + + + +View +Collapse All Threads + + + + +When this is activated, &knode; shows no threads; this is only +functional when Show threads is active. + + + + + +T +View +Toggle Subthread + + + + + +Toggles between showing and collapsing the selected thread. + + + + + + +View +Filter + + + + + +Allows you to choose a filter for the article view. + + + + + + +View +Sort + + + + + +Allows you to sort the article view. + + + + + + +F5 +View +Refresh List + + + + + +Refreshes the article view + + + + + + + +View +Unscramble (ROT 13) + + + + + +When this setting is activated, &knode; shows all characters of the complete article rotated by 13 characters. + + + + + + +View +Verify PGP signature + + + + +Checks the PGP signature in the article. + + + + + + +V +View +View Source + + + + + +The source code of the active article is opened in a new window. + + + + + + +X +View +Use Fixed Font + + + + + +Activates the configured fixed-width font for the viewer. + + + + + + + + + +View +Charset + + + + + +Here you can configure the charset which is used for the articles. + + + + + + + + + +The <guimenu>Go</guimenu> menu + + + + + +P +Go +Previous Article + + + + + +Jumps to previous article in the article view. + + + + + + +N +Go +Next Article + + + + + +Jumps to next article in the article view. + + + + + + +&Alt;&Shift;Space + +Go +Next Unread Article + + + + + +Jumps to the next unread article, and to the first unread article of the next newsgroup if necessary. + + + + + + +&Shift;Space +Go +Next Unread Thread + + + + + +Jumps to the next unread thread, and to the next unread thread in the next newsgroup if necessary. + + + + + + + +- +Go +Previous Group + + + + + +Jumps to the previous news group in the folder view + + + + + + + ++ +Go +Next Group + + + + + +Jumps to the next newsgroup in the folder view + + + + + + + + +The <guimenu>Account</guimenu> menu + + + + + +Account +Get New Articles in All Groups + + + + + +Connects with the active account and fetches any new messages. + + + + + + +Account +Get New Articles in All Accounts + + + + + +Connects with all account and fetches any new messages. + + + + + + +Account +Subscribe to Newsgroups... + + + + + +Opens the Dialog Box for subscribing to newsgroups for the active account. + + + + + + + +Account +Expire All Groups + + + + + +Here you can expire all groups of an account manually. + + + + + + + +Account +Account Properties + + + + + +Opens the properties dialog for the active account. + + + + + + +Account +Delete Account + + + + + +Deletes the active account and all subscribed newsgroups therein. + + + + + + + + + +The <guimenu>Group</guimenu> menu + + + + + +Group +Get New Articles + + + + + +Connects with the active account and fetches any new messages. + + + + + + +Group +Expire Group + + + + + +Checks if there are any old articles and, if so, deletes them. + + + + + + +Group +Reorganize Group + + + + + +Rebuilds the article view by using the configured sortings. + + + + + + +Group +Mark All as Read + + + + + +Sets the status of all articles in the active newsgroup to read. + + + + + + +Group +Mark All as Unread + + + + + +Sets the status of all articles in the active newsgroup to unread. + + + + + + +Group +Mark Last as Unread + + + + + +To be written. + + + + + + +Group +Group Properties + + + + + +Opens the dialog for the group properties. + + + + + + +Group +Unsubscribe From Group + + + + + +Unsubscribes from the active newsgroup + + + + + + + + + + +The <guimenu>Folder</guimenu> menu + + + + + +Folder +New Folder + + + + + +Creates a new main folder. + + + + + + +Folder +New Subfolder + + + + + +Creates a new subfolder. + + + + + + +Folder +Rename Folder + + + + + +Here you can rename the active folder. + + + + + + +Folder +Import MBox Folder... + + + + + +With this function it is possible to import an MBox folder into the active folder. + + + + + + +Folder +Export as MBox Folder... + + + + + +With this function you can export the active folder as an MBox folder. + + + + + + +Folder +Compact Folder + + + + + +Removes all deleted articles from the active folder. + + + + + + +Folder +Compact All Folders + + + + + +Removes all deleted articles from the every folder. + + + + + + +Folder +Empty Folder + + + + + +Deletes all articles from the active folder. + + + + + + +Folder +Delete Folder + + + + + +Deletes the active folder. + + + + + + + + + +The <guimenu>Article</guimenu> menu + + + + + +&Ctrl;N + +Article +Post to Newsgroup... + + + + + +Opens the Composer, with the settings for writing new articles set to those of the active newsgroup. + + + + + + +R +Article +Followup to Newsgroup + + + + + +Opens the Composer for writing a followup, with the content of the active article. + + + + + + +A +Article +Reply by Email... + + + + + +Opens the Composer for writing an e-mail to the author of the active article. + + + + + + +F +Article +Forward by Email... + + + + + +Opens the Composer for forwarding the active article as e-mail. + + + + + + +D +Article +Mark as Read + + + + +Set the status of the active article to +read + + + + + + +U +Article +Mark as Unread + + + + +Set the status of the active article to +unread + + + + + + +&Ctrl;D +Article +Mark Thread as Read + + + + +Set the status of the active thread to +read + + + + + + +&Ctrl;U +Article +Mark Thread as Unread + + + + +Set the status of the active thread to +unread + + + + + + +Article +Cancel Article + + + + + +Generate a message which deletes the active Article in Usenet; you can +only use this with your own articles. + + + + + + +Article +Supersede Article + + + + + +Opens the Composer with the content of the active article; when this article is posted it overwrites the original article. You can only use this with your own articles. + + + + + + +O +Article +Open in Own Window + + + + + +The active article is opened in a new window. + + + + + + +E +Article +Edit Article... + + + + + +Opens the Composer for editing the active article; +you can only use this in the +Outbox +and +Drafts +folders. + + + + + +Delete +Article +Delete Article + + + + + +Deletes the active article. +You can only use this in the +Outbox +and +Drafts + folders. + + + + + +Article +Send Now + + + + + +Sends the active article. +You can only use this in the +Outbox +and +Drafts +folders. + + + + + + + + +The <guimenu>Scoring</guimenu> menu + + + + + +&Ctrl;E +Scoring +Edit Scoring Rules... + + + + + +The dialog to edit the scoring rules will be opened. + + + + + + +Scoring +Recalculate Scores + + + + + +The scores will be reset and recalculated. + + + + + + +&Ctrl;L +Scoring +Lower Score for Author... + + + + + +Creates a rule for lowering the score of all articles posted by the author of the active article. + + + + + + +&Ctrl;I +Scoring +Raise Score for Author... + + + + + +Creates a rule for raising the score of all articles posted by the author of the active article. + + + + + + +WScoring +Watch Thread + + + + + +Sets the score for this thread to the configured score of watched threads (standard = 100). + + + + + + +I +Scoring +Ignore Thread + + + + + +Sets the score for this thread to the configured score of ignored threads (standard = -100). + + + + + + + + + +The <guimenu>Settings</guimenu> menu + + + + + +Settings +Show/Hide Toolbar + + + + + +This option toggles whether the toolbar is shown or not. + + + + + + +Settings +Show/Hide Statusbar + + + + + +This option toggles whether the statusbar is shown or not. + + + + + + + +&Ctrl;G + +Settings +Show/Hide Group View + + + + + +This option toggles whether the group list is shown or not. + + + + + + +&Ctrl;H + +Settings +Show/Hide Header View + + + + + +This option toggles whether the header view is shown or not. + + + + + + +&Ctrl;J + +Settings +Show Article Viewer + + + + + +This option toggles whether the article is shown or not. + + + + + + + + +Settings +Configure Shortcuts... + + + + + +Opens a dialog for configuring the key bindings. + + + + + + +Settings +Configure Toolbars... + + + + + +Opens a dialog for configuring the toolbars. + + + + + + +Settings +Configure &knode;... + + + + + +Opens a dialog for configuring &knode;. + + + + + + + + + +The <guimenu>Help</guimenu> menu + +&help.menu.documentation; + + + + + +The composer menus. + + + +The <guimenu>File</guimenu> menu + + + + + +&Ctrl;Return +File +Send Now + + + + + +Sends the current article immediately. + + + + + + +File +Send Later + + + + +Stores the current article in the +Outbox +to be sent later. + + + + + +File +Save as Draft + + + + +Saves the current article in the +Drafts +folder, so you can finish editing it another time. + + + + + +File +Delete + + + + + +Deletes the current article, closing the editor. + + + + + + +&Ctrl;W +File +Close + + + + + +Closes the editor window + + + + + + + + + +The <guimenu>Edit</guimenu> menu + + + + + +&Ctrl;Z +Edit +Undo + + + + + +Undo the last edit. + + + + + + +&Ctrl;ShiftZ +Edit +Redo + + + + +Redo the last action undone with the +Undo +menu entry. + + + + + +&Ctrl;X +Edit +Cut + + + + + +Cuts the currently-selected text to the clipboard, deleting it from the editor window. + + + + + + +&Ctrl;C +Edit +Copy + + + + + +Copies the selected text to the clipboard. + + + + + + +&Ctrl;V +Edit +Paste + + + + + +Pastes the current contents of the clipboard into the editor window. + + + + + + +Edit +Paste as Quotation + + + + + +Pastes the current contents of the clipboard into the editor window with +a quote character (>) at the beginning of each +line. + + + + + + +Edit +Select All + + + + + +Selects all the text in the editor window. + + + + + + +&Ctrl;F +Edit +Find + + + + + +Opens the Find dialog. + + + + + + +&Ctrl;R +Edit +Replace... + + + + + +Opens the Replace dialog. + + + + + + + + + +The <guimenu>Attach</guimenu> menu + + + + + +Attach +Append Signature + + + + + +Inserts your signature at the end of the article you are editing. + + + + + + +Attach +Insert File... + + + + + +Inserts the contents of a file into the editor window. + + + + + + + +Attach +Insert File (in a box)... + + + + + +Inserts the contents of a file into the editor window and puts a box around of it. + + + + + + + + +Attach +Attach File... + + + + + +Inserts a file as an attachment. + + + + + + + + + +The <guimenu>Options</guimenu> menu + + + + + +Options +Send News-Article + + + + + +Toggles whether the message is to be sent as an article or not. + + + + + + +Options +Send Email + + + + + +Toggles whether the message is to be sent as an email or not; if it's configured, an external editor will be activated. + + + + + + +Options +Set Charset + + + + + +Here you can configure the charset used for this article; normally you use us-ascii for English-speaking areas. + + + + + + +Options +Word Wrap + + + + + +Toggles the word wrapping in the editor on or off. + + + + + + + + + +The <guimenu>Tools</guimenu> menu + + + + + +Tools +Add Quote Characters + + + + + +Puts > in front of the marked lines. + + + + + + +Tools +Remove Quote Characters + + + + + +Removes the quote characters at the beginning of the marked lines. + + + + + + +Tools +Add Box + + + + + +Puts the marked lines in an ASCII box. + + + + + + +Tools +Remove Box + + + + + +Removes the ASCII box around the marked area. + + + + + + +Tools +Sign Article with PGP + + + + + +Signs the article with PGP. + + + + + + +Tools +Get Original Text (not rewrapped) + + + + + +Rebuilds the original posting when answering to an article. + + + + + + +Tools +Scramble (Rot-13) + + + + + +Encrypts the marked text by rotating every character 13 characters of the alphabet. + + + + + + +Tools +Start External Editor + + + + + +Start the external editor (if one is configured) with the current contents of the editor window. + + + + + + +&Ctrl;Z +Tools +Spelling... + + + + + +Opens a dialog box to check your spelling. + + + + + + + + + +The <guimenu>Settings</guimenu> menu + + + + + +Settings +Show Toolbar + + + + + +Toggles whether the toolbar should be shown or not. + + + + + + +Settings +Show Statusbar + + + + + +Toggles whether the statusbar should be shown or not. + + + + + + +Settings +Configure Shortcuts... + + + + + +Opens a dialog for configuring the key bindings. + + + + + + +Settings +Configure Toolbars... + + + + + +Opens a dialog for configuring the toolbars. + + + + + + +Settings +Configure KNode... + + + + + +Open the &knode; Preferences dialog. + + + + + + + + +The <guimenu>Help</guimenu> menu + +&help.menu.documentation; + + + + + diff --git a/doc/knode/credits.docbook b/doc/knode/credits.docbook new file mode 100644 index 000000000..093c16851 --- /dev/null +++ b/doc/knode/credits.docbook @@ -0,0 +1,55 @@ + +Credits and License + +&knode; + +Program Copyright 1999, 2000, 2001, 2002 KNode developers + + +Developers + +Christian Gebauer gebauer@kde.org + + +Christian Thurner cthurner@web.de + + +Dirk Mueller mueller@kde.org + + +Mark Mutz mutz@kde.org + + +Roberto Teixeira roberto@kde.org + + +Mathias Waack mathias@atoll-net.de + + + + +Documentation + +Copyright 2000, 2001 Stephan +Johachlucardus@onlinehome.de + + +Copyright 2001, 2002 Thomas Schütz +Thomas.Schuetz@gmx.li + + + + + +Thanks go to the &knode; developers who answered all my stupid +questions with patience. Then Thomas Diehl and Matthias Kiefer who +always were competent contacts regards to translation. Many Thanks to +Malcolm Hunter who checked this english translation. Not to forget +Michael McBride, always there to help me out with +documentation-related and general stuff, and everybody else in the +&kde; Team who contributed to the creation of this document. + +&underFDL; +&underGPL; + + diff --git a/doc/knode/eyes.png b/doc/knode/eyes.png new file mode 100644 index 000000000..f2eefe3a8 Binary files /dev/null and b/doc/knode/eyes.png differ diff --git a/doc/knode/faq.docbook b/doc/knode/faq.docbook new file mode 100644 index 000000000..6f37d8765 --- /dev/null +++ b/doc/knode/faq.docbook @@ -0,0 +1,189 @@ + + +Questions and Answers + + + + +I have installed &kde; 3, but &knode; does not exist in the +K Menu. + + +Does the Internetentry exist? If not, +maybe the kdenetwork package isn't installed (perhaps because your +distribution possibly doesn't do this for you); if the entry is there, +but you do not have a KNode item +in it, you should try to open a &konsole; and run &knode; from +there. Type + + +% knode & + + +If an error message appears that tells you that &knode; could +not be started or found please check whether the file +knode exists in $KDEDIR/bin and that its +permissions are correctly set. + + + + + + +When I start &knode;, a message appears in the task bar but suddenly +disappears without &knode; being started. + + +Try to start &knode; from the &konsole; (see previous question) +and keep attention for the messages displayed there: if they do not +make sense to you mark them with your mouse and copy it to the +clipboard; then, ask for help on one of the &kde; mailing lists or +&kde; news groups. + + + + + +I need an important article, but &knode; doesn't have it any +more; where can I find this article? + + +You can find some extensive usenet archives at +groups.google.com or +AltaVista; they even contain +articles that are several years old. + + + + + +How do I open and read several articles at the same time? + + + Open the article with Open in own +window. + + + + + +My articles do not appear in the newsgroup. + + +When you publish an article it may be some time until your +news server has it; wait several hours before you send the article +again. + + + + + +I want to keep an article; how do I archive it? + + +Choose the article in the article +view and then use +FileSave +to open a file dialog; you can then save the article to a file. Another +possibility is to copy the article to a folder. + + + + + +Some set headers do not appear for several articles in the +article window; am I doing something wrong? + + +This is not unusual because many headers are optional and often +not contained in articles; in this case &knode; does not show those +header lines. + + + + + +Sometimes I see an article which refers to other articles but +&knode; does not show any references; why is that? + + +This happens when somebody posted an article in another news +group and checked the option Followup To; the +article in question is then sent to your news group, but the referring +article is absent. In many cases the poster tells the reason for his +choice to set a followup. + + + + + +When I want to answer an article an error message appears +telling me that the external editor could not be started, but the +editor is correctly set. + + +Have a look whether you entered the place-holder for a filename +after the editor command; if not, enter it. If you want, for example, to +use &kedit; enter kedit +%f +If the %f is absent, your editor cannot be +run. + + + + + +Why can I not receive data from my local news server? + + +If you use &knode; together with with a local news server, you +must make sure that this server is correctly set up and started; for +further details, please consult the documentation of your local news +server. + + +The availability of the local news server can easily be verified with +the telnet program: open a console and type: + + +% telnet localhost nntp + + +Followed by that, the news server should respond with: + + + +Trying 127.0.0.1... +Connected to localhost. +Escape character is '^]'. +200 Leafnode NNTP Daemon, version 1.9.16 running at konqi.org + + + +You can quit the telnet session with: + + +% quit + + +If that does not work there is either no local news server +set up or the server was not started; in this case, please consult the +documentation of your local news server. + + +If you are trying to connect to a news server on the Internet +you need, of course, an open (dial-in) connection and to have set +up &knode; to use your ISP's news server; your +ISP should be able to give you information about +which news servers you can use. + + + + + + + diff --git a/doc/knode/gloss.docbook b/doc/knode/gloss.docbook new file mode 100644 index 000000000..5e04fd0d3 --- /dev/null +++ b/doc/knode/gloss.docbook @@ -0,0 +1,257 @@ + +Glossary + + +A + +Article + +An article in the sense of +newspapers: special articles are, for example, +followups; replies are not articles but +Email. + + + + + +C + + +Canceling + +To delete one of your articles from the newsserver: the newsreader +generates a special control message to tell the server to delete this +article. + + + + +Crossposting + +The posting of an article in several newsgroups; this is very +often disliked, because it disturbs the topic-oriented association of +the newsgroups. + + + + + +E + + +Expire + +Articles can not be held for eternity +because of harddisk limits. Because of this there is usually a program +called expire on most computer +systems; this program deletes all articles which are older than a +configured number of days. &knode; includes this functionality on its +own. + + + + + +F + +FAQ + +FAQ is the acronym for Frequently +Asked Questions. + + + + +Followup + +An article which is written as an answer +to another article. + + + + + +G + +GNKSA + +GNKSA is a kind of seal-of-approval for +newsreaders; you can get more information at http://www.gnksa.org. + + + + + +H + +Header + +The Header of an article contains +information about the sender, the subject, and the newsgroup of the +article. + + + + + + +K + +Killfile + +This is a functionality of a newsreader to hide +articles of a determined sender or +with certain contents. + + + + + +M + +Message-ID + + +The Message-ID of an article is a clear +mark for the newsserver to identify the article. A +Message-ID should not be used twice in the +whole usenet for about 2 years; wrong or double +Message-IDs could cause problems when +forwarding them and could overwrite other articles. + + + + + +N + +Newbie + +Somebody who is new somewhere, in relationship to usenet: +somebody who is new to the newsgroup, or new to usenet in +general. + + + + +Newsgroup + +A kind-of bulletin board in the usenet about a special topic or +a group of topics. This is where you post your +articles. + + + + +Newsreader + +A program for reading and writing news. + + + + +NNTP + + +Network News Transport Protocol; this is the protocol which +defines how the articles in the usenet are spread. + + + + + +P + + +Port + +A kind-of address for the application to listen for data on and +for connecting to another computer; the standard-port for the +connection between the newsreader and the newsserver is 119. + + + + +PGP-Signature + +A digital signature; you can use it to determine whether the document +has been changed since it was signed or if it is the original text from +the author. + + + + +Posting + +Either an article which is sent to usenet or the +act of sending itself; you are posting an +article into a newsgroup. + + + + + +Q + + +Quoting + +This is the act of citing of an article to which you are answering: +you quote the original article to make clear +which passages of text your answer refers to. + + + + + +R + + +Reply + +A reply is an answer to the author of an +article by e-mail. + + + + + +S + + +Scoring + + +This is the valuation of an article or a thread. + + + + +Signature + +A signature is a personal sign of the +author which is attached at the end of the normal contents of the article; +it is like a visiting card — very often there are e-mail addresses, a +homepage URL or other personal data. The +signature should not be longer than 4 lines. Note that +the signature should not be mixed up with the +PGP-signature. + + + + +Supersede + + +This is the overwriting of an existing article: the newsreader +generates a special article with a control message in the header which +tells the newsserver to overwrite the existing article with this +one. + + + + + + diff --git a/doc/knode/greyball.png b/doc/knode/greyball.png new file mode 100644 index 000000000..65335f182 Binary files /dev/null and b/doc/knode/greyball.png differ diff --git a/doc/knode/greyballchk.png b/doc/knode/greyballchk.png new file mode 100644 index 000000000..f5c86586d Binary files /dev/null and b/doc/knode/greyballchk.png differ diff --git a/doc/knode/index.docbook b/doc/knode/index.docbook new file mode 100644 index 000000000..29eeb14ba --- /dev/null +++ b/doc/knode/index.docbook @@ -0,0 +1,130 @@ + + + + + + + + + + + + + + + + +]> + + + + + +The &knode; manual + + + +StephanJohach +
lucardus@onlinehome.de
+ + + + + Thomas Schütz +
Thomas.Schuetz@gmx.li
+ + + + + Christian Gebauer + Developer and maintainer +
gebauer@kde.org
+ + + + Christian Thurner + Developer +
cthurner@web.de
+ + + + Dirk Mueller + Developer +
mueller@kde.org
+ + + + Mark Mutz + Developer +
mutz@kde.org
+ + + + Roberto Teixeira + Developer +
roberto@kde.org
+ + + + Mathias Waack + Developer +
mathias@atoll-net.de
+ + + + + + 2000 2001 2002 +Stephan Johach +Thomas Schütz + + +2002-04-13 +0.07.00 + + + + +&knode; is an easy-to-use newsreader. + + + +KDE +KNode +kdenetwork +newsreader + + + +&introduction; + + + + +Working with &knode; + +&using-firststart; +&using-subscribing; +&using-morefeatures; + + +&commands; + +&faq; + +&journey; + +&more; + +&credits; + +&install; + +&glossary; + +&documentation.index; + \ No newline at end of file diff --git a/doc/knode/install.docbook b/doc/knode/install.docbook new file mode 100644 index 000000000..6a5f11499 --- /dev/null +++ b/doc/knode/install.docbook @@ -0,0 +1,54 @@ + +Installation + + +Where do I get &knode;? + +&install.intro.documentation; + + + + + +Requirements + + +If you want to successfully install &knode;, you need &kde; +3.x; if, in addition, you want to use &knode; as an offline +newsreader, you need a local news server, ⪚ leafnode. + + + +Compile and install + +&knode; is part of the kdenetwork package of &kde; 3.x and is +installed together with it, provided you have chosen to install the +kdenetwork package; so, in general, there is no need for a user +to compile the sources of &knode;. + +&install.compile.documentation; + + + + +Notes about updating an older version of &knode; + +This section contains notes about what to take care of when +installing a newer version of &knode; with an older version already +installed. + + +Changes in configuration files and folders + +Since version 0.2 the format of the configuration files and the +saved articles has changed, so unfortunately, your old configuration +files cannot be imported. + +If you update from a version >= 0.4 the local folders will +automatically be converted into the new format; you will then be +unable to use the data with an older version of &knode; any more. + + + + \ No newline at end of file diff --git a/doc/knode/introduction.docbook b/doc/knode/introduction.docbook new file mode 100644 index 000000000..a86de4663 --- /dev/null +++ b/doc/knode/introduction.docbook @@ -0,0 +1,56 @@ + + + Introduction + + +&knode; is an easy-to-use, convenient newsreader; it is intended +to allow even newbies to use a newsreader under &kde;, but it also +offers advanced features appealing to experienced users. &knode; is a +online-reader but could work together with a newsserver like +leafnode as an offline-reader. + +As of version 0.4 &knode; complies with all the requirements of +the GNKSA. + +If you have problems or questions about this program, please +contact the mailing list for &kde; users (for subscription, seeHomepage of the &kde; mailing +lists ) or one of the &kde; newsgroups: + + +comp.windows.x.kde +de.comp.os.unix.apps.kde (german) + + +If you have found a bug or have suggestions regarding the +functionality of &knode; please report them via the +HelpReport +bug... menu. + +Please make sure when asking questions in the newsgroups and +mailing lists mentioned above that the question you are asking +is not answered in this manual. + +For those new to reading news and posting articles, the +A journey through +Usenet chapter is recommended; it is not so much about &knode; as how to +move about in the Usenet with its help. In general, it is not +sufficient to just master a news reader for writing news +articles: imagine a car driver who masters his car perfectly but does +not know about the traffic rules or signs; do you want to encounter +such a driver when out in traffic? So please take your time to learn +at least a little about the traffic rules of the +Usenet; the other participants will thank you. + + +&knode; supports you in many cases with hints and warnings: if +you do not simply ignore them you will avoid many beginners' +mistakes; but, do not exclusively depend on them either. + + +Please address suggestions and criticisms at the author or at the +responsible translator for your language. + + + diff --git a/doc/knode/journey.docbook b/doc/knode/journey.docbook new file mode 100644 index 000000000..30448513f --- /dev/null +++ b/doc/knode/journey.docbook @@ -0,0 +1,530 @@ + + + +A journey in the World of Newsgroups + + + +This chapter is supposed to be glance over the World of Newsgroups +and their inhabitants; someone who has never dared to go +there before will encounter some strange customs, which may give you a feeling +of being a lonely alien without backup; but stay calm, it is not like +this. The Usenet is a meeting place for all kinds of normal and +not-so-normal folks; it is here where they are distributing a lot of +information but also gossip and other stuff. + + +References to more detailed and qualified essays on the Usenet +can be found at More +Resources + + + +What are ... + + + +... online-readers? + +An online-reader connects to a newsserver and gives you access to +its content. &knode; is an online-reader: you are reading your News +and publishing your own articles while the +online-reader stays connected. + + + + +... offline-readers? + +An offline-reader connects to the Server and fetches only the +headers of new articles; then, the connection is closed and you can +mark (offline) the articles you are really interested in. When you +connect next time the offline-reader fetches the articles you +marked and sends the articles you have written whilst offline. + +There is no connection while you are reading or writing +articles. + + + + +... newsgroups? + +You can look at newsgroups as public bulletin boards and forums, +where everybody is allowed to participate. Articles you have +published in a newsgroup can be read by everybody subscribed to this +newsgroup and, normally, everybody is allowed to publish their articles +in a newsgroup. + + + + +... news? + +News is the collective term for articles published in a newsgroup. + + + + +... threads? + +A thread is a topic of discussion in a +newsgroup. + + + + + +Online Manners + + + +There are lot of different people meeting and talking in +newsgroups; it is seen as some kind of courtesy to obey some rules of +manner, the basics of which are listed here. + + + +Before you ask questions be sure you have read the newsgroup's +FAQ (Frequently Asked Questions) and didn't find +the answer. + + +If you take part in a discussion be aware of the fact that everybody +can read the answer: do not say anything that you would not say to the others +if you were facing them; avoid insults. + + +Try to avoid crossposting: do not ask a question in more than +one newsgroup when you do not know which is the right one. Ask in one +newsgroup; if it is wrong, you will be told which is right one. + + +Formulate your articles accurately; nobody likes to read an +article with lots of typos, even with content worth a Pulitzer. Think +of your articles as letters: your letter speaks for you; it represents +you; somebody reading your article will draw conclusions about you +from it, wrong or right. + + +Remember, nobody sees your grin when you are writing an ironic +sentence: it may be funny for you, but it can be very serious for the +person reading it. It is very difficult to include emotions in an +article. + + +The most important rule: use your common sense when you are +answering or publishing an article. + + + + + + +The Usenet language + + +You will not be surprised about English being the main language on +the Usenet; however, there are special trees for German (de.*), French (fr.*) +and many other languages. If you are unable to determine the main +language of a newsgroup the only possibility is careful listening +or a possible explanation in the description of the group in the +grouplist. + +In addition, over the time the Usenet has developed its own language +but it is easy to learn. + + + +<acronym>RTFM</acronym> and other typos + +When you read news, after some time you will read some strange +combinations of letters; for example, you can get a reply like: + +RTFM + +Nothing else. Strange, but absolutely intended; to solve the +riddle: those, most of the time, are shortcuts, acronyms. It is easier +to drop some letters than to write the same sentence over and over +again. + +But what is the meaning of RTFM? The writer +is asking you to read the manual, documentation or +FAQ before asking questions in the +newsgroup. It stands for: (R)ead (T)he (F)...ing +(M)anual; BTW this is advice you should adopt. + +Wait, what is BTW now? Another often-seen +acronym which means (B)y (T)he (W)ay. It is easy when you know +it; to avoid you having to continuously speculate over the meaning of +acronyms there is table at he end of this section containing the +most-often-used acronyms. + +This table does not try to be complete and is based on a list by +Martin Imlau. + + + +Acronyms on Usenet + + + + +Acronym + +Meaning + + + + + + +<g> + +grins + + + + +AAMOF + + +As a matter of fact + + + + +ACK + + +Acknowledge + + + + +AFAIK + + +As far as I know + + + + +AFAIR + + +As far as I remember + + + + +AWGTHTGTTA + + +Are we going to have to go through this again? + + + + +ASAP + + +As soon as possible + + + + +BFN + + +Bye for now! + + + + +BTW + + +By the way + + + + +BYKT + + +But you knew that + + + + +CMIIW + + +Correct me if I'm wrong + + + + +CU + + +See you! + + + + +CU2 + + +See you too! + + + + +CYL + + +See you later! + + + + +DAU + + +German abbreviation for the silliest user you can imagine (Dümmster +anzunehmender User) + + + + +EOD + + +End of discussion + + + + +ESOSL + + +Endless snorts of stupid laughter + + + + +FYI + + +For your information + + + + +GOK + + +God only knows + + + + +HAND + + +Have a nice day! + + + + +HTH + + +Hope that helps + + + + +HSIK + + +How should I know? + + + + +IAE + + +In any event + + + + +IANAL + + +I am not a lawyer + + + + +IIRC + + +If I remember correctly + + + + +IMCO + + +In my considered opinion + + + + +IMHO + + +In my humble opinion + + + + +IMNSHO + + +In my not so humble opinion + + + + +INPO + + +In no particular order + + + + +IOW + + +In other words + + + + +LMAO + + +Laughing my ass off + + + + +LOL + + +Laughing out loudly + + + + +NAK + + +Not acknowledged + + + + +NBD + + +No big deal + + + + +NFW + + +No f...ing way + + + + +ROTFL + + +Rolling on the floor, laughing + + + + +RTFM + + +Read the f...ing manual + + + + +SCNR + + +Sorry, could not resist + + + + +TIA + + +Thanks in advance + + + +
+ + + +Smile! + +Again, such a strange thing. What is this ;-) meant to be? Turn +your head so the left side of your screen is on top; got it? It's +a smile with a wink? This is a so-called emoticon; emoticons are an +often-used possibility to express emotions, one thing missing in +conversation on the Usenet (but there is a substitute, remember? +;-) + +It is very difficult to express emotions in email or news; your +joking comment appear to be very serious to the recipient and can lead to +unmeant reactions or conflicts (flames); so use emoticons to express +your intention. + +There are a lots of emoticons, which express a great variety of +emotions; the interpretation is easy if you turn your +head and think of a face. + + + + +PLONK! + +This PLONK! looks like some comic-sound, does it not? And that is +exactly what it is used for. The one who reads it knows he was just +added to the killfile of a newsreader; normally this means the +recipient of the PLONK! annoyed the sender. The PLONK! is meant to +play back the sound of the recipients name hitting the ground in the +killfile. + + + + diff --git a/doc/knode/knode-cleanup.png b/doc/knode/knode-cleanup.png new file mode 100644 index 000000000..9b4a1b051 Binary files /dev/null and b/doc/knode/knode-cleanup.png differ diff --git a/doc/knode/knode-colors-fonts.png b/doc/knode/knode-colors-fonts.png new file mode 100644 index 000000000..37934238e Binary files /dev/null and b/doc/knode/knode-colors-fonts.png differ diff --git a/doc/knode/knode-composer-attachments.png b/doc/knode/knode-composer-attachments.png new file mode 100644 index 000000000..dad84a292 Binary files /dev/null and b/doc/knode/knode-composer-attachments.png differ diff --git a/doc/knode/knode-composer-settings.png b/doc/knode/knode-composer-settings.png new file mode 100644 index 000000000..b4b27a030 Binary files /dev/null and b/doc/knode/knode-composer-settings.png differ diff --git a/doc/knode/knode-edit-filter.png b/doc/knode/knode-edit-filter.png new file mode 100644 index 000000000..4c0916892 Binary files /dev/null and b/doc/knode/knode-edit-filter.png differ diff --git a/doc/knode/knode-edit-header1.png b/doc/knode/knode-edit-header1.png new file mode 100644 index 000000000..6b7115050 Binary files /dev/null and b/doc/knode/knode-edit-header1.png differ diff --git a/doc/knode/knode-edit-header2.png b/doc/knode/knode-edit-header2.png new file mode 100644 index 000000000..b59a665a6 Binary files /dev/null and b/doc/knode/knode-edit-header2.png differ diff --git a/doc/knode/knode-filters.png b/doc/knode/knode-filters.png new file mode 100644 index 000000000..de4a20bbe Binary files /dev/null and b/doc/knode/knode-filters.png differ diff --git a/doc/knode/knode-followup.png b/doc/knode/knode-followup.png new file mode 100644 index 000000000..02edf3313 Binary files /dev/null and b/doc/knode/knode-followup.png differ diff --git a/doc/knode/knode-header-settings.png b/doc/knode/knode-header-settings.png new file mode 100644 index 000000000..35ba241bd Binary files /dev/null and b/doc/knode/knode-header-settings.png differ diff --git a/doc/knode/knode-identity.png b/doc/knode/knode-identity.png new file mode 100644 index 000000000..e732f264f Binary files /dev/null and b/doc/knode/knode-identity.png differ diff --git a/doc/knode/knode-mail-account.png b/doc/knode/knode-mail-account.png new file mode 100644 index 000000000..de4458d06 Binary files /dev/null and b/doc/knode/knode-mail-account.png differ diff --git a/doc/knode/knode-new-article.png b/doc/knode/knode-new-article.png new file mode 100644 index 000000000..3fcc44830 Binary files /dev/null and b/doc/knode/knode-new-article.png differ diff --git a/doc/knode/knode-news-account.png b/doc/knode/knode-news-account.png new file mode 100644 index 000000000..e2aa1f66c Binary files /dev/null and b/doc/knode/knode-news-account.png differ diff --git a/doc/knode/knode-post-settings.png b/doc/knode/knode-post-settings.png new file mode 100644 index 000000000..b7301a23d Binary files /dev/null and b/doc/knode/knode-post-settings.png differ diff --git a/doc/knode/knode-read-news-appearance-dialog.png b/doc/knode/knode-read-news-appearance-dialog.png new file mode 100644 index 000000000..8c98f2622 Binary files /dev/null and b/doc/knode/knode-read-news-appearance-dialog.png differ diff --git a/doc/knode/knode-read-news-settings.png b/doc/knode/knode-read-news-settings.png new file mode 100644 index 000000000..610b4bd07 Binary files /dev/null and b/doc/knode/knode-read-news-settings.png differ diff --git a/doc/knode/knode-reply.png b/doc/knode/knode-reply.png new file mode 100644 index 000000000..497007d11 Binary files /dev/null and b/doc/knode/knode-reply.png differ diff --git a/doc/knode/knode-rule-editor.png b/doc/knode/knode-rule-editor.png new file mode 100644 index 000000000..224e4be3c Binary files /dev/null and b/doc/knode/knode-rule-editor.png differ diff --git a/doc/knode/knode-search.png b/doc/knode/knode-search.png new file mode 100644 index 000000000..68b28af16 Binary files /dev/null and b/doc/knode/knode-search.png differ diff --git a/doc/knode/knode-start.png b/doc/knode/knode-start.png new file mode 100644 index 000000000..8d4307fcf Binary files /dev/null and b/doc/knode/knode-start.png differ diff --git a/doc/knode/knode-subscribe.png b/doc/knode/knode-subscribe.png new file mode 100644 index 000000000..4357ae54a Binary files /dev/null and b/doc/knode/knode-subscribe.png differ diff --git a/doc/knode/knode-views.png b/doc/knode/knode-views.png new file mode 100644 index 000000000..5fbae986d Binary files /dev/null and b/doc/knode/knode-views.png differ diff --git a/doc/knode/more.docbook b/doc/knode/more.docbook new file mode 100644 index 000000000..79bab8261 --- /dev/null +++ b/doc/knode/more.docbook @@ -0,0 +1,134 @@ + + + + +Further Information + + + +In this section we will detail some additional information +resources which could be useful to you. Many of the articles listed +below (for which URLs are given) are posted to +news groups regularly; some of those groups are also listed +here. + + +Informative Newsgroups + + + +news.answers +news.newusers.questions +de.newsusers.infos (German) +de.answers (German) +de.comp.os.unix.linux.infos (German) +de.newusers.answers (German) +de.newusers.questions (German) + + +For beginners it is especially recommended to read these +articles at least partially: informed users have strong advantages in +news groups. There are some more-specialized news groups where +FAQs and introductory +articles are posted frequently, ⪚ the +newsgroup de.comp.os.unix.linux.infos (German), +which contains a lot of useful articles about the &Linux; operating system. +Just have a look on the group list of your newsserver for +it. + + + + +Test Groups + + + +The following groups were created especially for testing, +&ie; after successfully configuring &knode; you should post some +articles to those groups to test your settings. + +Some groups support automatic replies through email to enable you to +test whether your entered identity is correct and mail-replies actually +arrive in your mailbox. + +In addition, some scripts are offered which check your articles +for erroneous settings and generate a followup with useful +hints. + + +de.test (German test newsgroup) +misc.test +alt.test +alt.test.ignore + + + + +Informative technical articles in the world wide web + + + +These URLs are from the corresponding article +in the newsgroup +de.newusers.infos and have the same contents as +the articles posted there. + + +Introduction for de.newusers.infos: http://www.kirchwitz.de/~amk/dni/einleitung +(German) +The newsgroups of the de.alt hierarchy: +http://www.kirchwitz.de/~amk/dni/de-alt-newsgruppen +(German) +The newsgroups of the de-hierarchy: http://www.kirchwitz.de/~amk/dni/de-newsgruppen +(German) +First read, then post: http://www.kirchwitz.de/~amk/dni/erst-lesen-dann-schreiben (German) +First steps in the usenet: http://www.kirchwitz.de/~amk/dni/erste-schritte +(German) +Questions and answers from de.newusers.questions: http://www.kirchwitz.de/~amk/dni/faq +(German) +Seven theses about behavior in the internet: http://www.kirchwitz.de/~amk/dni/hoeflichkeit +(German) +Introduction to the usenet: http://www.kirchwitz.de/~amk/dni/usenet-einfuehrung +(German) +Why should I take the rules seriously? http://www.kirchwitz.de/~amk/dni/warum-regel +(German) +The newsreader FAQ: http://www.crosswinds.net/~cgarbers/faq/newsreaderFAQ.htm +The correct quoting: http://www.afaik.de/usenet/faq/zitieren +(German) +The German umlauts FAQ: +http://www.westfalen.de/paefken/de.newusers/umlaute-faq.txt (German) + + + + +Informative technical articles + + +If you are interested in further technical information in +connection to news, you should not miss the following +URLs. + + +Header entries: +http://www.kirchwitz.de/~amk/dni/headerzeilen (German) +A very useful message-ID FAQ: +http://www.qad.org/faq/faq-messageid.html +A lot of links about newsreaders and related topics: http://www.leafnode.org/links +RFCs, Drafts and documents for the technical +interested: +http://www.landfield.com/usefor/ + + + diff --git a/doc/knode/newsubs.png b/doc/knode/newsubs.png new file mode 100644 index 000000000..ca443d01e Binary files /dev/null and b/doc/knode/newsubs.png differ diff --git a/doc/knode/redball.png b/doc/knode/redball.png new file mode 100644 index 000000000..506343729 Binary files /dev/null and b/doc/knode/redball.png differ diff --git a/doc/knode/redballchk.png b/doc/knode/redballchk.png new file mode 100644 index 000000000..d84cec9ac Binary files /dev/null and b/doc/knode/redballchk.png differ diff --git a/doc/knode/using-firststart.docbook b/doc/knode/using-firststart.docbook new file mode 100644 index 000000000..945b26fd2 --- /dev/null +++ b/doc/knode/using-firststart.docbook @@ -0,0 +1,1859 @@ + + +The first start + +You can find &knode; in the K Menu under the +Internet entry: the menu entry +KNode launches the program. + + +If the entry for &knode; can not be found or if &knode; does +not appear after clicking on the menu entry, read Questions and Answers. + + +The main window of &knode; should now be displayed on your +desktop as shown; on the first start, the settings dialog will be +invoked. + + +Setting up &knode; + + + + +&knode; after first start + + +&knode; after first start + + + + +The windows shows the menu bar, the toolbar below and the status +pane at the buttom. The area between the toolbar and the status pane +is occupied by a three-part window. + +There is a folder view, which currently contains only three +entries: + + +The folder Outbox +The folder Drafts +The folder Sent + + +When &knode; is completely and correctly configured, the news +servers and the subscribed news groups will appear there. + +In the upper section is the article view; it is currently empty +and does not show any articles. Directly below the article view is the +article window; the body of the currently-selected article +appears there. These windows are also blank at the moment, as there +are no articles, of course. You should not be concerned, though, as before +reading and publishing news some things have to be configured; this +will be covered by the following section. + +We are now beginning the setting up of &knode;. Most settings +are not important for daily use, but you should know what settings are +possible and what they are for. Some may skip the +Quickstart chapter but those who prefer a quick start +will just glance over the manual anyway. For others, especially those +who have not any or much experience with a news reader, this chapter +offers the chance to fully perform the configuration, although some +things may become clear only later on. + + +Personal settings + + + +Via +SettingsConfigure +KNode... you will enter the preferences +dialog of &knode;. The figure shows the dialog. + + +Dialog for entering personal information + + + + +Entering personal information + + +Entering personal information + + + +The dialog is divided into two parts: in one part there is a treeview, in +which the top entry Identity is already +highlighted; in the other part is the corresponding input +dialog -- these settings relate to the identity with which you navigate +through the newsgroups. + + +If you have already configured your personal settings in the +&kcontrolcenter; before the first start of &knode;, they will be +adopted. + + + +<guilabel>Name</guilabel> + +In the field Name you enter your name, ⪚ +Joe Miller or Mary +Gordon. This name will later appear in the newsgroups as +sender, and can be seen by anyone. + +Filling out the field Name is +mandatory. + + + +In most newsgroups, it is considered polite and appropriate to appear +with one's real name; other newsgroups are less strict about this. But, +there are also cases when one would not want to appear with one's real +name, ⪚ in newsgroups where one would like to (and can) talk about +very personal matters without being exposed; these groups mostly do +tell you in their Charter that the anonymity of their members is +explicitly approved. + + + +For those special cases, &knode; offers settings that can be +adjusted to each newsgroup individually; further information can be +found under Group local +Identities. + + + + +<guilabel>Organization</guilabel> + +The input field Organization is optional +and does not have to be filled out. You can enter, ⪚, the name of +your company or your university if you use &knode; +there; if you leave this field blank, it will often be filled out +later by your Internet service provider. + + + +<guilabel>Email address</guilabel> + +The email address you enter here will be used as sender in news +articles, &ie; as actual address of the author, in conjunction with +the real name (set in the field Name). + +The field Email Address shows up when +someone wants to reply to you by email: the email will be sent to +the address entered here. Many newsreaders display the sender address +together with the name in the Header of the article. + +Filling out the Email Address field is +mandatory. + +Note that the e-mail address will only be used for replies to you if +the field Reply-to Address is not filled out; in +this case, the field Email will be ignored for +replies and the address given under Reply-to +Address will be used. + + + + +<guilabel>Reply-to Address</guilabel> + +Reply-to Address offers you the possibility +to enter a different address than your sender e-mail address: if +someone replies to you by email this address will be displayed as +target address in the reply. An example for using Reply-to +Address would be that you write the article at the office +during the day but want to receive the answer in your home inbox, +because your boss co-reads your mail. + +Only enter an e-mail address in that field if it actually +differs from the field Email Address. + + +Some news readers deliberately set this to an invalid e-mail +address in order to prevent spam mails from being received; what could +happen, though, is that a reader sends an e-mail to this invalid address +which you will therefore never receive. You should drop a note about +this in the signature. + + + + +<guilabel>Mail-Copies-To</guilabel> + +If you enter an email address here every article will be sent +to the usenet and to this email address. + + + +<guilabel>Signing Key</guilabel> + +If you have configured the use of PGP or +GnuPG you can chose your signing key with +Change.... + + + +<guilabel>Use a signature from file</guilabel> + +If this option is selected, the file specified under +Signature File will be used as Signature. + + + +<guilabel>Signature File</guilabel> + +The field Signature File determines the +file, the content of which is appended to each of your articles. The +field is only enabled if the option Use a signature from +file is selected. + +The signature file is a simple text file, which should not +contain more than four lines; it can, for example, contain a reference +to your homepage with the corresponding link, your postal address with +your telephone number (which would then be of course visible to the +whole world with every article) or just a cool quote. The signature is +your brand, so to speak, which will mark all your articles; therefore, +your signature should not be designed sloppily or in the long run annoying +to others: an old joke that one would have to read over and over again +does not foster sympathy or the interest of the other newsgroup +subscribers. + +You can directly enter the file name of the signature file but +it is more convenient to use the button +Choose.... This opens a file open dialog and +you can conveniently choose the signature file with the mouse. The +button Edit File enables you, after choosing +the file, to edit the signature. + + +It is not necessary to include a separation line in the +signature file as &knode; inserts it automatically. + + + + +<guilabel>The file is a program</guilabel> + +If this option is activated, the signature file is not handled +as a text file, but as a program. The signature file will be started +as a program and the output will be used as a signature. Through that +you'll be able to chose a signature by accident or to use fortune to +generate a cool slogan every time. + + + + +<guilabel>Specify signature below</guilabel> + +If this option is selected you can enter the text of the +signature directly in the input field below. + + +Please make sure that in this case also your +signature should not contain more than 4 +lines. A separation line is not necessary as &knode; inserts it +automatically. + + + + +General notes + +You can later adapt the identity individually for each of the +subscribed groups via the Preferences dialog, +⪚ you can specify an English signature for English groups and a +German one for German groups. Apart from the language it is also +possible to have context-sensitive signatures, ⪚ your favorite +recipe in a cooking group or the names of your twelve cats in a cat +owner group. + +You find more in the section Group local identities. + +The next step in the configuration covers the news +account. + + + + + +Configuring the news account + + +Now we must tell &knode; about where we get the news from or +where to send the articles to later on. In the tree view on the +right, there is an Accounts entry; click on it +with the mouse; then, two sub entries will be opened out. Choose the +News entry, because we first want to configure +the news account: the list of accounts is still empty. + +To create a new account click on New.... The +following dialog appears: + + +The New Account dialog + + + + +The New Account dialog + + +The New Account dialog + + + + + +<guilabel>Name</guilabel> + +The Name field can be filled in as you +like; the text you enter will later be visible in the folder view. You +could, for example, enter the name of your Internet Provider; for our example we +enter the name My News Account. + + + + +<guilabel>Server</guilabel> + +The next field is labelled Server. Unlike +the field Name, what you enter here is +important. The name of the news server is fixed and you should be able +to get it from your Internet service provider; if you do not know the name +of the news server, you should get it now: without this information you can +not read any news. If your Internet service provider doesn't own a +news server you can use a public one (universities often provide public news +servers.) + +For our example configuration we enter the name +news.server.com; you will, +of course, enter the real name of your news server. + + +If you want to use &knode; with a local news server, enter the name +localhost here. + + + + +<guilabel>Port</guilabel> + +Port, the next field, has already a default +value. The Port designates, roughly speaking, a data channel on which +the server listens for whether someone wants to retrieve news: it +defaults to the value 119, which is applicable in most +cases; therefore, we do not change this default for our example. + + + +<guilabel>Hold connection for</guilabel> + +The time value you enter here is used if you have +established a connection to the news server and if, for whatever +reason, no data is received from or transmitted to the news +server: after the specified time has elapsed &knode; will automatically +disconnect. This, amongst other things, relieves the server of +unnecessary connections which would otherwise reduce its availability +for other subscribers; it also makes sure that an automatically-established +Internet connection is not held unnecessarily even if no data is +being sent or received. + + +This settings mainly makes sense if one receives and reads +news online; for local news servers it is of almost no importance. If +this waiting time is set too low, there can be waiting periods if you +read a longer article and do not do anything for some +time: &knode; will have canceled the connection to the server by then (after +the time period has elapsed) and has to reestablish it, causing a delay. + If the waiting time is set too high you might waste online +time whilst doing nothing (perhaps increasing your phone bill). + + + +<guilabel>Timeout</guilabel> + +If &knode; connects to the news server it waits no longer than the +time specified here for an answer; if the period is exceeded &knode; cancels +the connection attempt and you will get an error message stating that the +server is not responding. + + +Depending on the quality of your Internet account and the +news server's current load there can be busy periods where +&knode; cancels the connection; if this happens frequently, you should +set this setting to a higher value. + + + + + +<guilabel>Fetch group descriptions</guilabel> + +If this setting is selected, &knode; additionally requests the +available group descriptions; they will be displayed in the +Subscribe to Newsgroups dialog. + + +There is not a group description for every group, so it is not +an error if no group description is shown when subscribing to a group +later on. + + + + + +<guilabel>Server requires authentication</guilabel> + +The option Server requires authentication +needs only to be selected if your news server requires a user name and +a password when retrieving articles; you can find out if this is the case +from your Internet service provider or the server's +maintainer. + + +If you do not know if this setting is necessary forget +about selecting it for now: if you encounter an error later on, you can +try selecting it then. Otherwise, select this option and enter your user name +under User and the associated password +under Password. + + + + +General notes + +By now you have completed the setup of your news account. You can +confirm and save your settings by clicking on the +OK button: as soon as you have done that, +the account will appear in the list by the name that you entered in +Name earlier; and, if you have a close look, you +will see that the account also appears in the folder view. + +Using the Subscribe button you could +get directly to the dialog for subscribing to news groups; but, we +still have more to do so we'll ignore it for now: there are several ways +that lead to the goal. + +In the Managing +multiple news accounts chapter you can learn how to work with multiple +news accounts, but first we will stay with this one; in most cases, +one account is sufficient. + + +Please note that some Internet providers only allow retrieving +news from their news server if you are connected to the Internet +through them. + + +We will now move on to configuring the email account; in order +to do that, click on the Mail entry in the tree +view on the left. + + + + + +Setting up the mail account + +After selecting Mail in the tree view, the +following dialog box appears. + + +Dialog box for setting up the mail account + + + + +Setting up the mail account + + +Setting up the mail account + + + + +You will notice this dialog box is very similar to the news +account settings dialog box; but why do we need an email account in a +newsreader? + +Sometimes you need to answer to the author of an article +directly, without posting to the newsgroup; for example, when you want +to make a very personal comment or want to correct an error. Sometimes +an email is more appropriate than a public remark. + +That's why &knode; provides the possibility to reply by +email; if you want to use this feature you must tell &knode; how to +send emails: you just need to insert the mail server's address. If you have +already configured an email account, ⪚ with &kmail;, you can reuse +the settings used there. + + +<guilabel>Use external mail program</guilabel> + +If this option is active &knode; will use the mail program +which is configured in the control center; the other options in this +dialog will then be disabled. + + + + +<guilabel>Server</guilabel> + +The name (address) of your mail server as provided by your Internet +service +provider or system administrator; all you have to do here is enter the mail +server's +name in the Server field. + +In our example we entermail.server.de + + +If you have one you can send your mail via a local mail +server; if this is the case local mail server enter localhost in the +Server field. + + + + +<guilabel>Port</guilabel> + +Again, the Port field has a default +value; in this case it's port 25. You should not need to change this, +unless your ISP has a very exotic configuration +and tells you to do so. We do not change this for the example. + + + + +Hold connection for + +This value is important: if you have established a connection +with your mail server and there is no data transfer occurring &knode; +cancels the connection to your mailserver after the specified amount +of time has elapsed. + + + + +<guilabel>Timeout</guilabel> + +When &knode; tries to connect to the mail server it will wait this +long for a reply from the server; if this time is exceeded, you will get a +error message. + + +Depending on the quality of your connection and the actual load +of your mail server you might get long reply times; if &knode; cancels +the connection due to this, you should increase the timeout. + + + + +General notes + + +Some ISPs only allow you to send email using +their mail server after you have checked your mailbox for new mail: this +reduces spamming. + +For the same reasons, some ISPs will only allow you +to send mail using their mailservers if you are online with them +or if you are logged in at the mailserver; for example, this is the normal +configuration at GMX and isn't supported by &knode; or &kmail; yet. + + + + + + +Defining the appearance + +With the Appearance dialog you are given +the ability to set the colors, the character code and the font size of +the text in the article window; the picture below shows the +dialog. + + +Setting up the Appearance dialog + + + + +Setting up the Appearance dialog + + +Setting up the Appearance dialog + + + + + +<guilabel>Use custom colors</guilabel> + +If you select this option you can adjust the color settings of +&knode; in the list field below; to change a color setting do a +double-click with the &LMB; on the list entry to open the &kde; +color-selection dialog. + +The color selection can only be configured after the checkbox +has been checked; otherwise, a double-click on the list entries +won't do anything. + + +If the Use custom colors setting is +selected &knode; won't use colors which have been changed later +globally for &kde; but will only use the colors defined here +instead. + + + + +<guilabel>Use custom fonts</guilabel> + +If you select this setting you can adjust the fonts which +&knode; uses for the display in the list field below; to choose a +font do a double-click with the &LMB; on the list entry to open the +&kde; font-selection dialog. + +The font can only be configured after the checkbox has been +checked; otherwise, a double click on the list entries won't do +anything. + + +If the setting Use custom fonts is +selected &knode; won't use later changes to the global font settings +for &kde; but will use the fonts defined here instead. + + + + + + +General News Settings + +Now click on Reading news and then on the +General sub-entry; the figure below shows the dialog +containing the preferences you can configure there. + + +General Preferences dialog + + + + +The General Preferences dialog + + +The General Preferences dialog + + + + +You don't need to change most of these settings, but we will +discuss them step-by-step to give you an overview of the +possibilities of &knode;. + + +<guilabel>Check for new articles +automatically</guilabel> + +If this box is checked &knode; tries to request new articles +from the server when selecting a newsgroup. These settings especially +make sense when you use &knode; together with a local news +server: downloading the messages obviously only works when the server +is reachable; for a server which is only reachable via an Internet +connection, this setting rarely makes sense and should stay +deactivated. + +If your system isn't set up to establish an Internet connection +if necessary, you will get an error message each time you select a +newsgroup. + +If you want to keep control over when a connection to the server +is established, the +GroupGet new +articles menu option is appropriate. + + + + +<guilabel>Maximal number of articles to fetch</guilabel> + +This sets a restriction on the number articles which are requested +from the server while downloading. The value configured here is for +each newsgroup separately. If this is set, for instance, to 300 only +the 300 newest articles of the newsgroup are requested; other articles will +be discarded. + + +For newsgroups with relatively high traffic you might lose +articles if this value is too low; this especially occurs when you've +just subscribed to a newsgroup or only occasionally download articles +and the traffic for this reason rises above the value specified +here. + + + + +<guilabel>Mark article as read after</guilabel> + +Articles you have opened in the article window are marked as +read after the number of seconds specified here. If you set this value +to be relatively high you avoid articles you have just glanced at +being marked as read; on the other hand, it can be annoying for +relatively short articles, for which you need less time to read than +specified: if you browsed too quickly through the articles +they would stay unread even though you have read them. Therefore, you +should adjust this value to your personal preferences. + + + + +<guilabel>Mark crossposted articles as read</guilabel> + +Sometimes an article will be posted to +more than one group; this is known as crossposting. If you activate this +option, those crossposted articles will be marked as read in all the +newsgroups to which they were posted if you read it in one newsgroup. + + + + +<guilabel>Smart scrolling</guilabel> + +If this option is selected the lines in the article list are +scrolled smoothly instead of jerkily. + + + + + +<guilabel>Show whole thread on expanding</guilabel> + +This setting lets a discussion be displayed completely (over +multiple answer levels) if you click on the plus in front of the +discussion; if this setting isn't checked, only the immediate answers +to the current article are displayed. + + + + +<guilabel>Default to expanded threads</guilabel> + +Here you can toggle whether the threads are expanded by default or +not. + + + + +<guilabel>Show article score</guilabel> + +Here you can toggle whether the scoring column should be shown +in the article view. + + + + +<guilabel>Show line count</guilabel> + +Here you can toggle whether the column with the number of lines +should be shown in the article view. + + + + +<guilabel>Cache size for headers</guilabel> + +Here you can configure how much memory &knode; should use for +the caching of the headers. + + + + +<guilabel>Cache size for articles</guilabel> + +Here you can configure, how much memory &knode; should use for +the caching of the articles. + + + + + +<guilabel>Navigation</guilabel> + +Here you can change some navigation properties of &knode;. +Normally everything here is switched off, but if you don't like this +kind of navigation you can change it. + + +<guilabel>General</guilabel> + +The keyboard behavior between &knode; and &kmail; is a bit +different; with the Emulate the keyboard behavior of +KMail switch you can activate the same keyboard behavior +as in &kmail; for &knode;. + + + + +<guilabel>Mark All as Read</guilabel> + +If the box Switch to next group is checked, +&knode; automatically switches to the next group if you mark all +articles as read. + + + +<guilabel>Mark Thread as Read</guilabel> + +If Close the current thread is +checked, &knode; automatically closes a thread if you mark +it as read. + +If Go to next unread thread is +checked, &knode; automatically shows the next thread if you mark the +the previous thread as read. + + + + +<guilabel>Ignore Thread</guilabel> + +If Close the current threadis +checked, &knode; automatically closes a thread if you choose to +ignore it. + +If Go to next unread thread is +checked, &knode; automatically shows the next thread if you choose +to ignore the previous one. + + + + + +Scoring rules + +To sort the articles you have the possibility to score them. The +standard score is 0: a higher score means that the +article is interesting; a lower score means +it is less interesting. + +In the middle of the window you see a big, white area; here you +can see your scoring rules. Scoring rules are used by &knode; to score +the incoming articles automatically; if, for example, a person always +posts nonsense you can automatically score the articles of that person +down and hide them. + +With the buttons below the list of scoring-rules you can +edit, add, +remove and copy a +rule. We will skip this feature for now, because it is not essential +for the setup of &knode;. + +You can learn more about scoring; in the chapter Scoring, watching and +ignoring. + + +<guilabel>Default score for ignored threads</guilabel> + +Normally you only need the functions ignore and watch; this +simply shows if a thread is interesting or not. Here you can configure +a default score for the ignored threads; choosing the +ScoringIgnore +Thread menu item will give this score to all the +posts in that thread, and will apply that score also to future posts +that follow up the thread. + + + + +<guilabel>Default score for watched threads</guilabel> + +If an article is interesting, it will get a score above 0. Here +you can enter the default score for those articles; choosing the +ScoringWatch +Thread menu item will give this score to all the +posts in that thread, and will apply that score also to future posts +that follow up the thread. + + +You can use the W key to watch a thread or the +I key to ignore it. + + + + + +Filter settings + +This screenshot shows the filter settings. + + +The filter settings + + + + +The filter settings + + +The filter settings + + + + +This dialog shows two lists. The upper list, labeled +Filters, shows all defined filters; when you use &knode; +for the first time, you will only see the predefined filters. + +With the buttons Add, +Delete, Edit and +Copy you can add new filters or delete filters +which are no longer needed; we will skip this feature for now, because +it is not essential for the setup of &knode;. + +You can find more-detailed information about filters in Defining and using filters. + +The lower list, labeled Menu, shows the +appearance of the View +Filter menu, which you can reach from +the menu bar; the order of the filters in the this menu can be +configured in this list. + +The Up button shifts the selected filter +one position up. Try it: select the second filter and press +Up; this entry will then go up one position. + +The Down button does the opposite +action: select the filter you just shifted one up and +pressDown until it reaches its old +position. + +With the two buttons Add Separator and +Remove Separator you can visually group +the filters on the menu. The separators are shown as ==== +in the list; in the Menu they show up as some more-appealing +horizontal lines. Try adding separator; then, select the +separator and remove it by pressing Remove +separator. + +Any changes you make here, you can see in +ViewFilter +after closing this dialog. + + + + +<guilabel>Customize displayed article headers</guilabel> + + + +In this dialog you can set how the single header lines are +displayed in the article window. + + +The Customize displayed article +headers dialog + + + + +The Customize displayed article +headers dialog + + +The Customize displayed article +headers dialog + + + + +This list shows all the header lines which are to be +display in the article window. The identifiers at the left will be +displayed alongside the header lines in < > to their right; +the header lines are taken from each message, ⪚ for +From the From header line will be used (indicating +who send the message). + +Using Edit you can alter the shown +identifiers, alter the header line shown by each identifier and +change the font settings of the text used. To make things clearer, +we'll now simply select the +From:<From> entry in the list and open the dialog +for editing the header display by clicking on +Edit. + + +The Header Properties dialog + + + + +The Header Properties dialog + + +The Header Properties dialog + + + + + +<guilabel>Header</guilabel> + +The Header selection box shows the entry +From: that is the name of the header line for the +sender, as present in the article and evaluated by the +newsreader. If you drop down the selection box &knode; shows a range +of other identifiers, which stand all for a certain header lines in the +article: for now, we'll leave the From identifier +configured; we'll work with this list later, when we add a header line +to the display. + + + +<guilabel>Displayed Name</guilabel> + +This field holds the name you'd like to be later shown in the article +window as a label alongside the actual header +line text; for example, for the From header line the +label From is used. If you leave this field blank, only the +content of the header line appears in the article window; this is, for +example, the default setting for the Subject +header line. We won't change anything here either, for now. + + + + +<guilabel>Name</guilabel> + +Here you can influence the way the 'Displayed Name' +text is displayed; in our case, the Bold attribute +is selected for the name From, &ie; the text will +be shown in bold letters in the article window. Of course, you can +combine different attributes, for example Bold +and Underlined. + + + + +Value + +Here you can influence the way the header text is displayed +in the article window; for example, if the +Italic entry is selected the sender, ⪚ John Doe +<johndoe@doubleguns.com> will appears in an italic +font. + + + + +Add and remove header lines to the display + +To explain the possibilities of this dialog to you we're going +to add a new header line to the display. + + +Show the newsreader used for a post in the article window + +This pictures shows the dialog with the header line +X-Newsreader. + +The Header Properties dialog + + + + +The Header Properties dialog + + +The Header Properties dialog + + + + +It would be nice if one could see which newsreader another +subscriber uses in the article window; it is actually quite easy +to do this because there is a (optional) header line which contains +the necessary information. + +Drop down the Header selection field and +select the X-Newsreader entry from the +list. + +In the Displayed name field, enter +Newsreader. + +Now you can select any attribute for the display of the field +and its content; next, acknowledge your input with the +OK: the new header line appears now in the list +and will later be shown in the article window. + + + +Use the up and +Down buttons to arrange the order of the +headers in the article window. + + +The statement that the new header line will be shown in the +article window is actually pretty optimistic, because the entry +X-Newsreader isn't required for Usenet articles; therefore, not all +articles will contain that header line: if the line doesn't exist, the +according entry simply won't be shown. You can get more information +about headers at http://www.kirchwitz.de/~amk +/dni/headerzeilen +(german) + + + + + +<guilabel>Viewer</guilabel> + + +<guilabel>Show fancy header decorations</guilabel> + +If this is active, the headers will be 'beautified' a +bit; otherwise, only the plain text is shown. + + + + +<guilabel>Rewrap text when necessary</guilabel> + +If this option is active, the text wrapping in the viewer will +be automatically corrected. + + + + +<guilabel>Remove trailing empty lines</guilabel> + +If this is active empty lines at the end of the article will +be automatically hidden. + + + + +<guilabel>Show signature</guilabel> + +If this setting is activated, the +signature of the sender is displayed in the +article window; if it isn't, the signature is surpressed. + + +Please notice that &knode; can display the signature +correctly only if it can be separated correctly from the article +content in the current article: there are newsreaders which do this +separation incorrectly. Two - characters followed by a +  (space) is correct. + + + +Many participants in the newsgroups give hints on their homepage +or say that they have intentionally erroneously specified their Email addresses +in the header fields: if you disable displaying the signature, you might +lose this information; on the other hand, you might save yourself +from reading strange quotes. + + + + +<guilabel>Interpret text-format tags</guilabel> + +If this is active, all text format tags in the message like +*bold*, /italic/ and +_underline_ are shown directly in the viewer. These +text-format tags are an unofficial standard. + + + + +<guilabel>Recognize quote characters</guilabel> + +To display the quoted text in another size or color, &knode; +needs to recognize that it's quoted text. Quoted text is normally +marked with a > at the beginning of the line, but +sometimes there are other characters. In this field you can enter all +characters that should mark quoted text. + + + + +<guilabel>Show attachments inline if +possible</guilabel> + +If this setting is marked, &knode; tries to display the contents +of possible attachment directly in the window when opening an +article; for instance, a picture would be displayed directly below the +article text. + +Additionally, you have the possibility to save the attachment or +open it with the application you have associated with the +MIME type of the attachment by using the context +menu. + + + + +<guilabel>Open attachments on click</guilabel> + +If this box is checked, attachments are opened with the external +program which is configured for the MIME type; if +there is no such association, a dialog for saving a file is opened and +you can save the attachment to a separate file. + + + + +<guilabel>Show alternative contents as +attachments</guilabel> + +Articles which are sent as Multipart MIME +contain the text of the message in multiple formats, for example as +raw text and HTML; the newsreader decides which +part of the article is displayed. This setting makes it possible for +the other formats to be opened as if they were attachments with a +mouse click. + +If this setting is disabled, alternative contents are not +displayed. + + + + +<guilabel>Open links with</guilabel> + +Here you can select which browser is used for displaying links +you clicked on in a message. Currently, you can either select the +Netscape Navigator or the default, +&konqueror;; the selected browser has to be installed, of +course. + + + + + +Settings for publishing articles + +When you post articles with &knode; the settings in the +following dialog box are used. + + +The Technical Settings dialog + + + + +The Technical Settings dialog + + +The Technical Settings dialog + + + + + +If you choose the wrong settings here your articles could be +unreadable or not sendable at all, so please be careful with these +settings. + + + +<guilabel>Charset</guilabel> + +Here you can choose the charset used for encoding your +articles. Normally this is US-ASCII for English +speaking countries, but your charset may differ. The default is the +charset used in your global &kde; settings, so you should not have to +change this. + +When you want to post articles in newsgroups with other charsets +(⪚ eastern European or Asian) you can set the required charset +here. + + + + +<guilabel>Encoding</guilabel> + +Here you set the encoding of the characters for the message +transfer; you can choose between 8-bit and 7-bit +(quoted-printable). + +If you choose 8-bit encoding most special characters are +transfered correctly; this is, for example, the normal option for the +German groups (de.*). + +If you choose quoted-printable 8-bit characters (⪚ German +umlauts or special characters) are send as encoded 7-bit +characters. + + +In the English newsgroups 7-bit encoding is quite +normal. + + + + + +<guilabel>Use own default charset when +replying</guilabel> + +If this option is active, &knode; uses your default charset for +replying instead of the charset of the article you're answering +on. + + + + +<guilabel>Generate Message-ID</guilabel> + +When this is active, &knode; generates its own Message-IDs for +all articles you post. + + +The Message-ID must be unique worldwide: there would +otherwise be collisions between messages with the same Message-ID and the +news server would reject the second article because it thinks +this article has already been received. + +A Message-ID consists of a valid FQDN (Full +Qualified Domain Name); this means it looks similar to an email +address with an identification before the @ and the +domain. + +The identification is generated by &knode; automatically, but +you must provide a valid domain name in Hostname; +if you do not have your own domain, you should not activate this +option — let the newsserver generate a Message-ID for you. + + +Message-ID + +An example for a valid domain would be: +kde.org; a Message-ID generated with this domain +would look like: + +934lek9934@kde.org + + +An unique identification is only guaranteed if you have your +own domain. Even when you do not use &knode; for generating your +Message-IDs there may be collisions when you are using a local +newsserver; for example, leafnode generates +a Message-ID which it derives from the local hostname. + + + + +You can get more information about this and how to own a free domain at +http://www.qad.org/faq/faq- +messageid.html. + + + + +<guilabel>Hostname</guilabel> + +Here you enter the Hostname of your computer; this is used to +generate the Message-ID. If you do not have your own domain you +should not activate this option — let the newsserver generate a +Message-ID for you. Using the example above this would be: +kde.org. + + + + +<guilabel>X-Headers</guilabel> + +Here you can enter X-Headers which are not provided by &knode;; +for example, X-No-Archive: yes, which can be +used to prevent your articles from being archived by archive services +such as Google. + +X-Headers are experimental headers, which are not included in the +standard for Internet-Messages; they are, for example, used for +extended information transfer. To prevent collisions with later +standard headers, they have a X- prefix. + + + + +<guilabel>Don't add the "User-Agent" identification +header</guilabel> + +When this option is checked &knode; does not include the +corresponding line in the Header before posting. + +This header is used for identification of the newsreader the +article was written in; apart from statistical reasons, this allows +non-standard newsreaders to be identified. You should not activate this +option — &knode; has no need to hide. + + + + +The Composer Settings + + +The Composer Settings dialog + + + + +The Composer Settings dialog + + +The Composer Settings dialog + + + + + +<guilabel>Word-wrap at column</guilabel> + +Here you can set the column number at which &knode; wraps the +line; also, you can deactivate the automatic word-wrapping +completely. + + +It is recommended to use no more than 76 characters even if +you are able to display more: many Usenet users use text-based +newsreaders which can not display more than 80 characters and it is +difficult to read your articles in such a newsreader if you increase +this value — this would reduce the probability of your articles +being read at all. + + + + +<guilabel>Append signature automatically</guilabel> + +When you write a new article or a +followup, your signature +is appended automatically if you have configured one in +SettingsConfigure +KNode...Identity. + + + + +<guilabel>Introduction Phrase:</guilabel> + +When you write a followup, &knode; inserts an introduction +phrase before the quoted original text. You can put arbitrary text +here; you can also use the variables which &knode; extracts from the original +article, ⪚ the name of the author or the date the article was +written. + +The following variable are available: + + + +%NAME + +The name of the original author; + + + +%DATE + +The date on which the original article was written; + + + +%EMAIL + +The original author's email address; + + + +%MSID + +The Message-ID of the original article; + + + +%GROUP + +The name of the newsgroupthe article +comes from. + + + + + +Keep this short, because this introductory line appears in +every followup: a long introductory line can be as repelling as +a long signature. + + + +An example introductory line + +On %DATE %NAME wrote in +%MSID + +Let us assume the original article was written by Konqui on +Saturday the 17th of June at 17:42:32 - 0500. The article has the +Message-ID <8igdg5.3vvijgt.3@lizard.physos.com>. &knode; will +then insert the following introductionary line. + +On Sat, 17 Jun 2000 17:42:32 +0200 Konqui wrote in +<8igdg5.3vvijgt.3@lizard.physos.com>: + + + + + +<guilabel>Rewrap quoted text automatically</guilabel> + +When this is checked, the quoted text is wrapped at the correct +border value; hence, every new line will be at the correct quoting +level. + + + + +<guilabel>Include the author's signature</guilabel> + +When this is activated not only the text of the original +message, but also the signature of the author, is quoted in a +reply. + + +Quoting a signature is unnecessary and is often considered +impolite. + + + + +<guilabel>Put the cursor below the introduction +phrase</guilabel> + +Normally the cursor will appear below the whole message when +answering; with this option turned on the cursor appears below the +introduction phrase. + + +This is especially helpful if you quote an article and wish to +write between the quoted lines from top to bottom. + + + + +<guilabel>Define external editor</guilabel> + +You can define an external editor here which is opened by +selecting ToolsStart +external editor in the Composer +window. + +When Start external editor automatically is +checked the external editor is opened directly. + + +Notice the %f after the name of the +editor: this is a variable for the filename of the article you want to +edit; do not delete this — you will get an error message when opening +the external editor if you do. + + + +If you have problems with starting your external editor, the +reason may be that the editor starting in "the background"; this is called +forking: &knode; only notices the sub-process started and has finished, and +thinks you have quit the editor. The editor +gvim is an example for this; you can +disable the forking of gvim with the +commandline switch . It is recommended that you refer to +the documentation of your editor you are experiencing this problem. + +If you want to use gvim in +Specify Editor enter the following: + + + +gvim -f %f + + + + + +<guilabel>Start external editor +automatically</guilabel> + +If this option is active the external editor will be used for +editing articles. + + + + + +<guilabel>Spelling</guilabel> + +Here you can configure the behavior of the spell +checker. + + +<guilabel>Create root/affix not in +dictionary</guilabel> + +If this is checked a known word-root with an unknown affix will +be automatically accepted as a new word. + + + + +<guilabel>Consider run-together words as spelling +errors</guilabel> + +Here you can toggle if two known words that run together to form an +unknown word should be treated as an error or +not.) + + + + +<guilabel>Dictionary</guilabel> + +Here you chose the dictionary the spell-checker should +use. + + + + +<guilabel>Encoding</guilabel> + +Here you can tell &knode; which encoding should be used for +spell checking; for English text this should normally be +US-ASCII. + + + + +<guilabel>Client</guilabel> + +Here you can switch between the spell-checkers; you can use +International Ispell or +Aspell. + + + + + + +<guilabel>Signing and verifying</guilabel> + +Here you can configure &knode; for signing articles with +GnuPG or +PGP. Your +GnuPG/PGP +ID will be built automatically from your configured +name and email address; it is identical to the from line in the +header of the article. + + +<guilabel>Encryption tool</guilabel> + +Here you can choose your encryption tool. + + + + +<guilabel>Keep passphrase in memory</guilabel> + +If this option is active you only need to type the passphrase +for your private key once; &knode; will remember your passphrase until +you close &knode; again. + + + + +<guilabel>Show ciphered/signed text after +composing</guilabel> + +If this option is activated &knode; will show the signed message in +an extra window for confirmation before changing it in the +editor. + + + + +Always show the encryption keys for approval + +If you are using public newsgroups (on Usenet) you can safely +ignore this option as it would not be useful to encrypt messages sent +to Usenet; this option may, however, be useful in private +newsgroups on private networks where encryption is desired. + + + + + + +<guilabel>Check signatures automatically</guilabel> + +If this is marked, the PGP signature +of the article is automatically checked when showing the article; if +there's no mark, you can check the signature for correctness manually +with the ViewVerify +PGP-Signature menu entry. + + + + + + + +The article-cleanup settings. + +The dialog below shows the settings for the article +cleanup; these settings are used to keep the number of articles on +your local harddisk to a reasonable number. &knode; administrates the +articles in memory so there can be some decrease in speed if you +have to many articles lying around; most of the time it makes no sense +to keep articles for a very long time. Services like Google and +Altavista make archiving unnecessary. + + +&knode; isn't an offline reader, so all of the +configuration refers to the headers which are managed by &knode;; if +you are running a local news server, such as +leafnode, you should refer to its +documentation to handle expiring the articles on the server — +&knode; cannot do this for you. + + + +The cleanup settings + + + + +The cleanup settings + + +The cleanup settings + + + + + +<guilabel>Expire old articles automatically</guilabel> + +When this option is active all subscribed groups are checked for +old articles in the time interval set here; the old articles will +then be deleted. + + + +You can force this check by selecting +GroupExpire +group + + + + +<guilabel>Purge groups every</guilabel> + +Here you can configure how often subscribed groups should be +checked for old articles and how often those +articles should be deleted; this option only has an effect when +Expire old articles automatically is +selected. + + + + +<guilabel>Keep read articles</guilabel> + +Read articles are deleted by the next cleanup if they are older +than this value; &knode; uses the creation date for this. + + + + +<guilabel>Keep unread articles</guilabel> + +Unread articles are deleted by the next cleanup if they are +older than this value; &knode; uses the creation date for this. + + + + +<guilabel>Remove articles that are not available on the +server</guilabel> + +It may happen that you'll see a header in +&knode; but the article is not available on the server; if this option +is set, those articles will automatically deleted in &knode;. + + + + +<guilabel>Preserve threads</guilabel> + +This selection forces a thread to be deleted only if all +articles contained in it fulfil the delete conditions; this means that a thread +will not be deleted until the last article in the thread should be +deleted. + +This prevents old articles in a long thread from vanishing before +the discussion has ended. + + +&knode; can not predict whether there will be a reply after the set +conditions are fulfilled; you will have to find your own settings for +this. Some newsgroups have days between replies; others only hours. Use +your own judgement. + + + + +<guilabel>Compact folders automatically</guilabel> + +This option refers to the memory behavior of &knode;. If an +article in a folder is deleted it will be +marked as deleted but still take up space on your hard disk; with +this option you can tell &knode; to actually delete the articles and +free the hard-disk space regularly. + + +You can force this check by selecting +FolderCompact +folder or for all folders together with +FolderCompact all +folders. + + + + +<guilabel>Purge folders every</guilabel> + +Here you can configure how often the folder is checked for +deleted articles; this option only has an effect if the +Compact folders automatically is set. + + + + diff --git a/doc/knode/using-morefeatures.docbook b/doc/knode/using-morefeatures.docbook new file mode 100644 index 000000000..39892bf60 --- /dev/null +++ b/doc/knode/using-morefeatures.docbook @@ -0,0 +1,855 @@ + +The Advanced &knode; Features + + +Defining and Using Filters + +You may already have read about using filters in the chapter explaining +the configuration of &knode;; there, we were talking about the built-in +filters provided by &knode; there. You can configure the built-in +filters like all the others. The screenshot below shows the dialog box for +configuring the filters. + +While filters and scoring are very powerful and have many +uses, one of the most common requirements is simply to add all posts +written by someone you don't wish to read to a +killfile. At the end of this +section is a quick guide to using filters and scores to create +such a killfile. + + +The New Filter dialog + + + + +The New Filter dialog + + +The New Filter dialog + + + + +First we will create a new filter. You may, at some point, want +to find your own articles amongst all the others; or, you may not +want to see the articles posted by a particular person at all: both cases can +be solved by a simple filter on the Sender. Here are some +examples: + + +Do Not Show The Articles by a Particular Person + +SettingsConfigure +KNode...Reading +NewsFilters + + +Select New... + + +Insert Do not show idiot in the Text Box +Name + + +To make the filter appear on the menu, check Show +in menu. + + +Go to the From area. + + +Choose Does NOT contain from the drop-down +box. + + +Insert the name of the person you want to ignore in the now- +active Text Box; for example, Idiot. + + +Confirm the filter settings with +OK. + + + +The filter now shows all articles, except the ones containing +Idiot in the From: line. + +You can combine the settings of the 'Subject + From' tab +with the settings on the other tabs. For example: + + +Show only discussion with unread follow-ups on own +articles. + +SettingsConfigure +KNode...Reading +NewsFilters + + +Select the predefined filter threads with own +articles + + +Select Copy + + +Insert My threads with unread in the +Name field. + + +Select the Status tab + + +Select has new followups + + +Select true in the drop-down box next to +it. + + +Confirm the filter settings with +OK +This filter shows all the threads your are participating in which +have unread messages; also, you have seen the possibility of using +existing filters as a base for new ones: this makes life easier for +complex filters. + + + + +Show all articles, no older than 3 days, containing KNode in +the subject. + +SettingsConfigure +KNode...Reading +NewsFilters + + +Select Add + + +Insert Latest KNode threads in the +Name field. + + +To make the filter appear in the menu, check show +in menu. + + +From the apply on drop-down box select +single articles + + +Go to the Subject area and select +does contain in the drop-down box. + + +Insert knode in the text box. + + +Change to the Additional tab + + +Select the Age check box + + +Enter the following settings: 0 < days <= +3 + + +Confirm the filter settings with +OK +This filter, now, shows all articles, no older than 3 days, +containing knode in the subject. + + + + +Creating a Killfile + +&knode; offers viewing filters (all, +unread only, my posts, +&etc;) and scoring filters (threads and articles start with a score of +zero and can be adjusted according to author, thread, &etc;). + +Using viewing filters you could hide articles according to +poster, but this is not really suitable when you want to kill several +posters universally. + +Using the scoring gives lots of control but filters +only at the thread level, i.e. you can watch and ignore threads; the +disadvantage of this, however, is that you may lose otherwise-useful +threads just because of one poster. + +The solution is to use these in combination. + + +Creating a Killfile + +Go to +SettingsConfigure +KNodeReading +NewsFilters. + + + +Create a new filter below unread, called +killfile on. Be sure that Apply to single +articles is set and then click on the +Additional tab. Set score equal to or less than +zero (<=); then click the +OK until you have exited the dialog. + + + +Open an article whose author should be killed and just type +&Ctrl;L(or +select, from the Scoring menu, Lower Score +for Author). This opens the Rule Editor (a part of +scoring). You can optionally give the rule a name that matches the +author (Kook, for example.) and then, if this is +to be permanent, uncheck the expire automatically +box; you'll see that this rule will change the author's score to minus +ten (or the score you entered); finally, click OK. + + + +Go to the menu item +ViewFilterkillfile on. + + + + +This will cause any articles with scores less than zero will +disappear; to kill additional authors you only need repeat the +&Ctrl;L part of +these instructions. + + + + + + +The Composer + + +The &knode; composer provides many features, especially for +posting and replying to articles. + + +Publish Articles in Multiple Newsgroups + +By selecting the Button Browse you can +choose additional newsgroups you want to publish your article +in. + + +It is generally undesirable to post articles in multiple +newsgroups: please think twice about it; if you are not sure where to +post your article ask in one of the possible groups — somebody will +tell you were to post. + + + + +Redirect Followups + +The main use of this feature is when a thread has gone +off topic for the newsgroup in which it is posted; for example, a thread may +start in a &kde; newsgroup discussing how to redirect a followup in &knode;, +but may leads to a dicussion about graphical and text based +newsreaders. + +Sometimes it happens that usenet users post an article into the +wrong newsgroup; very often those articles are just ignored. If it +looks like the author did this unintentionally, you might like to tell +them politely and make the followup articles go into the right +group. + +Another reason for using Followup-To: is a +when dealing with articles cross-posted across in multiple newsgroups: +you should take care that the replies are only posted in one single newsgroup. + +You can activate this by filling the text box +Followups - To:; here you can enter the suitable +group. If there are multiple newsgroups in the +Groups: field, they are shown in the drop-down +list. + + +If you enter poster here, instead of a +newsgroup, the replies will go directly to the author, not to the +newsgroup. + +Some people put an email address here, but this is not a valid +entry: use poster and correctly set your +Reply-To address in the normal &knode; settings. + + + + + + +Working With an External Editor + +Using ToolsStart +External Editor you can start an editor of +your choice for editing the reply; this way you can use your preferred +Editor for writing articles and e-mails. + + + + +Spelling + +By selecting +ToolsSpelling, +you can check the article in the composer for spelling errors. + + + + +Sending Attachments + +By selecting +AttachAttach +File you can open the File Selection Dialog +Box; here you can choose the file you want to attach. + +Most of the time, &knode; determines the correct +MIME type for the attachment; if &knode; detects +it incorrectly, you can correct the MIME type manually. + +This screenshot shows the Composer with 2 attachments: a text +file and a PNG picture. + + +Sending Attachments + + + + +Sending Attachments + + +Sending Attachments + + + + + +Only do this if you know what you're doing! An incorrect +MIME type could cause the attachment to be sent +incorrectly, or mean that the attachment will not be able to be +rebuilt after sending. + + + +The English word attachment is used all over the world; you can +use it in your language, too. + + + +In most newsgroups, attachments are prohibited: do not send +unsolicited attachments; if you are asked to send them, look who is +asking for them — normally, the person will want you to send them by +email. + +The news server will probably reject articles with attachments +for most groups anyway; those that do accept attachments +normally have the word binaries in their name. Some +news servers even stop carrying non-binaries newsgroups that +continuously receive attachments. + + + + + +Searching for Articles + +Sooner or later, you will want to search for one specific +article; the &knode; search feature is an easy way to do this. + +You can reach the search function by selecting +EditSearch +Articles... or the by pressing +F4. The screenshot below shows the Search Dialog Box. + + +The Search Dialog Box + + + + +The Search Dialog Box + + +The Search Dialog Box + + + + +The Search Dialog Box has four tabs which allow several search +criteria: the first tab contains the settings for the +Subject and From criteria; the second +tab contains the settings for the message-IDs of +an article and its references; the third tab contains the settings for +the Status of an +article; the fourth tab, Additional, contains the remaining +criteria. + +You have probably already noticed the similarities between the Filter +Dialog Box and the Search Dialog Box: the usage is the same and should +not be too complicated if you have already defined your own +filters. + +&knode; always searches in the currently-active newsgroup; a +search in all newsgroups is not possible at the moment. After the +Search has finished the articles found appear in the article view; when +you close the Search Dialog Box using Close +the search results are deleted, and the old view of the newsgroup +appears again. + + +<guilabel>Start Search</guilabel> + +With this button you start the Search with the search criteria +you defined; all articles in the selected newsgroup, fulfiling these +criteria, appear in the article view. + + + + +<guilabel>New Search</guilabel> + +This button resets all search criteria. + + + + + +Supersede and Cancel Articles + +This chapter deals with superseding and canceling articles. You +will not use these two features very often, but they do exist should +you, one day, need them. + + +Both functions need a news server prepared to handle +them; you should also remember that there is no guarantee that no one has +already read your article before it is superseded or canceled. + + +So first think, then post. + + + +Cancel + +Canceling an article means deleting it from the +newsgroup. + +Why should you want to cancel an article? Perhaps you +flamed somebody in a rage and now you want to get this article out of +the newsgroup because you regret what you wrote: a personal insult, +read by everybody, doesn't look good, especially when you regret +it; so, there is only one thing you can do — cancel the article. + +Select the article you want to cancel and choose +Cancel article from its context menu. If +you are sure it is the right article, confirm &knode;s question with +Yes. Now you will be asked if you want to send the +Cancel message now or later; for this example we decide to send it +Later. You will notice the new message in the +folder Outbox. + +Now we want to look at the so-called cancel message. In the +subject you will find something like: + + +cancel of <n177m8.1m.ln@konqui.org> + + +This strange letters between the brackets are the Message-ID of +the article you want to cancel. This message tells the newsserver to +delete your article: if you look at complete header of this message, +by selecting ViewShow all +headers, you will notice a line with the +name control and the content cancel +<xxxxx@ddddd.dd> — this line tells the server that +this message is a control message and, in our case, tells the server to +cancel your article. + +You can still delete the control message from the +Outbox should you change your mind. + + +Keep in mind that articles can only be identified by their +Message-IDs; you need this Message-ID if you want to cancel an +article. Normally, your article gets a Message-ID when it arrives at +the newsserver — that's why you can only cancel an article once +it has been published. The articles in the +Sent folder have no Message-ID, so you cannot cancel +them from there. + +There is one exception: if you have configured &knode; to +generate a Message-ID you can cancel you articles in folder +Sent too. + +&knode; allows only to cancel your own articles: it refuses to +cancel articles from other authors. + + + +Since the cancel feature is so easily fooled, by newsreaders +that let you cancel any post, many news servers do not acknowledge +cancel messages from posters; even if your own ISP +accepts the cancel and passes it on, many other servers will ignore it +and will not pass it on. + +You should consider any previously-sent article, canceled or +not, to be published and publicly available. + + + + + +Supersede + +Supersede overwrites your article with a new version. One reason +for doing this could be: + +You have written a long article and have already posted it; now, you +have found an error in this article: you could cancel this article, and post a +new, corrected, article; or, you can use Supersede. + +Select the article in the article view. From its context menu +select Supersede article.... &knode; will +ask you if you really want to overwrite this article; if you confirm with +Yes the Composer appears. + +In the Composer you can now make the desired corrections and +changes. You can then publish this article in the same way as you post +every other article; when the newsserver receives this article it +reads some special lines in the header which tell the newsserver to +supersede the older article. Select +FileSend +Later for now, because we want to look at +the article's header in the Outbox. + +Activate ViewShow +all headers, because we want to see all the +headers the newsserver receives. You will notice a line like: + +Supersedes: <oggcm8.4n5.ln@konqi.org> + +This is the instruction for the newsserver for superseding the +article with the Message-ID <oggcm8.4n5.ln@konqi.org> with the +new article. + +Besides this, Supersede is used for periodical posted articles, ⪚ + an FAQ. The new article supersedes the old one and + the newsgroups do not end up with lots of different versions. + + +Again, using this function is only possible if the article +already has a Message-ID. Normally, articles get their Message-ID from the +newsserver: this means that you can only supersede articles which have +already been published. + +You can configure &knode; to generate this Message-ID, then you can +supersede your articles in the folder Sent, +too. + +&knode; allows you to only supersede your own articles. + + + + +As with cancels, supersede messages have been abused in the +past, with, for example, certain parties sending hundreds or even +thousands of them to overwrite legitimate posts with random computer +generated junk; again, as with cancels, many news servers do not +honor supersede messages, nor do they pass them on. + + + + + + +Score, watch, ignore + + +Score, Watch and Ignore are different names for the same +feature. + +By scoring a thread, you determine its importance. &knode; +allows scores between -100000 and 100000. A normal article will get a +score of 0 if you do not change this; threads with a score below 0 +are less important than average; threads with a score above 0 are more +important than average. + +The score is an attribute of the thread and the articles in this +thread, so you can use the score for filtering and searching +articles; for example, you can define a filter to show only +articles with a score > 0, i.e. all articles in which you are +specifically interested. + +The function Watch sets the score of +all article in a thread to 100; this way they get a high score and &knode; +labels them with a special icon. + +The function Ignore does the +opposite: it scores all articles in a thread with -100 so &knode; +does not show these articles anymore. + + +The English word scoring is used in many other +countries, too. + + +You can score an article or a thread manually with the right +mouse button or with the Scoring menu — here you can +score with Watch Thread and Ignore +Thread directly. Apart from scoring manually you can let &knode; +score the articles with scoring rules automatically; you can configure these +rules at SettingsConfigure +KNode...Reading +NewsScoring or +at ScoringEdit scoring +rules... — the only difference between these +dialogs is that the last one has the rule-list next to the rule +configuration. In the following guide I'm using the editor that appears +if ScoringEdit scoring +rules... is chosen. + + +The Rule Editor + + + + +The Rule Editor + + +The Rule Editor + + + + +The composer consists of 4 areas: on the left side is the list +of the rules; with the buttons below the list you can add, delete or +copy an existing rule; below that you have the possibility to limit +the rules which are shown — you have the choice whether to show all +rules or only the rules for a specific newsgroup. + +If you chose a rule-name in the list you the rule will be displayed +on the right-hand side; now you can edit the rule. At the top you can change +the name of the rule and set the newsgroups to which this rule applies. +You can choose one or +more than one group, note that group names must be separated by a +semicolon. You can choose from the subscribed groups with +the drop-down list and the Add group button; or +you can use regular expressions and wild cards, ⪚ .* for all +groups. The Expire rule automatically option +makes it possible to delete the rule automatically after the +configured number of days; this is useful if a specific person +behaves badly and you do not want to read anything from this person for a +few days. + +In the Condition field you enter the +condition on which this rule is activated. Normally, you can enter only +one condition, but you can change this by pressing the +More and Fewer buttons. If you +have more than one condition, you must tell knode whether all conditions +need to be fulfilled or only one of them; this can be done by choosing +Match all conditions or +Match any condition respectively. + + +Each condition consists of 2 drop-down lists and a text +field. In the first list you chose the part of the message which should +be used for the condition — this part will be compared with the text +field; the second drop-down list tells &knode; how it is to be +compared, for example, whether the chosen header should be identical +to the text entered in the text field, or if it just needs to match part of it. +Regular expressions are allowed, too. +If you check Not then the conditions under which +the condition is satisfied are reversed, and the condition will be satisfied +if the opposite of its shown conditions is true. + +Now, let's have a look at some +examples. + + + +Maybe you want to filter away all the postings by Theodor +Test; to do this choose the +From header line from the first drop-down +list, choose is exactly the same as from the second +drop-down list, and enter his name in the text field. +But, before doing this you should have a +look at the header of one of Theodor's +articles and see what is in the From line. + + +If you do not want to read articles with more than 100 lines, choose +the header entry Lines from the first drop-down +list, choose greater than from the second, and enter +100 in the text field. You probably, then, want to +score down the message. + + +Last example: of course, you're very interested in every article +that refers to &knode;. Choose the header entry +Subject, then contains substring +and enter knode in the text field. But what do +you do if &knode; is not mentioned in the +Subject? I suggest using a regular +expression: change contains substring to +matches regular expression and type +knode|newsreader|usenet into the text +field to match either knode, newsreader or usenet — the | symbol +means OR. Alternatively, you can make 3 conditions — one that matches knode, +one that matches newsreader and so on — and choose +Match any condition; but, this needs a lot of +space and it is not very elegant, is it? + + + + +Once your condition is ready you should set an action down in the +Actions section. The most important action is +adjust score; if this action is chosen you can +raise or lower the score, by the configured value, for articles to which +this rule applies. &knode; can also show you a little message when finding +such an article or colorize the header in the article list; for example, you could make +interesting articles scraeming pink so you would notice them very +quickly. + +When leaving the editor, or when the +ScoringRecalculate +scores menu item is chosen, the rules are executed; furthermore, +the rules are automatically used for new +articles. Scoring makes the most sense when +used with filters: by scoring some articles down and filtering them away +they won't appear in the article list. + + + + +Group identities + +With &knode; you can use a different identity with every +newsgroup to which you are subscribed; i.e. you can set a name, email address, +reply-to address and signature to use with that group. + +It is easy to set group identities. First, with the right mouse button, +click on the name of the newsgroup in which to have a different identity in; then, +select Group Properties from the context menu +that appears. In the dialog that appears the second tab contains +fields identical to the global identity settings; enter your settings here and +click OK to confirm the changes: then, your articles in +this group will always posted with this newly-entered identity. + + +When you unsubscribe from a group you lose its identity +settings for this group: if you re-subscribe to the group, you will need to +re-enter its identity settings. For new newsgroups, the global identity is +used. + + + + + +Managing Multiple News Accounts + +&knode; can handle an unlimited number of news server accounts in +addition to your main news server; most users don't need this feature, +but it can be very useful to if your main newsserver does not provide +all groups you want to read. Typical cases of this are when support groups for +commercial software are hosted on a special, private, server or binary +newsgroups, which are only available from some servers. + +Another example of why you sometimes need more than one newsserver +is that sometimes not all interesting newsgroups are on one +server; in fact, there is very often only a selection of +newsgroups. For example, many servers do not support binary +groups with pictures or programs; if you want such a newsgroup and +your newsserver provider does not want to serve it you can configure +&knode; to get it from another server. + +Or, perhaps you find you are just subscribed to too many +newsgroups, and would like to organize them a little better; you +could set up several accounts for the same server, perhaps one for +groups you read every day, and one for groups you read less often, so +that you do not have to search for your everyday groups +in a long list of subscribed groups. + +In order to add an new account, open the preferences +dialog via +SettingsConfigure +KNode...AccountsNews +. The New button creates a new +account; you then have to enter the same data as for your first +account, typically a name for the account, the host name, and a user name +and password if the server requires authentication. When +this is done the new server will appear both in the configuration +dialog and in the group view: you can now subscribe to +newsgroups. + +You can delete the currently-selected account by pressing the +Delete button. + + +In the Account properties dialog (available +from the context menu of the newsserver) you can setup an identity for use +only on this newsserver. + + + + +Sign and Verify Articles with <acronym>PGP</acronym> + + +PGP is the most-widespread method used to encrypt or +sign data. Using the PGP-signature you can +verify if an article is really from the original author or if it has been +changed by others. You can find PGP-programs and guides at http://www.pgpi.org. + +With &knode; you can sign an article with +PGP and to verify PGP-signed +article. After you have configured the PGP support, +at SettingsConfigure +Knode...Signing/Verifying, +you can sign articles in the editor with the +ToolsSign article with +PGP menu item — you will be asked for your passphrase +and after that the article will be signed. + + +Your GnuPG/PGP +ID is automatically built from your name and your +email address and is identical to the sender of the message +(From-header). + + + To verify +a PGP-signature you have to choose the menu +item ViewVerify +PGP-signature. + + + + diff --git a/doc/knode/using-subscribing.docbook b/doc/knode/using-subscribing.docbook new file mode 100644 index 000000000..618ab292a --- /dev/null +++ b/doc/knode/using-subscribing.docbook @@ -0,0 +1,1367 @@ + + +Working with newsgroups + +After the configuration of &knode; we will now try to get your +first news; to achieve this, you need to do some more steps of +configuration, but you will not have to do this very often. + + +Fetching the group-list from the news server + + + +If you want to read a newsgroup you first have to subscribe to +it. &RMB;-click with your mouse on the entry of your newsserver in the +folder-list; from the context menu that appears select the +Subscribe to Newsgroups entry. &knode;, at +this moment, does not know which newsgroups are available from this +server and will ask you if it should fetch a list of available +newsgroups: confirm with Yes. Now you should +see the following dialog. + + +The Subscribe to +Newsgroups Dialog + + + + +The Subscribe to +Newsgroups dialog + + +The Subscribe to +Newsgroups dialog + + + + +After some time &knode; will has fetched the list of available +newsgroups and will show them in the left window, Groups +on, in a tree; this tree view shows the +newsgroup hierarchy. + + +You can find a short description about the structure of the usenet +and the hierarchy of the single newsgroups at http://www.kirchwitz.de/~amk/dni/usenet-einfuehrung +(German). + + + +<guilabel>Search</guilabel> + +The simplest method to navigate in the tree is to use +the Search input field: &knode; will filter the groups +displayed according to your input. If you are searching for +a group about &kde;, but you do not know its exact position in the +hierarchy, just type kde in the +Search field. + +When you enter the k, you will already +see the list changing; the second letter, d, +give you a significantly-reduced list of shown groups; and the final +e reduces the list to the groups with kde in +their name. You will most likely end with just one group: + + +comp.windows.x.kde + + +If your server carries the international groups, you might find +your list is: + + +comp.windows.x.kde +de.comp.os.unix.apps.kde + + +This incremental search gives you the possibility to search for +newsgroups without knowing their exact paths. + + +On a closer look, you will see &knode; showing the groups without +a tree if there are only a few groups left; this is not a bug, it is a +feature. + + + + +<guilabel>disable tree view</guilabel> + +Normally &knode; shows all the groups in a tree; if this option +is activated, all newsgroups are listed amongst one another. + + + + + +<guilabel>subscribed only</guilabel> + +If subscribed only is checked the +tree-view Groups on shows only the groups you are +already subscribed to; this is very convenient if you want to +unsubscribe from some groups: you then won't have to search the whole tree +for these groups. + + + + +<guilabel>new only</guilabel> + +If new only is checked the tree-view +Groups on shows only the groups which are new +since you last fetched the group list; for this to be functional, you +first have to fetch a new group list with New +List. + +The New Groups button give the +possibility to show all the new groups since a specific date. + + + + +<guilabel>Groups on</guilabel> + +This list shows all newsgroups on this server; if you check one +of the checkboxes, subscribed only or +new only, you get the corresponding +selection. + + + + +<guilabel>Current changes</guilabel> + +The Current changes window shows all +changes you have made since you opened the dialog. + +The subscribe to list shows the newsgroups +you have chosen to subscribe to. + +Below you can see the unsubscribe +from list, which shows all newsgroups from which you have chosen to +unsubscribe. You cannot unsubscribe from groups you are not +subscribed to. + + + + +<guilabel>New Groups</guilabel> + +This button opens a dialog which allows you to configure the list +of new groups; you can choose between showing all groups since the +last refresh or all groups since a given date. With the date option, +&knode; provides a more-flexible possibility to check for new +groups; you can even check for new groups since before the last refresh of +the group list. + + + + +<guibutton>New List</guibutton> + +The New List button tells &knode; to +fetch a new group list from the news server. + + +The newsgroup hierarchy is in a constant flux; all the time +there are groups introduced, renamed or moved; some groups just +disappear: they are no longer available and get deleted. To reflect +this, &knode; gives you the possibility to refresh the the group +list. This is, normally, only needed to see if your server now +provides a group which was not there before. + + +If you simply want to make sure you have seen every new group, it is +more effective to use New Groups; fetching the +complete list is much more time consuming, but you do make sure that any +deleted groups vanish from the grouplist. + + +Unfortunately there is no guarantee that your newsserver is +providing all available newsgroups: many newsserver refuse groups +publishing binary attachments; other groups are only available from +special servers. &knode; provides you the possibility to use more than +one news-server if you want to access alternative servers providing +these groups; you can read more about this in . + + + + +Working with the dialog + +We now want to subscribe to the &kde; group: mark the the box +beside the name; you can now see the group in the list labelled +subscribe to. Another possibility is to use the +arrows between the two windows. + +If you picked the wrong newsgroup by mistake you can undo your +selection by unchecking the checkbox next to the group's name in the +Groups on window; again, you could use the +arrow (you probably noticed the arrow changing direction.) + +If you want to unsubscribe from a newsgroup it is as easy as +subscribing to it: you just uncheck the box next to its name. The groups +you wish to unsubscribe from are shown in the unsubscribe +from list. Again, the arrow is another way of doing things: to +correct your actions you can use the arrow again; this works as +long as the dialog is not closed by clicking +OK. + +As a &kde; and &knode; user you will probably want to subscribe +to the group, so make sure you checked the box and press +OK. This group now appears in the tree view +under the server entry it was chosen from; in our example this is +My News Account. If you can not see the group, +click on the cross next to the server entry or on the server entry +itself; the list of subscribed newsgroups should appear. + +Click on the newsgroup; now you see on the right in the article +view an empty folder: &knode; has to fetch the articles for the new +newsgroup. If you have, in +SettingsConfigure +KNodeReading +newsGeneral, the +check box Check for new article automatically +checked &knode; tries to fetch the articles from the server when the +newsgroup is first selected; if this is unchecked, you have to use +AccountGet new +articles. + + +When you are using leafnode as a +server, there will be a single article in the +group: leafnode generates an article in +every new subscribed group; this indicates that +leafnode will consider this group the next +time it fetches articles. You can ignore an error message saying the +article can not be found. If you select this article you tell +leafnode you are really interested in this +group. + +You get the real articles when your local newsserver fetches +them from the Internet and provides them to you; details about this +can be found in the documentation of your local newsserver. + + +When everything works the articles of the subscribed newsgroup +appear in the upper right window — the article view. + + + + + +Fetching and reading Articles + +&knode; always shows three views: the folder view, the article view and +the article window; you can change height and width of these views with +the mouse. If you click in a window it gets the focus; this is +important if you want to use &knode; with the keyboard. The +Tab key changes the focus between the views; the +currently-active view is indicated by a small colored bar over the +column headers. + +This picture shows &knode; with the subscribed &kde; +newsgroup. + + +The three views of &knode; + + + + +The three views of &knode; + + +The three views of &knode; + + + + +It is possible to select more than one group or article. You can +select an area by clicking on the first entry with the &LMB;, holding +the &Shift; key and clicking on the last entry with the &LMB; +again. + +If you want to select more than one single entry, but they are +not next to each other in the list, you have to select the first by +clicking on it with the &LMB; and then select the other entries by +holding down the &Ctrl; key and clicking on them with the &LMB;. + +In either case you can clear your selection by clicking on +another entry with the &LMB;. + + + +If you have selected more than one entry you have to activate the +context menu with the &Shift; key pressed, otherwise you'll clear the +selection. + + + +The Folder View + +The folder views contains not only the accounts you configured +— in our example this is My News Account +— but also three other folders. When you are subscribed to some +newsgroups there will be plus next to the name of the +account: clicking on the plus or the name of the account opens the +tree to show the names of the newsgroups you have chosen to subscribe +to using that account. + + +Using the &RMB; you can get a context menu for the selected item +(folders or newsgroups): if you select a newsgroup and choose +Properties you can, amongst other things, specify your identity for +this particular group; you can find more about this in the +Local Identities chapter. + + +When you select a newsgroup with your mouse a list of articles +of this group appears in the upper-right window; if there are no +articles in the upper-right window there are two possibilities — +either there are no articles for this newsgroup on the newsserver +or the newsserver did not fetch them yet. Select +AccountGet new articles in +all groups: if there are still no articles +appearing you either have some problems with your settings or there really +are no articles for this group. Try another group: if there are no +articles for this group you will probably have to work through the +first chapters, about the configuration of &knode;, again; the +Frequently Asked Questions chapter may help you, +too. + + +If you are using a local newsserver the articles only appear if +the newsserver has already got them from the internet; if you are using +leafnode this is done by the +fetchnews program. + + + +The Newsgroup Folders + +The newsgroup folders appear with the name they are given by the +hierarchy on the newsserver; in our example this is +comp.windows.x.kde. You can change the name shown +in this view: in the context menu (click with the &RMB; on the +newsgroup's name) choose Rename +group, then you can change the name in the +input field. A good name for comp.windows.x.kde +would be, for example, The KDE Newsgroup. + +If you don't change this, the hierarchical name will still be shown. + +Besides the name of newsgroups the folder view shows more +information by altering its appearance: if a newsgroup contains +new articles its name is shown bold; the columns +Total and Unread also tell you +how many articles are in the corresponding group or folder and how many +are marked as unread. + + + + +The <guilabel>Outbox</guilabel> folder + +The Outbox folder contains all articles +which are to be sent later, or which could not be sent because +of an error. If you want to sent an article later choose +FileSend +Later in the editor: the article is then +filed in the Outbox folder; it is possible to +edit, delete or send these articles later. + + +If an article was not sent because of an error, it is stored in +this folder; you will not lose these articles. + + + + +The <guilabel>Drafts</guilabel> folder + +This folder is used for storing drafts of your articles; for +example, if you want to do some further work on them but you have no +time for it right now. To store an article in this folder +choose FileSave as +Draft in the editor. + +You can edit, delete and send the articles in this +folder. + + + + +The <guilabel>Sent</guilabel> Folder + +This folder contains copies of the articles that you have successfully +sent, including your e-mail replies; you can delete the messages in +this folder, but it will not un-send the messages already +sent. + + +If your are using a local newsserver an article appearing in +the folder Sent only indicates the local +newsserver received the article; it is possible this article will never +appears in any newsgroup if the local newsserver was not able to +send it for some reason. If you notice some articles not appearing in +the according newsgroup first make sure it was sent by the local +newsserver. + + + +If you are using leafnode then articles +leafnode was unable to send are normally found in +/var/spool/failed.postings. + + + + + +The Article View + +The article view gives you a list of all articles in the +selected newsgroup or folder; you can change the appearance of this +view using the View menu. The uppermost row of the +view contains the column headers. + + + +Subject + +The Subject column shows the subjects of +an articles which, most of the time, give you a clue about the content +of this article. The subject is chosen by the article author. You can +find more about this in How to post +and reply to news. + + + +From + +The From column shows the author, or their +e-mail address if the author didn't give a name. You can configure +your settings in +SettingsConfigure +KNodeIdentity; when +you publish an article &knode; will show these settings in the +From column. + + + +Score + +The Score column shows the scoring of an +article as a number; the default is 0. Articles which are important to +you can be scored up; articles you want to ignore can be scored +down: the range is -100000 to +100000. You can read more about this in +the Scoring, Watching and +Ignoring chapter. +The Score column is only shown if +SettingsConfigure +KNode...Reading +NewsGeneralShow article +score is activated. + + + +Date + +The Date column shows the date and time +when the article was written. + + + +Lines + +The Lines column shows the number of lines +of the article; this column is only shown if +SettingsConfigure +KNode...Reading +NewsGeneralShow line +count is activated. + + + + + +The Symbols and Highlighting Used + +This is a short explanation of the different symbols for +labeling articles. + + + + + + + +Already-read articles are labeled with this symbol. + + + + + + + +Articles labeled with this symbol are read and the body was fetched +from the server. + + + + + + + +Articles labeled with this symbol are unread and the body has not yet +been fetched. + + + + + + + +Articles labeled with this symbol are unread but the body has already +been already fetched. + + + + + + + +Articles labeled with this symbol are part of a thread with new and/or +unread articles in it. + + + + + + + +Articles labeled with this symbol are parts of a guarded thread. This +corresponds to a score of 100. + + + +Besides different symbols, &knode; is using the following +highlighting: + + + +Bold article subjects. + +The article is new in this group; it was fetched during the last +connection with the server. + + + +Article subjects printed in gray. + +There are no unread follow-up articles. + + + + + + +Navigation in the Article View. + +You can navigate in articles, display an article and open or +close threads with your mouse or keyboard. + +When you select an article with your mouse its entry in the the +article view gets colored; at the same time the header and body of +this article appear in in the article window. If you want to read +another article you can use the mouse to select it, or you can use +the cursor keys. If you use the cursor keys you can move the +dashed frame to the article you want to read and then press +Enter to mark and display the article. + +There are many key commands to provide comfortable navigation +within a news group and to switching between newsgroups. Here the most +common key commands of the standard key configuration are listed; you +can configure the key bindings in +SettingsConfigure +Shortcuts. + + + +Toggle Subthreads T + + +The replies to an article are either shown or hidden by +multiply pressing this key; another way to open threads is +to use the Right Arrow key. + + + +Filter F6 + +A dialog is shown where you can choose the filter for the +articles. + + + +Sort F7 + + +A dialog is shown where you can change the sorting of the +articles; if you choose a column for a second time it will change the +sorting direction. + + + +Browsing articles Space + +This key gives you a convenient possibility for browsing through +the article view: by pressing this key the article in the article +window is scrolled; when you reach the end of the article by +repeatedly pressing Space, it takes you to the next +article; when you have read all articles in one newsgroup, +Space takes you to the first article of the next +newsgroup. By repeatedly pressing Space you can +browse through all subscribed newsgroups like this. + + + +Next unread article &Alt;Space + + +This key binding jumps to the next unread article. The sequence +follows the order of articles in the article view; threads are opened +if necessary. + + + +Next unread thread &Ctrl;Space + + +This command jumps to the next thread containing unread +articles: the first unread article is then selected and shown. The sequence +follows the order of articles in the article view. + + + +Next article N + + +This command jumps to the next article; the sequence follows the +order of articles in the article view. Replies in closed threads are +ignored. + + + +Previous article B + +This command jumps to the previous article in the group; the +sequence follows the order of articles in the article view. Replies in +closed threads are ignored. + + + +Next group ++ + + +This command jumps to the next newsgroup; the sequence follows +the order of newsgroups in the folder view. + + + +Previous group - + + +This command jumps to the previous newsgroup; the sequence +follows the order of newsgroups in the folder view. + + + + + + +Sorting and Filtering of Articles + +Some newsgroups are very crowded and contain lots of +articles; perhaps only some of them are interesting to you. One +possibility to keep track of the news you are interested in is +to sort your articles with a certain criterion. + +Sorting your articles, and choosing sorting criteria, is +done with the column titles in the article view: clicking on a column +title makes it the current sorting criterion; another click on the same +column title changes the order of sorting. + + +The current sorting criterion is indicated with an arrow next to +the title; this gives you an easy sign which column is used for +sorting, too. You have to make the column wide enough, though, so you +can actually see the arrow; you can change the column width by moving +the mouse pointer on the small area between two column titles: the +pointer changes its appearance to two horizontal arrows; clicking +and holding the &LMB; mouse button now allows you to change the width +of the column to the left of the mouse pointer. + + +&knode; gives you the possibility to reduce the flood of +articles: you can show only articles fitting specific +criteria; &knode; uses filters for this task. In the following paragraphs we +are just dealing with the predefined filters; for defining and using +your own filters please refer to the Defining and using Filters chapter. + +Normally you will read most articles only once, and then never +again. &knode; labels the articles which are unread, but when there +are more articles in a news group than can be shown by the article +view you often have to search for unread articles: it would be much +easier to see only the new fetched and unread articles; &knode; gives +you this feature by the predefined filters. + +In the status line at the bottom border of your main window +next to the word Filter the actually-active +filter is shown: if you do not change the filter configuration this +is the filter all; this means all articles of a +newsgroup are shown. all is one of the predefined +filters; there are eight of them in all, which are described in more detail +here. + + + + +All + + +This filter is the default setting; it shows all articles in a +newsgroup. You can choose this filter by selecting +ViewFilterAll + + + +Unread + +This filter shows only unread articles; you can choose this +filter by selecting +ViewFilterUnread + + + + +New + +This filter shows only articles fetched during the last +connection; you can choose this filter by selecting +ViewFilterNew + + + +Watched + +This shows only threads chosen as watched threads by you; you +may be watching a thread because, for example, you are participating in it, +or because you are particularly interested in the answers. +You can choose this filter by selecting +ViewFilterWatched + +This filter only shows something if have you selected one or more +threads to watch; you can achieve this by selecting +ArticleThreadWatch: +next to the subject a symbol will appear, showing a pair of eyes. + + + + +Threads With Unread + +This filter shows only threads containing unread articles; you +can choose this filter by selecting +ViewFilter +Threads With Unread + + + + +Threads With New + +This filter shows only threads with newly-fetched articles; you +can choose this filter by selecting +ViewFilterThreads +With New + + + +Own articles + +This filter only articles you have published; you can choose +this filter by selecting +ViewFilterOwn +Articles + + + + +Threads With Own Articles + +This filter only shows threads containing articles you +have published; you can +choose this filter by selecting View +FilterOwn +Articles + + + + + + +For everyday use the unread filter is +propably the most useful: it shows all unread articles, including the +old ones. The other filters are very task-specific and are seldom used; +in the end it is a matter of taste which filter to select. + + + + + +The Article Window + +The article window shows the currently-selected article. You can +scroll in it like in a normal text editor window; the difference is +that you cannot change the article — it is for reading only. + +By pressing the &RMB; in the article viewer you can access the +important functions in the context menu very quickly. + +The window itself is divided in three areas; they are explained +in more detail now. + + +The Header + +This part shows the header lines or a part of the header. You +will recognize some information here from the article view; for +example, the subject and the address or name where the article +originated. When you click on the From: address, +&knode; opens an editor window where the email address of the author and +the subject of the referring article are already filled in for +you; this enables you to reply to the author directly from their +article. + +The appearance and content of the header shown by default +can be configured by choosing SettingsConfiguring +KNode...Reading +NewsHeaders; you can +find a more-detailed view on this in Configuring the Shown +Headers. + +By selecting +ViewShow all +headers you force &knode; to show the whole +header as is produced by the newsreader and newsservers; normally +you do not need this view: it needs a lot of space in the article +window. + +The last lines of the header contain, if necessary, some +references to other articles, shown as numbers in the range from 1 to +n. These References are the articles to which the current article refers: +the article labeled with 1 is the oldest article to which this article +refers; the article with the highest number is the most-recent article +to which the current article refers. + +When you click on a reference the corresponding article is loaded +and shown in the article view; if the article is no longer available +you will be informed by &knode;. This will happen if +the article has been deleted by the article management of &knode; due to +its age, or your news server decided to delete it from the newsgroup; +for details on how to get such an article, please refer to the +Frequently Asked Questions. + + +The first lines in an article, with the subject and author +information and so on, are called +headers. + + + + +The Body of the Article + +The body of the article follows straight after the header; it +is the actual message the author published in the newsgroup. Be aware +that some articles may contain quotes from other articles which are +not recognizable as quotes; this depends on the news editor the author +used and their article-formatting habits. + +&knode; provides some formatting which can be used by articles; +at the moment the available options are: + + +/italic/ +*bold* +_underlined_ + + +Do not use the highlighting too often; the impact decreases +the more it is used. + + +The main part of the message (the contents) is called the +body. + + +Most of the time a quote is indicated by a prefixed > on +every line; however, there are other possible signs. If you can not directly +recognize a quote the author did not obey the rules of proper +quoting. + +Also, it is usual to start an answer with a +introductionary line, something like: + + +On 12/25/2000 Santa Claus wrote: + + + +Normally you do not have to concern yourself with these introductionary +lines: &knode; does this automatically when you reply to an +article; to find out how to customize this line see +The Composer Settings +documentation. + + + +In SettingsConfigure +KNode...Reading +NewsAppearance you can +choose how the articles are shown. In particular, &knode; provides the +smart coloring of different reply levels; you can read more about this +in the chapter Configuring the +appearance. + + +&knode; only supports the coloring of quotes if the quoting +lines starts with special characters; you can configure these +characters at +SettingsConfigure +KNode...Reading +NewsViewer. + + +When the body of an article contains links to internet addresses +you can invoke an internet browser to display the web page it links to +by clicking on the link; details about configuring this feature can be +found in General news +settings. + + + + +The Signature + +Below the main text of an article you can find the signature of the +author, provided you did not disable signatures in +SettingsConfigure +KNode...Reading +NewsGeneral. The +signature is divided from the text by thin horizontal line. + + + + +Attachments and Multipart <acronym>MIME</acronym> +messages + +If an article contains attachments they are shown below the +signature in a table. + +The multipart MIME format allows the body of +an article to be sent in more than one format; for example, in plain-text +and in HTML. It depends on the newsreader which format +is used for reading the article. + +&knode; allows the different formats to be shown by selecting +SettingsConfigure +KNode...Reading +NewsViewerShow alternative +contents as attachments; when this option is +checked all alternative formats are shown as attachments and can be +opened and viewed. + +If this option is unchecked you will not be shown the different text +formats and &knode; decides which one should be shown. + + + + + + +Writing and Replying to Articles + +Before you start writing articles or replying to other Usenet +users be sure you understand the habits of the current +newsgroup; again, reading A Journey +Through Usenet would be a good idea. + +For testing the settings of &knode; please resist sending an +article to a random newsgroup; it is not very friendly to bother +people with test articles: what if you are subscribed to a newsgroup +and half of its articles only contain the word +test? It is like somebody calling you just to +testing their phone. + +This is the reason for the special groups having +test in their name; for example, +alt.test. In these groups you can test everything +you want without bothering anybody; some groups even send you error +messages back. + +Here you can easily identify obvious mistakes, like a missing or +a wrong e-mail address or a wrongly-configured charset which doesn't +show all special characters. + +You can find a selection of test groups in Test Groups. + +Subscribe to one of the test groups now; some news servers have +their own test groups, which are probably less crowded. + + +Remember, you have to download the articles of the new +subscribed group; this may take some time if there are many articles +in the group. The only +important articles are yours and the answers by the check handler; if +you want to reduce the number of articles fetched during the test you +can configure this in +SettingsConfigure +KNode...Reading +NewsGeneralMaximal number of +articles to fetch: if you reduce this +dramatically, you should not wait too long to fetch the new +articles after sending your test article; however, if it set too low +your article might not be fetched. A tolerably-fast news server should +provide your article right after you sent it; you might, however, have to +wait a while, at worst 1 or 2 days. Feel free to send another article +if cannot see your initial one; this is what the test groups are +for. + + + +When you are using a local news server the configuration of +Maximal number of articles to fetch in &knode; is +probably unnecessary; you should consult the documentation of your +news server instead. + + +If you did not encounter any errors unsubscribe from the +test groups and set Maximum number of articles to +fetch back to normal (1000). + + +Publishing Articles + +You have seen most of &knode; now, but have only used it +passively so far, so let's publish a test +article now. Select the new subscribed test group in the folder +view; then, with ArticlePost to +newsgroup...or the key P, +the Editor will be opened. + +You can use the &knode; Editor like a normal Texteditor; there +are some additional features for writing news articles though. + +In the editor window there are two input lines: one +for the subject, which is empty at the moment; and another for the +newsgroups this article is going to be posted to. + +Enter the text This is a test in the +subject field. + + +Normally, when you post an article, use a descriptive subject. Articles +without a descriptive subject are often ignored. Avoid subjects like +Help, it doesn't work !!!!! This subject gives no +information about the content of your article. + + +The Groups: field already contains the test +newsgroup you selected before; do not change this. + +Below the input field for the newsgroup +there is another inactive option field: this function is explained +later in the chapter The +editor; for now it is irrelevant. + +For simplicity reasons we will only use a simple +sentence; type: + + +This is the body of my test article. @ $ % + + +Then, enter an empty line, followed by: + + +Did it work? + + +This may look funny to you, but it does what it is supposed to +do — test your configuration.. + +Your article should now look like the screenshot below: + + +Your first article + + + + +Your first article + + +Your first article + + + + +If you are using &knode; with a local newsserver choose +FileSend +Now in the Editor; if you do not have a +connection to a newsserver at this point, you may want to send the +article later — you can achieve this by using +FileSend +Later — &knode; then stores this article +in the folder Outbox. You can start sending the +articles in the Outbox manually by selecting +FileSend pending +messages. + +After sending the article you will notice &knode; stores a copy +in the Sent folder. + +Depending on how fast your article is published in the according +newsgroup you can check the result after some time: mostly it is +sufficient to check for new messages immediately after sending the +article; be patient, though, it may take the article some +hours before reaching the newsgroup. If the article does not arrive +after a number of hours it is likely that something went wrong: try again; then, +if it is still not working, have a look at the Frequently Asked Questions. + + +Even when you are using a local news server, you have to check +for new articles: the local news server just sends the article, it does +not store it in the local newsgroup, so you have to synchronize with +an external news server if you want to see if your test article +has arrived. + + +If the article appears in the newsgroup +you are successful; now you should check if there is the correct +sender and if the article is readable. Have a look on your +language-specific characters like the German umlauts; if they are not +readable you have to change the coding at +SettingsConfigure +KNode...Posting +NewsTechnicalto +Allow 8-bit. Change this and repeat your +test. + +If everything is right you have successfully published your first +article in usenet with &knode;. + + + + +Post Reply + +After successfully publishing an article we will now answer to +your own article. You want to answer the question you asked, don't +you? + +Select your article in the article view and press the &RMB;: a +context menu will appear; choose Followup to +newsgroup. + +&knode; opens the Editor again, but this time there is already a +subject filled in for you. The subject line reads: + + +Re: This is a test + + +Re: is a shortcut for the Latin In +re, which translates to something along the lines of relating +to. You should not change the subject and, above all, the +Re:: most newsreaders sort threads by the +subject. + + +If you want to change the subject for some reason put the new +subject in front of the old and replace the Re: with a parenthesized +(Was: ... ); in our example this would look like + + +A new subject! (Was: This is a test) + + +With this kind of subject you show the other readers there is a +branch in the original discussion; this happens, for example, +when a new topic occurs in the original discussion or the original +subject has changed for some reason. + +If you answer to an article with such a subject, delete the +parenthesized part of the subject; the first part with a prefixed +Re: remains. + + +Re: A new subject! + + + +Let us have look at the Editor now. The contents of the article +to which we want to reply has already been copied to the Editor by &knode;; +to indicate the text is a quote every line is prefixed with a +>. + +In front of the quoted text &knode; has put an introduction +line: the content of this line refers to the original author; you can +change the standard text of this line in +SettingsConfigure +KNode...Posting +NewsComposerIntroduction +Phrase:. + +The original article contains the question: Did it +work? We want to answer this question now. + +Place the cursor below the quoted question and write in the next +line: + + +Yes it worked, congratulations! + + +We are not finished yet: it is considered polite to begin with +a greeting like Hello in the first line; whether you call the +author by their name or not depends on your habits, watch the +newsgroup to get used to the habits there. + +Next we delete all non-mandatory parts of the quoted article; in +our case, we delete all parts except the question. + +With such a short text this is unnecessary, but this just an +example: if you have to read a message 100 lines long again just to +find an I agree at the end you will +understand.... Aside from this, it makes articles smaller so they use +less space on the server. + +At the end we say good bye. + +This screenshot shows our answer before sending it. + + +Your answer to your article + + + + +Your answer to your article + + +Your answer to your article + + + + + +You can find a good guide for correct quoting at http://www.afaik.de/usenet/faq/zitieren +(German). + + +Now we still need to post our reply; like posting the original message +choose FileSend +now or the alternative +FileSend +later, if you're not online at the moment +and you're not using a local newsserver. If everything works +you will see your article in the newsgroup after a while; easy, isn't +it? + + +Using the Options menu you can configure whether +you want to send an email, a news article or both. + + + + +Mail Reply + +The Mail Reply follows the same lines as posting a reply in a +newsgroup; the only difference is that a mail reply is sent directly +to the author and does not appear in any newsgroup. + +Sometimes it is better to use an emailed reply instead of +posting a reply to newsgroup; they are used primarily for when you +want to correct an error or misconduct by the author, without hurting +their feelings by doing so publicly on the newsgroup. + +To answer with an e-mail select your article; again, +open the context menu with the right mouse button; and choose +Reply by Email: &knode; opens the Composer +with the quoted article. + +Subject and body are identical as when posting an article but +the Groups: field is replaced by a +To: field; here the author's email address +appears. In our example this should be your own email address, if +&knode; is set up correctly. + +For emails the same rules for quoting and politeness apply +as for posting an article in a newsgroup. + +After finishing your Reply, you can send it. + +The screenshot below shows the reply we distributed by email. + + +A Mail Reply + + + + +A Mail Reply + + +A Mail Reply + + + + + +The Mail Reply only works if you have used the correct settings in +SettingsConfigure +KNode...AccountsMail. + +Depending on the configuration of your computer, you will find +the reply in your mailbox; you might have to connect to your +ISP and fetch your new mail first though. + + + +On the Options menu you can configure whether +you want to send an email, a news article or both. + + + + + -- cgit v1.2.1