Jump to content

KonsoleKalendar: Difference between revisions

From KDE UserBase Wiki
Annew (talk | contribs)
Markup edit
RogueScholar (talk | contribs)
Update uses of Input template following upgrade to SyntaxHighlight extension
 
(3 intermediate revisions by 3 users not shown)
Line 2: Line 2:
<translate>
<translate>


<!--T:1-->
{|class="tablecenter vertical-centered"
{|class="tablecenter vertical-centered"
|[[Image:Konsolekalendar-view.png|250px|thumb]]||'''Use your calendar when you can't us a graphical user interface'''
| [[File:Konsolekalendar-view.png|250px|thumb]]
| '''Use your calendar when you can't use a graphical user interface'''
|}
|}


<!--T:2-->
'''konsolekalendar''' is an application to administer a calendar without a graphical user interface. It normally works with the calendar that is marked "Default", if you use '''KOrganizer'''.  However, it is possible to create a calendar if you don't have one already.
'''konsolekalendar''' is an application to administer a calendar without a graphical user interface. It normally works with the calendar that is marked "Default", if you use '''KOrganizer'''.  However, it is possible to create a calendar if you don't have one already.


<!--T:3-->
As it is strictly a command-line application, '''konsolekalendar''''s syntax must be learned first.  
As it is strictly a command-line application, '''konsolekalendar''''s syntax must be learned first.  


<!--T:4-->
Here is a short introduction to using '''konsolekalendar''':
Here is a short introduction to using '''konsolekalendar''':




* If you do not already have a calendar set up, you first need to create one
<!--T:5-->
{{Input|1=konsolekalendar --create --file ~/.kde/share/apps/korganizer/vacation.ics}}
* If you do not already have a calendar set up, you first need to create one: {{Input|lang=shell|1=konsolekalendar --create --file ~/.kde/share/apps/korganizer/vacation.ics}}


(This location will enable it to be used either in '''konsolekalendar''' or in '''korganizer'''.)
<!--T:6-->
:(This location will enable it to be used either in '''konsolekalendar''' or in '''korganizer'''.)




* Add a calendar entry
<!--T:7-->
{{Input|1=konsolekalendar --add --date 2009-06-06 --summary "My Birthday" \
* Add your birthday to the default calendar: {{Input|lang=shell|1=konsolekalendar --add --date 2009-06-06 --summary "My Birthday" --description "Party Time"}}
--description "Party Time"}}adds your birthday to your default calendar.




* Add a vacation
<!--T:8-->
{{Input|1=konsolekalendar --add --file vacation.ics --date 2009-08-01 \
* Add a vacation: {{Input|lang=shell|1=konsolekalendar --add --file vacation.ics --date 2009-08-01 --end-date 2009-08-07 --summary "Vacation" \
--end-date 2009-08-07 --summary "Vacation" --description "Nobody will ever find me!"}}
  --description "Nobody will ever find me!"}}
    
    


* Show all calendar entries
<!--T:9-->
{{Input|1=konsolekalendar --all 2>errorlog }}
* Show all calendar entries: {{Input|lang=shell|1=konsolekalendar --all 2>errorlog}}




You probably don't want to do this, if you have been using your calendar for long.  However, you can specify date ranges:
<!--T:10-->
{{Input|1=konsolekalendar --view --date 2009-08-17 --end-date 2009-08-21}}shows that particular work-week.
* You probably don't want to do this if you have been using your calendar for long, however, you can specify date ranges, as in… {{Input|lang=shell|1=konsolekalendar --view --date 2009-08-17 --end-date 2009-08-21}}
:…which shows that particular work week.




* Maybe you only wanted to see the next entry?
<!--T:11-->
{{Input|1=konsolekalendar --next}}
* Or maybe you only wanted to see the next entry? Then use: {{Input|lang=shell|1=konsolekalendar --next}}




* Or for the week ahead?
<!--T:12-->
{{Input|1=konsolekalendar --show-next 7}}
* Or for the week ahead? Try: {{Input|lang=shell|1=konsolekalendar --show-next 7}}




* Show your calendar file
<!--T:13-->
{{Input|1=konsolekalendar --view 2>&1 | grep resource | grep konsolekalendar}}
* To show your calendar file, the rubric is: {{Input|lang=shell|1=konsolekalendar --view 2>&1 {{!}} grep resource {{!}} grep konsolekalendar}}




