# KOrganizer Handbuch

Preston
Brown

    pbrown@kde.org

Manuel
Gaul
Deutsche Übersetzung

    flying_horse@gmx.net

Letzte Überarbeitung: 16. April 1999

Online Hilfe / Einführung in KOrganizer für Version 1.1.1

Deutschsprachiges Handbuch zu KOrganizer

KOrganizer
KDE
Terminplaner

## Einführung

KOrganizer ist ein multifunktionelles Programm. Es ist Kalender, Terminplaner und Prioritätenliste in einem. Es hilft beim Abgleich von Terminen verschiedener Leute und sogar Gruppen. Im allgemeinen versucht es, Ihnen bei der Organisation Ihres Lebens zu helfen, deshalb auch der kurze, aber treffende Programmname. Sie haben vielleicht schon mit ähnlichen Programmen für sowohl UNIX, als auch Windows gearbeitet, wie z.B. plan, Netscape Calendar, Microsoft Outlook und Ecco Pro. Alle diese Programme fallen in die gleiche Kategorie von ``PIM'' oder Personal Information Manager, was soviel wie Verwalter Ihrer persönlichen Informationen bedeutet, und alle Programme versuchen mehr oder weniger das gleiche zu erreichen, wenn auch auf verschiedenen Wegen.

### vCalendar Portable Data Format - (Noch nicht übersetzt)

KOrganizer is the first free PIM for Unix which implements the vCalendar protocol for personal data interchange. This vendor-independent, open standard allows different programs and devices to share/synchronize appointment and calendar information without proprietary standards. The data is stored in ASCII and is easily human-readable. While some Windows programs have implemented a limited import/export ability from their native formats to vCalendar, KOrganizer's native file format on disk is vCalendar, so it bypasses this middle-step entirely. It also allows you to easily access your data without the program itself, in the spirit of other UNIX programs.

### 3COM PalmPilot Support - (Noch nicht übersetzt)

KOrganizer also offers even more convenience if you have a 3COM PalmPilot or IBM WorkPad in conjunction with KPilot, a set of pilot-access tools for KDE. With KPilot working in conjunction with KOrganizer, you can easily synchronize your desktop and portable schedules.

You will need to have KPilot installed, and have the "todo conduit" and "vcalendar conduits" configured in order for your Appointments and To Do items to be synchronized back and forth between KOrganizer and your Pilot. However, once this is done, FULL synchronization is supported, including recurring appointments, alarms, attached notes, etc.

## KOrganizer starten

KOrganizer kann sowohl von der Befehlszeile, als auch aus dem KDE Startmenü gestartet werden. Wenn Sie es von der Befehlszeile ausführen, können dem Programm einige Kommandozeilenbefehle mit gegeben werden, die da wären:

-display <display>

  Zeigt KOrganizer auf dem gewählten Bildschirm an, anstatt den Standardbildschirm oder den per DISPLAY Umgebungsvariable übergebenen zu verwenden.

-geometry <geometry>

  Damit bestimmen Sie die Breite und Höhe des KOrganizer Fensters und die mögliche Bildschirmposition. Weitere Informationen darüber finden Sie in der X man page.

-name <name>

  So können Sie den in der Titelleiste eingeblendeten Fensternamen in die von Ihnen angegebene Zeichenkette ändern.

-title <title>

  Setzt den Fensternamen im zustand in den Titel Ihrer Wahl.

-cmap

  Nutzt eine eigene Farbpalette für KOrganizer, damit keine Resourcen verschwendet werden. Nur bei 8bpp-Bildschirmen sinnvoll.

Es gibt aber auch einige KOrganizer-eigene Befehle:

-c, --calendar <calendar>

  Gibt den Namen des Kalenders, der am Anfang geladen werden soll, an. Wenn keiner angegeben wird, wird der Standardkalender, der in den Einstellungen gespeichert ist (also der aktiv war, als KOrganizer zuletzt geschlossen wurde), benutzt.

-l, --list

  Liste alle Verabredungen oder Ereignisse von heute auf die Kommandozeile in Form einer ASCII-Tabelle.

