# Jugar sota la capa de &kde;

Nicolas Goutte goutte@kde.org

## Editar manualment els fitxers de configuració

### Introducció

En &kde;, els fitxers de configuració són fàcils d'editar amb un simple editor com &kate; atès que els fitxers de configuració són fitxers de text.

Un exemple d'un fitxer de text:

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

La configuració especifica de cada usuari es desa en `./kde/share/config` (canvieu `.kde` amb el contingut de la vostra $`KDEHOME`) i la global en el subdirectori `share/config` de la ruta d'instal·lació de &kde;. (podeu trobar aquesta ruta executant el comandament `kde-config --prefix`). Usualment els noms de fitxer acaben en rc (sense punt inicial), per exemple `kopeterc`

Editar els fitxers de configuració manualment pot posar en perill la estabilitat de la vostra instal·lació &kde;. Les aplicacions no solen verificar qui llegeix els fitxers de configuració. Això vol dir que hi poden haver problemes quan carregueu la vostra configuració, fins i tot poden petar.

### Còpies de seguretat

De manera que la primera regla és fer una còpia de seguretat del vostre fitxer abans de modificar-lo. És aconsellable desar la còpia de seguretat fora de qualsevol subdirectori dins de `.kde` (o del directori corresponent $`KDEHOME`). Les còpies de seguretat són sempre una bona idea, atès que en el cas de produir-se una errada important de &kde; es podrien destruir fitxers de configuració importants (per exemple les vostres preferències de &kmail;, que estan en el fitxer `kmailrc`). (No s'hauria de produir cap errada important però podria succeir).

### Edició

Per què podria voler modificar els fitxers de configuració? Bé, en primer lloc us caldrà per a poder complir les directives del mode KIOSK. És possible que un desenvolupador us demani que afegiu una entrada per a resoldre un problema amb una aplicació. És possible que vulgueu resoldre un problema sense tenir que eliminar tot el directori `.kde`. És possible que vulgueu aprendre més sobre les interioritats de &kde;.

De tota manera, siguin quins siguin els vostres motius, voleu modificar de forma manual un fitxer de configuració.

Quan planegeu editar un fitxer, assegureu-vos que l'aplicació a la que l'usa no s'està executant. Si és un dels fitxers amb la configuració bàsica, penseu en editar el fitxer sense que el &kde; estigui en execució.

Llestos? Creeu una còpia de seguretat del fitxer (Si l'heu fet abans?), inicieu el vostre editor favorit (assumirem que és &kate;), carregueu el fitxer (assegureu-vos de carregar-lo amb UTF-8, &kate; el mostrarà com a utf8).

Ara teniu un fitxer com aquest:

    [Grup]
    Clau1=Valor1
    Clau2=Valor2
    Clau3=Valor3

Podeu modificar-lo (amb cura!) i desar-lo (assegureu-vos altra vegada que està en UTF-8).

Ara podeu provar l'aplicació i si l'aplicació no funciona correctament, tanqueu-la i restaureu la còpia de seguretat del fitxer de configuració.

### Informació relacionada

- kde-for-administrators conté més informació sobre la estructura de directoris de &kde;, per ajudar-vos a trobar el fitxer que us cal editar.

## Crear scripts de l'escriptori

&kde; proveeix un potent sistema de comunicació entre processos amb &DCOP;, el protocol de comunicació de l'escriptori. Usant &DCOP; podreu controlar un ampli nombre de funcions en &kde; des de la línia de comandaments o des d'un script escrit en el vostre llenguatge d'script favorit. També podreu obtenir informació de les aplicacions &kde;: Per exemple, alguns reproductors de &kde; proveeixen mètodes per a demanar al reproductor informació sobre la pista que s'està reproduint.

Parlant en termes generals, cada aplicació de &kde; proveeix una o més interfaces &DCOP;, que proveeixen mètodes (o, si ho preferiu, funcions) que poden ser cridades per una altra aplicació. De manera que, la primera passa per usar &DCOP; és trobar el mètode apropiat per a la tasca. La manera més senzilla és usar la interfície kdcop per obtenir els mètodes &DCOP; disponibles.

Executeu kdcop des d'una &konsole; o des del mini-CLI (la finestra que apareix al prémer &Alt;F2 ). La finestra kdcop mostrarà les aplicacions que s'estiguin executant i que proveeixen interfícies &DCOP;, usant una vista en arbre. En general, trobar el mètode correcte requereix cercar una mica al llarg de l'arbre, però un consell pràctic és usar la interfície marcada amb (omissió) la qual sol contenir les funcions d'ús més freqüent.

Per a comprovar que la funció és la que esperàveu, feu doble clic sobre l'entrada setColor. Per establir el color `c`, feu clic sobre el botó selector de color, i escolliu-ne un. Decidiu si el color hauria de ser un color A amb la caixa de selecció. Feu clic a Bé i s'assignarà el color al fons.

Per accedir al mètode &DCOP; des del vostre llenguatge d'script favorit, podeu usar les dreceres &DCOP;, si el mòdul kdebindings està disponible, o cridar a `dcop` des de la línia de comandaments. Per a un ús simple, cridar a `dcop` des de la línia de comandaments és suficient. Per a cridar a &DCOP; des de la línia de comandaments, us caldrà especificar l'aplicació i la pròpia interfície del mètode, el mètode en si mateix, i els arguments, en una manera adequada per a l'intèrpret de comandaments.

Especificarem l'aplicació, interfície i mètode en aquest ordre, seguit pels arguments en el mateix ordre en que es mostren en kdcop. `dcop` te moltes més opcions: Feu un cop d'ull a la sortida de ``dcop` `--help``.

Prou de teoria: Veiem un exemple:

### Un script per a canviar el color del fons amb &DCOP;

Amb el línia de comandament `dcop` de l'aplicació i una mica de Perl, crearem un simple script que canviarà el color del fons de l'escriptori a través de l'espectre en cicles curts.

En primer lloc, buscarem el mètode adequat amb kdcop. Per a aquest exemple, acurtarem la recerca, i anirem al gra: El mètode que ens cal és kdesktop KBackgroundIface setColor . Els arguments i el tipus retornat per la funció es mostraran en l'estil del llenguatge C++. Per a `setColor`, els arguments són, `c`, que especifica el nou color de fons, i un valor lògic (verdader o fals), `isColorA`, que especifica si el color és el primer o el segon (és pràctic per a configurar gradients).

Per usar el nostre mètode `setColor` en la línia de comandaments, usarem el següent:

    % dcop kdesktop KBackgroundIface setColor '#ffffff' false

Per especificar el color, usarem el valor RGB hexadecimal, tal i com s'usa en &HTML;. Tingueu present que haurà d'estar tancat entre cometes per a protegir la # des de l'intèrpret.

Per a trobar el valor hexadecimal del color RGB, obriu qualsevol diàleg selector de color en una aplicació &kde; (per exemple, en ¢recontrol;, Aparença i temes Colors ), seleccioneu el color desitjat, i useu el valor obtingut en la caixa de text HTML.

I això es tot el que ens cal de &DCOP;; ara tan sols és qüestió d'escriure un script basat en això. Veiem una (molt!) rudimentària implementació:

    $min=49;  # Valor mínim de color R, G o B
    $max=174; # Valor màxim de color R, G o B
    $step=5;  # Increment a cada passa de color
    $sleeptime=15; # Interval en segons entre cada passa

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

    while (1) {
            foreach (0..5) {
                    my $which = $_ % 3; # Quin color (R, G o B) canviar
                    my $updown = $_ % 2; # Indica si s'incrementa o decrementa el valor de color
                    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));
                    }
    }

