doc/: Add translated documentation

Created using `po2txt` from translate-toolkit.

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

22 files changed, 428 insertions, 0 deletions

diff --git a/doc/es/add.txt b/doc/es/add.txt
new file mode 100644
index 0000000..f27ebb6
--- /dev/null
+++ b/doc/es/add.txt
@@ -0,0 +1,39 @@
+Add
+===
+
+Add an item in either the todo or appointment list, depending on which panel is
+selected.
+
+To enter a new item in the todo list, you will need first to enter the
+description of this new item. Then you will be asked to specify the todo
+priority. This priority is represented by a number going from 9 for the lowest
+priority, to 1 for the highest one. It is still possible to change the item
+priority afterwards, by using the '+' and '-' keys inside the todo panel.
+
+If the appointment panel is selected, you will be able to enter either a new
+appointment or a new all-day long event. To enter a new event, press [ENTER]
+instead of the item start time, and just fill in the event description.
+
+To enter a new appointment to be added in the appointment list, you will need
+to enter successively the time at which the appointment begins, the appointment
+length (either by specifying the end time in [hh:mm] or the duration in
+[+hh:mm], [+xxdxxhxxm] or [+mm] format), and the description of the event. If
+you skip the end time by pressing [ENTER], a punctual appointment will be
+created.
+
+The day at which occurs the event or appointment is the day currently selected
+in the calendar, so you need to move to the desired day before.
+
+Notes
+-----
+
+* If an appointment lasts for such a long time that it continues on the next
+  days, this event will be indicated on all the corresponding days, and the
+  beginning or ending hour will be replaced by '..' if the event does not begin
+  or end on the day.
+
+* If you only press [ENTER] at the description prompt, without any description,
+  no item will be added.
+
+* Do not forget to save the calendar data to retrieve the new event next time
+  you launch calcurse.
diff --git a/doc/es/config.txt b/doc/es/config.txt
new file mode 100644
index 0000000..d5bace1
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/copy-paste.txt b/doc/es/copy-paste.txt
new file mode 100644
index 0000000..34ba7b2
--- /dev/null
+++ b/doc/es/copy-paste.txt
@@ -0,0 +1,10 @@
+Copy and Paste
+==============
+
+Copy and paste the currently selected item. This is useful to quickly copy an
+item from one date to another. To do so, one must first highlight the item that
+needs to be copied, then press the key assigned to the copy function. Once the
+new date is chosen in the calendar, the appointment panel must be selected and
+the paste key must be pressed to paste the item. The item will appear in the
+appointment panel, assigned to the newly selected date.
+
diff --git a/doc/es/credits.txt b/doc/es/credits.txt
new file mode 100644
index 0000000..5c6bb90
--- /dev/null
+++ b/doc/es/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
diff --git a/doc/es/delete.txt b/doc/es/delete.txt
new file mode 100644
index 0000000..ff652e8
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/displacement.txt b/doc/es/displacement.txt
new file mode 100644
index 0000000..cfd2a97
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/edit.txt b/doc/es/edit.txt
new file mode 100644
index 0000000..4d72fb2
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/enote.txt b/doc/es/enote.txt
new file mode 100644
index 0000000..78fd14b
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/export.txt b/doc/es/export.txt
new file mode 100644
index 0000000..2238141
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/flag.txt b/doc/es/flag.txt
new file mode 100644
index 0000000..fb04d88
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/general.txt b/doc/es/general.txt
new file mode 100644
index 0000000..d2a79d9
--- /dev/null
+++ b/doc/es/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).
diff --git a/doc/es/goto.txt b/doc/es/goto.txt
new file mode 100644
index 0000000..b1c34eb
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/import.txt b/doc/es/import.txt
new file mode 100644
index 0000000..88e63be
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/intro.txt b/doc/es/intro.txt
new file mode 100644
index 0000000..9b91c86
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/other.txt b/doc/es/other.txt
new file mode 100644
index 0000000..80dcfc5
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/pipe.txt b/doc/es/pipe.txt
new file mode 100644
index 0000000..2d0c6a7
--- /dev/null
+++ b/doc/es/pipe.txt
@@ -0,0 +1,9 @@
+Pipe
+====
+
+Pipe the selected item to an external program.
+
+Press the '|' key to pipe the currently selected appointment or todo entry to
+an external program.
+
+You will be driven back to calcurse as soon as the program exits.
diff --git a/doc/es/priority.txt b/doc/es/priority.txt
new file mode 100644
index 0000000..2476825
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/repeat.txt b/doc/es/repeat.txt
new file mode 100644
index 0000000..16a71da
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/save.txt b/doc/es/save.txt
new file mode 100644
index 0000000..9c453ba
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/tab.txt b/doc/es/tab.txt
new file mode 100644
index 0000000..348a633
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/view.txt b/doc/es/view.txt
new file mode 100644
index 0000000..c50f028
--- /dev/null
+++ b/doc/es/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.
diff --git a/doc/es/vnote.txt b/doc/es/vnote.txt
new file mode 100644
index 0000000..2099c48
--- /dev/null
+++ b/doc/es/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.