diff options
Diffstat (limited to 'doc')
132 files changed, 2595 insertions, 0 deletions
diff --git a/doc/de/add.txt b/doc/de/add.txt new file mode 100644 index 0000000..53e8e00 --- /dev/null +++ b/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. diff --git a/doc/de/config.txt b/doc/de/config.txt new file mode 100644 index 0000000..d5bace1 --- /dev/null +++ b/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. diff --git a/doc/de/copy-paste.txt b/doc/de/copy-paste.txt new file mode 100644 index 0000000..13926ea --- /dev/null +++ b/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. + diff --git a/doc/de/credits.txt b/doc/de/credits.txt new file mode 100644 index 0000000..5c6bb90 --- /dev/null +++ b/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 diff --git a/doc/de/delete.txt b/doc/de/delete.txt new file mode 100644 index 0000000..ff652e8 --- /dev/null +++ b/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. diff --git a/doc/de/displacement.txt b/doc/de/displacement.txt new file mode 100644 index 0000000..cfd2a97 --- /dev/null +++ b/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. diff --git a/doc/de/edit.txt b/doc/de/edit.txt new file mode 100644 index 0000000..4d72fb2 --- /dev/null +++ b/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. diff --git a/doc/de/enote.txt b/doc/de/enote.txt new file mode 100644 index 0000000..78fd14b --- /dev/null +++ b/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. diff --git a/doc/de/export.txt b/doc/de/export.txt new file mode 100644 index 0000000..2238141 --- /dev/null +++ b/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. diff --git a/doc/de/flag.txt b/doc/de/flag.txt new file mode 100644 index 0000000..fb04d88 --- /dev/null +++ b/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. diff --git a/doc/de/general.txt b/doc/de/general.txt new file mode 100644 index 0000000..d2a79d9 --- /dev/null +++ b/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). diff --git a/doc/de/goto.txt b/doc/de/goto.txt new file mode 100644 index 0000000..b1c34eb --- /dev/null +++ b/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. diff --git a/doc/de/import.txt b/doc/de/import.txt new file mode 100644 index 0000000..88e63be --- /dev/null +++ b/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. diff --git a/doc/de/intro.txt b/doc/de/intro.txt new file mode 100644 index 0000000..9b91c86 --- /dev/null +++ b/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. diff --git a/doc/de/other.txt b/doc/de/other.txt new file mode 100644 index 0000000..80dcfc5 --- /dev/null +++ b/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. diff --git a/doc/de/pipe.txt b/doc/de/pipe.txt new file mode 100644 index 0000000..89b049a --- /dev/null +++ b/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. diff --git a/doc/de/priority.txt b/doc/de/priority.txt new file mode 100644 index 0000000..2476825 --- /dev/null +++ b/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. diff --git a/doc/de/repeat.txt b/doc/de/repeat.txt new file mode 100644 index 0000000..16a71da --- /dev/null +++ b/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. diff --git a/doc/de/save.txt b/doc/de/save.txt new file mode 100644 index 0000000..9c453ba --- /dev/null +++ b/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. diff --git a/doc/de/tab.txt b/doc/de/tab.txt new file mode 100644 index 0000000..348a633 --- /dev/null +++ b/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. diff --git a/doc/de/view.txt b/doc/de/view.txt new file mode 100644 index 0000000..c50f028 --- /dev/null +++ b/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. diff --git a/doc/de/vnote.txt b/doc/de/vnote.txt new file mode 100644 index 0000000..2099c48 --- /dev/null +++ b/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. 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. diff --git a/doc/fr/add.txt b/doc/fr/add.txt new file mode 100644 index 0000000..f27ebb6 --- /dev/null +++ b/doc/fr/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/fr/config.txt b/doc/fr/config.txt new file mode 100644 index 0000000..d5bace1 --- /dev/null +++ b/doc/fr/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/fr/copy-paste.txt b/doc/fr/copy-paste.txt new file mode 100644 index 0000000..34ba7b2 --- /dev/null +++ b/doc/fr/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/fr/credits.txt b/doc/fr/credits.txt new file mode 100644 index 0000000..5c6bb90 --- /dev/null +++ b/doc/fr/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/fr/delete.txt b/doc/fr/delete.txt new file mode 100644 index 0000000..ff652e8 --- /dev/null +++ b/doc/fr/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/fr/displacement.txt b/doc/fr/displacement.txt new file mode 100644 index 0000000..cfd2a97 --- /dev/null +++ b/doc/fr/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/fr/edit.txt b/doc/fr/edit.txt new file mode 100644 index 0000000..4d72fb2 --- /dev/null +++ b/doc/fr/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/fr/enote.txt b/doc/fr/enote.txt new file mode 100644 index 0000000..78fd14b --- /dev/null +++ b/doc/fr/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/fr/export.txt b/doc/fr/export.txt new file mode 100644 index 0000000..2238141 --- /dev/null +++ b/doc/fr/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/fr/flag.txt b/doc/fr/flag.txt new file mode 100644 index 0000000..fb04d88 --- /dev/null +++ b/doc/fr/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/fr/general.txt b/doc/fr/general.txt new file mode 100644 index 0000000..d2a79d9 --- /dev/null +++ b/doc/fr/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/fr/goto.txt b/doc/fr/goto.txt new file mode 100644 index 0000000..b1c34eb --- /dev/null +++ b/doc/fr/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/fr/import.txt b/doc/fr/import.txt new file mode 100644 index 0000000..88e63be --- /dev/null +++ b/doc/fr/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/fr/intro.txt b/doc/fr/intro.txt new file mode 100644 index 0000000..9b91c86 --- /dev/null +++ b/doc/fr/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/fr/other.txt b/doc/fr/other.txt new file mode 100644 index 0000000..80dcfc5 --- /dev/null +++ b/doc/fr/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/fr/pipe.txt b/doc/fr/pipe.txt new file mode 100644 index 0000000..2d0c6a7 --- /dev/null +++ b/doc/fr/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/fr/priority.txt b/doc/fr/priority.txt new file mode 100644 index 0000000..2476825 --- /dev/null +++ b/doc/fr/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/fr/repeat.txt b/doc/fr/repeat.txt new file mode 100644 index 0000000..16a71da --- /dev/null +++ b/doc/fr/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/fr/save.txt b/doc/fr/save.txt new file mode 100644 index 0000000..9c453ba --- /dev/null +++ b/doc/fr/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/fr/tab.txt b/doc/fr/tab.txt new file mode 100644 index 0000000..348a633 --- /dev/null +++ b/doc/fr/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/fr/view.txt b/doc/fr/view.txt new file mode 100644 index 0000000..c50f028 --- /dev/null +++ b/doc/fr/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/fr/vnote.txt b/doc/fr/vnote.txt new file mode 100644 index 0000000..2099c48 --- /dev/null +++ b/doc/fr/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. 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 <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/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. diff --git a/doc/pt_BR/add.txt b/doc/pt_BR/add.txt new file mode 100644 index 0000000..7bc9a3a --- /dev/null +++ b/doc/pt_BR/add.txt @@ -0,0 +1,42 @@ +Adicionar +========= + +Adiciona um item para a lista de tarefas ou de agendamentos, dependendo +de qual painel está selecionado. + +Para inserir um novo item na lista de tarefas, você precisa primeiro inserir +a descrição deste novo item. Então, você será solicitado para especificar a +prioridade da tarefa. Esta prioridade é representada por um número que vai de +9, como a menor prioridade, até 1, como a maior. Também é possível alterar a +prioridade do item posteriormente, usando as teclas '+' e '-' dentro do +painel de tarefas. + +Se o painel de agendamentos estiver selecionado, você poderá inserir o +novo agendamento ou um evento para dia inteiro. Para inserir um novo +evento, pressione [ENTER] ao invés do item de horário de início, e +simplesmente preencha a descrição do evento. + +Para inserir um novo agendamento a ser adicionado à lista de agendamentos, +será necessário que você insira sucessivamente o horário no que o agendamento +será iniciado, sua extensão (especificando o horário de término no formato +[hh:mm] ou a duração, no formato [+hh:mm], [+xxdxxhxxm] ou [+mm]) e a +descrição do evento. Se você pular o horário de término pressionando [ENTER], +um agendamento pontual será criado. + +O dia em que o evento ou agendamento ocorrerá é o dia atualmente +selecionado no calendário. Então, você deve mover para o dia desejado +antes. + +Notas +----- + +* Se um agendamento durar por tanto tempo que chegar a continuar pelos + próximos dias, este evento será indicado em todos os dias correspondentes, + e os horários de início ou término serão substituídos por '..' se o evento + não iniciar ou terminar no dia. + +* Se você apenas pressionar [ENTER] no prompt de descrição, sem qualquer + descrição, nenhum item será adicionado. + +* Não se esqueça de salvar os dados do calendário para obter o novo + evento na próxima vez que você iniciar o calcurse. diff --git a/doc/pt_BR/config.txt b/doc/pt_BR/config.txt new file mode 100644 index 0000000..247ab53 --- /dev/null +++ b/doc/pt_BR/config.txt @@ -0,0 +1,24 @@ +Config +====== + +Abre os submenus de configuração. A partir deste submenu, você pode +selecionar dentre várias cores, layout, notificações e opções em geral, +e você pode até mesmo configurar suas teclas de atalhos. + +O submenu de cor permite que você escolha o tema de cores. + +O submenu de layout permite que você escolha o layout da tela do calcurse. +Em outras palavras, permite definir onde colocar três painéis diferentes +na tela. + +O submenu de opções gerais, Geral, traz uma tela com opções diferentes, +que modificam a forma como Calcurse interage com o usuário. + +O submenu de notificação permite que você altere as configurações da barrade +notificação. + +O submenu de teclas permite que você defina seus próprios atalhos de +teclado. + +Não esqueça de salvar os dados do calendário para restaurar sua configuração +na próxima vez que você iniciar o calcurse. diff --git a/doc/pt_BR/copy-paste.txt b/doc/pt_BR/copy-paste.txt new file mode 100644 index 0000000..5be6aa3 --- /dev/null +++ b/doc/pt_BR/copy-paste.txt @@ -0,0 +1,11 @@ +Copiar e Colar +============== + +Copia e cola o item atualmente selecionado. Isso é útil para rapidamente +copiar um item de uma data para outra. Para isso, deve-se primeiro destacar +o item que precisa ser copiado e, então, pressionar a tecla designada +para de função de cópia. Assim que a nova data tiver sido escolhida no +calendário, o painel de agendamentos deve estar selecionado e a tecla +deve ser pressionado para colar o item. O item vai aparecer o painel de +agendamentos, atribuído à data selecionada. + diff --git a/doc/pt_BR/credits.txt b/doc/pt_BR/credits.txt new file mode 100644 index 0000000..e3f15c6 --- /dev/null +++ b/doc/pt_BR/credits.txt @@ -0,0 +1,22 @@ +Calcurse - organizador baseado em texto +======================================= + +Copyright (c) 2004-2013 Equipe de Desenvolvimento do Calcurse +Todos os direitos reservados. + +A redistribuição e uso na forma de código-fonte e binário, com ou +sem modificações, são permitidas na medida em que as seguintes +condições sejam cumpridas: + + - As redistribuições de código-fonte devem reter os direitos de + propriedade, a presente licença, esta lista de condições e a + seguinte ressalva. + + - As redistribuições em forma binária devem reproduzir a + presente licença, esta lista de condições e a seguinte + ressalva na documentação e/ou outros materiais fornecidos + com a distribuição. + + +Envie seu feedback ou comentários para : misc@calcurse.org +Homepage do Calcurse : http://calcurse.org diff --git a/doc/pt_BR/delete.txt b/doc/pt_BR/delete.txt new file mode 100644 index 0000000..d671c87 --- /dev/null +++ b/doc/pt_BR/delete.txt @@ -0,0 +1,16 @@ +Excluir +======= + +Exclui um elemento da lista de tarefas ou de agendamentos. + +Dependendo do painel selecionado, quando você pressionar a tecla de exclusão, +o item selecionado de tanto a lista de Tarefas quanto de agendamentos será +excluído desta lista. + +Se o item a ser excluído é recorrente, você será perguntado se você deseja +suprimir todas ocorrências deste item ou somente o item que você selecionou. + +Se a opção geral "confirm_delete" estiver definida para "SIM", a você +será solicitada confirmação antes de excluir o evento selecionado. Não +esqueça de salvar os dados do calendário para recuperar as modificações na +próxima vez que iniciar o calcurse. diff --git a/doc/pt_BR/displacement.txt b/doc/pt_BR/displacement.txt new file mode 100644 index 0000000..6f35cb6 --- /dev/null +++ b/doc/pt_BR/displacement.txt @@ -0,0 +1,25 @@ +Teclas de deslocamento +====================== + +Movimenta pelas telas do calcurse. + +O seguinte esquema resume como funciona a movimentação: + + move para cima + move para semana anterior + + k K UP + move para esquerda ^ + move para dia anterior | + h H LFT + <-- + --> + l L RGT + | move para direita + v move para dia seguinte + k K DWN + + move para semana seguinte + move para baixo + +Ademais, enquanto dentro do painel de calendário, a tecla "0" move para +o primeiro dia da semana, e a tecla "$" seleciona o último dia da semana. diff --git a/doc/pt_BR/edit.txt b/doc/pt_BR/edit.txt new file mode 100644 index 0000000..08cf2a5 --- /dev/null +++ b/doc/pt_BR/edit.txt @@ -0,0 +1,27 @@ +Editar item +=========== + +Edita o item selecionado. + +Dependendo do tipo do item (agendamento, evento, ou tarefa), e se ele for +repetido ou não, a você será solicitado que escolha uma das propriedades +do item a modificar. Uma propriedade de item é uma das seguintes: o horário +de início, o horário de término, a descrição ou a repetição do item. Você +também pode mover um item, isto é, mover um item sem alterar sua duração. + +Assim que você tiver escolhido a propriedade que você deseja modificar, será +mostrado o valor atual e você poderá alterá-lo como quiser. + +Notas +------ + +* Se você escolher editar as propriedades de repetição do item, a você + será solicitado que insira novamente todas as características de repetição + (tipo de repetição, frequência e data de término). Ademais, a data anterior + referente às ocorrências excluídas será perdida. + +* Você pode inserir um horário de término vazio para converter um agendamento + existente em um agendamento pontual. + +* Não esqueça de salvar os dados do calendário para recuperar as propriedades + modificadas na próxima vez que iniciar o calcurse. diff --git a/doc/pt_BR/enote.txt b/doc/pt_BR/enote.txt new file mode 100644 index 0000000..d7453a7 --- /dev/null +++ b/doc/pt_BR/enote.txt @@ -0,0 +1,25 @@ +EditarNota +========== + +Anexa uma nota a qualquer tipo de item, ou edita qualquer nota existente. +Este recurso é útil se você não tem espaço suficiente para armazenar toda +descrição de seu item ou se você deseja adicionar subtarefas para um item +de tarefa já existente, por exemplo. + +Você primeiro precisa selecionar o item ao qual você deseja que a nota seja +anexada. Então, após pressionar a tecla do editor de notas, você será levado +a um edito externo para editar a sua nota. O editor é escolhido das seguintes +formas: + +* Se a variável de ambiente "VISUAL" estiver definida, então este será o + editor padrão a ser chamado. + +* Se "VISUAL" não estiver definido, então a variável de ambiente "EDITOR" + será usada como o editor padrão. + +* Se nenhuma das variáveis de ambiente acima estiverem definidas, então + "/usr/bin/vi" será usado. + +Assim que a nota do item for editada e salvada, saia do seu editor favorito. +Então, você voltará para o calcurse, e o sinal ">" aparecerá na frente do +item selecionado, o que significa haver uma nota anexada a ele. diff --git a/doc/pt_BR/export.txt b/doc/pt_BR/export.txt new file mode 100644 index 0000000..9e37f7a --- /dev/null +++ b/doc/pt_BR/export.txt @@ -0,0 +1,23 @@ +Exportar +======== + +Exporta dados do calcurse (agendamentos, eventos e tarefas). + +Esta opção leva ao submenu de exportação, no qual você pode escolher +entre dois formatos diferentes de exportação: "ical" e "pcal". +Escolhendo um destes formatos, será exportado dados do calcurse +para o formato icalendar ou pcal. + +Você primeiro precisa especificar o arquivo para o qual o arquivo será +exportado. Por padrão, este arquivo será: + + ~/calcurse.ics + +para uma exportação em ical, e: + + ~/calcurse.txt + +para uma exportação em pcal. + +Os dados do calcurse são exportados na seguinte ordem: eventos, agendamentos, +tarefas. diff --git a/doc/pt_BR/flag.txt b/doc/pt_BR/flag.txt new file mode 100644 index 0000000..8d571a2 --- /dev/null +++ b/doc/pt_BR/flag.txt @@ -0,0 +1,19 @@ +Sinalizar Item +============== + +Alterna estado de sinalização de "importante" de um agendamento ou +de "finalizada" de uma tarefa. Se uma tarefa é sinalizada como +finalizada, seu número de prioridade será substituído por um sinal +"X". Tarefas finalizadas não vão mais aparecer nos dados exportados +ou quando se estiver usando a opção de linha de comando "-t" (a não +ser que tenha sido especificado "0" como o número de prioridade, +caso este em que somente tarefas finalizadas serão mostrados). + +Se um agendamento é sinalizado como importante, uma exclamação vai +aparecer na frente dele e você será avisado quando o horário de início +do agendamento se aproximar. + +Para personalizar a forma de notificação, o submenu de configuração +permite que você escolha o comando a ser executado para avisar o +usuário de um agendamento próximo e quanto tempo até que ele seja +notificado. diff --git a/doc/pt_BR/general.txt b/doc/pt_BR/general.txt new file mode 100644 index 0000000..cc3ecce --- /dev/null +++ b/doc/pt_BR/general.txt @@ -0,0 +1,29 @@ +Teclas de Atalhos Genéricas +=========================== + +Algumas das teclas de atalhos se aplicam a qualquer painel que esteja +selecionado. Elas são chamadas teclas de atalhos genéricas. + +Aqui está a lista de todas as teclas de atalhos genéricas, junto com +suas respectivas ações: + + '^R' : Redesenhar -> redesenha painéis do calcurse, sendo útil se + você redimensionar a sua tela de terminal ou + quando aparece lixo na visão do calcurse + '^A' : AdicAgend -> adiciona um agendamento ou um evento + '^T' : AdiTarefa -> adiciona uma tarefa + 'T' : -1 Dia -> move para dia anterior + 't' : +1 Dia -> move para dia seguinte + 'W' : -1 Semana -> move para semana anterior + 'w' : +1 Semana -> move para semana seguinte + 'M' : -1 Mês -> move para mês anterior + 'm' : +1 Mês -> move para mês seguinte + 'Y' : -1 Ano -> move para ano anterior + 'y' : +1 Ano -> move para ano seguinte + '^G' : IrPara hoje -> move para o dia de hoje + +As teclas '^P' e '^N' são usadas para rolar texto para cima e para +baixo quando se está dentro de telas específicas, como, por exemplo, +as telas de ajuda. Elas também são usadas quando a tela de calendário +está selecionada para se alternar entre as visões disponíveis (visão +de calendário mensal ou semanal). diff --git a/doc/pt_BR/goto.txt b/doc/pt_BR/goto.txt new file mode 100644 index 0000000..50d6f6b --- /dev/null +++ b/doc/pt_BR/goto.txt @@ -0,0 +1,13 @@ +Ir Para +======= + +Pula para um dia especificado no calendário. + +Ao usar este comando, você não precisará viajar até aquele dia +usando as teclas de movimentação dentro do painel de calendário. + +Se você pressionar [ENTER] sem especificar qualquer data, o calcurse +verifica a data atual do sistema e você será levado àquela data. + +Repare que ao especificar uma tecla de atalho global, não importa o +painel que esteja selecionado, será selecionado o dia atual no calendário. diff --git a/doc/pt_BR/import.txt b/doc/pt_BR/import.txt new file mode 100644 index 0000000..d0d92c8 --- /dev/null +++ b/doc/pt_BR/import.txt @@ -0,0 +1,22 @@ +Importar +======== + +Importa dados de um arquivo icalendar. + +Você será solicitado a inserir o nome de arquivo do qual serão +carregados itens de ical. No final do processo de importação, e se +a opção geral 'system_dialogs' estiver definida como 'yes', um +relatório indicando quantos itens foram importados será mostrado. + +Este relatório conterá o número total de linhas lidas, o número de +de agendamentos, eventos e tarefas que foram importados com +sucesso, junto com o número de itens que apresentaram problemas e +que foram ignorados, se houver algum. + +Se um ou mais itens não puder ser importados, é possível ler o relatório +do processo de importação para que se identifique que problemas +ocorreram. + +Neste relatório é exibido um item por linha, com a linha do fluxo de +entrada em que este item começa, junto com a descrição do porquê o item +não pôde ser importado. diff --git a/doc/pt_BR/intro.txt b/doc/pt_BR/intro.txt new file mode 100644 index 0000000..a8952c7 --- /dev/null +++ b/doc/pt_BR/intro.txt @@ -0,0 +1,16 @@ +Ajuda Online do Calcurse +======================== + +Bem-vindo à ajuda online do calcurse. O sistema de ajuda online permite a +obtenção de ajuda sobre recursos específicos do calcurse. + +Na tela principal do calcurse, digite ":help <recurso>" (ex.: ":help add") +ou ":help <tecla>" (ex.: ":help ^A") para obter ajuda sobre um recurso +específico ou tecla de atalho. Digite ":help" sem qualquer parâmetro para +exibir esta introdução ou simplesmente use o atalho de teclado correspondente +("?" por padrão). + +Todos os textos de ajuda são exibidos usando um paginador externo. Você +precisa sair do paginador para voltar ao calcurse (pressionar "q" deve +quase sempre funcionar). O paginador padrão pode ser alterado ao definir +a variável de ambiente PAGER. diff --git a/doc/pt_BR/other.txt b/doc/pt_BR/other.txt new file mode 100644 index 0000000..0002249 --- /dev/null +++ b/doc/pt_BR/other.txt @@ -0,0 +1,11 @@ +OutroCmd +======== + +Alterna entre páginas de ajuda de barra de status. + +Por a tela do terminal ser muito estreita para exibir todos os +comandos disponíveis, este comando pode ser usado para ver o +próximo conjunto de comandos junto com suas teclas de atalhos. + +Assim que se chegar à última página de barra de status, ao se executar +o comando mais uma vez levará você de volta para a primeira página. diff --git a/doc/pt_BR/pipe.txt b/doc/pt_BR/pipe.txt new file mode 100644 index 0000000..e355f1a --- /dev/null +++ b/doc/pt_BR/pipe.txt @@ -0,0 +1,10 @@ +Redirecionar +============ + +Redireciona o item selecionado para um programa externo. + +Pressione a tecla '|' para redirecionar a entrada de agendamento ou +tarefa selecionada para um programa externo. + +Você será trazido de volta para o calcurse assim que o programa +for finalizado. diff --git a/doc/pt_BR/priority.txt b/doc/pt_BR/priority.txt new file mode 100644 index 0000000..e6c63cc --- /dev/null +++ b/doc/pt_BR/priority.txt @@ -0,0 +1,18 @@ +Prioridade +========== + +Altera a prioridade do item atualmente selecionado na lista de tarefas. +Prioridades são representadas pelo número que aparece na frente da +descrição da tarefa. O número vai desde 9, para a menor prioridade, até +1, para a maior prioridade. As tarefas que tenham maior prioridade serão +posicionadas primeiro (no topo) dentro do painel de tarefas. + +Se você desejar aumentar a prioridade de um item de tarefa, você deverá +pressionar "%s". Ao fazer isso, o número da prioridade deste item será +reduzida, o que significa um aumento na sua prioridade. A posição do +item dentro do painel de tarefas pode mudar, dependendo da prioridade dos +itens acima deste. + +E o contrário, para diminuir a prioridade de uma tarefa, pressione "-". +A posição da tarefa pode também alterar dependendo da prioridade dos +demais itens abaixo deste. diff --git a/doc/pt_BR/repeat.txt b/doc/pt_BR/repeat.txt new file mode 100644 index 0000000..00f04cc --- /dev/null +++ b/doc/pt_BR/repeat.txt @@ -0,0 +1,37 @@ +Repetir +======= + +Repete um evento ou um agendamento. + +Primeiro você deve que selecionar o item a ser repetido movendo-o dentro +do painel de agendamentos. Então, ao executar o comando de repetição, levará +você a um conjunto de três perguntas, com as quais você poderá +especificar as caraterísticas da repetição: + + o tipo: você pode escolher entre uma repetição diária, + semanal, mensal ou anual pressionando, "D", + "W","M" ou "Y", respectivamente. + + o frequência: indica com qual frequência o item deve se repetir. + Por exemplo, se você deseja sempre se lembrar de um + aniversário, escolha uma repetição "anual" com uma + frequência de "1", o que significa que deve repetir + todo ano. Outro exemplo: se você vai ao restaurante + a cada dois dias, escolha uma repetição "diária" com + frequência de "2". + + o data final: isso especifica quando deve parar a repetição do + evento ou agendamento selecionado. Para indicar + uma repetição sem fim, insira "0" e o item + será repetido para sempre. + +Notas +----- + +* Itens repetidos são marcados com um "*" dentro do painel de + agendamentos, para ser facilmente diferenciável dos não + repetidos. + +* Os comandos "Repetir" e "Excluir" podem ser combinados para + para criar configurações complicadas, já que é possível + excluir somente uma ocorrência de um item repetido. diff --git a/doc/pt_BR/save.txt b/doc/pt_BR/save.txt new file mode 100644 index 0000000..febdf18 --- /dev/null +++ b/doc/pt_BR/save.txt @@ -0,0 +1,15 @@ +Salvar +====== + +Salva dados do calcurse. + +Dados serão separados em quatro arquivos diferentes contendo : + + / ~/.calcurse/conf -> configuração do usuário + | (layout, cores, opções gerais) + | ~/.calcurse/apts -> dados relacionados a agendamentos + | ~/.calcurse/todo -> dados relacionados a lista de tarefas + \ ~/.calcurse/keys -> teclas de atalho do usuário + +No menu Config, você pode escolher salvar os dados do Calcurse +automaticamente antes de cada saída. diff --git a/doc/pt_BR/tab.txt b/doc/pt_BR/tab.txt new file mode 100644 index 0000000..4369c98 --- /dev/null +++ b/doc/pt_BR/tab.txt @@ -0,0 +1,16 @@ +Aba +=== + +Alterna entre painéis. + +O painel em uso no momento tem a sua borda colorizada. + +Algumas ações são possíveis somente se o painel correto estiver +selecionado. Por exemplo, se você quer adicionar uma tarefa na +lista de TAREFAS, você precisa primeiro pressionar a tecla "TAB" +para que o painel de tarefas seja selecionado. Então, você poderá +pressionar "a" para adicionar seu item. + +Repare como na parte inferior da tela a lista de ações possíveis muda +quando se pressiona "TAB", de forma que você sempre saberá qual ação +pode ser executada no painel selecionado. diff --git a/doc/pt_BR/view.txt b/doc/pt_BR/view.txt new file mode 100644 index 0000000..c0a4cb1 --- /dev/null +++ b/doc/pt_BR/view.txt @@ -0,0 +1,14 @@ +Ver +=== + +Vê o item que você selecionou em tanto no painel de tarefas quanto de +agendamentos. + +Isto é útil quando a descrição de um evento é maior do que o espaço +disponível para exibi-lo. Se esse for o caso, a descrição será +reduzida e seu final será substituído por "...". Para ler a descrição +por inteiro, basta pressionar "%s" e uma janela de pop-up aparecerá, +contendo o evento completo. + +Pressione qualquer tecla para fechar a janela pop-up e vá para a tela +principal do Calcurse. diff --git a/doc/pt_BR/vnote.txt b/doc/pt_BR/vnote.txt new file mode 100644 index 0000000..f0f597b --- /dev/null +++ b/doc/pt_BR/vnote.txt @@ -0,0 +1,22 @@ +VerNota +======= + +Vê uma nota que foi previamente anexada a um item (um item que possui +uma nota tem um sinal ">" na sua frente). + +Este comando somente permite que se visualize a note, e não que se edite +(para fazê-lo, use o comando "EditarNota"). + +Assim que você tiver realçado um item contendo uma nota anexada, e a +tecla de ver nota for pressionada, você será levado para um paginador +externo para ver aquela nota. O paginador padrão é escolhido das +seguintes formas: + +* se a variávei de ambiente "PAGER" estiver definida, então esta + será chamada como visualizador padrão. + +* Se a variável de ambiente acima não estiver definida, então + "/usr/bin/less" será usado. + +Quanto à edição de notas, saia do paginador e você será levado de volta +ao Calcurse. diff --git a/doc/ru/add.txt b/doc/ru/add.txt new file mode 100644 index 0000000..bc8b4e4 --- /dev/null +++ b/doc/ru/add.txt @@ -0,0 +1,37 @@ +Добавить +=== + +Добавление записи в дело или в задачи зависит от текущей выбранной панели. + +Чтобы добавить новую запись в список дел, необходимо для начала войти в описание +этой новой записи, где будет предложено уточнить приоритет дела. Приоритет +представлен числами от 9 - низкий - до 1 - высокий. Впоследствии возможно +изменить приоритет дела, используя клавиши '+' и '-' внутри панели дел. + +Если выбрана панель задач, то можно добавить новую задачу или новое +событие на весь день. Для добавления нового события нажмите [ENTER] +вместо указания времени начала и просто заполните описание события. + +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. + +День, отображающий событие или задачу это выбранный день в календаре. +Выберите нужный вам день. + +Заметки +----- + +* 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. + +* Если вы просто нажали [ENTER] в командной строке описания, без заполнения +оного, то запись не будет создана. + +* Не забудьте сохранить данные при выходе, чтобы созданные события +были доступны при следующем запуске. diff --git a/doc/ru/config.txt b/doc/ru/config.txt new file mode 100644 index 0000000..d5bace1 --- /dev/null +++ b/doc/ru/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/ru/copy-paste.txt b/doc/ru/copy-paste.txt new file mode 100644 index 0000000..34ba7b2 --- /dev/null +++ b/doc/ru/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/ru/credits.txt b/doc/ru/credits.txt new file mode 100644 index 0000000..5c6bb90 --- /dev/null +++ b/doc/ru/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/ru/delete.txt b/doc/ru/delete.txt new file mode 100644 index 0000000..ff652e8 --- /dev/null +++ b/doc/ru/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/ru/displacement.txt b/doc/ru/displacement.txt new file mode 100644 index 0000000..cfd2a97 --- /dev/null +++ b/doc/ru/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/ru/edit.txt b/doc/ru/edit.txt new file mode 100644 index 0000000..4d72fb2 --- /dev/null +++ b/doc/ru/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/ru/enote.txt b/doc/ru/enote.txt new file mode 100644 index 0000000..78fd14b --- /dev/null +++ b/doc/ru/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/ru/export.txt b/doc/ru/export.txt new file mode 100644 index 0000000..2238141 --- /dev/null +++ b/doc/ru/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/ru/flag.txt b/doc/ru/flag.txt new file mode 100644 index 0000000..fb04d88 --- /dev/null +++ b/doc/ru/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/ru/general.txt b/doc/ru/general.txt new file mode 100644 index 0000000..d2a79d9 --- /dev/null +++ b/doc/ru/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/ru/goto.txt b/doc/ru/goto.txt new file mode 100644 index 0000000..5cd59c7 --- /dev/null +++ b/doc/ru/goto.txt @@ -0,0 +1,13 @@ +Goto +==== + +Переход на заданный день в календаре. + +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/ru/import.txt b/doc/ru/import.txt new file mode 100644 index 0000000..88e63be --- /dev/null +++ b/doc/ru/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/ru/intro.txt b/doc/ru/intro.txt new file mode 100644 index 0000000..9b91c86 --- /dev/null +++ b/doc/ru/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/ru/other.txt b/doc/ru/other.txt new file mode 100644 index 0000000..80dcfc5 --- /dev/null +++ b/doc/ru/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/ru/pipe.txt b/doc/ru/pipe.txt new file mode 100644 index 0000000..2d0c6a7 --- /dev/null +++ b/doc/ru/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/ru/priority.txt b/doc/ru/priority.txt new file mode 100644 index 0000000..2476825 --- /dev/null +++ b/doc/ru/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/ru/repeat.txt b/doc/ru/repeat.txt new file mode 100644 index 0000000..16a71da --- /dev/null +++ b/doc/ru/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/ru/save.txt b/doc/ru/save.txt new file mode 100644 index 0000000..9c453ba --- /dev/null +++ b/doc/ru/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/ru/tab.txt b/doc/ru/tab.txt new file mode 100644 index 0000000..348a633 --- /dev/null +++ b/doc/ru/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/ru/view.txt b/doc/ru/view.txt new file mode 100644 index 0000000..c50f028 --- /dev/null +++ b/doc/ru/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/ru/vnote.txt b/doc/ru/vnote.txt new file mode 100644 index 0000000..e27640c --- /dev/null +++ b/doc/ru/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). + +Этой командой можно только просмотреть записку, а не редактировать её +(для редактирование нужно воспользоваться командой 'EditNote'). + +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. + +* Если переменная окружения не задана, то будет использоваться +'/usr/bin/less'. + +As for editing a note, quit the pager and you will be driven back to calcurse. |