# The &kapplication; Handbook

&Mehrdad.Momeny;&Mehrdad.Momeny.mail;
2009
&Mehrdad.Momeny;
&FDLNotice;
2009-09-21
1.0

&kapplication; is a blogging client for &kde;.

KDE
blog

## Introduction

&kapplication; is a blogging client.

A blog client (also called blog software or blogware) is software designed to simplify the creation and maintenance of weblogs. As other specialized content management systems do, weblog applications support the authoring, editing, and publishing of blog posts and comments, with special functions for image management, web syndication, and moderation of posts and comments.

## Using &kapplication;

### Getting started

In the &kapplication; main window, you can create new posts, modify previous ones, remove them from the server as well as upload media files to the server. You can also save posts locally for later use.

All of these will be available after you configure at least one blog in &kapplication;.

Without any configured blog you can write and save posts locally for later use.

Here's a screenshot of &kapplication;
Main Window

### Configuring a blog

Blog management is available in the Configure &kapplication; dialog, and is accessible via the Settings Configure &kapplication;... menu, or alternatively via the Blog Add Blog... menu.

Add a new blog - Basic tab
Add a new blog - Basic tab

To add a blog, you simply have to insert your blog address, username and password in the corresponding fields and then click the Auto Configure button for the most popular blogging servers, such as Wordpress. It will guess your blog, and api, and then will fetch your Blog Id.

If it fails, you can manually select your blog's API type in the Advanced tab and click Fetch ID to fetch your Blog Id, or enter your Blog Id if you know it. And if you are using a “right to left” language, select Right To Left in next drop-down list.

Add a new blog - Advanced tab
Add a new blog - Advanced tab

You can check what &kapplication; supports for your blog in the Supported Features tab.

### Creating a new Post

To create a new post, in the main window, you can click on New Post toolbar button or under the Post menu, or simply press &Ctrl;N (its shortcut).

A new/empty post is created, and you can write, and configure it, and then submit it to your blog.

The &kapplication; main window is divided into two sections, Composer and Toolbox.

#### Composer

In the Composer section, you have a text field with the label Title, where you can write the title of the post. Below it, you have three tabs to edit your post in several ways. The first is a Visual Editor: it is a WYSIWYG editor and you only need to use the icons to format your text. The next tab is an &HTML; editor, where you have a syntax highlighted text editor to edit the &HTML; code of your post. And on the last tab, you can preview your post with your blog style, before submitting it to the server.

#### Toolbox

The Toolbox has four sections:

1. Blog Posts

   Blog Posts
   Blog Posts

   In this section, you can fetch the latest posts from the server.

   Double click on a post entry to load it into the composer and modify it, or select a post and use the relevant button to remove it from the server.

2. Post Categories

   Post Categories
   Post Categories

   In this section you can select categories and tags for your post. Tags must be comma separated.

3. Post Options

   Post Options
   Post Options

   Here you can select options for the currently active post in the composer such as Feedback options (for example, if visitors can leave a comment for this post or not), select a publish date, or a title to use for a permalink of the post (for Wordpress blogs only).

4. Local Entries

   Local Entries
   Local Entries

   And in the Local Entries section, you can double click on an entry to load it into the composer, or you can remove it from disk.

### Uploading a Media file to the server

To upload a file to the server, use Blog Upload Media.... You are then asked to select a file from your disk. The media upload dialog will be displayed:

Upload Media
Upload Media

If your blog API supports media uploading, you have 2 options here, and if not, there is just one and it's &FTP; server.

You can preview your desired file here (if preview method available), and enter its name on the server. And then click Upload.

If you want to upload to an &FTP; server, the absolute path of the folder is required. And you have to enter a &URL; to use for identifying the link of the file on the server.

## Menu Reference

### The File Menu

&Ctrl;Q File Quit

  Quit &kapplication;

### The Blog Menu

Blog Add Blog...

  A quick way to add a new blog.

Blog Upload Media...

  Open Media uploader, to upload files such as images to blog or &FTP; server.

  Only MetaWeblog and MovableType and Wordpress APIs support media uploading function.

### The Post Menu

&Ctrl;N Post New Post

  Create a new and empty post.

&Ctrl;S Post Save Locally

  Save current post locally.

Post Submit...

  Open the Submit post dialog, to submit the current active post to the current blog.

  In submit post, you can select if this post should submit as a draft or not. And additionally, whether as an edit of the current post, or as a new post.

### The Settings Menu

&Ctrl;T Settings Show Toolbox

  Toggle displaying the toolbox.

Settings Show Toolbar

  Toggle displaying the toolbar.

Settings Show Statusbar

  Toggle displaying the statusbar.

Settings Configure Shortcuts...

  Configure the keyboard shortcuts used by &kapplication;.

Settings Configure Toolbars...

  Configure the items you want to put in the toolbar.

Settings Configure &kapplication;...

  Display the &kapplication; settings dialog.

### The Help Menu

&help.menu.documentation;

## Credits and License

&kapplication;

Program copyright 2008-2009 &Mehrdad.Momeny; &Mehrdad.Momeny.mail; and &Golnaz.Nilieh; &Golnaz.Nilieh.mail;

Documentation Copyright © 2009 &Mehrdad.Momeny; &Mehrdad.Momeny.mail;

&underFDL; &underGPL;

## Installation

### How to obtain &kapplication;

&install.intro.documentation;

### Compilation and Installation

&install.compile.documentation;

&documentation.index;