Handbok KonsoleKalendar
Handbok KonsoleKalendar
Nästa

Handbok KonsoleKalendar

Tuukka Pasanen

Allen Winter

Granskning: Malcolm Hunter
Översättare: Stefan Asserhäll
Revision 1.1.1 (2004-04-15)

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.


Kapitel 1. Inledning
Inledning
Föregående
Nästa

Kapitel 1. Inledning

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.

Föregående
Nästa
Hem


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Kapitel 2. Funktioner
Funktioner
Föregående
Nästa

Kapitel 2. Funktioner

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.

Visa händelser

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


Infoga händelser
Infoga händelser

Infoga händelser

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!" 



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Ta bort poster
Ta bort poster

Ta bort poster

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).

Varning

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Ändra händelser
Ändra händelser

Ändra händelser

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!"



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Skapa en ny kalenderfil
Skapa en ny kalenderfil

Skapa en ny kalenderfil

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Export till andra format
Export till andra format

Export till andra format

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Exportformat
Exportformat

Exportformat

Några, men inte nödvändigtvis alla, format som stöds beskrivs i det här avsnittet.

KonsoleKalendar textformat

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
--------------------------------------------------

KonsoleKalendar kort textformat

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.

Format med värden åtskilda av kommatecken (CSV)

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

HTML-format

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

HTML-månadsformat

Formatet skapar en HTML-fil som visar alla möten under de månader som anges av tidsintervallet. 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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Importera kalendrar
Importera kalendrar

Importera kalendrar

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 annan.ics i kalendern aktuell.ics, kör:

% konsolekalendar --import annan.ics --file aktuell.ics



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Föregående
Nästa
Hem


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Kapitel 3. Kommandoradsväljare
Kommandoradsväljare
Föregående
Nästa

Kapitel 3. Kommandoradsväljare

KonsoleKalendar stöder följande väljare:

AlternativBeskrivning
--help, --help-allVisar hjälp om programmets väljare.
--authorVisar information om programmets upphovsmän.
-v, --versionVisar programmets versionsinformation.
--licenseVisar programmets licensinformation.
--verboseSkriver ut hjälpsamma meddelanden under körning.
--dry-runSkriv 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  kalenderfilAnge en kalenderfil att använda.

Om den inte anges, används KOrganizers standardresurs.

Huvudkommandolägen: 
--viewSkriv ut kalenderhändelser i angivet exportformat.
--addInfoga en händelse i kalendern.
--changeÄndra en befintlig händelse i kalendern.
--deleteTa bort en befintlig händelse i kalendern.
--createSkapa en ny kalenderfil om den inte finns.
--import  importfilImportera kalendern i huvudkalendern.
Väljare för kommandolägen: 
--allVisa alla kalenderposter.
--nextVisa nästa händelse i kalendern.
--show-next  dagarVisa nästa antal dagars händelser med början på angivet datum.
--uid  UIDVisa, ta bort eller ändra händelsen med den här unika identifieringssträngen.
--date  datumBörja med dagen [ÅÅÅÅ-MM-DD]. Standardvärde är dagens datum.
--time  tidBö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 --time float eller --end-time float.

--end-date  slutdatumSluta med dagen [ÅÅÅÅ-MM-DD]. Standardvärde anges av --date.
--end-time  sluttidSluta 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 --time float eller --end-time float.

--epoch-start  epokBörja vid tiden [sekunder efter epoken].
--epoch-end  epokSluta vid tiden [sekunder efter epoken].
--summary  sammanfattningLägg till sammanfattning till händelse (fungerar vid tillägg och ändring).
--description  beskrivningLägg till beskrivning till händelse (fungerar vid tillägg och ändring).
--location  platsLägg till plats till händelse (fungerar vid tillägg och ändring).
Exportalternativ: 
--export-type  exporttypExportera filtypen. Standardfiltyp för export är text.
--export-file  exportfilExportera till fil. Normalt skrivs utdata till standardutmatningen.
--export-listSkriv ut lista med exporttyper som stöds och avsluta.
Föregående
Nästa
Hem


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Kapitel 4. Vanliga frågor
Vanliga frågor
Föregående
Nästa

