From 47804c9d208802095d7cd594300e5a2070b4f1b8 Mon Sep 17 00:00:00 2001 From: Lukas Fleischer Date: Tue, 27 Aug 2013 17:43:44 +0200 Subject: doc/: Add translated documentation Created using `po2txt` from translate-toolkit. Signed-off-by: Lukas Fleischer --- doc/nl/add.txt | 39 +++++++++++++++++++++++++++++++++++++++ doc/nl/config.txt | 21 +++++++++++++++++++++ doc/nl/copy-paste.txt | 10 ++++++++++ doc/nl/credits.txt | 22 ++++++++++++++++++++++ doc/nl/delete.txt | 15 +++++++++++++++ doc/nl/displacement.txt | 25 +++++++++++++++++++++++++ doc/nl/edit.txt | 27 +++++++++++++++++++++++++++ doc/nl/enote.txt | 24 ++++++++++++++++++++++++ doc/nl/export.txt | 21 +++++++++++++++++++++ doc/nl/flag.txt | 16 ++++++++++++++++ doc/nl/general.txt | 28 ++++++++++++++++++++++++++++ doc/nl/goto.txt | 13 +++++++++++++ doc/nl/import.txt | 20 ++++++++++++++++++++ doc/nl/intro.txt | 15 +++++++++++++++ doc/nl/other.txt | 11 +++++++++++ doc/nl/pipe.txt | 9 +++++++++ doc/nl/priority.txt | 16 ++++++++++++++++ doc/nl/repeat.txt | 35 +++++++++++++++++++++++++++++++++++ doc/nl/save.txt | 15 +++++++++++++++ doc/nl/tab.txt | 14 ++++++++++++++ doc/nl/view.txt | 12 ++++++++++++ doc/nl/vnote.txt | 20 ++++++++++++++++++++ 22 files changed, 428 insertions(+) create mode 100644 doc/nl/add.txt create mode 100644 doc/nl/config.txt create mode 100644 doc/nl/copy-paste.txt create mode 100644 doc/nl/credits.txt create mode 100644 doc/nl/delete.txt create mode 100644 doc/nl/displacement.txt create mode 100644 doc/nl/edit.txt create mode 100644 doc/nl/enote.txt create mode 100644 doc/nl/export.txt create mode 100644 doc/nl/flag.txt create mode 100644 doc/nl/general.txt create mode 100644 doc/nl/goto.txt create mode 100644 doc/nl/import.txt create mode 100644 doc/nl/intro.txt create mode 100644 doc/nl/other.txt create mode 100644 doc/nl/pipe.txt create mode 100644 doc/nl/priority.txt create mode 100644 doc/nl/repeat.txt create mode 100644 doc/nl/save.txt create mode 100644 doc/nl/tab.txt create mode 100644 doc/nl/view.txt create mode 100644 doc/nl/vnote.txt (limited to 'doc/nl') diff --git a/doc/nl/add.txt b/doc/nl/add.txt new file mode 100644 index 0000000..f27ebb6 --- /dev/null +++ b/doc/nl/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/nl/config.txt b/doc/nl/config.txt new file mode 100644 index 0000000..d5bace1 --- /dev/null +++ b/doc/nl/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/nl/copy-paste.txt b/doc/nl/copy-paste.txt new file mode 100644 index 0000000..34ba7b2 --- /dev/null +++ b/doc/nl/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/nl/credits.txt b/doc/nl/credits.txt new file mode 100644 index 0000000..5c6bb90 --- /dev/null +++ b/doc/nl/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/nl/delete.txt b/doc/nl/delete.txt new file mode 100644 index 0000000..ff652e8 --- /dev/null +++ b/doc/nl/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/nl/displacement.txt b/doc/nl/displacement.txt new file mode 100644 index 0000000..cfd2a97 --- /dev/null +++ b/doc/nl/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/nl/edit.txt b/doc/nl/edit.txt new file mode 100644 index 0000000..4d72fb2 --- /dev/null +++ b/doc/nl/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/nl/enote.txt b/doc/nl/enote.txt new file mode 100644 index 0000000..78fd14b --- /dev/null +++ b/doc/nl/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/nl/export.txt b/doc/nl/export.txt new file mode 100644 index 0000000..2238141 --- /dev/null +++ b/doc/nl/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/nl/flag.txt b/doc/nl/flag.txt new file mode 100644 index 0000000..fb04d88 --- /dev/null +++ b/doc/nl/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/nl/general.txt b/doc/nl/general.txt new file mode 100644 index 0000000..d2a79d9 --- /dev/null +++ b/doc/nl/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/nl/goto.txt b/doc/nl/goto.txt new file mode 100644 index 0000000..b1c34eb --- /dev/null +++ b/doc/nl/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/nl/import.txt b/doc/nl/import.txt new file mode 100644 index 0000000..88e63be --- /dev/null +++ b/doc/nl/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/nl/intro.txt b/doc/nl/intro.txt new file mode 100644 index 0000000..9b91c86 --- /dev/null +++ b/doc/nl/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 ` (e.g. `:help add`) or +`:help ` (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/nl/other.txt b/doc/nl/other.txt new file mode 100644 index 0000000..80dcfc5 --- /dev/null +++ b/doc/nl/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/nl/pipe.txt b/doc/nl/pipe.txt new file mode 100644 index 0000000..2d0c6a7 --- /dev/null +++ b/doc/nl/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/nl/priority.txt b/doc/nl/priority.txt new file mode 100644 index 0000000..2476825 --- /dev/null +++ b/doc/nl/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/nl/repeat.txt b/doc/nl/repeat.txt new file mode 100644 index 0000000..16a71da --- /dev/null +++ b/doc/nl/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/nl/save.txt b/doc/nl/save.txt new file mode 100644 index 0000000..9c453ba --- /dev/null +++ b/doc/nl/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/nl/tab.txt b/doc/nl/tab.txt new file mode 100644 index 0000000..348a633 --- /dev/null +++ b/doc/nl/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/nl/view.txt b/doc/nl/view.txt new file mode 100644 index 0000000..c50f028 --- /dev/null +++ b/doc/nl/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/nl/vnote.txt b/doc/nl/vnote.txt new file mode 100644 index 0000000..2099c48 --- /dev/null +++ b/doc/nl/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. -- cgit v1.2.3-70-g09d2