Configuration of the news sources
Prev
Next

Configuration of the news sources


This is what the News Sources tab of
			the preferences dialog looks like.

On this tab you can manage and maintain the list of news sites KNewsTicker queries for news. Click on any entry with the right mouse button to open a context menu which lets you remove the current entry, or add a new entry. At the bottom of the page you can also find three buttons which have the same effect.

Adding a news site

There are four ways to add a new news site to the list:

  • You can click on the button at the bottom labeled Add....

  • You can click with the right mouse button on the table and choose Add news source.

  • You can drag any RSS file from another application (such as Konqueror) onto the table. This adds a new entry to the list, sets the name to “Unknown” and sets the maximum number of articles to 10.

  • And finally, you can just click on any RSS file in the Konqueror filemanager to have it added to the list immediately.

Either way will cause the News site dialog to show up, presenting you with a form to enter the properties of the news site to add.

Modifying an existing news site

There are two ways to adjust the properties of an existing news site:

  • You can click on the button at the bottom labeled Modify....

  • You can right-click with the right mouse button on the news site you'd like to edit and choose Modify '...' from the menu.

No matter which way you chose, it will cause the News site dialog to pop up, showing the properties of the selected news site.

Removing a news site

Of course, you want to remove a news source from the list sometimes. To do this, you can either

  • click on the button at the bottom labeled Remove, or

  • right-click with the right mouse button on the news site you'd like to edit and choose Remove '...' from the menu.

In both cases, a confirmation box will pop up and make sure you didn't select the wrong entry.

Tip

You can also remove multiple news sites at once by holding Ctrl while clicking on the entries you wouldd like to remove, or by clicking the left mousebutton and dragging the mouse over all the entries you'd like to select.

The news site dialog


This is what the dialog for adding and editing news sites
			looks like.

When adding or modifying a news site, the news site dialog (shown above) pops up and provides input facilities to edit the various properties of a news site:

Name:

This is the name of the news source.

Note

This text will only be used if Use custom names for news sites on the tab labeled General is activated.

Source file:

Here you can set the URL which references the RSS file of this news site; this can either be a local file, or a file saved on a remote server. You can also click on the button at the right to open a convenient file-selection dialog and browse to the file you would like to use, instead of typing the URL by hand.

The file is a program

If this file is checked, KNewsTicker will not assume that the URL (which was specified in the Source file field) references an RSS file, but rather that the URL refers a program (usually a script). When querying this news site, KNewsTicker will execute the program and treat whatever the program prints to stdout as RSS markup. This is very convenient for conversion scripts which download an HTML file and process it, producing RSS markup which is suitable for use with KNewsTicker.

Tip

You can find some scripts which for example, download stock data in the tdeaddons module, in the knewsticker-scripts directory.

Category:

Here you can specify into which category the news site belongs. Arranging the news sites into categories makes it much easier to maintain large lists of news sites.

Max. articles:

This option lets you define how many articles KNewsTicker will cache for this news site; the value will never be exceeded.

This is particularly handy for news sites which provide only three news items at once, but you'd like to see the last ten items (for instance); KNewsTicker will always download the three items and merge them into its list, caching the last seven items.

Icon:

Here you can specify a URL to an image file (preferably 16x16 pixels in size) which should be used for this news site. Icons make it much easier to distinguish multiple news sites, and see which news site a headline appeared on as it scrolls by in KNewsTicker.

At the button you will find the usual buttons. One of them deserves an extra note: clicking on the Suggest button will make KNewsTicker try to guess suitable values for most of the fields if you specify a URL to a valid source file.

This means that you can usually just paste a URL to an RSS file in the input field labeled Source file, press the Suggest button and then modify the suggested values as needed.

Prev
Next
Home


Would you like to comment or contribute an update to this page?
Send feedback to the TDE Development Team