-s, --show <numdays>

  Ähnlich zu dem vorher beschriebenen, aber es werden alle Verabredungen oder Ereignisse von heute an bis zu in der von Ihnen angegebenen Zahl von Tagen ausgegeben.

-h, --help

  Zeigt eine kurze Zusammenfassung aller Kommandozeilenbefehle.

## KOrganizer Docking Icon (Alarm Daemon)

Der "Alarm Daemon" ist ein kleines, von KOrganizer unabhängiges Programm, das sowohl die sicht-, als auch hörbaren Alarmanzeigen verarbeitet. Es stellt sich als ein kleines Bild eines Kalenders mit einer Glocke auf der Kontrolleiste dar.

Wenn man KOrganizer startet, überprüft das Programm, ob der Alarm Daemon bereits läuft, und wenn nicht, dann wird er automatisch gestartet. Auch nach dem Beenden von KOrganizer läft der Daemon noch weiter, um es zu ermöglichen, daß Sie immer noch Alarmmeldungen bekommen können. Das hat den Vorteil, daß sich nicht ständig das gesamte Hauptprogramm im Speicher befinden muß, denn der Alarm Daemon benötigt wesentlich weniger Speicher.

Der Alarm Daemon hat verschiedene Funktionen. Die Hauptfunktion ist den KOrganizer selbst zu starten. Ein EINZIGER Klick mit der linken Maustaste auf das Bild in der Kontrolleiste genügt, und schon startet das Programm. Zur Zeit wird mit jedem Klick ein neues KOrganizer Fenster gestartet. Seien Sie also vorsichtig, und versuchen Sie auch wirklich nur einmal zu klicken. In der nächsten Version wird das behoben sein.

Die nächsrangigen Aufgaben kann man über einen Klick mit der rechten Maustaste auf das Alarm Daemon - Bild erreichen. Es wird dann ein PopUp-Menü geöffnet. Zur Zeit kann man zwischen ein- und ausschalten der Alarme und Beenden wählen. Diese Funktionen sollten selbsterklärend sein.

## Hauptprogrammfenster - (Noch nicht übersetzt)

When KOrganizer starts, you are first presented with the main KOrganizer window. The window has several components, including a menubar, a toolbar, a month calendar, a current ``view'' of events, and a tasklist. The calendar defaults to displaying today's date.

### Menus - (Noch nicht übersetzt)

The menus provide access to all the common operations that can be performed on the calendar, including saving, loading, adding and deleting appointments, printing, etc. etc.

#### File Menu

The `File` menu provides access to functions involving the entire calendar.

New Window

  Allows you to open up another main window. You might want to do this if you wish to have two simultaneous but different views of a calendar open at once.

Open

  Opens a file dialog allowing you to select a new vCalendar to load. If you have made changes to the current calendar, you will be given the option of saving them before loading a new one.

Open Recent

  Provides a list of recently opened calendars for quick access, allowing you to bypass the file dialog entirely.

Close

  Closes the current window. If this is the last window, this choice has the same effect as Quit.

Save

  Saves the calendar to disk, making sure all changes you might have made will be kept. If the calendar has no name, save will behave like `Save As`.

Save As

  Gives you a file dialog so that you may choose a different name for your calendar than the one currently assigned to it. Useful if you have made changes to a calendar that you want to save, but also want to keep separate from your ``regular'' calendar.

Import From Ical

  If you have used ical, a popular but older calendar program for unix using the Tk widget set, you may wish to import your appointments, events, and todo items directly to KOrganizer. This action will read the `.calendar` file from your home directory and merge any entries it contains into your current calendar. If any errors or suspicious things occur during the process, you will be notified via a message box.

Merge Calendar

  If you have a different vCalendar file somewhere, and you would like to include its contents into your own calendar, this will do just that. A good time to do this would be if you received a vCalendar with a few entries via e-mail, for instance.

Print Setup

  Brings up the print setup dialog and allows you to set up how you want printed output to appear. See the section on printing for more information.

Print

  Prints the current calendar.