Ara executeu l'script sense arguments, i començarà un cicle de canvis de color del fons a través del espectre fins que sigui matat. Voilà!

Per descomptat, Perl no és l'únic llenguatge que podeu usar per escriure scripts amb &DCOP; —si preferiu fer scripts per a un intèrpret de comandaments, també està disponible:

### Establir un fons des de Internet

El següent script obtindrà la imatge principal des de la tira còmica User Friendly i la col·loca com a fons de l'escriptori, usant les eines normalment disponibles i una mica de &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

La primera línia després de #!/bin/sh usa `wget` i alguna expressió regular per extraure la localització de la imatge a partir de les fonts de la pàgina &HTML;. La segona i tercera línies descarreguen la imatge, i finalment, `dcop` col·loca la imatge descarregada com a fons de l'escriptori.

## Afegir dreceres extra a &kde;

Alguns teclats moderns tenen tecles extra que per omissió no tenen assignada cap acció.

Algunes vegades les tecles multimèdia generen una senyal, i es poden assignar en una aplicació com qualsevol altra tecla. Tot i que algunes tecles, no es detecten i prémer-les en Configura dreceres no tindrà cap efecte.

Alguns portàtils IBM, per exemple, tenen tecles extra sobre les fletxes esquerra i dreta, que són similars a pàgina esquerra i pàgina dreta.

1. Useu `xev` per a trobar el codi d'aquestes tecles. En aquest cas, són 233 i 234

2. Escolliu els símbols de tecla. Hi ha un rang d'aquests que per omissió no s'usen, i per tant, estan lliures. Podeu trobar la llista en `/usr/X11R6/include/X11/keysymdef.h` (o el seu equivalent en el vostre sistema).

3. Crea un fitxer en el vostre directori inicial anomenat `.Xmodmap`, i afegiu-hi el següent:

       keycode 233 = Next_Virtual_Screen
       keycode 234 = Prev_Virtual_Screen

4. Executeu el comandament ``xmodmap` `~/.Xmodmap``

En aquest punt, hauríeu de poder executar `xev` altra vegada i veureu com les tecles generades per keysym són les que heu assignat. Ara les podreu associar a una acció de la forma habitual.

## Informació relacionada

- La pàgina de manual de `xev`. La podeu veure escrivint `man:/xev` en una finestra de &konqueror; o escrivint ``man` xev` en un terminal.

## Afegir dreceres per a accions noves

