Copyright © 2002, 2004 Tuukka Pasanen
Copyright © 2003, 2005 Allen Winter
Härmed ges tillåtelse att kopiera, distribuera och/eller ändra detta dokument under villkoren i GNU Free Documentation License, Version 1.1 eller någon senare version publicerad av Free Software Foundation; utan invarianta avsnitt, utan framsidestexter och utan baksidestexter. En kopia av licensen inkluderas i avsnittet som heter "GNU Free Documentation License".
KonsoleKalendar är ett kommandoradgränssnitt för KDE:s kalendrar.
Innehållsförteckning
KonsoleKalendar är ett kommandoradgränssnitt för KDE:s kalendrar. Det låter dig visa, infoga, ta bort eller ändra kalenderhändelser via kommandoraden eller från ett skriptspråk. Dessutom kan KonsoleKalendar skapa en ny KDE-kalender, exportera en KDE-kalender till ett antal andra format, och importera en annan KDE-kalender.
I sitt grundläggande läge visar KonsoleKalendar händelselistan i standardkalendern för aktuellt datum (från 7:00 till 17:00).
Huvudfunktioner i KonsoleKalendar:
Visa kalenderposter från ett startdatum och -tid till ett slutdatum och -tid
Infoga (lägga till) kalenderposter
Ta bort (avlägsna) kalenderposter
Modifiera (ändra) kalenderposter
Skapa en ny kalender
Exportera kalenderposter till andra filformat
Importera en befintlig KDE-kalender
KonsoleKalendar är inte ett annat grafiskt gränssnitt till en KDE-kalender (dvs. KOrganizer) KonsoleKalendar är bara avsett för användning där ett grafiskt användargränssnitt inte är praktiskt eller möjligt.
KonsoleKalendar tillhandahåller inte ett fullständigt språk för att göra förfrågningar om användarens kalender, det är heller inte upphovsmännens avsikt att någonsin lägga till en sådan möjlighet. Enkla kommandoradsväljare tillhandahålls för att komma åt kalenderhändelser i ett datum- och tidsintervall.
I det här kapitlet lär du dig om huvudfunktionerna i KonsoleKalendar, och hur du kan styra dem med kommandoradsväljare (kom ihåg att KonsoleKalendar inte har ett grafiskt användargränssnitt, utan bara är ett kommadoradsprogram).
Du lär dig om att infoga, ta bort och ändra kalenderhändelser, och hur händelser kan exporteras till andra filformat. Att skapa och importera KDE-kalendrar täcks också i det här kapitlet.
I normalläge, eller genom att använda väljaren --view
, listar KonsoleKalendar händelser i ett angivet datum- och tidsintervall.
För att visa alla dagens händelser (från 7:00 till 17:00), kör helt enkelt:
%
konsolekalendar
I nästa exempel, visar vi alla händelser för veckan från 18 till 22 augusti:
%
konsolekalendar
--view
--date
2003-08-18
--end-date
2003-08-22
Visa nästa händelse(r) i kalendern från aktuell tid och framåt:
%
konsolekalendar
--next
För att visa alla händelser för de fem nästa dagarna, kör:
%
konsolekalendar
--show-next
5
KonsoleKalendar kan infoga händelser i en KDE-kalender eller kalenderresurs med kommandoradsväljaren --add
. Händelser som infogas med lyckat resultat, visas omedelbart av KDE:s kalenderprogram (som KOrganizer).
I följande exempel infogas en händelse som börjar 2003-06-04 (4:e juni, 2003) klockan 10:00 och slutar klockan 12:00 med sammanfattningen "Läkarbesök" i användarens standardkalenderresurs:
%
konsolekalendar
--add
--date
2003-06-04
--time
\10:00
--end-time
12:00
--summary
"Läkarbesök"
I det här exemplet läggs en födelsedag till i användarens standardkalenderresurs:
%
konsolekalendar
--add
--date
2003-06-06
--summary
\"Min födelsedag"
--description
"Tid för fest"
Här infogas en veckas semester i en delad semester
-kalender:
%
konsolekalendar
--add
--file
semester.ics
--date
\2003-08-01
--end-date
2003-08-20
--summary
"Semester"
--description
"Ingen kan någonsin hitta mig!"
KonsoleKalendar stöder att ta bort poster i en kalenderfil eller resurs med kommandoradsväljaren --delete
. Kalenderposter som ska tas bort specificeras exakt med en unik identifieringssträng (UID) med väljaren --uid
. Unika identifierare hittas genom att först titta på händelsen med väljaren --view
.
Händelser som tas bort med lyckat resultat, tas omedelbart bort inne i KDE:s kalenderprogram (till exempel KOrganizer).
När du tar bort något från kalendern kan du inte ångra det! Med andra ord, när du tar bort en post kan du inte få tillbaka den borttagna posten. Den är borta för alltid.
Här tar vi bort en kalenderpost med UID KonsoleKalendar-1887551750.196
:
%
konsolekalendar
--delete
--uid
KonsoleKalendar-1887551750.196
KonsoleKalendar stöder att ändra befintliga poster i en kalenderfil eller resurs med kommandoradsväljaren --change
. Kalenderposter som ska ändras specificeras exakt med en unik identifieringssträng (UID) med väljaren --uid
. Unika identifierare hittas genom att först titta på händelsen med väljaren --view
.
Att ändra beter sig på samma sätt som att infoga: Du kan ändra startdatum och -tid, slutdatum och -tid, beskrivning, plats och sammanfattning för en händelse. För händelser som ändras med lyckat resultat, visas ändringen omedelbart av KDE:s kalenderprogram (som KOrganizer).
Exempel: Här ändrar vi sammanfattningen och beskrivningen för en kalenderpost med UID KonsoleKalendar-1887551750.196
:
%
konsolekalendar
--change
--uid
KonsoleKalendar-1887551750.196
--summary
"Få huvudet undersökt"
--description
"Gå inte till den läkaren igen!"
KonsoleKalendar kan användas för att skapa en ny KDE-kalenderfil. Eftersom du inte kan infoga en post i en kalender som inte finns, måste du först skapa filen med kommandoradsväljarna --create
och --file
.
Skapa en kalenderfil som heter
./data/share/calendars/semester.ics
%
konsolekalendar
--create
--file
/data/share/calendars/semester.ics
KonsoleKalendar kan exportera en KDE-kalender till andra välkända format. Att exportera är ett särskilt sätt att visa. Normalt visas händelser med “KonsoleKalendar textformat”. För att ändra visningsformat använd kommandoradsväljaren --export-type
.
För att se en lista med alla exportformat som stöds, använd alternativet --export-list
, som följer:
%
konsolekalendar
--export-list
Några, men inte nödvändigtvis alla, format som stöds beskrivs i det här avsnittet.
KonsoleKalendar-textformat är KonsoleKalendars eget format och det är konstruerat för att vara bekvämt att läsa och kunna tolkas av efterföljande skript.
KonsoleKalendar textformat är:
Date:\t<Händelsens datum>(dddd åååå-MM-dd) [\t<Händelsens starttid>(tt:mm) - <Händelsens sluttid>(tt:mm)] Summary: \t<Sammanfattning av händelsen | "(ingen sammanfattning tillgänglig)"> Location: \t<Händelsens plats | "(ingen platsinformation tillgänglig)"> Description: \t<Beskrivning av händelsen | "(ingen beskrivning tillgänglig)"> UID: \t<Händelsens UID> --------------------------------------------------
Till exempel:
Date: Tisdag 2003-11-01
8:00 - 9:00
Summary:
Personalmöte
Location:
Konferensrummet
Description:
Träffa hela personalen för att diskutera projektet.
UID:
KonsoleKalendar-1128954167.1013
--------------------------------------------------
Kort textformat tillhandahåller en kompaktare mindre utförlig version av KonsoleKalendars eget format.
KonsoleKalendar kort textformat är:
[--------------------------------------------------] {<Händelsens datum>(dddd åååå-MM-dd)] [<Händelsens starttid>(tt:mm) - <Händelsens sluttid>(tt:mm) | "\t"] \t<Sammanfattning av händelsen | \t>[, <Händelsens plats>] \t\t<Beskrivning av händelsen | "\t">
Till exempel:
-------------------------------------------------- Tisdag 2003-11-01 08:00 - 09:00 Personalmöte, Konferensrummet Träffa hela personalen för att diskutera projektet.
Formatet med värden åtskilda av kommatecken visar händelsevärden i samma ordning som KonsoleKalendars textformat. Den enda skillnaden är att informationen finns på samma rad med varje fält åtskilt av ett kommatecken. De skapade exportfilerna kan direkt importeras i kalkylark som KSpread, OpenOffice.org Calc och Microsoft® Excel. Dessutom är CSV-formatet lätt att tolka med efterföljande skript.
Formatet med värden åtskilda av kommatecken (CSV) är:
ÅÅÅÅ-MM-DD,TT:MM,ÅÅÅÅ-MM-DD,TT:MM,sammanfattning,plats,beskrivning,UID
Till exempel:
2003-11-01,08:00,2003-11-01,09:00,Personalmöte,Konferensrummet,Träffa hela personalen\
i det stora konferensrummet.,KonsoleKalendar-1128954167.1013
Exportformatet HTML skapar en giltig HTML-fil som kan publiceras på WWW. Exportformatet är inte lämpligt för efterföljande tolkning av ett skript, men är mycket trevligt för att publicera kalendrar så att de enkelt kan beskådas.
Här ska en skärmbild visas
KonsoleKalendar kan importera en ICS-kalenderfil till en KDE-kalender. Alla händelser från kalendern som importeras infogas, inklusive identiska händelser. I nästa utgåva av KonsoleKalendar kommer inte identiska händelser att infogas.
För att importera kalenderfilen
i kalendern annan.ics
, kör:aktuell.ics
%
konsolekalendar
--import
annan.ics
--file
aktuell.ics
KonsoleKalendar stöder följande väljare:
Alternativ | Beskrivning |
---|---|
--help, --help-all | Visar hjälp om programmets väljare. |
--author | Visar information om programmets upphovsmän. |
-v, --version | Visar programmets versionsinformation. |
--license | Visar programmets licensinformation. |
--verbose | Skriver ut hjälpsamma meddelanden under körning. |
--dry-run | Skriv ut vad som skulle ha gjorts, men utför det inte. Ändrar inga filer: infogar, tar bort eller ändrar inga befintliga filer, eller skapar några nya filer. |
--file kalenderfil | Ange en kalenderfil att använda. Om den inte anges, används KOrganizers standardresurs. |
Huvudkommandolägen: | |
--view | Skriv ut kalenderhändelser i angivet exportformat. |
--add | Infoga en händelse i kalendern. |
--change | Ändra en befintlig händelse i kalendern. |
--delete | Ta bort en befintlig händelse i kalendern. |
--create | Skapa en ny kalenderfil om den inte finns. |
--import importfil | Importera kalendern i huvudkalendern. |
Väljare för kommandolägen: | |
--all | Visa alla kalenderposter. |
--next | Visa nästa händelse i kalendern. |
--show-next dagar | Visa nästa antal dagars händelser med början på angivet datum. |
--uid UID | Visa, ta bort eller ändra händelsen med den här unika identifieringssträngen. |
--date datum | Börja med dagen [ÅÅÅÅ-MM-DD]. Standardvärde är dagens datum. |
--time tid | Börja med tiden [TT:MM]. Standardvärde för visning är 07:00. För att lägga till eller ändra en flytande händelse, använd alternativen |
--end-date slutdatum | Sluta med dagen [ÅÅÅÅ-MM-DD]. Standardvärde anges av --date . |
--end-time sluttid | Sluta med tiden [TT:MM]. Standardvärde för visning är 17:00. För att lägga till eller ändra en flytande händelse, använd alternativen |
--epoch-start epok | Börja vid tiden [sekunder efter epoken]. |
--epoch-end epok | Sluta vid tiden [sekunder efter epoken]. |
--summary sammanfattning | Lägg till sammanfattning till händelse (fungerar vid tillägg och ändring). |
--description beskrivning | Lägg till beskrivning till händelse (fungerar vid tillägg och ändring). |
--location plats | Lägg till plats till händelse (fungerar vid tillägg och ändring). |
Exportalternativ: | |
--export-type exporttyp | Exportera filtypen. Standardfiltyp för export är text. |
--export-file exportfil | Exportera till fil. Normalt skrivs utdata till standardutmatningen. |
--export-list | Skriv ut lista med exporttyper som stöds och avsluta. |
KonsoleKalendar program copyright 2002,2003:
Tuukka Pasanen (illuusio AT mailcity.com)
Allen Winter (awinterz AT users.sourceforge.net)
Dokumentation copyright 2003:
Allen Winter (awinterz AT users.sourceforge.net)
Tuukka Pasanen (illuusio AT mailcity.com)
Stefan Asserhäll(stefan.asserhall AT comhem.se)
Den här dokumentationen licensieras under villkoren i GNU Free Documentation License.
Det här programmet licensieras under villkoren i GNU General Public License.
Innehållsförteckning
KonsoleKalendar är en del av KDE-projektet http://www.kde.org/.
KonsoleKalendar finns i kdepim-paketet på ftp://ftp.kde.org/pub/kde/, KDE-projektets huvudsakliga FTP-plats.
KonsoleKalendar levereras tillsammans med KDE 3, och är inte separat tillgängligt.
KonsoleKalendar kräver att KDE:s standardbibliotek är installerade (paketet kdelibs
). För att kompilera från källkod, behöver du också Qt™ och kdelibs
utvecklingspaket.
Du hittar en lista över ändringar i filen ChangeLog
.
Det här avsnittet ger en snabb översikt av byggprocessen. Läs gärna Kompilera KDE 3.2.x för fullständiga instruktioner.
Om du inte kan skaffa ett lämpligt förkompilerat binärpaket, måste du kompilera KonsoleKalendar själv från källkod. Hämta källkodspaketfilen kdepim-x.x.tar.bz2
. Packa upp den i en ny katalog med ett kommando som liknar tar
, och gå till katalogen som har skapats.xvfj
paket.tar.bz2
För att kompilera och installera KonsoleKalendar på ditt system, skriv följande i baskatalogen för distributionen av KonsoleKalendar:
%
./configure
%
make
%
make install
Eftersom KonsoleKalendar använder autoconf och automake bör du inte ha några problem med att kompilera det. Skulle du stöta på problem, var snäll rapportera dem till KDE:s e-postlistor.
Om du har mer än en version av KDE installerad (t.ex. KDE 2 och KDE 3), kan KonsoleKalendar möjligen installeras i fel KDE-katalog. Om det behövs, kan du ange KDE-katalogen som en väljare till ./configure
. Till exempel, om KDE är installerad i /opt/kde3
:
./configure --prefix=
/opt/kde3
Inga särskilda inställningar krävs för att få KonsoleKalendar att köra med KDE:s skrivbordsmiljö.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team