Print Preview

  Prints the current calendar and displays it with your print preview program, instead of sending the output directly to the printer. You can choose the program that you use to preview output in the Options dialog.

Quit

  Quits KOrganizer, prompting to save if the current calendar has been modified but not yet saved.

#### Edit Menu

The `Edit` menu provides editing operations on appointments.

Cut

  Cuts the currently selected appointment(s) to the clipboard, removing them from your calendar.

Copy

  Copies the currently selected appointment(s) to the clipboard, leaving them untouched in your calendar.

Paste

  Inserts the contents of the clipboard into your calendar. The clipboard must contain a valid vCalendar, provided either by a previous Cut/Copy operation or from a selection made outside of KOrganizer. You will be warned if the contents of the clipboard cannot be understood.

#### View Menu

Options for changing the current view of your appointments

List

  Switches to List View.

Day

  Switches to Day View.

Work Week

  Switches to name="Week View">, but with only the 5 days of a business week selected instead of the normal 7.

Week

  Switches to Week View.

Month

  Switches to Month View.

Todo List

  Switches to full screenTodo View.

Update

  Updates or refreshes the currently displayed view.

#### Actions Menu

Different actions you can take to modify your calendar.

New Appointment

  Brings up the appointment window, allowing you to create a new appointment. By default, the appointment will begin on the currently selected date.

New Event

  Brings up the appointment window, allowing you to create a new appointment. The default for this mode is that the appointment has no time associated with it; it is merely a reminder of something you mean to do on that particular date or range of dates.

Edit Appointment

  Brings up the appointment window with the currently selected appointment filled in to the fields and ready for editing.

Delete Appointment

  Confirms that you would like to delete the currently selected appointment, and upon positive confirmation, removes it from your calendar.

Search

  Pops up the Search Window, allowing you to search for appointment(s) by date, a common phrase, etc.

Mail Appointment

  This is currently unimplemented.

#### Options Menu

Allows access to configuration options common to the entire program.

Show Tool Bar

  Toggles whether or not the tool bar is visible.

Show Status Bar

  Toggles whether or not the status bar (at the bottom of the screen) is visible.

Edit Options

  Brings up the Options Dialog, allowing you to change common options like date/time formats, fonts, etc.

#### Help Menu

Various methods of getting help on KOrganizer.

Contents

  The contents of the KOrganizer online help manual.

Help On

  Gives you context sensitive help information on the object that you click on after choosing this. However, none of the help for the different objects has been written as of the time this manual was last updated, so this will not be too useful. Volunteers?

About

  Shameless plug about the authors of KOrganizer.

### Date Navigator - (Noch nicht übersetzt)

The small calendar that is in the upper-left corner of the screen is the main way provided to navigate among and select from various dates. The single-arrow icons move forwards and backwards in time by increments of a month, while the double-arrows allow moving by years at a time. Today's date will be outlined with a gray box. Dates which have appointments scheduled on them will be bold and a different color than the regular dates. Selecting a date is accomplished simply by clicking on it; multiple dates may be selected/deselected simply by holding down the `control` key while clicking.

### Views - (Noch nicht übersetzt)

There are several different ``views'' available for displaying your list of events and appointments, including a ``list'' view, a ``day'' view, a ``week'' view, and a ``month'' view. KOrganizer is smart enough to remember in between sessions what the last active view was, and the next time it is started, it will default to that view.

In general, each view will provide a way of displaying your events and appointments constrained to a particular time period or style of display. clicking on any appointment will select it for further action. Right clicking an appointment brings up a menu with options such as `edit`, `delete`, and so on. You can also use the `Action` menu to perform similar operations.

#### List View

This view allows you to see all your appointments for the day in list-type arrangement. Appointments are displayed one per line. The first column of the appointment will have a bell icon displayed in it if an alarm is set for the appointment. The second column will display a chasing-arrows icon if the appointment repeats multiple times. Holding the mouse over the arrows icon will bring up a tooltip with more detailed recurrence information. The third column displays start and end time information, and the fourth column gives a summary of the appointment.

