# Leg med de indre dele af &kde;

Nicolas
Goutte
goutte@kde.org

## Redigér indstillingsfiler i hånden

### Indledning

Indstillingsfilerne i &kde; er enkle at redigere med en almindelig editor såsom &kate;, eftersom indstillingsfilerne er tekstfiler.

Et eksempel på en tekstfil:

    [General]
    AutoSave=1
    LastFile=/var/tmp/test.txt

Brugerspecifikke indstillingsfiler opbevares i `.kde/share/config` (erstat `.kde` med din indstilling af $`KDEHOME`) og de globale er i undermappen `share/config` i &kde;'s installationssøgesti. (Du kan finde søgestien ved at køre kommandoen `kde-config --prefix`.) Filnavnene slutter typisk med rc (uden indledende punktum), for eksempel `kopeterc`.

At redigere indstillingsfiler i hånden kan udgøre en risiko for stabiliteten af din installation af &kde;. Programmer tjekker oftest ikke hvad de læser i indstillingsfiler. Det betyder at de kan forstyrres af hvad de får som indstillinger, og kan til og med bryde sammen.

### Sikkerhedskopier

Den første regel er altså at lave en sikkerhedskopi af filen inden du ændrer den. Det er bedst at opbevare sikkerhedskopien udenfor en undermappe i `.kde` (eller tilsvarende $`KDEHOME` mappe). Sikkerhedskopier er under alle omstændigheder en god idé i tilfælde af en større fejl i &kde; som ville forstyrre vigtige indstillingsfiler (for eksempel dine indstillinger af &kmail;, som findes i filen `kmailrc`). En sådant større fejl skulle ikke indtræffe, men det kan ske alligevel.

### Redigering

Hvorfor skulle du ville røre indstillingsfilerne i det hele taget? Ja, først og fremmest behøver du det hvis du vil oprette en kiosktilstand. Måske har en udvikler bedt dig om at tilføje en indgang for at hjælpe til med at løse et problem i programmet. Måske vil du komme ud af fra et problem uden at behøve fjerne hele `.kde` mappen. Måske vil du gerne lære dig mere om de interne funktioner i &kde;.

Under alle omstændigheder, hvilken grund du end har, vil du ændre en indstillingsfil i hånden.

Når du tænker dig at redigere en sådan fil, så sørg for at programmet som bruger den ikke kører. Hvis det er en af de grundlæggende indstillingsfiler, så overvej at redigere filen når &kde; slet ikke kører.

Klar? Lav når en sikkerhedskopi af filen (det har vi vel allerede talt om?). Starte din favoriteditor (lad os antage at det er &kate;), indlæs filen (Var forsigtig med at indlæse den som UTF-8, som &kate; viser som utf8).

Nu har du en fil som ser sådan her ud:

    [Group]
    Key1=Value1
    Key2=Value2
    Key3=Value3

Du kan nu ændre den (med forsigtighed) og derefter gemme den. (Sørg igen for at det er som UTF-8).

Nu kan du teste programmet og hvis det ikke længere kører som det skal, så luk programmet og genopret indstillingsfilens sikkerhedskopi.

#### Relateret information

- har mere information om &kde;'s mappestruktur, for at hjælpe dig finde filen du behøver redigere.

## Brug scripter med skrivebordet

&kde; sørger for et kraftfuldt kommunikationssystem mellem processer med &DCOP;, Desktop COmmunication Protocol. Ved at bruge &DCOP; kan du styre et stort antal funktioner i &kde; fra kommandolinjen eller fra et script skrevet i dit foretrukne scriptsprog. Du kan også få information fra &kde;-programmer: for eksempel sørges der i flere mediaafspillere i &kde; for metoder til at spørge afspilleren om information om sporet som for øjeblikket afspilles.

Generelt set sørger hvert &kde;-program for et eller flere &DCOP; grænseflader, som på sin side sørger for metoder (eller hvis du foretrækker det, funktioner) som andre programmer kan kalde. Det første skridt i at skrive vort script er altså at finde en passende metode til at ændre desktoppens baggrundsfarve. Den nemmeste måde at gøre dette er at bruge grænsefladen kdcop for at se de tilgængelige &DCOP;-metoder.

