[prev in list] [next in list] [prev in thread] [next in thread]
List: kde-commits
Subject: KDE/kdepim/doc/akregator
From: Danny Allen <dannya40uk () yahoo ! co ! uk>
Date: 2006-12-12 13:53:28
Message-ID: 1165931608.762611.19126.nullmailer () svn ! kde ! org
[Download RAW message or body]
SVN commit 612737 by dannya:
reviewing documentation again
M +28 -21 index.docbook
--- trunk/KDE/kdepim/doc/akregator/index.docbook #612736:612737
@@ -62,34 +62,33 @@
<chapter id="introduction">
<title>Introduction</title>
-<sect1 id="what-is-it">
-<title>What is it?</title>
+<sect1 id="what-is-akregator">
+<title>What is &akregator;?</title>
<para>&akregator; is a &kde; application for reading online news feeds. It has a
powerful, user-friendly interface for reading feeds and the management of
them.</para>
-<para>&akregator; is a lightweight and fast program to display news items
+<para>&akregator; is a lightweight and fast program for displaying news items
provided by feeds, supporting all commonly-used versions of
<acronym>RSS</acronym> and Atom feeds. Its interface is similar to those of
-e-mail programs, thus being very intuitive to use. Useful features are searching
-in article titles, management of feeds in folders and setting archiving
-preferences. Feeds can be displayed in a similar manner to e-mails. Websites related to a feed can be \
shown in &akregator;'s embedded browser or, at the users' choice, opened in an external
-browser.</para>
+e-mail programs, thus hopefully being very familiar to the user. Useful features include searching \
within article titles, management of feeds in folders and setting archiving +preferences. Feeds can be \
displayed in a similar manner to e-mails. Websites related to a feed can be shown in &akregator;'s \
embedded browser or, at the users' choice, opened in an external browser.</para> </sect1>
-<sect1 id=" rss-and-atom-feeds">
+<sect1 id="rss-and-atom-feeds">
<title><acronym>RSS</acronym> and Atom feeds</title>
-<para><acronym>RSS</acronym> (Really Simple Syndication) is an &XML;-based format to
-publish news or articles in machine-readable form. An <acronym>RSS</acronym>
+<para><acronym>RSS</acronym> (Really Simple Syndication) is an &XML;-based format used for publishing \
news or articles in a machine-readable form. An <acronym>RSS</acronym> or Atom file is also called a \
feed. A program that can be used to read such feeds is
-called a feed reader or aggregator, hence the title of the application, &akregator;. It automatically \
extracts new items from the feed and displays them to the user. The user therefore saves time with \
regularly-visited websites as they need no longer manually check whether there are new pieces of \
information available.</para> +called a feed reader or aggregator, hence the title of the application, \
&akregator;.</para> +
+<para>&akregator; automatically extracts new items from the feed and displays them in a human-friendly \
form to the user. The user can therefore save time with regularly-visited websites, as they need no \
longer manually check whether there are new pieces of information available.</para> \
<para><acronym>RSS</acronym> is available in different versions which are not compatible with each other \
(this situation caused by competing companies): <acronym>RSS</acronym> 0.9, <acronym>RSS</acronym> 1.0 \
and <acronym>RSS</acronym> 2.0. Atom is also an &XML;-based feed language which has
-been redesigned to fit the needs of webloggers and news sites. It also tries to
+been redesigned to fit the needs of webloggers and news sites. Atom attempts to
replace <acronym>RSS</acronym> feeds and remove the uncertainty with
incompatiblities in the different <acronym>RSS</acronym> versions.</para>
@@ -103,7 +102,7 @@
<para>
This section describes how to start using &akregator;. It explains the user
interface and shows you how to add your own feed to the list. This section is
-particularily interesting if you are not yet familiar with the general <acronym>RSS</acronym>/Atom news \
feeds and feed aggregator concept. +particularily interesting if you are not yet familiar with the \
general <acronym>RSS</acronym>/Atom and feed aggregator concept. </para>
<sect1 id="main-window">
@@ -166,9 +165,9 @@
<sect1 id="add-feed">
<title>Adding a feed</title>
-<para>&akregator; provides you some default feeds related to &kde;. You
-might want to add your own feeds. Good candidates are news sites you visit
-regularly, for example.</para>
+<para>&akregator; provides you with some default feeds related to &kde; - of course, you
+probably want to add your own feeds. Good candidates are the news sites you visit
+regularly.</para>
<itemizedlist>
<listitem><para>
@@ -183,10 +182,10 @@
<textobject><phrase>Add a new feed</phrase></textobject>
</mediaobject>
</screenshot>
-</para> </listitem>
+</para></listitem>
<listitem><para>
-Enter <userinput>www.slashdot.org</userinput> in the line edit next
+Enter <userinput>http://www.slashdot.org</userinput> in the line edit next
to <guilabel>Feed URL</guilabel> and click <guibutton>OK</guibutton>.
</para></listitem>
<listitem><para>
@@ -198,13 +197,21 @@
<textobject><phrase>The feed properties dialog</phrase></textobject>
</mediaobject>
</screenshot>
-</para> </listitem>
-<listitem><para>
+</para></listitem>
+<listitem><para>
Now Slashdot has been added to your feed list.
</para> </listitem>
</itemizedlist>
<para>
-There are multiple other ways to find and add interesting feeds.</para>
+There are multiple other ways to find and add interesting feeds. Within KDE, websites browsed with \
&konqueror; will display the recognizable "RSS lozenge" in the bottom-right if a compatible \
news feed is detected at the website: +<screenshot>
+<screeninfo>Automatically finding feeds through &konqueror;</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="konq.png" format="PNG" /></imageobject>
+<textobject><phrase>Automatically finding feeds through &konqueror;</phrase></textobject>
+</mediaobject>
+</screenshot>
+</para>
</sect1>
<sect1 id="creating-folder">
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic