diff options
Diffstat (limited to 'doc/knode/using-firststart.docbook')
| -rw-r--r-- | doc/knode/using-firststart.docbook | 1859 |
1 files changed, 1859 insertions, 0 deletions
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 @@ +<!-- <?xml version="1.0" ?> +<!DOCTYPE sect1 PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" +"dtd/kdex.dtd"> --> +<sect1 id="first-start"> +<title>The first start</title> + +<para>You can find &knode; in the <guimenu>K</guimenu> Menu under the +<guisubmenu>Internet</guisubmenu> entry: the menu entry +<guimenuitem>KNode</guimenuitem> launches the program.</para> + +<tip> +<para>If the entry for &knode; can not be found or if &knode; does +not appear after clicking on the menu entry, read <link +linkend="faq">Questions and Answers</link>.</para> +</tip> + +<para>The main window of &knode; should now be displayed on your +desktop as shown; on the first start, the settings dialog will be +invoked.</para> + +<screenshot> +<screeninfo>Setting up &knode;</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-start.png" format="PNG"/></imageobject> +<textobject> +<phrase>&knode; after first start</phrase> +</textobject> +<caption> +<para>&knode; after first start</para> +</caption> +</mediaobject> +</screenshot> + +<para>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.</para> + +<para>There is a folder view, which currently contains only three +entries:</para> + +<simplelist> +<member>The folder <guilabel>Outbox</guilabel></member> +<member>The folder <guilabel>Drafts</guilabel></member> +<member>The folder <guilabel>Sent</guilabel></member> +</simplelist> + +<para>When &knode; is completely and correctly configured, the news +servers and the subscribed news groups will appear there.</para> + +<para>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.</para> + +<para>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 +<quote>Quickstart</quote> 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.</para> + +<sect2 id="setting-your-identity"> +<title>Personal settings</title> + +<anchor id="anc-setting-your-identity"/> + +<para>Via +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure +KNode...</guimenuitem></menuchoice> you will enter the preferences +dialog of &knode;. The figure shows the dialog.</para> + +<screenshot> +<screeninfo>Dialog for entering personal information</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-identity.png" format="PNG"/></imageobject> +<textobject> +<phrase>Entering personal information</phrase> +</textobject> +<caption> +<para>Entering personal information</para></caption> +</mediaobject> +</screenshot> + +<para>The dialog is divided into two parts: in one part there is a treeview, in +which the top entry <guilabel>Identity</guilabel> 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.</para> + +<tip> +<para>If you have already configured your personal settings in the +&kcontrolcenter; before the first start of &knode;, they will be +adopted.</para> +</tip> + +<sect3> +<title><guilabel>Name</guilabel></title> + +<para>In the field <guilabel>Name</guilabel> you enter your name, ⪚ +<replaceable>Joe Miller</replaceable> or <replaceable>Mary +Gordon</replaceable>. This name will later appear in the newsgroups as +sender, and can be seen by anyone.</para> + +<para>Filling out the field <guilabel>Name</guilabel> is +mandatory.</para> + +<caution> +<para> +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.</para> +</caution> + +<tip> +<para>For those special cases, &knode; offers settings that can be +adjusted to each newsgroup individually; further information can be +found under <link linkend="group-identity">Group local +Identities</link>.</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Organization</guilabel></title> + +<para>The input field <guilabel>Organization</guilabel> 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.</para> +</sect3> + +<sect3> +<title><guilabel>Email address</guilabel></title> + +<para>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 <guilabel>Name</guilabel>).</para> + +<para>The field <guilabel>Email Address</guilabel> 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.</para> + +<para>Filling out the <guilabel>Email Address</guilabel> field is +mandatory.</para> +<tip> +<para>Note that the e-mail address will only be used for replies to you if +the field <guilabel>Reply-to Address</guilabel> is not filled out; in +this case, the field <guilabel>Email</guilabel> will be ignored for +replies and the address given under <guilabel>Reply-to +Address</guilabel> will be used.</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Reply-to Address</guilabel></title> + +<para><guilabel>Reply-to Address</guilabel> 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 <guilabel>Reply-to +Address</guilabel> 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.</para> + +<para>Only enter an e-mail address in that field if it actually +differs from the field <guilabel>Email Address</guilabel>.</para> + +<warning> +<para>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.</para> +</warning> +</sect3> + +<sect3> +<title><guilabel>Mail-Copies-To</guilabel></title> + +<para>If you enter an email address here every article will be sent +to the usenet and to this email address.</para> +</sect3> + +<sect3> +<title><guilabel>Signing Key</guilabel></title> + +<para>If you have configured the use of <acronym>PGP</acronym> or +GnuPG you can chose your signing key with +<guibutton>Change...</guibutton>. </para> +</sect3> + +<sect3> +<title><guilabel>Use a signature from file</guilabel></title> + +<para>If this option is selected, the file specified under +<guilabel>Signature File</guilabel> will be used as Signature.</para> +</sect3> + +<sect3> +<title><guilabel>Signature File</guilabel></title> + +<para>The field <guilabel>Signature File</guilabel> determines the +file, the content of which is appended to each of your articles. The +field is only enabled if the option <guilabel>Use a signature from +file</guilabel> is selected.</para> + +<para>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.</para> + +<para>You can directly enter the file name of the signature file but +it is more convenient to use the button +<guibutton>Choose...</guibutton>. This opens a file open dialog and +you can conveniently choose the signature file with the mouse. The +button <guibutton>Edit File</guibutton> enables you, after choosing +the file, to edit the signature.</para> + +<tip> +<para>It is not necessary to include a separation line in the +signature file as &knode; inserts it automatically.</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>The file is a program</guilabel></title> + +<para>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.</para> + +</sect3> + +<sect3> +<title><guilabel>Specify signature below</guilabel></title> + +<para>If this option is selected you can enter the text of the +signature directly in the input field below.</para> + +<tip> +<para>Please make sure that in this case also your +<glossterm>signature</glossterm> should not contain more than 4 +lines. A separation line is not necessary as &knode; inserts it +automatically.</para> +</tip> +</sect3> + +<sect3> +<title>General notes</title> + +<para>You can later adapt the identity individually for each of the +subscribed groups via the <guilabel>Preferences</guilabel> 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.</para> + +<para>You find more in the section <link +linkend="group-identity">Group local identities</link>.</para> + +<para>The next step in the configuration covers the news +account.</para> + +</sect3> +</sect2> + +<sect2 id="setting-the-news-account"> +<title>Configuring the news account</title> +<anchor id="anc-setting-the-news-account"/> + +<para>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 <guilabel>Accounts</guilabel> entry; click on it +with the mouse; then, two sub entries will be opened out. Choose the +<guilabel>News</guilabel> entry, because we first want to configure +the news account: the list of accounts is still empty.</para> + +<para>To create a new account click on <guibutton>New...</guibutton>. The +following dialog appears:</para> + +<screenshot> +<screeninfo>The <guilabel>New Account</guilabel> dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-news-account.png" format="PNG"/></imageobject> +<textobject> +<phrase>The <guilabel>New Account</guilabel> dialog</phrase> +</textobject> +<caption> +<para>The <guilabel>New Account</guilabel> dialog</para> +</caption> +</mediaobject> +</screenshot> + +<sect3> +<title><guilabel>Name</guilabel></title> + +<para>The <guilabel>Name</guilabel> 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 <userinput>My News Account</userinput>.</para> + +</sect3> + +<sect3> +<title><guilabel>Server</guilabel></title> + +<para>The next field is labelled <guilabel>Server</guilabel>. Unlike +the field <guilabel>Name</guilabel>, 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.)</para> + +<para>For our example configuration we enter the name +<userinput><systemitem +class="systemname">news.server.com</systemitem></userinput>; you will, +of course, enter the real name of your news server.</para> + +<tip> +<para>If you want to use &knode; with a local news server, enter the name +<userinput><systemitem +class="systemname">localhost</systemitem></userinput> here.</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Port</guilabel></title> + +<para><guilabel>Port</guilabel>, 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.</para> +</sect3> + +<sect3> +<title><guilabel>Hold connection for</guilabel></title> + +<para>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.</para> + +<tip> +<para>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 <quote>anything</quote> 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.</para> +<para> If the waiting time is set too high you might waste online +time whilst doing nothing (perhaps increasing your phone bill).</para></tip> +</sect3> + +<sect3> +<title><guilabel>Timeout</guilabel></title> + +<para>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.</para> + +<tip> +<para>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.</para> +</tip> +</sect3> + +<sect3> +<title> +<guilabel>Fetch group descriptions</guilabel></title> + +<para>If this setting is selected, &knode; additionally requests the +available group descriptions; they will be displayed in the +<guilabel>Subscribe to Newsgroups</guilabel> dialog.</para> + +<tip> +<para>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.</para> +</tip> + +</sect3> + +<sect3> +<title><guilabel>Server requires authentication</guilabel></title> + +<para>The option <guilabel>Server requires authentication</guilabel> +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.</para> + +<tip> +<para>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 <guilabel>User</guilabel> and the associated password +under <guilabel>Password</guilabel>.</para> +</tip> +</sect3> + +<sect3> +<title>General notes</title> + +<para>By now you have completed the setup of your news account. You can +confirm and save your settings by clicking on the +<guibutton>OK</guibutton> button: as soon as you have done that, +the account will appear in the list by the name that you entered in +<guilabel>Name</guilabel> earlier; and, if you have a close look, you +will see that the account also appears in the folder view.</para> + +<para>Using the <guibutton>Subscribe</guibutton> 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.</para> + +<para>In the <link linkend="multiple-news-accounts"> Managing +multiple news accounts</link> 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.</para> + +<caution> +<para>Please note that some Internet providers only allow retrieving +news from their news server if you are connected to the Internet +through them.</para> +</caution> + +<para>We will now move on to configuring the email account; in order +to do that, click on the <guilabel>Mail</guilabel> entry in the tree +view on the left.</para> + +</sect3> +</sect2> + +<sect2 id="setting-the-mail-account"> +<title>Setting up the mail account</title> + +<para>After selecting <guilabel>Mail</guilabel> in the tree view, the +following dialog box appears.</para> + +<screenshot> +<screeninfo>Dialog box for setting up the mail account</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-mail-account.png" format="PNG"/></imageobject> +<textobject> +<phrase>Setting up the mail account</phrase> +</textobject> +<caption> +<para>Setting up the mail account</para> +</caption> +</mediaobject> +</screenshot> + +<para>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?</para> + +<para>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.</para> + +<para>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.</para> + +<sect3> +<title><guilabel>Use external mail program</guilabel></title> + +<para>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.</para> + +</sect3> + +<sect3> +<title><guilabel>Server</guilabel></title> + +<para>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 <guilabel>Server</guilabel> field.</para> + +<para>In our example we enter<userinput><systemitem +class="systemname">mail.server.de</systemitem></userinput></para> + +<tip> +<para>If you have one you can send your mail via a local mail +server; if this is the case local mail server enter <systemitem +class="systemname">localhost</systemitem> in the +<guilabel>Server</guilabel> field.</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Port</guilabel></title> + +<para>Again, the <guilabel>Port</guilabel> field has a default +value; in this case it's port 25. You should not need to change this, +unless your <acronym>ISP</acronym> has a very exotic configuration +and tells you to do so. We do not change this for the example.</para> + +</sect3> + +<sect3> +<title>Hold connection for</title> + +<para>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.</para> + +</sect3> + +<sect3> +<title><guilabel>Timeout</guilabel></title> + +<para>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.</para> + +<tip> +<para>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.</para> +</tip> +</sect3> + +<sect3> +<title>General notes</title> + +<caution> +<para>Some <acronym>ISP</acronym>s only allow you to send email using +their mail server after you have checked your mailbox for new mail: this +reduces spamming.</para> + +<para>For the same reasons, some <acronym>ISP</acronym>s 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.</para> +</caution> + +</sect3> +</sect2> + +<sect2 id="knode-appearance"> +<title>Defining the appearance</title> + +<para>With the <guilabel>Appearance</guilabel> 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.</para> + +<screenshot> +<screeninfo>Setting up the Appearance dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-colors-fonts.png" format="PNG"/></imageobject> +<textobject> +<phrase>Setting up the Appearance dialog</phrase> +</textobject> +<caption> +<para>Setting up the Appearance dialog</para> +</caption> +</mediaobject> +</screenshot> + +<sect3> +<title><guilabel>Use custom colors</guilabel></title> + +<para>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.</para> + +<para>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.</para> + +<caution> +<para>If the <guilabel>Use custom colors</guilabel> 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.</para> +</caution> +</sect3> + +<sect3> +<title><guilabel>Use custom fonts</guilabel></title> + +<para>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.</para> + +<para>The font can only be configured after the checkbox has been +checked; otherwise, a double click on the list entries won't do +anything.</para> + +<caution> +<para>If the setting <guilabel>Use custom fonts</guilabel> is +selected &knode; won't use later changes to the global font settings +for &kde; but will use the fonts defined here instead.</para> +</caution> +</sect3> + +</sect2> + +<sect2 id="setting-news-general"> +<title>General News Settings</title> + +<para>Now click on <guibutton>Reading news</guibutton> and then on the +<guibutton>General</guibutton> sub-entry; the figure below shows the dialog +containing the preferences you can configure there.</para> + +<screenshot> +<screeninfo><guilabel>General Preferences</guilabel> dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-read-news-settings.png" format="PNG"/></imageobject> +<textobject> +<phrase>The <guilabel>General Preferences</guilabel> dialog</phrase> +</textobject> +<caption> +<para>The <guilabel>General Preferences</guilabel> dialog</para> +</caption> +</mediaobject> +</screenshot> + +<para>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;.</para> + +<sect3> +<title><guilabel>Check for new articles +automatically</guilabel></title> + +<para>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.</para> + +<para>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.</para> + +<para>If you want to keep control over when a connection to the server +is established, the +<menuchoice><guimenu>Group</guimenu><guimenuitem>Get new +articles</guimenuitem></menuchoice> menu option is appropriate.</para> + +</sect3> + +<sect3> +<title><guilabel>Maximal number of articles to fetch</guilabel></title> + +<para>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.</para> + +<warning> +<para>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.</para> +</warning> +</sect3> + +<sect3> +<title><guilabel>Mark article as read after</guilabel></title> + +<para>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.</para> + +</sect3> + +<sect3> +<title><guilabel>Mark crossposted articles as read</guilabel></title> + +<para>Sometimes an <glossterm>article</glossterm> 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.</para> + +</sect3> + +<sect3> +<title><guilabel>Smart scrolling</guilabel></title> + +<para>If this option is selected the lines in the article list are +scrolled smoothly instead of jerkily. +</para> <!-- LW: FIXME could be explained a tiny bit better --> + +</sect3> + +<sect3> +<title><guilabel>Show whole thread on expanding</guilabel></title> + +<para>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.</para> + +</sect3> + +<sect3> +<title><guilabel>Default to expanded threads</guilabel></title> + +<para>Here you can toggle whether the threads are expanded by default or +not.</para> + +</sect3> + +<sect3> +<title><guilabel>Show article score</guilabel></title> + +<para>Here you can toggle whether the scoring column should be shown +in the article view.</para> + +</sect3> + +<sect3> +<title><guilabel>Show line count</guilabel></title> + +<para>Here you can toggle whether the column with the number of lines +should be shown in the article view.</para> + +</sect3> + +<sect3> +<title><guilabel>Cache size for headers</guilabel></title> + +<para>Here you can configure how much memory &knode; should use for +the caching of the headers.</para> + +</sect3> + +<sect3> +<title><guilabel>Cache size for articles</guilabel></title> + +<para>Here you can configure, how much memory &knode; should use for +the caching of the articles.</para> + +</sect3> +</sect2> + +<sect2> +<title><guilabel>Navigation</guilabel></title> + +<para>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.</para> + +<sect3> +<title><guilabel>General</guilabel></title> + +<para>The keyboard behavior between &knode; and &kmail; is a bit +different; with the <guilabel>Emulate the keyboard behavior of +KMail</guilabel> switch you can activate the same keyboard behavior +as in &kmail; for &knode;.</para> + +</sect3> + +<sect3> +<title><guilabel>Mark All as Read</guilabel></title> + +<para>If the box <guilabel>Switch to next group</guilabel> is checked, +&knode; automatically switches to the next group if you mark all +articles as read.</para> +</sect3> + +<sect3> +<title><guilabel>Mark Thread as Read</guilabel></title> + +<para>If <guilabel>Close the current thread</guilabel> is +checked, &knode; automatically closes a thread if you mark +it as read.</para> + +<para>If <guilabel>Go to next unread thread</guilabel> is +checked, &knode; automatically shows the next thread if you mark the +the previous thread as read.</para> + +</sect3> + +<sect3> +<title><guilabel>Ignore Thread</guilabel></title> + +<para>If <guilabel>Close the current thread</guilabel>is +checked, &knode; automatically closes a thread if you choose to +ignore it.</para> + +<para>If <guilabel>Go to next unread thread</guilabel> is +checked, &knode; automatically shows the next thread if you choose +to ignore the previous one.</para> + +</sect3> +</sect2> + +<sect2 id="knode-scoring-settings"> +<title>Scoring rules</title> + +<para>To sort the articles you have the possibility to score them. The +standard score is 0: a higher score means that the +<glossterm>article</glossterm> is interesting; a lower score means +it is less interesting.</para> + +<para>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.</para> + +<para>With the buttons below the list of scoring-rules you can +<guibutton>edit</guibutton>, <guibutton>add</guibutton>, +<guibutton>remove</guibutton> and <guibutton>copy</guibutton> a +rule. We will skip this feature for now, because it is not essential +for the setup of &knode;.</para> + +<para>You can learn more about scoring; in the chapter <link +linkend="anc-score-watch-ignore">Scoring, watching and +ignoring</link>.</para> + +<sect3> +<title><guilabel>Default score for ignored threads</guilabel></title> + +<para>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 +<menuchoice><guimenu>Scoring</guimenu><guimenuitem>Ignore +Thread</guimenuitem></menuchoice> 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.</para> + +</sect3> + +<sect3> +<title><guilabel>Default score for watched threads</guilabel></title> + +<para>If an article is interesting, it will get a score above 0. Here +you can enter the default score for those articles; choosing the +<menuchoice><guimenu>Scoring</guimenu><guimenuitem>Watch +Thread</guimenuitem></menuchoice> 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.</para> + +<tip> +<para>You can use the <keycap>W</keycap> key to watch a thread or the +<keycap>I</keycap> key to ignore it.</para> +</tip> +</sect3> +</sect2> + +<sect2 id="knode-filter-settings"> +<title>Filter settings</title> + +<para>This screenshot shows the filter settings.</para> + +<screenshot> +<screeninfo>The filter settings</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-filters.png" format="PNG"/></imageobject> +<textobject> +<phrase>The filter settings</phrase> +</textobject> +<caption> +<para>The filter settings</para> +</caption> +</mediaobject> +</screenshot> + +<para>This dialog shows two lists. The upper list, labeled <guilabel> +Filters</guilabel>, shows all defined filters; when you use &knode; +for the first time, you will only see the predefined filters.</para> + +<para>With the buttons <guibutton>Add</guibutton>, +<guibutton>Delete</guibutton>, <guibutton>Edit</guibutton> and +<guibutton>Copy</guibutton> 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;.</para> + +<para>You can find more-detailed information about filters in <link +linkend="using-filters">Defining and using filters</link>.</para> + +<para>The lower list, labeled <guilabel>Menu</guilabel>, shows the +appearance of the <menuchoice><guimenu>View</guimenu> +<guisubmenu>Filter</guisubmenu></menuchoice> menu, which you can reach from +the menu bar; the order of the filters in the this menu can be +configured in this list.</para> + +<para>The <guibutton>Up</guibutton> button shifts the selected filter +one position up. Try it: select the second filter and press +<guibutton>Up</guibutton>; this entry will then go up one position.</para> + +<para>The <guibutton>Down</guibutton> button does the opposite +action: select the filter you just shifted one up and +press<guibutton>Down</guibutton> until it reaches its old +position.</para> + +<para>With the two buttons <guibutton>Add Separator</guibutton> and +<guibutton>Remove Separator</guibutton> you can visually group +the filters on the menu. The separators are shown as <literal>====</literal> +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 <guibutton>Remove +separator</guibutton>.</para> + +<para>Any changes you make here, you can see in +<menuchoice><guimenu>View</guimenu><guisubmenu>Filter</guisubmenu></menuchoice> +after closing this dialog.</para> + +</sect2> + +<sect2 id="knode-headers"> +<title><guilabel>Customize displayed article headers</guilabel></title> + +<anchor id="anc-knode-headers"/> + +<para>In this dialog you can set how the single header lines are +displayed in the article window.</para> + +<screenshot> +<screeninfo>The <guilabel>Customize displayed article +headers</guilabel> dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-header-settings.png" format="PNG"/></imageobject> +<textobject> +<phrase>The <guilabel>Customize displayed article +headers</guilabel> dialog</phrase> +</textobject> +<caption> +<para>The <guilabel>Customize displayed article +headers</guilabel> dialog</para> +</caption> +</mediaobject> +</screenshot> + +<para>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 +<guilabel>From</guilabel> the From header line will be used (indicating +who send the message).</para> + +<para>Using <guibutton>Edit</guibutton> 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 +<guilabel>From:<From></guilabel> entry in the list and open the dialog +for editing the header display by clicking on +<guibutton>Edit</guibutton>.</para> + +<screenshot> +<screeninfo>The Header Properties dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-edit-header1.png" format="PNG"/></imageobject> +<textobject> +<phrase>The Header Properties dialog</phrase> +</textobject> +<caption> +<para>The Header Properties dialog</para> +</caption> +</mediaobject> +</screenshot> + +<sect3> +<title><guilabel>Header</guilabel></title> + +<para>The <guilabel>Header</guilabel> selection box shows the entry +<guilabel>From</guilabel>: 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 <guilabel>From</guilabel> identifier +configured; we'll work with this list later, when we add a header line +to the display.</para> +</sect3> + +<sect3> +<title><guilabel>Displayed Name</guilabel></title> + +<para>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 <guilabel>From</guilabel> header line the +label <guilabel>From</guilabel> 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 <guilabel>Subject</guilabel> +header line. We won't change anything here either, for now.</para> + +</sect3> + +<sect3> +<title><guilabel>Name</guilabel></title> + +<para>Here you can influence the way the 'Displayed Name' +text is displayed; in our case, the <guilabel>Bold</guilabel> attribute +is selected for the name <guilabel>From</guilabel>, &ie; the text will +be shown in bold letters in the article window. Of course, you can +combine different attributes, for example <guilabel>Bold</guilabel> +and <guilabel>Underlined</guilabel>.</para> + +</sect3> + +<sect3> +<title>Value</title> + +<para>Here you can influence the way the header text is displayed +in the article window; for example, if the +<guilabel>Italic</guilabel> entry is selected the sender, ⪚ <quote>John Doe +<johndoe@doubleguns.com></quote> will appears in an italic +font.</para> + +</sect3> + +<sect3> +<title>Add and remove header lines to the display</title> + +<para>To explain the possibilities of this dialog to you we're going +to add a new header line to the display.</para> + +<example> +<title>Show the newsreader used for a post in the article window</title> + +<para>This pictures shows the dialog with the header line +<literal>X-Newsreader</literal>.</para> +<screenshot> +<screeninfo>The Header Properties dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-edit-header2.png" format="PNG"/></imageobject> +<textobject> +<phrase>The Header Properties dialog</phrase> +</textobject> +<caption> +<para>The Header Properties dialog</para> +</caption> +</mediaobject> +</screenshot> + +<para>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.</para> + +<para>Drop down the <guilabel>Header</guilabel> selection field and +select the <guilabel>X-Newsreader</guilabel> entry from the +list.</para> + +<para>In the <guilabel>Displayed name</guilabel> field, enter +<userinput>Newsreader</userinput>.</para> + +<para>Now you can select any attribute for the display of the field +and its content; next, acknowledge your input with the +<guibutton>OK</guibutton>: the new header line appears now in the list +and will later be shown in the article window.</para> + +</example> + +<para>Use the <guibutton>up</guibutton> and +<guibutton>Down</guibutton> buttons to arrange the order of the +headers in the article window.</para> + +<tip> +<para>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 <ulink +url="http://www.kirchwitz.de/~amk/dni/headerzeilen">http://www.kirchwitz.de/~amk +/dni/headerzeilen</ulink> +(german)</para> +</tip> +</sect3> +</sect2> + +<sect2> +<title><guilabel>Viewer</guilabel></title> + +<sect3> +<title><guilabel>Show fancy header decorations</guilabel></title> + +<para>If this is active, the headers will be 'beautified' a +bit; otherwise, only the plain text is shown.</para> + +</sect3> + +<sect3> +<title><guilabel>Rewrap text when necessary</guilabel></title> + +<para>If this option is active, the text wrapping in the viewer will +be automatically corrected.</para> + +</sect3> + +<sect3> +<title><guilabel>Remove trailing empty lines</guilabel></title> + +<para>If this is active empty lines at the end of the article will +be automatically hidden.</para> + +</sect3> + +<sect3> +<title><guilabel>Show signature</guilabel></title> + +<para>If this setting is activated, the +<glossterm>signature</glossterm> of the sender is displayed in the +article window; if it isn't, the signature is surpressed.</para> + +<caution> +<para>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 <quote>-</quote> characters followed by a +<quote> </quote> (space) is correct.</para> +</caution> + +<tip> +<para>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.</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Interpret text-format tags</guilabel></title> + +<para>If this is active, all text format tags in the message like +<literal>*bold*</literal>, <literal>/italic/</literal> and +<literal>_underline_</literal> are shown directly in the viewer. These +text-format tags are an unofficial standard.</para> + +</sect3> + +<sect3> +<title><guilabel>Recognize quote characters</guilabel></title> + +<para>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 <quote>></quote> 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.</para> + +</sect3> + +<sect3> +<title><guilabel>Show attachments inline if +possible</guilabel></title> + +<para>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.</para> + +<para>Additionally, you have the possibility to save the attachment or +open it with the application you have associated with the +<acronym>MIME</acronym> type of the attachment by using the context +menu.</para> + +</sect3> + +<sect3> +<title><guilabel>Open attachments on click</guilabel></title> + +<para>If this box is checked, attachments are opened with the external +program which is configured for the <acronym>MIME</acronym> 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.</para> + +</sect3> + +<sect3> +<title><guilabel>Show alternative contents as +attachments</guilabel></title> + +<para>Articles which are sent as Multipart <acronym>MIME</acronym> +contain the text of the message in multiple formats, for example as +raw text and <acronym>HTML</acronym>; 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.</para> + +<para>If this setting is disabled, alternative contents are not +displayed.</para> + +</sect3> + +<sect3> +<title><guilabel>Open links with</guilabel></title> + +<para>Here you can select which browser is used for displaying links +you clicked on in a message. Currently, you can either select the +<application>Netscape Navigator</application> or the default, +&konqueror;; the selected browser has to be installed, of +course.</para> + +</sect3> +</sect2> + +<sect2 id="knode-post-news-settings"> +<title>Settings for publishing articles</title> + +<para>When you post articles with &knode; the settings in the +following dialog box are used.</para> + +<screenshot> +<screeninfo>The Technical Settings dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-post-settings.png" format="PNG"/></imageobject> +<textobject> +<phrase>The Technical Settings dialog</phrase> +</textobject> +<caption> +<para>The Technical Settings dialog</para> +</caption> +</mediaobject> +</screenshot> + +<caution> +<para>If you choose the wrong settings here your articles could be +unreadable or not sendable at all, so please be careful with these +settings.</para> +</caution> + +<sect3> +<title><guilabel>Charset</guilabel></title> + +<para>Here you can choose the charset used for encoding your +articles. Normally this is <acronym>US-ASCII</acronym> 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.</para> + +<para>When you want to post articles in newsgroups with other charsets +(⪚ eastern European or Asian) you can set the required charset +here.</para> + +</sect3> + +<sect3> +<title><guilabel>Encoding</guilabel></title> + +<para>Here you set the encoding of the characters for the message +transfer; you can choose between 8-bit and 7-bit +(quoted-printable).</para> + +<para>If you choose 8-bit encoding most special characters are +transfered correctly; this is, for example, the normal option for the +German groups (de.*).</para> + +<para>If you choose quoted-printable 8-bit characters (⪚ German +umlauts or special characters) are send as encoded 7-bit +characters.</para> + +<tip> +<para>In the English newsgroups 7-bit encoding is quite +normal.</para> +</tip> + +</sect3> + +<sect3> +<title><guilabel>Use own default charset when +replying</guilabel></title> + +<para>If this option is active, &knode; uses your default charset for +replying instead of the charset of the article you're answering +on.</para> + +</sect3> + +<sect3> +<title><guilabel>Generate Message-ID</guilabel></title> + +<para>When this is active, &knode; generates its own Message-IDs for +all articles you post.</para> + +<caution> +<para>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.</para> + +<para>A Message-ID consists of a valid <acronym>FQDN</acronym> (Full +Qualified Domain Name); this means it looks similar to an email +address with an identification before the <literal>@</literal> and the +domain.</para> + +<para>The identification is generated by &knode; automatically, but +you must provide a valid domain name in <guilabel>Hostname</guilabel>; +if you do not have your own domain, you should not activate this +option — let the newsserver generate a Message-ID for you.</para> + +<example> +<title>Message-ID</title> + +<para>An example for a valid domain would be: +<literal>kde.org</literal>; a Message-ID generated with this domain +would look like:</para> + +<screen>934lek9934@kde.org</screen> +</example> + +<para>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, <application>leafnode</application> generates +a Message-ID which it derives from the local hostname.</para> + +</caution> + +<tip> +<para>You can get more information about this and how to own a free domain at +<ulink +url="http://www.qad.org/faq/faq-messageid.html">http://www.qad.org/faq/faq- +messageid.html</ulink>.</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Hostname</guilabel></title> + +<para>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: +<userinput>kde.org</userinput>.</para> + +</sect3> + +<sect3> +<title><guilabel>X-Headers</guilabel></title> + +<para>Here you can enter X-Headers which are not provided by &knode;; +for example, <userinput>X-No-Archive: yes</userinput>, which can be +used to prevent your articles from being archived by archive services +such as Google.</para> + +<para>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 <quote>X-</quote> prefix.</para> + +</sect3> + +<sect3> +<title><guilabel>Don't add the "User-Agent" identification +header</guilabel></title> + +<para>When this option is checked &knode; does not include the +corresponding line in the Header before posting.</para> + +<para>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.</para> +</sect3> +</sect2> + +<sect2 id="knode-composer-settings"> +<title>The Composer Settings</title> + +<screenshot> +<screeninfo>The Composer Settings dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-composer-settings.png" format="PNG"/></imageobject> +<textobject> +<phrase>The Composer Settings dialog</phrase> +</textobject> +<caption> +<para>The Composer Settings dialog</para> +</caption> +</mediaobject> +</screenshot> + +<sect3> +<title><guilabel>Word-wrap at column</guilabel></title> + +<para>Here you can set the column number at which &knode; wraps the +line; also, you can deactivate the automatic word-wrapping +completely.</para> + +<tip> +<para>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.</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Append signature automatically</guilabel></title> + +<para>When you write a new <glossterm>article</glossterm> or a +<glossterm>followup</glossterm>, your <glossterm>signature</glossterm> +is appended automatically if you have configured one in +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure +KNode...</guimenuitem><guilabel>Identity</guilabel></menuchoice>.</para> + +</sect3> + +<sect3> +<title><guilabel>Introduction Phrase:</guilabel></title> + +<para>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.</para> + +<para>The following variable are available:</para> + +<variablelist> +<varlistentry> +<term><varname>%NAME</varname></term> +<listitem> +<para>The name of the original author;</para> +</listitem> +</varlistentry> +<varlistentry> +<term><varname>%DATE</varname></term> +<listitem> +<para>The date on which the original article was written;</para> +</listitem> +</varlistentry> +<varlistentry> +<term><varname>%EMAIL</varname></term> +<listitem> +<para>The original author's email address;</para> +</listitem> +</varlistentry> +<varlistentry> +<term><varname>%MSID</varname></term> +<listitem> +<para>The Message-ID of the original article;</para> +</listitem> +</varlistentry> +<varlistentry> +<term><varname>%GROUP</varname></term> +<listitem> +<para>The name of the <glossterm>newsgroup</glossterm>the article +comes from.</para> +</listitem> +</varlistentry> +</variablelist> + +<tip> +<para>Keep this short, because this introductory line appears in +every followup: a long introductory line can be as repelling as +a long signature.</para> +</tip> + +<example> +<title>An example introductory line</title> + +<screen><userinput>On <varname>%DATE</varname> <varname>%NAME</varname> wrote in +<varname>%MSID</varname></userinput></screen> + +<para>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.</para> + +<screen><computeroutput>On Sat, 17 Jun 2000 17:42:32 +0200 Konqui wrote in +<8igdg5.3vvijgt.3@lizard.physos.com>:</computeroutput></screen> + +</example> +</sect3> + +<sect3> +<title><guilabel>Rewrap quoted text automatically</guilabel></title> + +<para>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.</para> + +</sect3> + +<sect3> +<title><guilabel>Include the author's signature</guilabel></title> + +<para>When this is activated not only the text of the original +message, but also the signature of the author, is quoted in a +reply.</para> + +<tip> +<para>Quoting a signature is unnecessary and is often considered +impolite.</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Put the cursor below the introduction +phrase</guilabel></title> + +<para>Normally the cursor will appear below the whole message when +answering; with this option turned on the cursor appears below the +introduction phrase.</para> + +<tip> +<para>This is especially helpful if you quote an article and wish to +write between the quoted lines from top to bottom.</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Define external editor</guilabel></title> + +<para>You can define an external editor here which is opened by +selecting <menuchoice><guimenu>Tools</guimenu><guimenuitem>Start +external editor</guimenuitem></menuchoice> in the Composer +window.</para> + +<para>When <guilabel>Start external editor automatically</guilabel> is +checked the external editor is opened directly.</para> + +<caution> +<para>Notice the <varname>%f</varname> 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.</para> +</caution> + +<tip> +<para>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 +<application>gvim</application> is an example for this; you can +disable the forking of <application>gvim</application> with the +commandline switch <option>-f</option>. It is recommended that you refer to +the documentation of your editor you are experiencing this problem.</para> + +<para>If you want to use <application>gvim</application> in +<guilabel>Specify Editor</guilabel> enter the following:</para> + +<para> +<userinput> +gvim -f %f</userinput> +</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Start external editor +automatically</guilabel></title> + +<para>If this option is active the external editor will be used for +editing articles.</para> + +</sect3> +</sect2> + +<sect2> +<title><guilabel>Spelling</guilabel></title> + +<para>Here you can configure the behavior of the spell +checker.</para> + +<sect3> +<title><guilabel>Create root/affix not in +dictionary</guilabel></title> + +<para>If this is checked a known word-root with an unknown affix will +be automatically accepted as a new word.</para> + +</sect3> + +<sect3> +<title><guilabel>Consider run-together words as spelling +errors</guilabel></title> + +<para>Here you can toggle if two known words that run together to form an +unknown word should be treated as an error or +not.)</para> + +</sect3> + +<sect3> +<title><guilabel>Dictionary</guilabel></title> + +<para>Here you chose the dictionary the spell-checker should +use.</para> + +</sect3> + +<sect3> +<title><guilabel>Encoding</guilabel></title> + +<para>Here you can tell &knode; which encoding should be used for +spell checking; for English text this should normally be +<acronym>US-ASCII</acronym>.</para> + +</sect3> + +<sect3> +<title><guilabel>Client</guilabel></title> + +<para>Here you can switch between the spell-checkers; you can use +<application>International Ispell</application> or +<application>Aspell</application>.</para> + +</sect3> + +</sect2> + +<sect2> +<title><guilabel>Signing and verifying</guilabel></title> + +<para>Here you can configure &knode; for signing articles with +<application>GnuPG</application> or +<application>PGP</application>. Your +<application>GnuPG</application>/<application>PGP</application> +<acronym>ID</acronym> will be built automatically from your configured +name and email address; it is identical to the from line in the +header of the <glossterm>article</glossterm>.</para> + +<sect3> +<title><guilabel>Encryption tool</guilabel></title> + +<para>Here you can choose your encryption tool.</para> + +</sect3> + +<sect3> +<title><guilabel>Keep passphrase in memory</guilabel></title> + +<para>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.</para> + +</sect3> + +<sect3> +<title><guilabel>Show ciphered/signed text after +composing</guilabel></title> + +<para>If this option is activated &knode; will show the signed message in +an extra window for confirmation before changing it in the +editor.</para> + +</sect3> + +<sect3> +<title>Always show the encryption keys for approval</title> + +<para>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.</para> +<!-- FIXME: LW - I can see use for --> +<!-- encryption, on private networks etc. This needs a rewrite --> +<!-- AndrewColes: is this revision any better? --> +</sect3> + +<sect3> +<title><guilabel>Check signatures automatically</guilabel></title> + +<para>If this is marked, the <application>PGP</application> 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 <menuchoice><guimenu>View</guimenu><guimenuitem>Verify +PGP-Signature</guimenuitem></menuchoice> menu entry.</para> + +</sect3> + +</sect2> + + +<sect2 id="knode-article-cleanup"> +<title>The article-cleanup settings.</title> + +<para>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.</para> + +<caution> +<para>&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 +<application>leafnode</application>, you should refer to its +documentation to handle expiring the articles on the server — +&knode; cannot do this for you.</para> +</caution> + +<screenshot> +<screeninfo>The cleanup settings</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="knode-cleanup.png" format="PNG"/></imageobject> +<textobject> +<phrase>The cleanup settings</phrase> +</textobject> +<caption> +<para>The cleanup settings</para> +</caption> +</mediaobject> +</screenshot> + +<sect3> +<title><guilabel>Expire old articles automatically</guilabel></title> + +<para>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.</para> + + +<tip> +<para>You can force this check by selecting +<menuchoice><guimenu>Group</guimenu><guimenuitem>Expire +group</guimenuitem></menuchoice></para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Purge groups every</guilabel></title> + +<para>Here you can configure how often subscribed groups should be +checked for old <glossterm>article</glossterm>s and how often those +articles should be deleted; this option only has an effect when +<guilabel>Expire old articles automatically</guilabel> is +selected.</para> + +</sect3> + +<sect3> +<title><guilabel>Keep read articles</guilabel></title> + +<para>Read articles are deleted by the next cleanup if they are older +than this value; &knode; uses the creation date for this.</para> + +</sect3> + +<sect3> +<title><guilabel>Keep unread articles</guilabel></title> + +<para>Unread articles are deleted by the next cleanup if they are +older than this value; &knode; uses the creation date for this.</para> + +</sect3> + +<sect3> +<title><guilabel>Remove articles that are not available on the +server</guilabel></title> + +<para>It may happen that you'll see a <glossterm>header</glossterm> in +&knode; but the article is not available on the server; if this option +is set, those articles will automatically deleted in &knode;.</para> + +</sect3> + +<sect3> +<title><guilabel>Preserve threads</guilabel></title> + +<para>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.</para> + +<para>This prevents old articles in a long thread from vanishing before +the discussion has ended.</para> + +<caution> +<para>&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.</para> +</caution> +</sect3> + +<sect3> +<title><guilabel>Compact folders automatically</guilabel></title> + +<para>This option refers to the memory behavior of &knode;. If an +<glossterm>article</glossterm> 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.</para> + +<tip> +<para>You can force this check by selecting +<menuchoice><guimenu>Folder</guimenu><guimenuitem>Compact +folder</guimenuitem></menuchoice> or for all folders together with +<menuchoice><guimenu>Folder</guimenu><guimenuitem>Compact all +folders</guimenuitem></menuchoice>.</para> +</tip> +</sect3> + +<sect3> +<title><guilabel>Purge folders every</guilabel></title> + +<para>Here you can configure how often the folder is checked for +deleted articles; this option only has an effect if the +<guilabel>Compact folders automatically</guilabel> is set.</para> +</sect3> +</sect2> + +</sect1> |