[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