Kapitel 4. Vanliga frågor

4.1. Vilka inställningsfiler använder KonsoleKalendar?
4.2. Vad är programnamnet för KonsoleKalendar?
4.3. Vad är formatet för att ange datum?
4.4. Vad är formatet för att ange tid?
4.5. Kommer KonsoleKalendar att infoga en ny händelse i kalendern som är identisk med en som redan finns?
4.6. Hur avgör KonsoleKalendar att en händelse är identisk till en som redan finns i kalendern?
4.7. Kan en händelse som inte flyter ändras till en flytande händelse?
4.8. Varför skrivs händelsernas UID:er ut i de flesta exportformat?
4.9. Hur kan jag få en fråga tillagd bland de här vanliga frågorna?
4.1.

Vilka inställningsfiler använder KonsoleKalendar?

Inga.

4.2.

Vad är programnamnet för KonsoleKalendar?

KonsoleKalendars programnamn är konsolekalendar.

4.3.

Vad är formatet för att ange datum?

KonsoleKalendar förkastar datum som anges på kommandoraden om de inte anges enligt standarden ISO 8601, det vill säga ÅÅÅÅ-MM-DD, där ÅÅÅÅ representerar år med fyra siffror (som 2003), MM representerar månader med två siffror (01, 02, ... 12), och DD representerar dagar med två siffror (01, 02, ... 31).

KonsoleKalendar exporterar alltid datum enligt formatet ISO 8601.

4.4.

Vad är formatet för att ange tid?

KonsoleKalendar förkastar tider som anges på kommandoraden om de inte anges enligt standarden ISO 8601, det vill säga TT:MM:SS, där TT representerar timmar med två siffror (01, 02, ... 24), MM representerar minuter med två siffror (01, 02, ... 60), och SS representerar sekunder med två siffror (01, 02, ... 60).

KonsoleKalendar exporterar alltid tider enligt formatet ISO 8601.

4.5.

Kommer KonsoleKalendar att infoga en ny händelse i kalendern som är identisk med en som redan finns?

Nej. Se nästa fråga.

4.6.

Hur avgör KonsoleKalendar att en händelse är identisk till en som redan finns i kalendern?

KonsoleKalendar kontrollerar angivet startdatum och -tid, slutdatum och -tid, och sammanfattningen mot alla händelser i kalendern. En träff sker om alla tre värden passar ihop med en befintlig händelse.

4.7.

Kan en händelse som inte flyter ändras till en flytande händelse?

Ja. Använd alternativet --time float med --change.

4.8.

Varför skrivs händelsernas UID:er ut i de flesta exportformat?

Eftersom du måste ange UID:er för att ta bort eller ändra händelser. Om du inte vill se händelsernas UID:er, använd då exportformatet kort (--export-type short).

4.9.

Hur kan jag få en fråga tillagd bland de här vanliga frågorna?

Skicka dina frågor till .

Föregående
Nästa
Hem


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Kapitel 5. Tack till och licens
Tack till och licens
Föregående
Nästa

Kapitel 5. Tack till och licens

KonsoleKalendar program copyright 2002,2003:

  • Tuukka Pasanen

  • Allen Winter

Dokumentation copyright 2003:

  • Allen Winter

  • Tuukka Pasanen

Stefan Asserhäll

Den här dokumentationen licensieras under villkoren i GNU Free Documentation License.

Det här programmet licensieras under villkoren i GNU General Public License.

Föregående
Nästa
Hem


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Appendix A. Installation
Installation
Föregående
Nästa

Appendix A. Installation

Hur man skaffar KonsoleKalendar

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.

Krav
Krav

Krav

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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Kompilering och installation
Kompilering och installation

Kompilering och installation

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 xvfj paket.tar.bz2, och gå till katalogen som har skapats.

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.

Notera

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Anpassning
Anpassning

Anpassning

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

Föregående
Nästa
Hem


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Nästa
 


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team