The list view is good for displaying many appointments on a single day in a compact fashion. It is also useful if your appointments are spread out over a long time period that would not normally fit entirely on the screen when using one of the other views.

#### Day View

This view presents your appointment information in a chronological fashion which also provides visual feedback on the length of each appointment. Time is indicated on the left side of the view. A scrollbar on the right is provided when the entire day cannot fit onto the screen at one time (which is the usual case). Each rectangle in the view represents an individual appointment, and displays the appointment's start and end time, summary, and whether or not the appointment repeats or has any alarms set.

A useful shortcut that this view provides for adding appointments is the ability to double-click on any open region of time, which will automatically create a one hour long appointment and let you start editing the description. The appointment's ``snap'' to half-hour increments, rounding off to the closest half hour from where you clicked.

#### Week View

The week view provides a view very similar to the day view for displaying seven days worth of appointments next to each other. All of the functions available for the day view are available in the week view. See the Day View section for further information.

#### Month View

The month view displays all the appointments for the current month in a familar calendar layout. Each day displays all of the appoints that can fit in the area provided (maximizing the window will enable you to see more appointments). Information on repeating and alarm status is indicated through icons.

Navigation inside the month view is provided by a set of buttons along the right side of the screen. By pressing the appropriate upwards-facing button, you can navigate by week, month, or even year. The downwards-facing buttons perform the analogous function, except forwards in time versus backwards.

### Todo List - (Noch nicht übersetzt)

The todo list is unfortunately in a state of flux, so what is described here (as far as ``operation'' of the todo list goes) may change in the near future.

The todolist provides a place for you to jot down quick (or long-term) notes to yourself about things that you need to do. Currently, you cannot associate a date due with a todo entry, but this is forthcoming. You can however assign priorities to todos, and they will appear sorted in order of priority. The lower the number, the higher the priority, except that zero (0) is defined as ``no priority.''

To make a new todo entry, right click in the todo box. You will get a menu with the option to create a new entry. If you clicked on an already existing todo, you will also see a choice to delete that entry if you wish. When you choose `New Todo`, a new todo will be created and you will be prompted to enter a short description. After doing this, you can change the priority by double-clicking in the second column of the todo, which will bring up a list of possible priorities. simply click on one to choose it. Similarly, if you double-click in the description (third) column of an existing todo, you will be able to edit the description. Double clicking on the box (first column) will toggle the todo's ``completed'' status.

You may also pick `Purge Completed` from the right mouse button menu to delete all todo entries that you have marked completed. This is handy for quick cleanup.

As has already been mentioned, the todo list could be a lot friendlier and fancier, and we plan for it to be so. If you have any suggestions for what you would like to see in the todo list, please e-mail the authors.

## Appointment Editor Window - (Noch nicht übersetzt)

The appointment editor window is a detailed interface for adding new appointments or editing existing ones. Without using this window, you are generally limited to changing only an appointment's description (and hopefully, when we have time to implement it, an appointment's time and date as well). While this is good for ``quick'' access, if you want to change more sophisticated components of an appointment such as how often it repeats, when and if an alarm should be set, what categories it belongs to, and so on, you will need this window.

The appointment editor window is made up of three tabs. The `General` tab has the most common items related to the appointment, including times and dates, description, privacy information, categories, etc. The `Details` tab has more advanced information, especially information pertaining to group scheduling. Unfortunately, we haven't finished implementing most of these features, and for that reason, the documentation will not cover the `Details` tab (until that part of the code is completed). The last tab is the `Recurrence` tab, which holds all the settings for if and how often an event should repeat over a period of time.

To save changes to your appointment, press the ``disk'' button on the toolbar (it stands for save). To cancel, either close the window, or press the ``cancel'' button on the toolbar.

### General Tab - (Noch nicht übersetzt)

Summary

  A Short description of the event or appointment.

Start and End Time

  Set your appointment's starting and ending date and time here. Click on the little calendar icon next to the date to pull up an interactive date selector, or type in a date in the same format shown. For changing the time, you can type it in directly, or use the pulldown on the combobox to choose the time from a list. You can also use the up and down arrows to scroll through 15 minute increments of time.