Kør kdcop fra en terminal eller Kør program (vinduet som dukker op med &Alt;F2). Vinduet kdcop viser de programmer som for øjeblikket kører og sørger for en &DCOP;-grænseflade, med en trævisning. Generelt kræves en vis gennemsøgning i trævisningen for at finde den rigtige metode, men et nyttigt vink er at grænsefladen markeret (default) almindeligvis indeholder de oftest bruge funktioner.

For at teste at funktionen gør det vi forventer os, dobbeltklikkes på indgangen setColor. For at angive farven `c`, klikkes på farvevælgerknappen og en farve vælges. Angiv om farven skal være farve A med afkrydsningsfeltet. Klik på O.k. så ændres baggrundens farve.

For at få adgang til &DCOP;-metoden fra dit foretrukne scriptsprog, kan du enten bruge &DCOP;-bindninger, om de er tilgængelige i modulet kdebindings, eller kalde kommandoradsprogrammet `dcop`. For enkel brug er det tilstrækkeligt at kalde kommandoradsprogrammet `dcop`. For at kalde en &DCOP;-metod på kommandolinjen, skal vi angive programmet og grænsefladen som metoden tillhør, selva metoden og argumenten på en form som er læmplig for skallen.

Vi angiver program, grænseflade og metode i denne rækkefølge, fulgt af argumenterne i samme rækkefølge som de vises i kdcop. `dcop` har mange andre tilvalg: Kig engang på udskriften fra ``dcop` `--help``.

Det er nok med teori. Tid til et eksempel:

### Et script til at ændre desktoppens farve med &DCOP;

Ved hjælp af kommandolinjeprogrammet `dcop` og lidt kode i Perl, vil vi lave et enkelt script som langsomt lader desktoppens baggrund gå gennem spektret cyklisk.

Først kigger vi efter en passende medode med kdcop. I dette eksempel går vi forbi søgningen, og går direkte til den: Metoden vi vil have er kdesktop KBackgroundIface setColor. Funktionens argument og returtype vises med stilen i sproget C++. For `setColor`, er argumentet en farve, `c`, som angiver den nye baggrundsfarve, og en Boolesk værdi, `isColorA` som angiver om farven er den første eller anden (dette er nyttigt for at angive toninger med mere).

For at bruge metoden `setColor` på kommandolinjen, bruger vi følgende:

    % dcop kdesktop KBackgroundIface setColor '#ffffff' false

For at angive farven bruger vi den hexadecimale RGB-værdi, som bruges af &HTML;. Bemærk at den er omgivet af enkle citationstegn, for at beskytte # fra skallen.

For at finde den hexadecimale RGB-værdi for en farve, åbnes en farvevalgsdialog i et &kde;-program (for eksempel i &kcontrolcenter;, Udseende og temaer Farver ), vælg farven du vil have, og brug værdien som angives i tekstfeltet HTML.

Det er altså alt vi behøver fra &DCOP;. Nu er det kun spørgsmålet om at skrive et script omkring det. Her er en (meget) grov implementering:

    $min=49;  # Minimal værdi for farven R, G eller B
    $max=174; # Maksimal værdi for farven R, G eller B
    $step=5;  # Værdi at stige farven med for hvert skridt
    $sleeptime=15; # Interval i sekunder mellem hvert skridt

    @start = ($max, $min, $min);
    @colour = @start;

    while (1) {
            foreach (0..5) {
                    my $which = $_ % 3; # Hvilken farve (R, G eller B) som skal ændres
                    my $updown = $_ % 2; # Om farvens værdi skal øges eller mindskes
                    do {
                            if ($updown == 0) { $colour[$which]+=$step; }
                            if ($updown == 1) { $colour[$which]-=$step; }
                            my $dcopcall=sprintf "dcop kdesktop KBackgroundIface setColor '#%x%x%x' true\n", @colour;
                            system($dcopcall);
                            sleep $sleeptime;
                            } while (($colour[$which]
    >= $min) and ($colour[$which] <= $max));
                    }
    }

