doc/: Add translated documentation

Created using `po2txt` from translate-toolkit.

Signed-off-by: Lukas Fleischer <calcurse@cryptocrack.de>

doc/de/add.txt

@@ -0,0 +1,38 @@
+Hinzufügen
+==========
+
+In Abhängigkeit davon welches Panel ausgewählt ist, wird entweder ein Termin
+oder eine Aufgabe hinzugefügt.
+
+Um einen neuen Eintrag in der Zu-erledigen-Liste zu erstellen, müssen Sie als
+erstes eine Beschreibung eingeben. Anschließend werden Sie aufgefordert, die
+Priorität anzugeben. Diese wird durch eine Skala von 9 (niedrigste Priorität)
+bis 1 (höchste Priorität) repräsentiert. Sie können die Priorität auch im
+Nachhinein noch durch die '+'- und '-'-Tasten verändern.
+
+Wenn das Terminpanel ausgewählt ist, können Sie eine neuen Termin oder ein
+ganztägiges Ereignis erstellen. Für letzteres drücken Sie [ENTER] anstatt eine
+Startuhrzeit einzugeben und geben lediglich eine Beschreibung an.
+
+Um einen neuen Termin hinzuzufügen, müssen Sie die Startuhrzeit, die Dauer
+(entweder per Enduhrzeit ([hh:mm]) oder per tatsächlicher Dauer ([+hh:mm],
+[+xxdxxhxxm] oder [+mm]) und die Beschreibung des Ereignisses angeben. Falls Sie
+keine Enduhrzeit oder Dauer angeben und stattdessen [ENTER] drücken, findet das
+Ereignis nur exakt zur Startuhrzeit statt.
+
+Der Tag, an dem das Ereignis oder der Termin stattfinden, ist der momente
+ausgewählte Tag im Kalender. Ergo müssen Sie vorher ggf. den korrekten Tag
+auswählen.
+
+Notizen
+-------
+
+* Falls ein Termin bis in den nächsten Tag hinein dauert, wird er an allen
+entsprechenden Tagen angezeigt. Falls er nicht an dem jeweilen Tag beginnt bzw.
+endet, wird die Start- bzw. Endstunde durch '..' ersetzt.
+
+* Falls sie [ENTER] drücken ohne eine Beschreibung eingegeben zu haben, wird
+kein Eintrag hinzugefügt.
+
+* Vergessen Sie nicht, die Kalenderdaten zu speichern, um sie beim nächsten
+Start von Calcurse wiederherstellen zu können.

doc/de/config.txt

@@ -0,0 +1,21 @@
+Config
+======
+
+Open the configuration submenu. From this submenu, you can select between
+color, layout, notification and general options, and you can also configure
+your key bindings.
+
+The color submenu lets you choose the color theme.
+
+The layout submenu lets you choose the calcurse screen layout, in other words
+where to place the three different panels on the screen.
+
+The general options submenu brings a screen with the different options which
+modifies the way calcurse interacts with the user.
+
+The notify submenu allows you to change the notify-bar settings.
+
+The keys submenu lets you define your own key bindings.
+
+Do not forget to save the calendar data to retrieve your configuration next
+time you launch calcurse.

doc/de/copy-paste.txt

@@ -0,0 +1,11 @@
+Kopieren und Einfügen
+=====================
+
+Kopieren und Einfügen des momenten ausgewählen Eintrages. Dies ist hilfreich, um
+schnell einen Eintrag von einem Tag zu einem anderen zu verschieben. Hierfür
+muss zunächst der zu kopierende Eintrag markiert und anschließend die der
+Kopier-Funktion zugewiesene Taste gedrückt werden. Sobald der neue Tag im
+Kalender gewählt ist, muss das Terminpanel ausgewählt und die Einfügen-Taste
+betätigt werden. Das Ereignis wird anschließend im Terminpanel in dem neuen Tag
+erscheinen.
+

doc/de/credits.txt

@@ -0,0 +1,22 @@
+Calcurse - text-based organizer
+===============================
+
+Copyright (c) 2004-2013 calcurse Development Team
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+	- Redistributions of source code must retain the above
+	  copyright notice, this list of conditions and the
+	  following disclaimer.
+
+	- Redistributions in binary form must reproduce the above
+	  copyright notice, this list of conditions and the
+	  following disclaimer in the documentation and/or other
+	  materials provided with the distribution.
+
+
+Send your feedback or comments to : misc@calcurse.org
+Calcurse home page : http://calcurse.org

doc/de/delete.txt

@@ -0,0 +1,15 @@
+Delete
+======
+
+Delete an element in the todo or appointment list.
+
+Depending on which panel is selected when you press the delete key, the
+highlighted item of either the todo or appointment list will be removed from
+this list.
+
+If the item to be deleted is recurrent, you will be asked if you wish to
+suppress all of the item occurrences or just the one you selected.
+
+If the general option 'confirm_delete' is set to 'YES', then you will be asked
+for confirmation before deleting the selected event. Do not forget to save the
+calendar data to retrieve the modifications next time you launch calcurse.

doc/de/displacement.txt

@@ -0,0 +1,25 @@
+Displacement keys
+=================
+
+Move around inside calcurse screens.
+
+The following scheme summarizes how to get around:
+
+                               move up
+                        move to previous week
+
+                                 k K UP 
+       move left                  ^  
+ move to previous day             |
+                      h H LFT 
+                            <--   +  -->
+                                           l L RGT 
+                                  |            move right
+                                  v         move to next day
+                                 j J DWN 
+
+                          move to next week
+                              move down
+
+Moreover, while inside the calendar panel, the '0' key moves to the first day
+of the week, and the '$' key selects the last day of the week.

doc/de/edit.txt

@@ -0,0 +1,27 @@
+Edit Item
+=========
+
+Edit the item which is currently selected.
+
+Depending on the item type (appointment, event or todo) and item repetition,
+you will be asked to choose one of the item properties to modify. An item
+property is one of the following: the start time, the end time, the
+description, or the item repetition. You can also move an item, that is, move
+an item without changing its duration.
+
+Once you have chosen the property you want to modify, you will be shown its
+actual value, and you will be able to change it as you like.
+
+Notes
+-----
+
+* If you choose to edit the item repetition properties, you will be asked to
+  re-enter all of the repetition characteristics (repetition type, frequency,
+  and ending date). Moreover, the previous data concerning the deleted
+  occurrences will be lost.
+
+* You can enter an empty end time to convert an existing appointment into a
+  punctual appointment.
+
+* Do not forget to save the calendar data to retrieve the modified properties
+  next time you launch Calcurse.

doc/de/enote.txt

@@ -0,0 +1,24 @@
+EditNote
+========
+
+Attach a note to any type of item, or edit an already existing note. This
+feature is useful if you do not have enough space to store all of your item
+description, or if you would like to add sub-tasks to an already existing todo
+item for example.
+
+You first need to highlight the item you want the note to be attached to. Then,
+after pressing the edit note key, you will be driven to an external editor to
+edit your note. This editor is chosen the following way:
+
+* If the 'VISUAL' environment variable is set, then this will be the default
+  editor to be called.
+
+* If 'VISUAL' is not set, then the 'EDITOR' environment variable will be used
+  as the default editor.
+
+* If none of the above environment variables is set, then '/usr/bin/vi' will be
+  used.
+
+Once the item note is edited and saved, quit your favorite editor. You will
+then go back to calcurse, and the '>' sign will appear in front of the
+highlighted item, meaning there is a note attached to it.

doc/de/export.txt

@@ -0,0 +1,21 @@
+Export
+======
+
+Export calcurse data (appointments, events and todos).
+
+This leads to the export submenu, from which you can choose between two
+different export formats: 'ical' and 'pcal'. Choosing one of those formats lets
+you export calcurse data to iCal or pcal format.
+
+You first need to specify the file to which the data will be exported.  By
+default, this file is:
+
+     ~/calcurse.ics
+
+for an ical export, and:
+
+     ~/calcurse.txt
+
+for a pcal export.
+
+calcurse data are exported in the following order: events, appointments, todos.

doc/de/flag.txt

@@ -0,0 +1,16 @@
+Flag Item
+=========
+
+Toggle an appointment's 'important' flag or a todo's 'completed' flag.  If a
+todo is flagged as completed, its priority number will be replaced by an 'X'
+sign. Completed tasks will no longer appear in exported data or when using the
+'-t' command line flag (unless specifying '0' as the priority number, in which
+case only completed tasks will be shown).
+
+If an appointment is flagged as important, an exclamation mark appears in front
+of it, and you will be warned if time gets closed to the appointment start
+time.
+
+To customize the way one gets notified, the configuration submenu lets you
+choose the command launched to warn user of an upcoming appointment, and how
+long before it he gets notified.

doc/de/general.txt

@@ -0,0 +1,28 @@
+Generic key bindings
+====================
+
+Some of the key bindings apply whatever panel is selected. They are called
+generic key bindings.
+
+Here is the list of all the generic key bindings, together with their
+corresponding action:
+
+ '^R' : Redraw function -> redraws calcurse panels, this is useful if
+                           you resize your terminal screen or when
+                           garbage appears inside the display
+ '^A' : Add Appointment -> add an appointment or an event
+ '^T' : Add TODO        -> add a todo
+ 'T' : -1 Day          -> move to previous day
+ 't' : +1 Day          -> move to next day
+ 'W' : -1 Week         -> move to previous week
+ 'w' : +1 Week         -> move to next week
+ 'M' : -1 Month        -> move to previous month
+ 'm' : +1 Month        -> move to next month
+ 'Y' : -1 Year         -> move to previous year
+ 'y' : +1 Year         -> move to next year
+ '^G' : Goto today      -> move to current day
+
+The '^P' and '^N' keys are used to scroll text upward or downward when inside
+specific screens such the help screens for example. They are also used when the
+calendar screen is selected to switch between the available views (monthly and
+weekly calendar views).

doc/de/goto.txt

@@ -0,0 +1,13 @@
+Goto
+====
+
+Jump to a specific day in the calendar.
+
+Using this command, you do not need to travel to that day using the
+displacement keys inside the calendar panel.
+
+If you hit [ENTER] without specifying any date, calcurse checks the system
+current date and you will be taken to that date.
+
+Notice that you can also specify a global key binding to return to the current
+day, no matter which panel is currently selected.

doc/de/import.txt

@@ -0,0 +1,20 @@
+Import
+======
+
+Import data from an iCal file.
+
+You will be asked to enter the file name from which to load iCal items. At the
+end of the import process, and if the general option 'system_dialogs' is set to
+'yes', a report indicating how many items were imported is shown.
+
+This report contains the total number of lines read, the number of
+appointments, events and todo items which were successfully imported, together
+with the number of items for which problems occurred and that were skipped, if
+any.
+
+If one or more items could not be imported, one has the possibility to read the
+import process report in order to identify which problems occurred.
+
+In this report is shown one item per line, with the line in the input stream at
+which this item begins, together with the description of why the item could not
+be imported.

doc/de/intro.txt

@@ -0,0 +1,15 @@
+calcurse Online Help
+====================
+
+Welcome to the calcurse online help. The online help system allows for easily
+getting help on specific calcurse features.
+
+On the calcurse main screen, type `:help <feature>` (e.g. `:help add`) or
+`:help <key>` (e.g. `:help ^A`) to get help on a specific feature or key
+binding. Type `:help` without any parameter to display this introduction or
+simply use the corresponding keyboard shortcut (`?` by default).
+
+All help texts are displayed using an external pager. You need to exit the
+pager in order to get back to calcurse (pressing `q` should almost always
+work). The default pager can be changed by setting the PAGER environment
+variable.

doc/de/other.txt

@@ -0,0 +1,11 @@
+OtherCmd
+========
+
+Switch between status bar help pages.
+
+Because the terminal screen is too narrow to display all of the available
+commands, this command can be used to see the next set of commands together
+with their key bindings.
+
+Once the last status bar page is reached, running the command another time
+leads you back to the first page.

doc/de/pipe.txt

@@ -0,0 +1,9 @@
+Pipe
+====
+
+Das ausgewählte Item an ein externes Programm weiterleiten.
+
+Drücken Sie die '|'-Taste (Pipe), um den momentan ausgewählten Eintrag an ein
+externes Programm weiterzugeben.
+
+Sie werden zurück zu Calcurse geleitet, sobald das Programm beendet ist.

doc/de/priority.txt

@@ -0,0 +1,16 @@
+Priority
+========
+
+Change the priority of the currently selected item in the todo list.
+Priorities are represented by the number appearing in front of the todo
+description. This number goes from 9 for the lowest priority to 1 for the
+highest priority. Todo items having higher priorities are placed first (at the
+top) inside the todo panel.
+
+By default, if you want to raise the priority of a todo item, you need to press
+'+'.  In doing so, the number in front of this item will decrease, meaning its
+priority increases. The item position inside the todo panel may change,
+depending on the priority of the items above it.
+
+At the opposite, to lower a todo priority, press '-'. The todo position may
+also change depending on the priority of the items below.

doc/de/repeat.txt

@@ -0,0 +1,35 @@
+Repeat
+======
+
+Repeat an event or an appointment.
+
+You must first select the item to be repeated by moving inside the appointment
+panel. Then running the repeat command will lead you to a set of three
+questions, with which you will be able to specify the repetition
+characteristics:
+
+  o        type: you can choose between a daily, weekly, monthly or
+                 yearly repetition by pressing 'D', 'W', 'M' or 'Y'
+                 respectively.
+
+  o   frequency: this indicates how often the item shall be repeated.
+                 For example, if you want to remember an anniversary,
+                 choose a 'yearly' repetition with a frequency of '1',
+                 which means it must be repeated every year. Another
+                 example: if you go to the restaurant every two days,
+                 choose a 'daily' repetition with a frequency of '2'.
+
+  o ending date: this specifies when to stop repeating the selected
+                 event or appointment. To indicate an endless 
+                 repetition, enter '0' and the item will be repeated
+                 forever.
+
+Notes
+-----
+
+* Repeated items are marked with an '*' inside the appointment panel, to be
+  easily recognizable from non-repeated ones.
+
+* The 'Repeat' and 'Delete' command can be mixed to create complicated
+  configurations, as it is possible to delete only one occurrence of a repeated
+  item.

doc/de/save.txt

@@ -0,0 +1,15 @@
+Save
+====
+
+Save calcurse data.
+
+Data are split into four different files which contain :
+
+         / ~/.calcurse/conf -> user configuration
+        |                      (layout, color, general options)
+        |  ~/.calcurse/apts -> data related to the appointments
+        |  ~/.calcurse/todo -> data related to the todo list
+         \ ~/.calcurse/keys -> user-defined key bindings
+
+In the config menu, you can choose to save the calcurse data automatically
+before quitting.

doc/de/tab.txt

@@ -0,0 +1,14 @@
+Tab
+===
+
+Switch between panels.
+
+The panel currently in use has its border colorized.
+
+Some actions are possible only if the right panel is selected. For example, if
+you want to add a task in the todo list, you need first to press the 'TAB' key
+to get the todo panel selected. Then you can press 'a' to add your item.
+
+Notice that at the bottom of the screen the list of possible actions change
+while pressing 'TAB', so you always know what action can be performed on the
+selected panel.

doc/de/view.txt

@@ -0,0 +1,12 @@
+View
+====
+
+View the item you select in either the todo or appointment panel.
+
+This is useful when an event description is longer than the available space to
+display it. If that is the case, the description will be shortened and its end
+replaced by '...'. To be able to read the entire description, just run the view
+command and a popup window will appear, containing the whole event.
+
+Press any key to close the popup window and go back to the main calcurse
+screen.

doc/de/vnote.txt

@@ -0,0 +1,20 @@
+ViewNote
+========
+
+View a note which was previously attached to an item (an item which owns a note
+has a '>' sign in front of it).
+
+This command only permits to view the note, not to edit it (to do so, use the
+'EditNote' command).
+
+Once you highlighted an item with a note attached to it, and the view note key
+was pressed, you will be driven to an external pager to view that note. The
+default pager is chosen the following way:
+
+* If the 'PAGER' environment variable is set, then this will be the default
+  viewer to be called.
+
+* If the above environment variable is not set, then '/usr/bin/less' will be
+  used.
+
+As for editing a note, quit the pager and you will be driven back to calcurse.