All day event

  Click this checkbox if you don't want to associate any time with the appointment at all; instead you want to make more of a ``general reminder'' that the appointment occurs on this date.

Recurring event

  If you click this checkbox, the `Recurrence` tab will become available, and you will be able to set up how often the appointment repeats itself. By default, it isn't checked--the appointment will occur only once. See Recurrence Tab.

Reminder

  Clicking this checkbox will enable a visual reminder or alarm for your appointment. Type in the number of minutes ``lead-time'' in the textbox next to it. Unfortunately, at this time, the ``WAV'' and ``PROG'' buttons, which will eventually let you play a noise or run a program when the alarm goes off, are not available.

Show Time As:

  Using this combo box, you will be able to switch how your appointment's time appears to the ``outside world''--either Free or Busy. This will make more sense when the group scheduling features of KOrganizer are completed.

Description

  The large text area beneath the alarm information is where you can put any details about the appointment. Cut and paste in airline flight information, details of a meeting, notes about a homework assignment, or anything else that requires more detail beyond the simple one-line summary.

Categories

  This button will bring up a dialog box which will allow you to select a number of categories to place this appointment in. Eventually, you will be able to sort events by category or select to only view events in certain categories, but this isn't finished yet. For now, use categories as personal reminders and notes about what sort of appointment or event this is.

Private

  If the appointment is of a private or confidential nature, you will want to click this textbox. When the group scheduling features are completed, only ``public'' events will be world-visible; private events will not show up.

### Details Tab

  Dieser Abschnitt muß noch geschrieben werden. Freiwillige?

### Recurrence Tab - (Noch nicht übersetzt)

Appointment Time

  In this area, you can edit an appointment's start and end time. Changes made in these areas will be reflected on the `General` tab, and vice versa. See General Tab.

Recurrence Rule

  This appears to be a complex section, but it is really rather simple. Choose the repetition period by clicking the `Daily, Weekly, Monthly,` or `Yearly` radio button on the left side of this area. When you choose a different period, the display to the right of the radio button will change to reflect the settings associated with that period. By default, an appointment will set itself up to repeat on a weekly basis.

  For `Daily`, simply choose how often to repeat. By default, it is every day (1), but you can change this to every other day (2), etc.

  For `Weekly`, change the period of weeks if you wish, and select which days of the week you want the appointment to occur on.

  For `Monthly`, you can either have the appointment occur on the same day of the month, or in a specific week on a specific day of the month. You need to choose this. By default, it assumes you want to repeat on the same calendar day of the month (like the 15th for instance). You can also adjust the period, so you can repeat monthly, tri-monthly, bi-yearly, etc.

  `Yearly` is similar to `Monthly`. You need to choose whether or not you are indicating a calendar day of the year (i.e., the 250th day of the year), or this day of the month in a particular month of the year. By default, KOrganizer assumes you mean the actual day of the year. You can adjust the period to reflect events that occur bi-annually, every four years, and so on.

Recurrence Range

  By default, appoints which repeat will do so forever; there is no ``end'' to the repetition. This may or may not be desirable, so you are provided with two ways of terminating the repetition: either by giving an ending date, or by specifying a total number of recurrences. In this area, you can choose the method that is suitable for this appointment.

Exceptions

  You may have a very nice recurrence rule set up, but realize that there are a few exceptions. If you set up your college class schedule for instance, you may want to make exceptions for holidays and the like. In this area, you can add, change, and delete dates from the list of exceptions (i.e. times when even if the recurrence rule matches, the event will not be scheduled). Pick a date with the date selector, and press `Add` to include it. For removing dates, hilight them in the box on the right side, and then click `Delete`.

## Search Window - (Noch nicht übersetzt)

When you want to find a particular instance of an appointment, or remember something you typed in regarding an appointment but not the exact date and time, the search window becomes highly useful.

The search dialog is very simple. It consists of a field where you enter your search query, a table where results of the query are displayed, and a `Search` button. Simply type in the string that you want too look for (it is case insensitive) and press the button. Wildcard characters (*, ?, and &lsqb;]) are supported for matching unknown text.