* Edit an entry
<!--T:14-->
{{Input|1=konsolekalendar --change --uid libkcal-1652809671.172 --summary "Get my head examined" --description "I must be crazy!!"}}
* To edit an entry, use: {{Input|lang=shell|1=konsolekalendar --change --uid libkcal-1652809671.172 --summary "Get my head examined" \
  --description "I must be crazy!!"}}




* Before you can delete an entry, you first need to list it:
<!--T:15-->
[[Image:Konsolekalendar-list.png|300px|center]]
* Before you can delete an entry, you first need to list it: [[File:Konsolekalendar-list.png|thumb|right|641px]]




There at the bottom is the UID of the entry.
<!--T:16-->
:There at the bottom is the UID of the entry.


Now you are ready to delete it -
<!--T:17-->
{{Input|1=konsolekalendar --delete --uid libkcal-1652809671.172}}
{{Clear|right}}
:Now you are ready to delete it: {{Input|lang=shell|1=konsolekalendar --delete --uid libkcal-1652809671.172}}


<!--T:18-->
{{Warning|Beware - this is a permanent delete.  You cannot recover the entry }}
{{Warning|Beware - this is a permanent delete.  You cannot recover the entry }}




* Export a calendar
<!--T:19-->
It is possible to export to several formats, including ''CSV'' and ''html''.
* Export a calendar; it is possible to export to several formats, including ''CSV'' and ''HTML'': {{Input|lang=shell|1=konsolekalendar --export-type CVS current.ics}}
{{Input|1=konsolekalendar --export-type CVS current.ics}}




* Import a calendar
<!--T:20-->
{{Input|1=konsolekalendar --import another.ics --file current.ics}}
* Import a calendar: {{Input|lang=shell|1=konsolekalendar --import another.ics --file current.ics}}


In this case, all the entries from another.ics will be merged into current.ics.
<!--T:21-->
:In this case, all the entries from another.ics will be merged into current.ics.


<!--T:22-->
[[Category:Office]]
[[Category:Office]]
</translate>
</translate>

Latest revision as of 11:01, 25 February 2025

Use your calendar when you can't use a graphical user interface

konsolekalendar is an application to administer a calendar without a graphical user interface. It normally works with the calendar that is marked "Default", if you use KOrganizer. However, it is possible to create a calendar if you don't have one already.

As it is strictly a command-line application, konsolekalendar's syntax must be learned first.

Here is a short introduction to using konsolekalendar:


  • If you do not already have a calendar set up, you first need to create one:
    konsolekalendar --create --file ~/.kde/share/apps/korganizer/vacation.ics
    
(This location will enable it to be used either in konsolekalendar or in korganizer.)


  • Add your birthday to the default calendar:
    konsolekalendar --add --date 2009-06-06 --summary "My Birthday" --description "Party Time"
    


  • Add a vacation:
    konsolekalendar --add --file vacation.ics --date 2009-08-01 --end-date 2009-08-07 --summary "Vacation" \
      --description "Nobody will ever find me!"
    


  • Show all calendar entries:
    konsolekalendar --all 2>errorlog
    


  • You probably don't want to do this if you have been using your calendar for long, however, you can specify date ranges, as in…
    konsolekalendar --view --date 2009-08-17 --end-date 2009-08-21
    
…which shows that particular work week.


  • Or maybe you only wanted to see the next entry? Then use:
    konsolekalendar --next
    


  • Or for the week ahead? Try:
    konsolekalendar --show-next 7
    


  • To show your calendar file, the rubric is:
    konsolekalendar --view 2>&1 | grep resource | grep konsolekalendar
    


  • To edit an entry, use:
    konsolekalendar --change --uid libkcal-1652809671.172 --summary "Get my head examined" \
      --description "I must be crazy!!"
    


  • Before you can delete an entry, you first need to list it:


There at the bottom is the UID of the entry.
Now you are ready to delete it:
konsolekalendar --delete --uid libkcal-1652809671.172

Warning

Beware - this is a permanent delete. You cannot recover the entry


  • Export a calendar; it is possible to export to several formats, including CSV and HTML:
    konsolekalendar --export-type CVS current.ics
    


  • Import a calendar:
    konsolekalendar --import another.ics --file current.ics
    
In this case, all the entries from another.ics will be merged into current.ics.