La majoria de les accions tant a l'escriptori com en les aplicacions se'ls hi pot assignar una drecera. Si l'acció per a la que voleu una drecera és alguna cosa escrita per vos mateix , o és una que no en te de disponible, encara li podeu assignar una.

D'igual manera a com passa en les dues seccions anteriors, potser voleu assignar tecles no usades en el vostre teclat a un script o a un comandament dcop. El següent exemple assignarà les dues tecles afegides en adding-extra-keys per anar als escriptoris virtuals anterior o següent, per al qual us caldran dues funcions DCOP (tal i com es discuteix en scripting-the-desktop).

Això es pot aconseguir fàcilment usant el següent mètode:

1. Obriu &kcontrol;, i en la secció Regional i accessibilitat, seleccioneu Accions d'entrada

2. Escolliu Acció nova

3. Anomeneu la nova acció, &pex; `Pantalla virtual següent`

4. Seleccioneu Drecera de teclat -> Comandament/URL (simple) per al Tipus de l'acció

5. En la pestanya Drecera de teclat, feu clic al botó que voleu usar per a commutador el comandament. Per a aquest exemple, hauríeu de prémer la tecla que te el dibuix Pàgina següent. Apareixerà Next_Virtual_Screen en la imatge de la tecla.

6. En la pestanya Arranjament de comandament/URL, introduïu el comandament que s'haurà d'executar en el camp: ``dcop kwin default nextDesktop``

Repetiu el procediment anterior amb la tecla Prev_Virtual_Screen i ``dcop kwin default previousDesktop``.

Ara premeu Prev_Virtual_Screen o Next_Virtual_Screen per anar a l'escriptori anterior i següent, respectivament.

Òbviament, podeu assignar qualsevol tecla lliure a qualsevol acció.

## Informació relacionada

- Mireu la documentació de KHotKeys usant &khelpcenter;, o escriviu `help:/khotkeys` en una finestra de &konqueror;.

- adding-extra-keys

- scripting-the-desktop

## &kdebugdialog; - Controlar la sortida de depuració de &kde;

### Ús bàsic

&kdebugdialog; no apareix en el &kmenu; per omissió. Us caldrà executar-lo des d'un intèrpret de comandaments o des del mini-client amb el comandament ``kdebugdialog``. &kdebugdialog; mostrarà una finestra amb una llarga llista de les àrees de depuració. Cada àrea te una caixa de selecció que podeu marcar o desmarcar, habilitar o deshabilitar la depuració per a aquesta part de &kde;.

La llista de les àrees de depuració s'ordena numèricament, no alfabèticament, de manera que kio (127) apareixerà abans que artskde (400). Els números van fins el 20000 aproximadament, però en realitat tan sols hi ha 400 àrees. No necessiteu desplaçar-vos a través de tota la pantalla per a trobar l'àrea que us cal. Hi ha una caixa d'edició en la part superior del diàleg en la que podreu introduir una part del nom de l'àrea que voleu. La llista d'entrades es filtrarà per a tan sols mostrar aquelles àrees de depuració que contenen el text introduït. &pex; introduir `k` no filtrarà gaire, però introduir `kont` tan sols mostrarà les àrees de depuració de &kontact;. Com a manera ràpida d'habilitar o deshabilitar la sortida de depuració, podreu usar els botons selecciona-ho tot i deselecciona-ho tot que causaran que el &kde; produeixi una sortida de depuració enorme, o una molt petita.

### KDebugDialog en el mode complet

En el mode complet, que és el que s'obté quan inicieu kdebugdialog amb ``kdebugdialog` `--fullmode``, estarà disponible la mateixa llista d'àrees de depuració que en el mode senzill, però tan sols podreu seleccionar una cada vegada des d'una caixa desplegable. Podeu establir de forma independent la sortida de varis tipus de missatges: Informació, avis, error i error fatal. Per a cadascun d'aquests tipus, podeu escollir a on s'envien aquests missatges. Les eleccions són:

Fitxer, en el qual podeu introduir un nom de fitxer. Aquest fitxer serà escrit en el vostre directori $`HOME`.

Caixa de missatge. Cada missatge de depuració serà mostrat en un diàleg d'informació, sobre el que haureu de prémer Bé per a continuar amb l'aplicació.

L'intèrpret de comandaments, l'entrada per omissió. Els missatges seran impresos en la sortida estàndard, i apareixeran en la finestra de l'intèrpret de comandaments des del que s'inicià l'aplicació, o en `.xsession-errors`.

Registre del sistema. Això envia cada missatge de depuració a la utilitat de registre del sistema, que podeu usar per al seu propi processat del missatge.

Cap. Això suprimeix la sortida d'aquest tipus de missatges.

Per als missatges generats pels errors fatals, sol ser una mala idea escollir cap o registre del sistema, tot i que és possible que en ambdós casos no pugueu veure el missatge i l'aplicació que hagi sofert l'error fatal desaparegui sense deixar pistes de perquè ha desaparegut. El que desaparegui o no l'aplicació en els errors fatals pot ser controlat per la caixa de selecció Cancel·la al produir-se errors fatals, que per omissió està marcat —però és possible esperar que una aplicació peti (de manera desordenada) si es produeix un error fatal.