In the future, KOrganizer will support more searching options, such as regular expressions, time ranges and/or date ranges, etc. Code contributions are welcomed and encouraged.

## Options - (Noch nicht übersetzt)T

The options dialog will allow you to configure a number of different areas of KOrganizer.

### Personal - (Noch nicht übersetzt)

The personal options relate to your personal identity, and other miscellaneous things that don't fall under any of the other general categories.

Your Name

  Refers to your full name.

Email Address

  Your email address, which will be used both to identify appointments and events which belong to you, and for group scheduling, so others know what address to send appointments to.

Additional

  Additional information about yourself. Currently this field is unused, so you may safely ignore it.

### Time & Date - (Noch nicht übersetzt)

Time Zone

  Specifies your time zone in hours offset from UTC (GMT). For the US East Coast, that means -0500 when Daylight Savings are not in effect, and -0400 when they are. KOrganizer will automatically adjust for daylight savings. In the future, the name of the region (i.e. US/Eastern) will be specified instead of the harder-to-remember numeric representation.

Time Format

  Here, you may choose either 24 hour or 12 hour (am/pm) time representations. Most widgets and display areas in KOrganizer are smart enough to switch between the two, but there are a few remaining areas where you may notice that this property has not been fully implemented. This will change before the 1.0 release.

Default Appointment Time

  When you choose `New Appointment` >from the Action Menu, or create an appointment in some other manner such that KOrganizer cannot guess what time you would like it to start at, KOrganizer will put this hour in the start time editor as the default value.

Default Alarm Time

  Select the time at which you would like alarms to go off preceeding the actual event's scheduled time. Right now, you must choose among the hard-coded times that are available.

### Schriftarten - (Noch nicht übersetzt)

List View

  The font which appointments are displayed in for List View.

Schedule View

  The font which appointments are displayed in for Schedule View, which includes views such as Day View and Week View.

Month View

  The font which appointments are displayed in for Month View.

Time Bar

  Currently unimplemented.

Todo View

  The font which appointments are displayed in for the Todo List.

### Farben

Dieses Kapitel ist zur Zeit noch nicht in die Online-Hilfe eingebaut.

### Ansichten - (Noch nicht übersetzt)

Day Begins At

  this is the hour for which KOrganizer defaults to on the scroll bar when you are in day or week view. Useful when you don't usually have appointments beginning before 8 or 9 o'clock in the morning.

### Drucken

Papiergröße

  Gibt die Größe des Papiers an, auf dem Sie standardmäßig drucken wollen. Selbstverständlich können Sie bei jedem Drucken etwas anderes als den Standard wählen. Sicherlich werden Sie A4 in Europa und Letter im Rest der Welt nehmen.

Papierformat

  Zeigt die Lage, in der Ausdrucke erfolgen. Hoch- und Querformat sollten selbsterklärend sein. Diese Funktion ist zur Zeit nicht verfügbar, denn die verschiedenen Ansichten wählen das Format automatisch. Wenn sich daran etwas ändert, wird diese Einstellung sofort aktiviert.

Vorschauprogramm

  Dies teilt KOrganizer das Programm mit, welches bei der Wahl von `Druckvorschau` aus dem Dateimenü benutzt wird. Normalerweise wird hier kghostview, ghostview oder gv eingetragen sein.

## Drucken

Dieses Kapitel muß erst noch geschrieben werden.

## Allgemeine Fragen und Antworten

Bis jetzt gibt es noch keine, noch...

## Danksagungen und Anerkennungen

Ein Dank geht an alle, die mit Quell-Code, Dokumentation und Vorschlägen zu KOrganizer beigetragen haben. Dazu gehöhren Ian Dawes, Fester Zigterman, Laszlo Boloni und zahlreiche andere. Danke auch an unsere Alpha- und Betatester, die uns mit Fehlerlisten, Meinungen und Verbesserungswünschen geholfen haben. Weitere Danksagungen gehen an Linux und natürlich an die Free Software Communities, die jedem kostenlos eine exzellente Programmierumgebung bereitstellen.