runtime/doc/userguide/usenet.docbook

   1 <chapter id="usenet">
   2 <!-- Uncomment the <*info> below and add your name to be -->
   3 <!-- credited for writing this section. -->
   4
   5 <!--
   6 <chapterinfo>
   7 <authorgroup>
   8 <author>
   9 <firstname>Your First Name here</firstname>
  10 <surname>Your Surname here </surname>
  11 </author>
  12 </authorgroup>
  13 </chapterinfo>
  14 -->
  15
  16 <title>Usenet News</title>
  17
  18 <para>Usenet newsgroups are forums in which you can post messages to discuss
  19 various topics: almost any subject you like (and many you don't!) can
  20 be found there. Although usenet has become less popular than it once
  21 was, because of the increasing use of web forums, &etc;, it is still a
  22 useful tool. &kde; provides a powerful usenet news reader called &knode;.</para>
  23
  24 <para>You can find &knode; in the <guimenu>K</guimenu> Menu under the
  25 <guisubmenu>Internet</guisubmenu> entry: the menu entry
  26 <guimenuitem>&knode; (News Reader)</guimenuitem> launches the program.</para>
  27
  28
  29 <para>The main window of &knode; should now be displayed on your
  30 desktop as shown; on the first start, the settings dialog will be
  31 invoked.</para>
  32
  33 <screenshot>
  34 <screeninfo>Setting up &knode;</screeninfo>
  35 <mediaobject>
  36 <imageobject>
  37 <imagedata fileref="knode-start.png" format="PNG"/> </imageobject>
  38 <textobject>
  39 <phrase>&knode; after first start</phrase>
  40 </textobject>
  41 <caption>
  42 <para>&knode; after first start</para>
  43 </caption>
  44 </mediaobject>
  45 </screenshot>
  46
  47 <sect1 id="knode-setting-your-identity">
  48 <title>Personal settings</title>
  49
  50 <para>The first page of the settings dialog is for personal settings: </para>
  51 <screenshot>
  52 <screeninfo>Dialog for entering personal information</screeninfo>
  53 <mediaobject>
  54 <imageobject>
  55 <imagedata fileref="knode-identity.png" format="PNG"/> </imageobject>
  56 <textobject>
  57 <phrase>Entering personal information</phrase>
  58 </textobject>
  59 <caption>
  60 <para>Entering personal information</para></caption>
  61 </mediaobject>
  62 </screenshot>
  63
  64 <variablelist>
  65
  66 <varlistentry>
  67 <term>
  68 <guilabel>Name</guilabel></term>
  69 <listitem>
  70 <para>In the field <guilabel>Name</guilabel>, enter your name. This
  71 name will later appear in the newsgroups as sender, and can be seen by
  72 anyone.</para>
  73
  74 <para>Filling out the field <guilabel>Name</guilabel> is
  75 mandatory.</para>
  76 </listitem>
  77 </varlistentry>
  78
  79 <varlistentry>
  80 <term>
  81 <guilabel>Email address</guilabel></term>
  82 <listitem>
  83 <para>The email address you enter here will be used as sender in news
  84 articles, &ie; as actual address of the author, in conjunction with
  85 the real name (set in the field <guilabel>Name</guilabel>).</para>
  86
  87 <para>Filling out the <guilabel>Email Address</guilabel> field is
  88 mandatory.</para>
  89
  90 </listitem>
  91 </varlistentry>
  92
  93 </variablelist>
  94
  95 </sect1>
  96
  97 <sect1 id="knode-setting-the-news-account">
  98 <title>Configuring the news account</title>
  99
 100
 101 <para>Now we must tell &knode; about where we get the news from or
 102 where to send the articles to later on. In the list on the
 103 right, there is an <guilabel>Accounts</guilabel> entry; click on it and choose the
 104 <guilabel>Newsgroup servers</guilabel> tab, because we first want to configure
 105 the news account: the list of accounts is still empty.</para>
 106
 107 <para>To create a new account click on <guibutton>Add...</guibutton>. The
 108 following dialog appears:</para>
 109
 110 <screenshot>
 111 <screeninfo>The <guilabel>New Account</guilabel> dialog</screeninfo>
 112 <mediaobject>
 113 <imageobject>
 114 <imagedata fileref="knode-news-account.png" format="PNG"/> </imageobject>
 115 <textobject>
 116 <phrase>The <guilabel>New Account</guilabel> dialog</phrase>
 117 </textobject>
 118 <caption>
 119 <para>The <guilabel>New Account</guilabel> dialog</para>
 120 </caption>
 121 </mediaobject>
 122 </screenshot>
 123
 124 <variablelist>
 125
 126 <varlistentry>
 127 <term><guilabel>Name</guilabel></term>
 128 <listitem>
 129 <para>The <guilabel>Name</guilabel> field can be filled in as you
 130 like; the text you enter will later be visible in the folder view. You
 131 could, for example, enter the name of your Internet Provider; for our example we
 132 enter the name <userinput>My News Account</userinput>.</para>
 133 </listitem>
 134 </varlistentry>
 135
 136 <varlistentry>
 137 <term><guilabel>Server</guilabel></term>
 138 <listitem>
 139
 140 <para>The next field is labelled <guilabel>Server</guilabel>. Unlike
 141 the field <guilabel>Name</guilabel>, what you enter here is important.
 142 The name of the news server is fixed and you should be able to get it
 143 from your Internet service provider; if you do not know the name of
 144 the news server, you should get it now: without this information you
 145 cannot read any news. If your Internet service provider doesn't own a
 146 news server you can use a public one (universities often provide
 147 public news servers.)</para>
 148
 149 <para>For our example configuration we enter the name
 150 <userinput><systemitem
 151 class="systemname">news.server.com</systemitem></userinput>; you will,
 152 of course, enter the real name of your news server.</para>
 153 </listitem>
 154 </varlistentry>
 155
 156 <varlistentry>
 157 <term><guilabel>Port</guilabel></term>
 158 <listitem>
 159 <para>You probably will not need to change this from the default in most
 160 cases.</para>
 161 </listitem>
 162 </varlistentry>
 163
 164 </variablelist>
 165
 166 </sect1>
 167
 168 <sect1 id="knode-setting-the-mail-account">
 169 <title>Setting up the mail account</title>
 170
 171 <para>Sometimes you need to answer to the author of an article
 172 directly, without posting to the newsgroup; for example, when you want
 173 to make a very personal comment or want to correct an error. If you
 174 want to do this, select the <guilabel>Mail Server (SMTP)</guilabel> tab. The
 175 following dialog box appears:</para>
 176
 177 <screenshot>
 178 <screeninfo>Dialog Box for setting up the mail account</screeninfo>
 179 <mediaobject>
 180 <imageobject>
 181 <imagedata fileref="knode-mail-account.png" format="PNG"/> </imageobject>
 182 <textobject>
 183 <phrase>Setting up the mail account</phrase>
 184 </textobject>
 185 <caption>
 186 <para>Setting up the mail account</para>
 187 </caption>
 188 </mediaobject>
 189 </screenshot>
 190
 191 <variablelist>
 192
 193 <varlistentry>
 194 <term><guilabel>Server</guilabel></term>
 195 <listitem>
 196 <para>The name (address) of your mail server as provided by your
 197 Internet service provider or system administrator; all you have to do
 198 here is enter the mail server's name in the
 199 <guilabel>Server</guilabel> field.</para>
 200
 201 <para>In our example we enter <userinput><systemitem
 202 class="systemname">mail.server.com</systemitem></userinput></para>
 203 </listitem>
 204 </varlistentry>
 205
 206
 207 <varlistentry>
 208 <term><guilabel>Port</guilabel></term>
 209 <listitem>
 210
 211 <para>Again, you probably will not need to change the
 212 <guilabel>Port</guilabel> setting.</para>
 213 </listitem>
 214 </varlistentry>
 215 </variablelist>
 216
 217 <!-- Add links to "further reading" here -->
 218 <itemizedlist>
 219 <title>Related Information</title>
 220 <listitem><para>The comp.windows.x.kde newsgroup is the main user
 221 support group for &kde; on usenet. You can find other resources for
 222 getting help with &kde; in <xref linkend="getting-help"/>.</para>
 223 </listitem>
 224 <listitem><para><ulink url="http://gmane.org">Gmane</ulink> provides a
 225 usenet frontend to many mailing lists, including most of the &kde;
 226 lists, so you can read them with &knode;.</para>
 227 </listitem>
 228 </itemizedlist>
 229
 230
 231 </sect1>
 232
 233 </chapter>
 234
 235 <!-- Keep this comment at the end of the file
 236 Local variables:
 237 mode: xml
 238 sgml-omittag:nil
 239 sgml-shorttag:nil
 240 sgml-namecase-general:nil
 241 sgml-general-insert-case:lower
 242 sgml-minimize-attributes:nil
 243 sgml-always-quote-attributes:t
 244 sgml-indent-step:0
 245 sgml-indent-data:true
 246 sgml-parent-document:("index.docbook" "book" "chapter")
 247 sgml-exposed-tags:nil
 248 sgml-local-catalogs:nil
 249 sgml-local-ecat-files:nil
 250 End:
 251 -->