Kør blot scriptet uden argument så går det cyklisk gennem baggrundsfarver i et noget begrænset spektrum indtil det afbrydes. Voilà!

Perl er naturligvis ikke det eneste sprog du kan bruge til at skrive scripter med &DCOP;. Hvis du foretrækker skalscript, er det også tilgængeligt:

### Hent en baggrund fra internettet

Følgende script henter hovedbilledet fra serien User Friendly og bruger det som naggrundstapet, med almindeligt tilgængelige værktøjer og en lille smule &DCOP;:

    #!/bin/sh
    COMICURL=`wget -qO - http://www.userfriendly.org/static/index.html | \
              grep Latest | sed -e "s,.*SRC=\",," -e "s,\"
    >.*,,"`
    TMPFILE=`mktemp /tmp/$0.XXXXXX` || exit 1
    wget -q -O $TMPFILE $COMICURL
    dcop kdesktop KBackgroundIface setWallpaper $TMPFILE 1

Den første linje efter #!/bin/sh bruger `wget` og lidt magi med regulære udtryk for at plukke billedets sted ud fra hovedsidens &HTML;-kode. Den anden og tredje linje henter billedet, og til sidst sætter `dcop` billedet som baggrundsbillede.

## Tilføj til ekstra tastebindinger til &kde;

Mange moderne tastaturer har ekstra taster som normalt ikke er tildelte til nogen handling.

Multimediataster genererer ofte et signal, og kan helt enkelt vælges som en genvejstast i et program præcis som at vælge en hvilken som helst anden tast. Visse taster detekteres dog ikke, og at trykke på dem i Indstil genveje har ingen effekt.

For eksempel har visse bærbare maskiner fra IBM ekstra taster omkring venstre- og højrepilene, som ser ud som side venstre og side højre.

1. Brug `xev` til at finde tasternes koder. I dette tilfælde er de 233 og 234.

2. Vælg tastsymboler. Der er et helt sæt sådanne som ikke normalt bruges, altså er mange ledige. Du finder listen i `/usr/X11R6/include/X11/keysymdef.h` (eller tilsvarende på dit system).

3. Opret en fil i din hjemmemappe som hedder `.Xmodmap`, og tilføj følgende:

       keycode 233 = Next_Virtual_Screen
       keycode 234 = Prev_Virtual_Screen

4. Kør kommandoen ``xmodmap` `~/.Xmodmap``

Nu skal du kunne køre `xev` igen og se at tasterne nu genererer tastsymbolerne som du tildelte dem. Du kan nu helt enkelt tildele dem til en hvilken somhelsthandling som normalt.

### Relateret information

- Manualsiden for `xev`. Du kan kigge på den ved at skrive `man:/xev` i et &konqueror;-vindue eller ved at skrive ``man` xev` i en terminal.

## Tilføj tastebindinger for nye handlinger

De fleste handlinger enten på desktoppen eller i programmer er enkelt tilgængelige at tildele en tastebinding til. Hvis handlingen du vil have en genvejstast for er noget du selv har skrevet, eller på anden måde ikke er tilgængelig, kan du alligevel tildele den en genvejstast.

For at sammenknytte de to foregående afsnit, vil du måske tildele en tast på tastaturet som ellers er ubrugt til et script eller en DCOP-kommando. Vort eksempel her er at tildele de to taster vi har tilføjet i til at gå til foregående eller næste virtuelle desktop, hvilket man behøver DCOP for at gøre (som beskrevet i ).

Det kan enkelt opnås med følgende metode:

1. Åbn kontrolcentret og vælg Indtastningshandlinger under afsnittet Region og tilgængelighed

2. Vælg Ny handling

3. Navngiv den nye handling, f.eks. `Næste virtuelle skærm`

4. Vælg Tastaturgenvej -> Kommando/URL (enkel) som Handlingstype:

