From 0b8ca6637be94f7814cafa7d01ad4699672ff336 Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Tue, 21 Jan 2014 22:06:48 -0600 Subject: Beautify docbook files --- tde-i18n-da/docs/tdebase/ksplashml/index.docbook | 1140 ++++++---------------- 1 file changed, 316 insertions(+), 824 deletions(-) (limited to 'tde-i18n-da/docs/tdebase/ksplashml') diff --git a/tde-i18n-da/docs/tdebase/ksplashml/index.docbook b/tde-i18n-da/docs/tdebase/ksplashml/index.docbook index 3ea16fd3e97..1553747cfd1 100644 --- a/tde-i18n-da/docs/tdebase/ksplashml/index.docbook +++ b/tde-i18n-da/docs/tdebase/ksplashml/index.docbook @@ -10,186 +10,98 @@ -&ksplash;-håndbogen +&ksplash;-håndbogen -&Teemu.Rytilahti; &Teemu.Rytilahti.mail; +&Teemu.Rytilahti; &Teemu.Rytilahti.mail; -&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail; +&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail; -&Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail; +&Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail; &erik.kjaer.pedersen.role; -2003 -Teemu Rytilahti +2003 +Teemu Rytilahti -2003-04 -Ravikiran Rajagopal +2003-04 +Ravikiran Rajagopal -&FDLNotice; +&FDLNotice; -2003-01-10 -1.01.00 +2003-01-10 +1.01.00 -&ksplash; er en opstartsskærm der viser fremskridt for et program der er ved at blive indlæst. +&ksplash; er en opstartsskærm der viser fremskridt for et program der er ved at blive indlæst. -KDE -tdebase -ksplash -ksplashml -opstartsskærm -øjenlækkerier +KDE +tdebase +ksplash +ksplashml +opstartsskærm +øjenlækkerier -Indledning +Indledning -&ksplash; er en opstartsskærm der viser fremskridt for et program der er ved at blive indlæst. Rapportér venligst om problemer eller ønsker om nye egenskaber til &kde;'s e-mail-lister. &ksplash;'s hovedegenskaber er: +&ksplash; er en opstartsskærm der viser fremskridt for et program der er ved at blive indlæst. Rapportér venligst om problemer eller ønsker om nye egenskaber til &kde;'s e-mail-lister. &ksplash;'s hovedegenskaber er: -Kan påvirkes af temaer -Bruger plugin til fuldstændig brugerinderetning -Kan bruges af et vilkårligt program der bruger DCOP +Kan påvirkes af temaer +Bruger plugin til fuldstændig brugerinderetning +Kan bruges af et vilkårligt program der bruger DCOP -Denne håndbog vil vise dig hvordan man laver temaer til brug med plugin der allerede findes. Hvis ingen af de tilgængelige plugin tilfredsstiller din smag, kan du lære hvordan du brugerindstiller &ksplash;'s udseende fuldstændigt ved at skrive et plugin i C++. +Denne håndbog vil vise dig hvordan man laver temaer til brug med plugin der allerede findes. Hvis ingen af de tilgængelige plugin tilfredsstiller din smag, kan du lære hvordan du brugerindstiller &ksplash;'s udseende fuldstændigt ved at skrive et plugin i C++. -brug af temaer - -For at bruge temaer fra KDE-Look, pakkes de ud til ~/.trinity/share/apps/ksplash/Themes/ for en enkelt bruger, eller til $TDEDIR/share/apps/ksplash/Themes/ for at gøre dem tilgængelige for alle brugerne på dit system. - - Du kan også bruge Opstartsskærm-modulet under Udseende i &kde;'s kontrolcenter til at gøre dette automatisk. +brug af temaer + +For at bruge temaer fra KDE-Look, pakkes de ud til ~/.trinity/share/apps/ksplash/Themes/ for en enkelt bruger, eller til $TDEDIR/share/apps/ksplash/Themes/ for at gøre dem tilgængelige for alle brugerne på dit system. + + Du kan også bruge Opstartsskærm-modulet under Udseende i &kde;'s kontrolcenter til at gøre dette automatisk. -Ved brug af &kcontrol;-modulet - -Dette module tillader dig at installere, teste og fjerne &ksplash;-temaer. - -Nede langs siden af modulet er en liste af de for øjeblikket tilgængelige &ksplash;-temaer. Når du vælger en, vil en forhåndsvisning blive vist i hoveddelen af vinduet. Når du har valgt den du ønsker at bruge, tryk så på O.k. eller Anvend. Tryk på Annullér for at afslutte modulet uden at lave ændringer, og Standard for at genoprette systemets standard-opstartsskærm. - -Fro at installere nye moduler, trykkes på Tilføj..., og find temaet på din computer. Du behøver ikke at pakke temafiler ud, du kan blot vælge den komprimerede temafil. Installering af et tema gør det ikke til det tema der bruges før du vælger det på listen og trykker enten på O.k. eller Anvend. - -Selvom du kan se en forhåndsvisning af opstartsskærmen, vil du måske gerne se hvordan det ser ud i rigtigt brug, for eksempel for at se hvordan animeringen ser ud. Du kan teste temaer ved at vælge dem på listen og klikke på Test-knappen. - -Du kan også fjerne de temaer du ikke længere ønsker at bruge, ved at vælge dem og trykke på Fjern-knappen. bemærk at din brugerkonto måske ikke har lov til at fjerne temaer der er installeret systemomfattende. Det anbefales også at du ikke afinstallerer Standard-opstartskærmen. +Ved brug af &kcontrol;-modulet + +Dette module tillader dig at installere, teste og fjerne &ksplash;-temaer. + +Nede langs siden af modulet er en liste af de for øjeblikket tilgængelige &ksplash;-temaer. Når du vælger en, vil en forhåndsvisning blive vist i hoveddelen af vinduet. Når du har valgt den du ønsker at bruge, tryk så på O.k. eller Anvend. Tryk på Annullér for at afslutte modulet uden at lave ændringer, og Standard for at genoprette systemets standard-opstartsskærm. + +Fro at installere nye moduler, trykkes på Tilføj..., og find temaet på din computer. Du behøver ikke at pakke temafiler ud, du kan blot vælge den komprimerede temafil. Installering af et tema gør det ikke til det tema der bruges før du vælger det på listen og trykker enten på O.k. eller Anvend. + +Selvom du kan se en forhåndsvisning af opstartsskærmen, vil du måske gerne se hvordan det ser ud i rigtigt brug, for eksempel for at se hvordan animeringen ser ud. Du kan teste temaer ved at vælge dem på listen og klikke på Test-knappen. + +Du kan også fjerne de temaer du ikke længere ønsker at bruge, ved at vælge dem og trykke på Fjern-knappen. bemærk at din brugerkonto måske ikke har lov til at fjerne temaer der er installeret systemomfattende. Det anbefales også at du ikke afinstallerer Standard-opstartskærmen. -Hvordan man laver temaer for &ksplash; +Hvordan man laver temaer for &ksplash; -Generelt -Det er nemt at lave dine egne temaer for &ksplash;. Efter du er færdig med dine temaer kan du sende dem til KDE-Look så andre kan bruge dem. +Generelt +Det er nemt at lave dine egne temaer for &ksplash;. Efter du er færdig med dine temaer kan du sende dem til KDE-Look så andre kan bruge dem. -Identificering af dit tema - -Lad os lave et tema der hedder MitHeltEget. For at temaet skal blive genkendt af &ksplash;, skal det gemmes i en mappe der hedder MitHelEget under ~/.trinity/apps/ksplash/Themes/. Det skal have en fil der hedder Theme.rc, der indeholder opsætningen af temaet. Du kan angive mange specielle ting i temaet, ændre den plugin-maskine der bruges, og så videre. Du behøver ikke at bruge alle de mulige indstillinger; sædvanligvis har indstillingerne en acceptabel standardværdi. Den basale syntaks for indgange i Theme.rc-filen er [option] = [value] Du kan finde definitionerne på de forskellige muligheder i de følgende afsnit. +Identificering af dit tema + +Lad os lave et tema der hedder MitHeltEget. For at temaet skal blive genkendt af &ksplash;, skal det gemmes i en mappe der hedder MitHelEget under ~/.trinity/apps/ksplash/Themes/. Det skal have en fil der hedder Theme.rc, der indeholder opsætningen af temaet. Du kan angive mange specielle ting i temaet, ændre den plugin-maskine der bruges, og så videre. Du behøver ikke at bruge alle de mulige indstillinger; sædvanligvis har indstillingerne en acceptabel standardværdi. Den basale syntaks for indgange i Theme.rc-filen er [option] = [value] Du kan finde definitionerne på de forskellige muligheder i de følgende afsnit. -Simpel <filename ->Theme.rc</filename -> fil -[KSplash Theme: MitHeltEget] +Simpel <filename>Theme.rc</filename> fil +[KSplash Theme: MitHeltEget] Name = MitHeltEget Description = Et lækkert tema der bruger XpLike-maskinen Version = 1.0 @@ -201,91 +113,53 @@ Welcome Text = Indlæser KDE -Efter at have angivet navnet, beskrivelsen og forfatteren for temaet, skal du først vælge en tema-maskine (også kendt som et plugin). Så kan du brugerindstille forskellige egenskaber af tema-maskinen ved at tilknytte nøgle-værdi par som i eksempel-filen ovenfor. +Efter at have angivet navnet, beskrivelsen og forfatteren for temaet, skal du først vælge en tema-maskine (også kendt som et plugin). Så kan du brugerindstille forskellige egenskaber af tema-maskinen ved at tilknytte nøgle-værdi par som i eksempel-filen ovenfor. -Sørg for at navnet på mappen hvori temafilerne opbevares (~/.trinity/apps/ksplash/Themes/MitHeltEget i vores tilfælde) og identifikatoren ([KSplash Tema: MitHeltEget] i vores tilfælde) for temaet i Theme.rc-filen er identiske.Ellers vil &ksplash; ikke genkende temaet. +Sørg for at navnet på mappen hvori temafilerne opbevares (~/.trinity/apps/ksplash/Themes/MitHeltEget i vores tilfælde) og identifikatoren ([KSplash Tema: MitHeltEget] i vores tilfælde) for temaet i Theme.rc-filen er identiske.Ellers vil &ksplash; ikke genkende temaet. -Baggrundsfiler - -Når &ksplash; starter, prøver den at finde et baggrundsbillede der passer til skærmens opløsning hvis tema-maskinen bruger et. Baggrundsbilledfilen skan navngives i følgende: Background-WWWxHHH.png. - -For eksempel vil du måske bruge en fil der hedder Background-1024x768. Hvis baggrundsbilledet for din skærms opløsning ikke kan findes, prøver den at ændre størrelse på den originale Background.png eller filen angivet i Theme.rc til at passe med den nuværende opløsning. Ændring af størrelse uden-videre vil selvfølgelig tage et stykke tid, så du bør sørge for baggrundsbilleder i det mindste i følgende størrelser: 1280x1024, 1024x768 og 800x600. +Baggrundsfiler + +Når &ksplash; starter, prøver den at finde et baggrundsbillede der passer til skærmens opløsning hvis tema-maskinen bruger et. Baggrundsbilledfilen skan navngives i følgende: Background-WWWxHHH.png. + +For eksempel vil du måske bruge en fil der hedder Background-1024x768. Hvis baggrundsbilledet for din skærms opløsning ikke kan findes, prøver den at ændre størrelse på den originale Background.png eller filen angivet i Theme.rc til at passe med den nuværende opløsning. Ændring af størrelse uden-videre vil selvfølgelig tage et stykke tid, så du bør sørge for baggrundsbilleder i det mindste i følgende størrelser: 1280x1024, 1024x768 og 800x600. -Valgmuligheder for tema-maskiner +Valgmuligheder for tema-maskiner -Standardtema +Standardtema -Indstillinger for standardtema +Indstillinger for standardtema -Navn -Argument -Forklaring +Navn +Argument +Forklaring -Vis altid fremgang -[sand/falsk] -Indikerer om indlæsningsfremgang skal vises. Standard er sand. +Vis altid fremgang +[sand/falsk] +Indikerer om indlæsningsfremgang skal vises. Standard er sand. -Forgrund for etiket -[farve] -Afgør hvilken farve der skal bruges for statuslinjens test. Standardværdien er er #FFFFFF (hvidt). +Forgrund for etiket +[farve] +Afgør hvilken farve der skal bruges for statuslinjens test. Standardværdien er er #FFFFFF (hvidt). -Ikoner blinker -[sand/falsk] -Angiver om ikoner skal blinke. Standardværdien er sandt (true). +Ikoner blinker +[sand/falsk] +Angiver om ikoner skal blinke. Standardværdien er sandt (true). @@ -293,135 +167,88 @@ Welcome Text = Indlæser KDE -Standard-tema +Standard-tema
-Valgmuligheder for standard-tema +Valgmuligheder for standard-tema -Navn -Argument -Forklaring +Navn +Argument +Forklaring -Placering af statuslinje -[top/bund] -Skifter positionen af statuslinjen på skærmen. Standard er for neden. +Placering af statuslinje +[top/bund] +Skifter positionen af statuslinjen på skærmen. Standard er for neden. -Synlig statuslinje -[sand/falsk] -Indikerer om statuslinjen skal vises. Standard er sand. +Synlig statuslinje +[sand/falsk] +Indikerer om statuslinjen skal vises. Standard er sand. -Fremgang synlig -[sand/falsk] -Indikerer om indlæsningsfremgang skal vises. Standard er sand. +Fremgang synlig +[sand/falsk] +Indikerer om indlæsningsfremgang skal vises. Standard er sand. -Skrifttype for statuslinje -[skrifttypenavn] -Den skrifttype der bruges i statuslinjen. Standard er Helvetica. +Skrifttype for statuslinje +[skrifttypenavn] +Den skrifttype der bruges i statuslinjen. Standard er Helvetica. -Skrifttypestørrelse for statuslinje -[størrelse] -Skrifttypens størrelse på statuslinjen. Standard er 16. +Skrifttypestørrelse for statuslinje +[størrelse] +Skrifttypens størrelse på statuslinjen. Standard er 16. -Fed skrifttype på statuslinje -[sand/falsk] -Indikerer om skrifttypen på statuslinjen skal være fed. Standard er sand. +Fed skrifttype på statuslinje +[sand/falsk] +Indikerer om skrifttypen på statuslinjen skal være fed. Standard er sand. -Kursiv skrifttype for statuslinje -[sand/falsk] -Indikere om statuslinjen skrifttype skal være kursiv. Standard er falsk. +Kursiv skrifttype for statuslinje +[sand/falsk] +Indikere om statuslinjen skrifttype skal være kursiv. Standard er falsk. -Forgrund for statuslinje -[farve] -Forgrundsfarven på statuslinjen. Standard er hvid. +Forgrund for statuslinje +[farve] +Forgrundsfarven på statuslinjen. Standard er hvid. -Baggrund for statuslinje -[farve] -Baggrundsfarve for statuslinjen. Standard er sort. +Baggrund for statuslinje +[farve] +Baggrundsfarve for statuslinjen. Standard er sort. -Ikon for statuslinje -[sand/falsk] -Indikerer om statuslinjen skal have en ikon. +Ikon for statuslinje +[sand/falsk] +Indikerer om statuslinjen skal have en ikon. -Ikoner synlige -[sand/falsk] -Indikerer om ikoner skal være synlige. Standard er sand. +Ikoner synlige +[sand/falsk] +Indikerer om ikoner skal være synlige. Standard er sand. -Ikoner hopper -[sand/falsk] -Indikerer om ikoner skal hoppe. Standard er sand. +Ikoner hopper +[sand/falsk] +Indikerer om ikoner skal hoppe. Standard er sand. -Ikonplacering -[0-3,10-13] -Position hvor ikonerne vises. Standard er for neden til venstre. +Ikonplacering +[0-3,10-13] +Position hvor ikonerne vises. Standard er for neden til venstre. -Opstartskærm -[navn] -Ændrer det billede der vises i opstartsskærmen. +Opstartskærm +[navn] +Ændrer det billede der vises i opstartsskærmen. @@ -429,137 +256,88 @@ Welcome Text = Indlæser KDE -Redmond tema +Redmond tema
-Indstillinger for Redmond tema +Indstillinger for Redmond tema -Navn -Argument -Forklaring +Navn +Argument +Forklaring -Baggrundsbillede -[filnavn] -Brugerdefineret baggrundsbillede der skal bruges. +Baggrundsbillede +[filnavn] +Brugerdefineret baggrundsbillede der skal bruges. -Bruger-ikon -[Ikonnavn] -Navn på standard-ikon at vise til brugeren. Standard er kør. +Bruger-ikon +[Ikonnavn] +Navn på standard-ikon at vise til brugeren. Standard er kør. -Velkomsttekst -[tekst] -Tekst der vises i opstartsskærmen. Standard er "Velkommen". +Velkomsttekst +[tekst] +Tekst der vises i opstartsskærmen. Standard er "Velkommen". -Tekst for brugernavn -[tekst] -Tekst der vises i stedet for brugerens rigtige navn. +Tekst for brugernavn +[tekst] +Tekst der vises i stedet for brugerens rigtige navn. -Placering af velkomsttekst -[x,y] -Position på skærmen hvor velkomstteksten vises. +Placering af velkomsttekst +[x,y] +Position på skærmen hvor velkomstteksten vises. -Tekst-position for brugernavn -[x,y] -Position på skærmen hvor brugernavnet vises. +Tekst-position for brugernavn +[x,y] +Position på skærmen hvor brugernavnet vises. -Placering af handlingstekst -[x,y] -Position på skærmen hvor den nuværende handling vises. +Placering af handlingstekst +[x,y] +Position på skærmen hvor den nuværende handling vises. -Ikonplacering -[x,y] -Position på skærmen hvor brugerikonen vises. +Ikonplacering +[x,y] +Position på skærmen hvor brugerikonen vises. -Vis velkomsttekst -[sand/falsk] -Slår visning af velkomsttekst til og fra. Standard er sand. +Vis velkomsttekst +[sand/falsk] +Slår visning af velkomsttekst til og fra. Standard er sand. -Vis velkomstskygge -[sand/falsk] -Slår visning af velkomsttekstens skygge til og fra. Standard er sand. +Vis velkomstskygge +[sand/falsk] +Slår visning af velkomsttekstens skygge til og fra. Standard er sand. -Vis brugernavn -[sand/falsk] -Slår visning af brugernavn til og fra. Standard er sand. +Vis brugernavn +[sand/falsk] +Slår visning af brugernavn til og fra. Standard er sand. -Vis handling -[sand/falsk] -Slår visning af den handling der udføres lige nu til og fra. Standard er sand. +Vis handling +[sand/falsk] +Slår visning af den handling der udføres lige nu til og fra. Standard er sand. -Vis ikon -[sand/falsk] -Indikerer om ikon skal vises. Standard er sand +Vis ikon +[sand/falsk] +Indikerer om ikon skal vises. Standard er sand -Brug TDM's bruger-ikon -[sand/falsk] -Vis brugerens login-ikon. Standard er sand. +Brug TDM's bruger-ikon +[sand/falsk] +Vis brugerens login-ikon. Standard er sand. @@ -567,68 +345,45 @@ Welcome Text = Indlæser KDE -MacX tema +MacX tema
-Indstillinger for MacX tema +Indstillinger for MacX tema -Navn -Argument -Forklaring +Navn +Argument +Forklaring -Minimum ikonstørrelse -[størrelse] -Tilknyt en minimumstørrelse for ikoner. Standard er 16. +Minimum ikonstørrelse +[størrelse] +Tilknyt en minimumstørrelse for ikoner. Standard er 16. -Maksimal ikonstørrelse -[størrelse] -Tilknyt maksimum størrelse for ikoner. Standard er 64. +Maksimal ikonstørrelse +[størrelse] +Tilknyt maksimum størrelse for ikoner. Standard er 64. -Optimeret ikonvisning -[sand/falsk] -Optimér ikonvisning. Standard er sand. +Optimeret ikonvisning +[sand/falsk] +Optimér ikonvisning. Standard er sand. -Synlig fremgangslinje -[sand/falsk] -Standard er sand. +Synlig fremgangslinje +[sand/falsk] +Standard er sand. -Placering af fremgangslinje -[top/bund] -Skifter mellem om statuslinjen skal være foroven eller forneden. Standard er forneden. +Placering af fremgangslinje +[top/bund] +Skifter mellem om statuslinjen skal være foroven eller forneden. Standard er forneden. -Ikoner hopper -[sand/falsk] -Indikerer om ikoner skal hoppe. Standard er falsk. +Ikoner hopper +[sand/falsk] +Indikerer om ikoner skal hoppe. Standard er falsk. @@ -636,52 +391,35 @@ Welcome Text = Indlæser KDE -MacClassic tema +MacClassic tema
-Indstillinger af MacClassic tema +Indstillinger af MacClassic tema -Navn -Argument -Forklaring +Navn +Argument +Forklaring -Ikonplacering -[0-3,10-13] -Placering af ikonerne på skærmen. Standard er forneden til venstre. +Ikonplacering +[0-3,10-13] +Placering af ikonerne på skærmen. Standard er forneden til venstre. -Ikoner hopper -[sand/falsk] -Indikerer om ikoner skal hoppe. Standard er falsk. +Ikoner hopper +[sand/falsk] +Indikerer om ikoner skal hoppe. Standard er falsk. -Ikoner synlige -[sand/falsk] -Indikerer om ikoner skal være synlige. Standard er sand. +Ikoner synlige +[sand/falsk] +Indikerer om ikoner skal være synlige. Standard er sand. -Opstartskærm -[navn] -Ændrer det billede der vises i opstartsskærmen. +Opstartskærm +[navn] +Ændrer det billede der vises i opstartsskærmen. @@ -689,84 +427,55 @@ Welcome Text = Indlæser KDE -2k tema +2k tema
-Indstillinger af 2k tema +Indstillinger af 2k tema -Navn -Argument -Forklaring +Navn +Argument +Forklaring -Baggrundsfarve for titel -[farve] -Baggrundsfarven for titlen. Standard er mørkeblå. +Baggrundsfarve for titel +[farve] +Baggrundsfarven for titlen. Standard er mørkeblå. -Forgrundsfarve for titel -[farve] -Forgrundsfarve for titlen. Standard er hvid. +Forgrundsfarve for titel +[farve] +Forgrundsfarve for titlen. Standard er hvid. -Tekstfarve for status -[farve] -Farven på statustekster. Standard er den samme som titelens baggrundsfarve. +Tekstfarve for status +[farve] +Farven på statustekster. Standard er den samme som titelens baggrundsfarve. -Rotator-farve 1 -[farve] -Definerer farven på rotator 1. Standard er mørkeblå. +Rotator-farve 1 +[farve] +Definerer farven på rotator 1. Standard er mørkeblå. -Rotator-farve 1 -[farve] -Definerer farven på rotator 1. Standard er cyan. +Rotator-farve 1 +[farve] +Definerer farven på rotator 1. Standard er cyan. -Rotatorhastighed -[værdi] -Definerer rotatorens hastighed. Standard er 30. +Rotatorhastighed +[værdi] +Definerer rotatorens hastighed. Standard er 30. -Vinduestitel -[tekst] -Angiver titelens tekst i vinduet. +Vinduestitel +[tekst] +Angiver titelens tekst i vinduet. -Logo-fil -[filnavn] -Definerer det logo der bruges. +Logo-fil +[filnavn] +Definerer det logo der bruges. @@ -776,33 +485,22 @@ Welcome Text = Indlæser KDE -Brug af &ksplash; indefra dit eget program +Brug af &ksplash; indefra dit eget program -I dette kapitel beskriver en simpel metode at bruge &ksplash; som opstartskærm for dit &kde;-program. Hvis du ikke udvikler programmer for &kde;, kan du springe over dette kapitel. +I dette kapitel beskriver en simpel metode at bruge &ksplash; som opstartskærm for dit &kde;-program. Hvis du ikke udvikler programmer for &kde;, kan du springe over dette kapitel. -Basale krav - -Dit &kde;-program skal være klar over &DCOP;. &DCOP; er den teknik &kde; bruger til at kommunikere mellem programmer. Hvis du bruger &kde; application framework, sker dette automatisk. For information om &DCOP; og relaterede &kde; teknologier, besøg venligst &kde; developers' corner. +Basale krav + +Dit &kde;-program skal være klar over &DCOP;. &DCOP; er den teknik &kde; bruger til at kommunikere mellem programmer. Hvis du bruger &kde; application framework, sker dette automatisk. For information om &DCOP; og relaterede &kde; teknologier, besøg venligst &kde; developers' corner. -Start af &ksplash; +Start af &ksplash; -Før dit program starter sit beregningsintensive arbejde, eller før det begynder med at indlæse plugin, &etc;, startes &ksplash; som følger: +Før dit program starter sit beregningsintensive arbejde, eller før det begynder med at indlæse plugin, &etc;, startes &ksplash; som følger: -DCOPClient *c = kapp->dcopClient(); +DCOPClient *c = kapp->dcopClient(); QString error; QCString KSplashName; int pid = 0; @@ -816,19 +514,15 @@ if (kapp->startServiceByDesktopName("ksplash", args, &error, } -Vi vil antage at der kun er én udgave af &ksplash; der kører. Andre tilfælde er en smule mere komplicerede. Se venligst &DCOP;-dokumentationen for yderligere detaljer. +Vi vil antage at der kun er én udgave af &ksplash; der kører. Andre tilfælde er en smule mere komplicerede. Se venligst &DCOP;-dokumentationen for yderligere detaljer. -Viser beskeder +Viser beskeder -Før du viser nogen beskeder, skal du indstille det antal skridt du vil vise. For eksempel bruger &kde;'s opstartsprocedure 7 skridt. +Før du viser nogen beskeder, skal du indstille det antal skridt du vil vise. For eksempel bruger &kde;'s opstartsprocedure 7 skridt. -QByteArray data; +QByteArray data; QDataStream arg(data,IO_WriteOnly); arg << someNumber; if (!(c->send(KSplashName, "KSplashIface", "setStartupItemCount(int)", @@ -836,11 +530,9 @@ data)) // Some error processing here. -Når du ønsker at vise en besked med eller uden ikon bruges +Når du ønsker at vise en besked med eller uden ikon bruges -arg << QString("iconName") << QString("programName") << +arg << QString("iconName") << QString("programName") << QString("Some description"); if (!(c->send(KSplashName, "KSplashIface", "programStarted(QString,QString,QString)", data)) @@ -849,20 +541,15 @@ QString("Some description"); } -Hver gang du kalder programStarted, forøges antallet af færdige skridt. Når dit program er færdig med sin opstart, så gør følgende for at få opstartskærmen til at gå væk: +Hver gang du kalder programStarted, forøges antallet af færdige skridt. Når dit program er færdig med sin opstart, så gør følgende for at få opstartskærmen til at gå væk: -if (!(c->send(KSplashName, "KSplashIface", "startupComplete()", data)) +if (!(c->send(KSplashName, "KSplashIface", "startupComplete()", data)) { // Noget fejlbehandling her. } -Det er det hele! Du behøver ikke andet for kunne udnytte alt hvad &ksplash; har at tilbyde. +Det er det hele! Du behøver ikke andet for kunne udnytte alt hvad &ksplash; har at tilbyde. @@ -871,65 +558,25 @@ QString("Some description"); -Skriv nye &ksplash;-plugin +Skriv nye &ksplash;-plugin -Det er ikke svært at skrive et nyt plugin for &ksplash;. I dette kapitel vil vi skrive et simpelt plugin der vil emulere opstartsskærmen for et velkendt operativsystem. Denne øvelse antager at du kender til basal C++, og en smule om KDE/Qt programmering. +Det er ikke svært at skrive et nyt plugin for &ksplash;. I dette kapitel vil vi skrive et simpelt plugin der vil emulere opstartsskærmen for et velkendt operativsystem. Denne øvelse antager at du kender til basal C++, og en smule om KDE/Qt programmering. -Basale krav -Vi vil lave et plugin der hedder 2k. Navnet på et plugin bruges forskellige steder, og det er vigtigt at du er konsistent i dets brug så dit plugin bliver genkendt af &ksplash;. &ksplash; plugin er rent faktisk dynamisk indlæsbare biblioteker med følgende navnekonvention: +Basale krav +Vi vil lave et plugin der hedder 2k. Navnet på et plugin bruges forskellige steder, og det er vigtigt at du er konsistent i dets brug så dit plugin bliver genkendt af &ksplash;. &ksplash; plugin er rent faktisk dynamisk indlæsbare biblioteker med følgende navnekonvention: -Biblioteket skal hedde ksplash+temanavnmedsmaabogstaver. For vore tema, vil et være ksplash2k. -Det skal have en tilsvarende desktop-fil som hedder ksplash+temanavnmedsmaabogstaver.desktop. For vores tema vil det være ksplash2k.desktop. -Endelig skal objektet der returneres af biblioteket være en klasse som hedder Theme+temanavnet. For vores eksempel vil det være Theme2k. +Biblioteket skal hedde ksplash+temanavnmedsmaabogstaver. For vore tema, vil et være ksplash2k. +Det skal have en tilsvarende desktop-fil som hedder ksplash+temanavnmedsmaabogstaver.desktop. For vores tema vil det være ksplash2k.desktop. +Endelig skal objektet der returneres af biblioteket være en klasse som hedder Theme+temanavnet. For vores eksempel vil det være Theme2k. -Du skal ikke bekymre dig om du forstår alt dette. Vi vil betragte hvert af punkterne i detalje senere. Den anden meget vigtige detalje er at plugin-klassen skal være afledt fra ThemeEngine. +Du skal ikke bekymre dig om du forstår alt dette. Vi vil betragte hvert af punkterne i detalje senere. Den anden meget vigtige detalje er at plugin-klassen skal være afledt fra ThemeEngine. -Bygning af skelet-ramme -Vi vil bruge &kde;'s program-ramme som vil tage sig af at bygge dit plugin og vil sørge for uafhængighed af platform uden at vi skal gøre noget. For at gøre dette sørg for at du har tdesdk-pakken installeret. Kør kommandoen kapptemplate for at producere et program der hedder "2k". Det vil lave en mappe på topniveau som indeholder generiske filer såsom AUTHORS, &etc;. Vi er mest interesseret i undermappen der hedder 2k. Gå ind i den undermappe og slet alle filerne der. Nu har vi det krævede skelet. -Næste skridt er at lave en .desktop-fil som, når den er installeret, vil fortælle &ksplash; at vores plugin er tilstede. Konsistent med navngivningkonventionerne lagt ud i det foregående afsnit, laves en fil der hedder ksplash2k.desktop i den mappe. Den skal indeholde følgende linjer: - +Bygning af skelet-ramme +Vi vil bruge &kde;'s program-ramme som vil tage sig af at bygge dit plugin og vil sørge for uafhængighed af platform uden at vi skal gøre noget. For at gøre dette sørg for at du har tdesdk-pakken installeret. Kør kommandoen kapptemplate for at producere et program der hedder "2k". Det vil lave en mappe på topniveau som indeholder generiske filer såsom AUTHORS, &etc;. Vi er mest interesseret i undermappen der hedder 2k. Gå ind i den undermappe og slet alle filerne der. Nu har vi det krævede skelet. +Næste skridt er at lave en .desktop-fil som, når den er installeret, vil fortælle &ksplash; at vores plugin er tilstede. Konsistent med navngivningkonventionerne lagt ud i det foregående afsnit, laves en fil der hedder ksplash2k.desktop i den mappe. Den skal indeholde følgende linjer: + [Desktop Entry] Encoding=UTF-8 Type=Service @@ -940,94 +587,29 @@ X-TDE-Library=ksplash2k X-KSplash-Default=true X-KSplash-PluginName=2k X-KSplash-ObjectName=Theme2k - + -Encoding, Type, Comment og ServiceTypes er det samme for alle plugin. Navnet på dit plugin og biblioteksnavnet følger de konventioner ve bemærkede tidligere. Indgangen X-KSplash-Default tager en boolesk værdi som afgør om det vises som standard i kontrolpanelets indstillingsmodul. Undtagen i meget sjældne tilfælde skal det være true. +Encoding, Type, Comment og ServiceTypes er det samme for alle plugin. Navnet på dit plugin og biblioteksnavnet følger de konventioner ve bemærkede tidligere. Indgangen X-KSplash-Default tager en boolesk værdi som afgør om det vises som standard i kontrolpanelets indstillingsmodul. Undtagen i meget sjældne tilfælde skal det være true. -Deklaration af plugin-klasse -Nu da vi er færdige med det indledende arbejde, lad os begynde med den morsomme del - at lave en klasse der vil sørge for den opførsel vi ønsker. Mens vi er fire til at få denne klasse til at gøre næsten hvadsomhelst vi ønsker den skal gøre, er der nogle få begrænsninger. +Deklaration af plugin-klasse +Nu da vi er færdige med det indledende arbejde, lad os begynde med den morsomme del - at lave en klasse der vil sørge for den opførsel vi ønsker. Mens vi er fire til at få denne klasse til at gøre næsten hvadsomhelst vi ønsker den skal gøre, er der nogle få begrænsninger. -Plugin-klasser skal arve ThemeEngine-klassen. -Plugin-klasser skal navngives efter reglen: Tema+PluginNavn. -Plugin-klasser skal sørge for en statisk funktion der hedder names der returnerer en liste af navne ved hvilke de kan startes. -Hvis dit plugin kan indstilles i kontrolcenter-modulet, skal det sørge for en ThemeEngineConfig-baseret klasse for indstillingen. -Plugin-klasser skal gå forud for mindst en af de virtuelle funktioner slotSetText, slotSetPixmap, slotUpdateProgress og slotUpdateSteps for at være brugbare. -Konstruktøren skal være på formen ThemeEngine( QWidget *parent, const char *name, const QStringList &args ) så den kan bruges med KGenericFactory. +Plugin-klasser skal arve ThemeEngine-klassen. +Plugin-klasser skal navngives efter reglen: Tema+PluginNavn. +Plugin-klasser skal sørge for en statisk funktion der hedder names der returnerer en liste af navne ved hvilke de kan startes. +Hvis dit plugin kan indstilles i kontrolcenter-modulet, skal det sørge for en ThemeEngineConfig-baseret klasse for indstillingen. +Plugin-klasser skal gå forud for mindst en af de virtuelle funktioner slotSetText, slotSetPixmap, slotUpdateProgress og slotUpdateSteps for at være brugbare. +Konstruktøren skal være på formen ThemeEngine( QWidget *parent, const char *name, const QStringList &args ) så den kan bruges med KGenericFactory. -Det sidste krav synes måske kompliceret, men, som vi skal se senere, du kan sædvanligvis ignorere det ved at tilføje en enkelt linje til din kildefil. +Det sidste krav synes måske kompliceret, men, som vi skal se senere, du kan sædvanligvis ignorere det ved at tilføje en enkelt linje til din kildefil. -Kode for header-filen -Givet disse begrænsninger vil vi nu se at header-filen theme2k.h ser sådan her ud: +Kode for header-filen +Givet disse begrænsninger vil vi nu se at header-filen theme2k.h ser sådan her ud: -Visning af <filename ->theme2k.h</filename -> -#ifndef __THEME2K_H__ +Visning af <filename>theme2k.h</filename> +#ifndef __THEME2K_H__ #define __THEME2K_H__ #include <qlabel.h> @@ -1091,50 +673,20 @@ private: #endif -Lad os analysere ovenstående. Theme2k-klassen tilfredsstiller navnekonventionerne, og er arvet fra ThemeEngine. Den sørger for en Theme2k::names(), og har en konstruktør der tager de krævede parametre: Theme2k( QWidget *, const char *, const QStringList& ); og sørger også for en simpel Theme2k::slotSetText() metode. Indtil videre bekymrer vi os ikke om RotWidget-klassen. Det er en lille kontrol der sørger for nogle øjenlækkerier for brugeren. Vores plugin er meget simpelt og viser ikke nogen ikoner og har ingen fremgangslinje. Hvis du gerne vil vise ikoner, så sæt slotSetPixmap-funktionen ud af kraft. Lignende funktioner eksisterer til at sætte fremgangslinjens område (slotUpdateSteps) og til at forøge (slotUpdateProgress) det nuværende skridt. +Lad os analysere ovenstående. Theme2k-klassen tilfredsstiller navnekonventionerne, og er arvet fra ThemeEngine. Den sørger for en Theme2k::names(), og har en konstruktør der tager de krævede parametre: Theme2k( QWidget *, const char *, const QStringList& ); og sørger også for en simpel Theme2k::slotSetText() metode. Indtil videre bekymrer vi os ikke om RotWidget-klassen. Det er en lille kontrol der sørger for nogle øjenlækkerier for brugeren. Vores plugin er meget simpelt og viser ikke nogen ikoner og har ingen fremgangslinje. Hvis du gerne vil vise ikoner, så sæt slotSetPixmap-funktionen ud af kraft. Lignende funktioner eksisterer til at sætte fremgangslinjens område (slotUpdateSteps) og til at forøge (slotUpdateProgress) det nuværende skridt. -Implementation af plugin -Vi vil kun undersøge de relevante dele af implementationen. For en liste af hele implementationen, kig venligst i appendiks. Det første vi vil gøre er at bibliotekskravene til en side: +Implementation af plugin +Vi vil kun undersøge de relevante dele af implementationen. For en liste af hele implementationen, kig venligst i appendiks. Det første vi vil gøre er at bibliotekskravene til en side: -Bibliotekskrav -K_EXPORT_COMPONENT_FACTORY( ksplash2k, KGenericFactory<Theme2k> ); +Bibliotekskrav +K_EXPORT_COMPONENT_FACTORY( ksplash2k, KGenericFactory<Theme2k> ); -Makroen K_EXPORT_COMPONENT_FACTORY erklæres i kgenericfactory.h. Videre til konstruktøren! Da dette er et meget simpelt plugin, er konstruktøren temmelig ligetil. +Makroen K_EXPORT_COMPONENT_FACTORY erklæres i kgenericfactory.h. Videre til konstruktøren! Da dette er et meget simpelt plugin, er konstruktøren temmelig ligetil. -Plugin-konstruktør -Theme2k::Theme2k( QWidget *parent, const char *name, const QStringList &args +Plugin-konstruktør +Theme2k::Theme2k( QWidget *parent, const char *name, const QStringList &args ) :ThemeEngine( parent, name, args ) { @@ -1143,15 +695,10 @@ private: } -Metoden readSettings() illustrerer den rigtige måde at opnå din temaopsætning. (Du ønsker at folk skal bruge dit plugin i deres temaer, ikke sandt?) +Metoden readSettings() illustrerer den rigtige måde at opnå din temaopsætning. (Du ønsker at folk skal bruge dit plugin i deres temaer, ikke sandt?) -Opnået temaopsætning -void Theme2k::readSettings() +Opnået temaopsætning +void Theme2k::readSettings() { if( !mTheme ) return; @@ -1182,25 +729,14 @@ private: } -Da vi kan lide vore brugere, sørger vi for rimelige standardværdier for parametre der ikke er tilstede i temafilen. Bemærk at vi altid skal sætte vores gruppe til "KSplash Theme: themename" for at forblive kompatible med fremtidige tema-specifikationer. initUI()-metoden er ikke særlig interessant, da den blot opbygger kontrollerne. Se venligst appendiks for detaljer. +Da vi kan lide vore brugere, sørger vi for rimelige standardværdier for parametre der ikke er tilstede i temafilen. Bemærk at vi altid skal sætte vores gruppe til "KSplash Theme: themename" for at forblive kompatible med fremtidige tema-specifikationer. initUI()-metoden er ikke særlig interessant, da den blot opbygger kontrollerne. Se venligst appendiks for detaljer. -Kompilering af plugin -Da vi besluttede os for at bruge &kde;'s rammer til at kompilere vores plugin, må vi lave en Makefile.am. Den skal se sådan her ud: +Kompilering af plugin +Da vi besluttede os for at bruge &kde;'s rammer til at kompilere vores plugin, må vi lave en Makefile.am. Den skal se sådan her ud: -Visning af <filename ->Makefile.am</filename -> -INCLUDES = $(all_includes) +Visning af <filename>Makefile.am</filename> +INCLUDES = $(all_includes) kde_module_LTLIBRARIES = ksplash2k.la @@ -1219,103 +755,67 @@ themedir = $(kde_datadir)/ksplash/Themes/2k theme_DATA = Theme.rc Preview.png -For yderligere oplysninger om at skrive Makefile.am-filer for &kde;, se venligst &kde;-udviklernes' netside. Det eneste der skal bemærkes er at vi sørger for et standardtema baseret på dette plugin, og vi sørger for et forhåndsbillede for det. Som en venlighed overfor dine brugere, bør du sørge for et eksempel på en Theme.rc-fil der illustrerer brugen af de forskellige tilvalg. +For yderligere oplysninger om at skrive Makefile.am-filer for &kde;, se venligst &kde;-udviklernes' netside. Det eneste der skal bemærkes er at vi sørger for et standardtema baseret på dette plugin, og vi sørger for et forhåndsbillede for det. Som en venlighed overfor dine brugere, bør du sørge for et eksempel på en Theme.rc-fil der illustrerer brugen af de forskellige tilvalg. -Spørgsmål og svar +Spørgsmål og svar &reporting.bugs; &updating.documentation; -Jeg kan ikke finde nogen temaer der virker i &ksplash;. Hvorfor er det? +Jeg kan ikke finde nogen temaer der virker i &ksplash;. Hvorfor er det? -Du har formodentlig ikke de rigtige plugin for temaet. Plugin er i kde-artwork pakken. Hent den og installér den, og prøv så igen. +Du har formodentlig ikke de rigtige plugin for temaet. Plugin er i kde-artwork pakken. Hent den og installér den, og prøv så igen. -Hvad er filen Theme.rc og hvordan laver jeg én? +Hvad er filen Theme.rc og hvordan laver jeg én? -Theme.rc er filen hvor du kan specificere temaets opsætning. For yderligere oplysninger kig i Hvordan laver jeg temaer for &ksplash;. +Theme.rc er filen hvor du kan specificere temaets opsætning. For yderligere oplysninger kig i Hvordan laver jeg temaer for &ksplash;. -Medvirkende og licens +Medvirkende og licens -&ksplash; +&ksplash; -Program ophavsret © 2003 &Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail; +Program ophavsret © 2003 &Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail; -Bidragydere -&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail; +Bidragydere +&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail; -Dokumentation ophavsret © 2003 &Teemu.Rytilahti; &Teemu.Rytilahti.mail; +Dokumentation ophavsret © 2003 &Teemu.Rytilahti; &Teemu.Rytilahti.mail; &underFDL; &underGPL; -Installation +Installation -Krav +Krav -For at det skal lykkes at bruge &ksplash;, har du brug for &kde; version 3.2 eller højere. Nogle temaer vil måske kræve bestemte plugin. Hvis et tema ikke virker, så kontakt venligst temaets forfatter for at finde ud af hvor man får fat i et passende plugin. +For at det skal lykkes at bruge &ksplash;, har du brug for &kde; version 3.2 eller højere. Nogle temaer vil måske kræve bestemte plugin. Hvis et tema ikke virker, så kontakt venligst temaets forfatter for at finde ud af hvor man får fat i et passende plugin. -Kompilering og installation +Kompilering og installation &install.compile.documentation; -Kildekode +Kildekode -Visning af <filename ->theme2k.cpp</filename -> -#include <qlabel.h> +Visning af <filename>theme2k.cpp</filename> +#include <qlabel.h> #include <qwidget.h> #include <tdeapplication.h> @@ -1426,12 +926,8 @@ void Theme2k::readSettings() -Visning af <filename ->rotwidget.h</filename -> -#ifndef __ROTWIDGET_H__ +Visning af <filename>rotwidget.h</filename> +#ifndef __ROTWIDGET_H__ #define __ROTWIDGET_H__ #include <qlabel.h> @@ -1470,12 +966,8 @@ protected: -Visning af <filename ->rotwidget.cpp</filename -> -#include <kdebug.h> +Visning af <filename>rotwidget.cpp</filename> +#include <kdebug.h> #include <kdialogbase.h> #include <kpixmapeffect.h> -- cgit v1.2.1