Copyright © 2002, 2004 Tuukka Pasanen
Copyright © 2003, 2005 Allen Winter
Het is toegestaan dit document te kopiëren, te verdelen en/of te wijzigen onder de voorwaarden van de GNU vrije-documentatie-licentie, versie 1.1 of een latere versie, gepubliceerd door de Free Software Foundation; zonder invariante paragrafen, zonder vooromslagteksten, en zonder achteromslagteksten. Een kopie van de licentie vindt u hier: de paragraaf "GNU vrije-documentatielicentie".
Met KonsoleKalendar kunt u via een comandoregel de KDE-kalender raadplegen.
Inhoudsopgave
KonsoleKalendar is een toepassing om op de commandoregel de KDE-kalender te kunnen raadplegen. U kunt evenementen bekijken, wijzigen of verwijderen vanaf een commandoregel of via een scripttaal. Tevens is het mogelijk om via KonsoleKalendar een nieuwe kalender te beginnen, een bestaande kalender te exporteren naar verschillende formaten of een andere KDE-kalender te importeren.
De eenvoudigste toepassing van KonsoleKalendar is om de evenementen in uw standaardkalender van vandaag (tussen 7:00u en 17:00u) weer te geven.
De hoofdfuncties van KonsoleKalendar:
Evenementen tussen twee data en tijdstippen bekijken
Evenementen toevoegen
Evenementen verwijderen
Evenementen wijzigen
Een nieuwe kalender creëren
Kalendergegevens exporteren naar andere bestandsformaten
Een bestaande KDE-kalender importeren
KonsoleKalendar heeft geen grafische schil voor de KDE-kalender. Dit heeft KOrganizer bijvoorbeeld wel. KonsoleKalendar is gemaakt voor gebruikers die geen grafische desktop geactiveerd hebben of waarvoor een grafische desktop onhandig zou zijn.
KonsoleKalendar is geen complete set met alle mogelijke commando's om kalenders te raadplegen. Dat is ook nooit de bedoeling geweest van de auteur. Er kunnen alleen eenvoudige opties worden gebruikt om evenementen van de kalender op te roepen, te wijzigen en te verwijderen.
In dit hoofdstuk vindt u uitleg over de belangrijkste mogelijkheden van KonsoleKalendar en hoe u deze via parameters op de commandoregel kunt gebruiken (bedenk dat KonsoleKalendar geen grafische schil biedt, het kan alleen op de commandoregel gebruikt worden).
U vindt uitleg over het toevoegen, verwijderen en wijzigen van evenementen en hoe u evenementen kunt exporteren naar bepaalde bestandsformaten. Tevens wordt er aandacht besteed aan het importeren en creëren van KDE-kalenders.
Standaard, of door het opgeven van de parameter --view
zal KonsoleKalendar de evenementen weergeven die in een bepaalde periode vallen.
Om alle evenementen van vandaag (tussen 7:00u en 17:00u) te zien, voert u het volgende commando uit:
%
konsolekalendar
In het volgende voorbeeld ziet u alle evenementen voor de week van 18 tot 22 augustus:
%
konsolekalendar
--view
--date
2005-08-18
--end-date
2005-08-22
Om de komende evenementen vanaf het huidige tijdstip te bekijken:
%
konsolekalendar
--next
Om de evenementen voor de komende vijf dagen te bekijken:
%
konsolekalendar
--show-next
5
KonsoleKalendar kan evenementen toevoegen in een KDE-kalender door de parameter -add
te gebruiken. Evenementen die succesvol toegevoegd zijn, worden direct getoond in KDE-kalendertoepassingen, zoals KOrganizer.
In het volgende voorbeeld voegen we een evenement toe op )4 juni 2005, 10:00u. Het eindigt om 12:00u en heeft als titel "Tandarts bezoek".
%
konsolekalendar
--add
--date
2005-06-04
--time
\10:00
--end-time
12:00
--summary
"Tandarts bezoek"
In het volgende voorbeeld wordt een verjaardag toegevoegd aan de standaardkalender:
%
konsolekalendar
--add
--date
2005-06-06
--summary
\"Mijn verjaardag"
--description
"Feestje bouwen!"
Op de volgende manier kunt u een week vakantie in een gedeelde kalender invoegen:
%
konsolekalendar
--add
--file
vacation.ics
--date
\2005-08-01
--end-date
2003-08-07
--summary
"Vakantie"
--description
"Onbereikbaar voor iedereen!"
U kunt evenementen verwijderen met behulp van KonsoleKalendar door de volgende parameter te gebruiken: --delete
. Evenementen worden verwijderd door de unieke identificatie-code (UID) te gebruiken bij de parameter --uid
. UIDs kunnen gevonden worden door het evenement te bekijken met de --view
parameter.
Evenementen die succesvol worden verwijderd, worden ook direct verwijderd uit KDE-kalendertoepassingen zoals KOrganizer.
Wanneer u evenementen verwijdert kan dit niet ongedaan gemaakt worden. Met andere woorden, weg is weg, voorgoed.
Voorbeeld van het verwijderen van een evenement met het UID KonsoleKalendar-1887551750.196
:
%
konsolekalendar
--delete
--uid
KonsoleKalendar-1887551750.196
In KonsoleKalendar kunnen evenementen gewijzigd worden door gebruik te maken van de parameter --change
. Het wijzigen van evenementen gaat aan de hand van de unieke identificatie-code (UID), die wordt opgegeven bij de parameter --uid
. UIDs kunnen worden gevonden door het evenement met de --view
parameter te bekijken.
Wijzigen werkt op dezelfde manierals toevoegen: u kunt de start- en eindtijd wijzigen, de start- en einddatum, de titel, de samenvatting, de locatie en de beschrijving. Gewijzigde evenementen worden direct zichtbaar in KDE-kalendertoepassingen zoals KOrganizer.
Voorbeeld: het wijzigen van de titel en beschrijving van een evenement met UID KonsoleKalendar-1887551750.196
:
%
konsolekalendar
--change
--uid
KonsoleKalendar-1887551750.196
--summary
"Mijn hoofd laten nakijken"
--description
"Niet meer naar die dokter toe!"
KonsoleKalendar kan gebruikt worden om een nieuw KDE-kalenderbestand te creëren. Aangezien het niet mogelijk is om een evenement toe te voegen aan een kalender die niet bestaat, moet het bestand eerst aangemaakt worden met de parameters --create
en --file
.
Creëer een kalenderbestand met de naam
:/data/share/calendars/vacation.ics
%
konsolekalendar
--create
--file
/data/share/calendars/vacation.ics
KonsoleKalendar kan KDE-kalenders exporteren naar andere populaire formaten. Exporteren is eigenlijk een aparte manier van bekijken. Standaard worden evenementen bekeken in het “KonsoleKalendar tekst”-formaat. Om het formaat te wijzigen, wordt de parameter --export-type
gebruikt.
Om een lijst met de verschillende exportformaten te zien, gebruikt u de parameter --export-list
:
%
konsolekalendar
--export-list
Enkele formaten, maar niet allemaal, worden in het volgende gedeelte beschreven.
Het KonsoleKalendar tekst-formaat is het standaardformaat dat door KonsoleKalendar gebruikt wordt. Het is ontwikkeld om op een prettige manier de evenementen te kunnen bekijken en om andere scripts de mogelijkheid te geven de gegevens te verwerken.
Het KonsoleKalendar-tekstformaat ziet er als volgt uit:
Date:\t<Datum evenement>(dddd jjjj-MM-dd) [\t<Starttijd evenement>(uu:mm) - <Eindtijd evenement>(uu:mm)] Titel: \t<Titel van evenement | "(geen titel beschikbaar)"> Locatie: \t<Locatie van evenement | "(geen locatie beschikbaar)"> Omschrijving: \t<Omschrijving van evenement | "(geen omschrijving beschikbaar)"> UID: \t<UID van het evenement> --------------------------------------------------
Bijvoorbeeld:
Datum: Dinsdag 2005-11-01
08:00 - 09:00
Titel:
Directievergadering
Locatie:
Vergaderruimte
Omschrijving:
Vergadering van complete staf over het project.
UID:
KonsoleKalendar-1128954167.1013
--------------------------------------------------
Het verkorte tekstformaat is een compacte, minder uitgebreide versie van het gebruikelijke KonsoleKalendar-tekstformaat.
Het verkorte KonsoleKalendar-tekstformaat ziet er als volgt uit:
[--------------------------------------------------] {<Datum evenement>(dddd jjjj-MM-dd)] [<Starttijd evenement>(uu:mm) - <Eindtijd evenement>(uu:mm) | "\t"] \t<Titel evenement | \t>[, <Locatie evenement>] \t\t<Omschrijving evenement | "\t">
Bijvoorbeeld:
-------------------------------------------------- Dinsdag 2005-11-01 08:00 - 09:00 Directievergadering, Vergaderruimte vergadering van complete staf over het project.
In het door komma's gescheiden formaat staan de velden in dezelfde volgorde als het KonsoleKalendar-tekstformaat. Het enige verschil is dat alle gegevens op één regel staan en gescheiden worden door een komma. Indien de gegevens in een bestand worden opgeslagen, kunnen deze zonder veel problemen in een spreadsheet worden geïmporteerd. Voorbeelden hiervan zijn KSpread, OpenOffice.org Calc en Microsoft® Excel. Ook is dit formaat uitermate geschikt voor verdere verwerking door andere scripts en toepassingen.
Het door komma's gescheiden formaat ziet er als volgt uit:
JJJJ-MM-DD,UU:MM,JJJJ-MM-DD,UU:MM,Titel,Locatie,Omschrijving,UID
Bijvoorbeeld:
2005-11-01,08:00,2005-11-01,09:00,Directievergadering,Vergaderruimte,Vergadering van complete staf\
over het project.,KonsoleKalendar-1128954167.1013
Het HTML-formaat zal een HTML-bestand aanmaken dat geschikt is om op het WWW te publiceren. Dit formaat is niet geschikt voor verdere bewerkingen door andere scripts, maar is erg goed voor het publiceren van kalenders op het internet.
TODO: hier komt een schermafdruk
Dit formaat maakt een HTML-bestand aan dat alle afspraken in de maanden uit het opgegeven datumbereik toont. Dit formaat is niet geschikt voor verdere bewerkingen door andere scripts, maar is erg goed voor het publiceren van kalenders op het internet.
TODO: hier komt een schermafdruk
KonsoleKalendar kan ICS-kalenders importeren in een KDE-kalender. Alle evenementen van de kalender die worden geïmporteerd, worden ook toegevoegd aan de kalender. Dit zou kunnen leiden tot twee identieke evenementen op dezelfde datum en tijd. In de volgende uitgave van KonsoleKalendar zal dit waarschijnlijk verholpen worden.
Om een
te importeren in de andere.ics
-kalender voert u het volgende commando uit:huidige.ics
%
konsolekalendar
--import
andere.ics
--file
huidige.ics
KonsoleKalendar ondersteunt de volgende parameters:
Parameter | Omschrijving |
---|---|
--help, --help-all | Toont informatie over de mogelijke parameters. |
--author | Toont gegevens over de auteur van dit programma. |
-v, --version | Toont het versienummer van dit programma. |
--license | Toont de licentie van dit programma. |
--verbose | Geeft meer informatie tijdens het uitvoeren van commando's. |
--dry-run | Drukt af wat er gedaan zou gaan worden zonder deze parameter. Nu veranderen er geen bestanden, er wordt niets toegevoegd, gewijzigd of verwijderd. Ook worden geen nieuwe bestanden aangemaakt. |
--file kalenderbestand | Specificeert het te gebruiken kalenderbestand. Indien niet opgegeven wordt de standaard KOrganizer-kalender gebruikt. |
Hoofdhandelingen: | |
--view | Toont de evenementen in het opgegeven exportformaat. |
--add | Voegt een evenement toe aan de kalender. |
--change | Wijzigt een bestaand evenement. |
--delete | Verwijdert een bestaand evenement. |
--create | Creëert een nieuw kalenderbestand indien het niet bestaat. |
--import importbestand | Importeert deze kalender in de huidige kalender. |
Handeling aanpassen: | |
--all | Toont alle evenementen. |
--next | Toont het volgende evenement. |
--show-next dagen | Toont de evenementen binnen het opgegeven aantal dagen. |
--uid UID | Toont, verwijdert of wijzigt de evenementen met deze unieke identificatiecode. |
--date datum | Start vanaf deze dag [JJJJ-MM-DD]. Standaard is dit vandaag |
--time tijd | Start vanaf dit tijdstip [UU:MM]. Standaard is dit 07:00u. Om een evenement toe te voegen of te wijzigen zonder dat deze een vaste tijd heeft, gebruikt u |
--end-date einddatum | Eindig op deze dag [JJJJ-MM-DD]. Standaard is hetgeen opgegeven is bij --date . |
--end-time eindtijd | Eindig op dit tijdstip [UU:MM]. Standaard is dit 17:00u. Om een evenement toe te voegen of te wijzigen zonder dat deze een vaste tijd heeft, gebruikt u |
--epoch-start epoch-tijd | Start op dit tijdstip. De waarde is het aantal seconden sinds epoch. |
--epoch-end epoch-tijd | Eindig op dit tijdstip. De waarde is het aantal seconden sinds epoch. |
--summary titel | Geeft een titel aan het evenement (werkt bij toevoegen en wijzigen). |
--description omschrijving | Geeft een omschrijving aan het evenement (werkt bij toevoegen en wijzigen). |
--location locatie | Geeft een locatie aan het evenement (werkt bij toevoegen en wijzigen). |
Exportparameters: | |
--export-type export-type | Exportformaat. Het standaard formaat is Tekst |
--export-file exportbestand | Exporteert naar een bestand. Standaard wordt naar het beeldscherm geëxporteerd. |
--export-list | Toont een lijst met exportformaten. |
Problemen en suggesties kunnen op de website http://bugs.kde.nl gemeld worden.
Deze handleiding kan inmiddels vernieuwd zijn. De meest recente versie van het handboek van KonsoleKalendar is te vinden op http://docs.kde.org/nl/.
KonsoleKalendar programma copyright 2002,2003:
Tuukka Pasanen (illuusio AT mailcity.com)
Allen Winter (awinterz AT users.sourceforge.net)
Documentatie copyright 2003:
Allen Winter (awinterz AT users.sourceforge.net)
Tuukka Pasanen(illuusio AT mailcity.com)
Dit document is vertaald in het Nederlands door Tom Albers.
Dit document is vertaald in het Nederlands door Alexander S. Koning.
De vertaling werd nagelezen door Natalie Koning.
Deze documentatie valt onder de bepalingen van de GNU vrije-documentatie-licentie.
Deze toepassing valt onder de bepalingen van de GNU General Public License.
KonsoleKalendar is een onderdeel van het KDE-project http://www.kde.org/.
KonsoleKalendar is een onderdeel van de module kdepim. Deze module kunt u vinden op de FTP-site van het KDE-project: ftp://ftp.kde.org/pub/kde/.
KonsoleKalendar hoort bij KDE3 en is niet los verkrijgbaar.
KonsoleKalendar vereist de standaard KDE-bibliotheken. Deze zijn te vinden in het kdelibs
-pakket. Om vanuit de broncode te compileren zijn ook Qt™ en de kdelibs
ontwikkelpakketten (development packages) nodig.
Een lijst van verbeteringen en aanpassingen is te vinden in het ChangeLog
-bestand.
Dit gedeelte geeft een kort overzicht over het compilatie- en installatieproces. Bekijk de internetpagina Compiling KDE 3.2.x voor een volledig overzicht.
Indien u geen geschikt voorgecompileerd pakket kunt verkrijgen, kunt u KonsoleKalendar zelf compileren vanuit de broncode. Haal de broncode op door het bestand met de naam kdepim-x.x.tar.bz2
te downloaden. Pak dit uit in een nieuwe map met een commando soortgelijk aan tar
en ga naar de zojuist gecreëerde map.xvfj
pakket.tar.bz2
Er zijn een aantal stappen nodig om KonsoleKalendar op uw systeem te compileren en te installeren. Voer de volgende commando's uit in de hoofdmap van de broncode van KonsoleKalendar:
%
./configure
%
make
%
make install
Aangezien KonsoleKalendar autoconf en automake gebruikt, zouden er bij de compilatie geen problemen mogen voorkomen. Indien u toch problemen tegenkomt, meldt u ze dan in de betreffende KDE-mailinglists.
Indien u meer dan één versie van KDE hebt geïnstalleerd, bijvoorbeeld KDE2 en KDE3, dan kan het gebeuren dat KonsoleKalendar in de verkeerde map wordt geïnstalleerd. Het is mogelijk om de juiste KDE-map als parameter mee te geven aan ./configure
. Bijvoorbeeld als KDE geïnstalleerd is in /opt/kde3
:
./configure --prefix=
/opt/kde3
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team