# The &kblogger; Handbook

## Introduction

&kblogger; is a simple to use blogging application for the K Destkop Environment. It integrates in the KDE Kicker for easy and fast blogging. The Interface is very minimalstic and tries to provide maximal usability for your enjoymnet. Just push to the blog button and start writing. By now &kblogger; supports the MetaWeblog API and the Blogger API 1.0, support for Atom API is planned. &kblogger; shares its backend with Kontact's blogging resource.

## Configuration

Configuration is done via the applet menu. To enter the configuration menu click either on the little arrow left of the applet (note: Kicker has to be unlocked to see this arrow), then choose Configure KBlogger or choose configure from the right-click-menu. Now the configuration dialog pops up. There you can set all needed options, in case you don't know what an option means are here short descriptions:

- API is the type of API you use at your blog, this can be either the Google Blogger API or the MetaWeblog API.

- URL describes the path to the xml-rpc gateway, e.g. http://www.blogger.com/api/RPC2 This gateway will be automatically set, if you choose Blogger API 1.0 and there is no other URL set yet.

- Blog-ID is the id of your blog on the server. If you enter your username, your password and the gateway ( it must be compatible with Blogger API 1.0 ), than the available ids are automatically fetched and shown in the list. Choose one of them and you will see the name of the chosen blog. Otherwise, if it doesn't work, you should have a look to your webinterface or ask your server admin to get it.

## Using &kblogger;

Title and content should be self-explanatory (note that title is disabled for Blogger.com since the supported API doesn't allow it). Choose or enter your prefered category (also not available for Blogger.com), if you don't select any name will &kblogger; use the default category. If you'd like to publish your entry later you can uncheck the publish button, then &kblogger; will submit a draft instead of a usual entry. If you submitted a draft you have to use your web interface or another tool to activate the entry. To edit older posts or upload files, which is only available in MetaWeblog API, right click on the applet and select the appropriate part in the menu. Here's a screenshot of &kblogger; Screenshot

### More &kblogger; features

- KDE proxy support

- Kicker integration

- File uploading

- Category fetching

- Blog-ID fetching

- Post editing

- Spell checking

- Support for UTF-8 (unicode)

## Developer's Guide to &kblogger;

There is nothing to program here... If you want to help me, just look at the code, it's not very complex and should be commented. In fact the real work should be done in the blogging resource of Kontact, since this applet will not be available in Plasma (KDE 4).

## Questions and Answers

&reporting.bugs; &updating.documentation;

Why is there no FAQ yet?

Because it is being worked on ;-) Ask the questions, we'll give the answers and build an FAQ.

## Credits and License

Program copyright 2005-2006 Christian Weilbach christian_weilbach@web.de

## Contributors:

- Christian Weilbach (development) christian_weilbach@web.de

- Kenneth Wimer (icon designer) ken@oxygen-icons.org

Documentation copyright 2005-2006 Christian Weilbach christian_weilbach@web.de and Harald Sitter harald.sitter@kdemail.net

&underFDL; &underGPL;

## Installation

### How to obtain &kblogger;

Obtaining &kblogger; is actually quite easy. You can either download the source tarball and compile it your self, or you download one of the pre-built packages for your distribution. Tarball and pre-built packages are available at the &kblogger; website

### Requirements

In order to successfully use &kblogger;, you need &kde; 3.4. &kblogger;. Everything else is included.

&kblogger; can be found on The &kblogger; home page.

You can find a list of changes at KDE-Apps.

### Compilation and Installation

&install.compile.documentation;
&documentation.index;