#format rst

:title: Kommandozeilen Kalendersoftware
:author: vm069
:description:  
:css: https://wiki.hack-hro.de/talk_styles/assets/css/style2.css


Bestandteile dieses Workshops
=============================

- einfuehrung
- vdirsyncer
- khal
- praxis

-------------------------------


einfuehrung
============

- ansprechende Software zum Verwalten und Synchroniseren von Kalendern und Kontakten
- CALDAV und CARDDAV als moegliche Schnittstelle
- Software zum Betrachten von Kalendern

-------------------------------

khal
========= 
 
- ``khal interactive`` 
- ``khal import`` -- importiert eine ics
- ``khal printcalendars`` -- gibt die genutzen kalender aus
- ``khal search SEARCHSTRING`` -- suche nach Ereignissen in den Kalendern die SEARCHSTRING enthalten
- ``khal agenda`` -- Einblendung der nächsten Termine (z.B. in der ``.profile`` aufrufen)

-------------------------------

khal-configuration
==================

- ``[[calendars]]``-section
- es werden die verschiedenen Verzeichnisse mit .ics Dateien konfiguiert um als *calendar* genutzt zu werden
- :: 

    [[hackspace]]
    path = ~/.config/vdir/hackhro/
    readonly = True

-------------------------------

khal-configuration
==================

- ``[[locale]]``-section
- Einstellungen zur Zeitzone und Locale
- :: 

   local_timezone = Europe/Berlin
   default_timezone = Europe/Berlin
   timeformat = %H:%M
   dateformat = %d.%m.

-------------------------------

khal-configuration
==================

- ``[[default]]``-section
- einstellungen zu den defaults von khal
- :: 

    default_command = calendar
    default_calendar = oc
    highlight_event_days = True

-------------------------------

khal-configuration
==================

- und wo kommen jetzt die Events im Kalendar her?
- selbst anlegen beispielsweise: ``khal new tomorrow 16:30 Kaffepause :: mit coolen Leuten``
- oder  ``khal import $ICS-Datei`` oder durch vdirsyncer in vdir-Ordner importiert

-------------------------------


vdirsyncer
============

- synchronisiert calender und kontakte 
- bevorzugt durch cronjob aufzurufen
- ``vdirsyncer sync``
- auch zum Zusammenfuehren von Kalendern geeignet

-------------------------------


vdirsyncer-config
==================

- ``[general]``
-  generelle configurationsoptionen
-  ``status_path = ~/.vdirsyncer/status/``

-------------------------------



vdirsyncer-pairs-config
=========================

- pairs beschreiben ein Paar von storages fuer einen ( vdir )
- ::
 
       [pair $pair_name]
       a = $local_storage_name
       b = $remote_storage_name
       #optional
       collections = [ ] #siehe http://vdirsyncer.readthedocs.org/en/stable/config.html#pair-section
       conflict_resolution = "a wins" oder   "b wins" oder null
 

-------------------------------





vdirsyncer-storage-config
=========================

- storages beschreiben Vdir's zwischen denen synchronisiert werden soll
- ::
 
       [storage $storage_name]
       type = caldav|carddav|filesystem|http
       path = /.config/vdir/$storage_name
       # oder
      url = http://xyz.de/calendar
      #optional
      auth= basic|digest|auto
      readonly = true|false
      #weiters http://vdirsyncer.readthedocs.org/en/stable/config.html#storage-section
 


-------------------------------



Praxis 
=========================

- Installieren
- Beispielkonfiguration 
- Fragen
- https://pad.hack-hro.de/p/vdirkhal