5. Under fanebladet Tastaturgenvej, klik på knappen som du vil bruge til at udføre kommandoen. I dette eksempel, skal du trykke på den med ikonen Næste side, Så vises Next_Virtual_Screen som tastebilled.

6. Under fanebladet Indstillinger for kommando/URL, skrives kommandoen at køre i feltet: ``dcop kwin default nextDesktop``

Gentag ovenstående med tasten Prev_Virtual_Screen og ``dcop kwin default previousDesktop``.

Ved nu at trykke på Prev_Virtual_Screen eller Next_Virtual_Screen skifter du til foregående eller næste virtuelle desktop.

Åbenbart kan du tildele en hvilken som helst ledig tast til en handling.

### Relateret information

- Se dokumentationen for Khotkeys ved at slå op den i hjælpecentret, eller skrive `help:/khotkeys` i et &konqueror;-vindue.

Adriaan
de Groot
groot@kde.org

## &kdebugdialog;: Styr &kde;:s fejlsøgningsudskrift

### Basal brug

&kdebugdialog; ses ikke normalt i K-menuen. Du skal starte det fra en skal eller fra Kør kommando... med kommandoen ``kdebugdialog``. &kdebugdialog; viser et vindue med en lang liste over fejlsøgningsområder. Hvert område har et afkrydsningsfelt som du kan markere eller afmarkere for at aktivere eller deaktivere fejlsøgningsudskrift for den del af &kde;.

Listen med fejlsøgningsområder er sorteret i nummerrækkefølge, ikke alfabetisk, så kio (127) kommer før artskde (400). Numrene går op til omkring 200000, men der er egentlig kun 400 områder. Du behøver dog ikke gennemsøge hele listen for at finde området du vil have. Der er et linjeeditorfelt længst oppe i dialogen hvor du kan indtaste en del af navnet på området du vil have. Listen med indgange som vises filtreres så kun de fejlsøgningsområder som indeholder teksten du har skrevet vises. Ved f.eks. at indtaste `k` filtreres ikke særligt meget, men skrives `kont` vises kun fejlsøgningsområder for &kontact;. Som en endnu hurtigere måde at aktivere eller deaktivere fejlsøgningsuddata, er der også knapperne Markér alle og Afmarkér alle, som gør at &kde; laver enorme mængder af fejlsøgningsuddata, eller meget lidt.

### Kdebugdialog i fuldstændigt tilstand

I fuldstændig tilstand, som du får når du starter kdebugdialog som ``kdebugdialog` `--fullmode``, er samme liste med fejlsøgningsområder tilgængelige som i enkel tilstand, men du kan kun vælge en af gangen i et dropned-felt. Nu kan du uafhængigt indstille uddata for forskellige typer af meddelelser: Information, Advarsel, Fejl og Alvorlig fejl. For hver af disse typer kan du vælge hvor meddelelsen sendes. Valgene er:

Fil,i hvilket tilfælde kan indtaste et filnavn. Filen skrives i mappen $`HOME`.

Meddelelsesfelt. Hver fejlsøgningsmeddelelse vises i en informationsdialog, som du skal klikke O.k. i for at fortsætte med programmet.

Skal, standardindgang. Meddelelser skrives ud med standardfejludskriften, og ses enten i skalvinduet hvor programmet startedes eller i `.xsession-errors`.

Syslog. Dette sender hver fejlsøgningsmeddelelse til systemets syslog-funktion, som kan udføre sin egen behandling af meddelelsen.

Ingen. Det undertrykker udskrift af denne slags meddelelse.

For meddelelser som genereres af alvorlige fejl er det generelt en dårlig idé at vælge Ingen eller Syslog, eftersom du i begge tilfælde ikke ser meddelelsen og programmet som støder på den alvorlige fejl forsvinder uden at efterlade nogen ledetråd om hvorfor det forsvandt. Hvis programmet forsvinder eller ikke ved en alvorlig fejl, kan styres med afkrydsningsfeltet Afbryd ved alvorlig fejl, som normalt er markeret, men du kan alligevel forvente dig at et program bryder sammen (på en uskøn måde) hvis det støder på en alvorlig fejl.