diff options
author | Darrell Anderson <darrella@hushmail.com> | 2014-01-21 22:06:48 -0600 |
---|---|---|
committer | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2014-01-21 22:06:48 -0600 |
commit | 0b8ca6637be94f7814cafa7d01ad4699672ff336 (patch) | |
tree | d2b55b28893be8b047b4e60514f4a7f0713e0d70 /tde-i18n-ca/docs/tdebase/ksplashml/index.docbook | |
parent | a1670b07bc16b0decb3e85ee17ae64109cb182c1 (diff) | |
download | tde-i18n-0b8ca6637be94f7814cafa7d01ad4699672ff336.tar.gz tde-i18n-0b8ca6637be94f7814cafa7d01ad4699672ff336.zip |
Beautify docbook files
Diffstat (limited to 'tde-i18n-ca/docs/tdebase/ksplashml/index.docbook')
-rw-r--r-- | tde-i18n-ca/docs/tdebase/ksplashml/index.docbook | 1222 |
1 files changed, 320 insertions, 902 deletions
diff --git a/tde-i18n-ca/docs/tdebase/ksplashml/index.docbook b/tde-i18n-ca/docs/tdebase/ksplashml/index.docbook index 3e03c3d8c1f..321eb26e695 100644 --- a/tde-i18n-ca/docs/tdebase/ksplashml/index.docbook +++ b/tde-i18n-ca/docs/tdebase/ksplashml/index.docbook @@ -10,200 +10,98 @@ <book lang="&language;"> <bookinfo> -<title ->El manual de &ksplash;</title> +<title>El manual de &ksplash;</title> <authorgroup> -<author ->&Teemu.Rytilahti; &Teemu.Rytilahti.mail; </author> - -<othercredit role="developer" ->&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail; </othercredit> - -<othercredit role="developer" ->&Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail; </othercredit> - -<othercredit role="translator" -><firstname ->Antoni</firstname -><surname ->Bella</surname -><affiliation -><address -><email ->bella5@teleline.es</email -></address -></affiliation -><contrib ->Traductor</contrib -></othercredit -> +<author>&Teemu.Rytilahti; &Teemu.Rytilahti.mail; </author> + +<othercredit role="developer">&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail; </othercredit> + +<othercredit role="developer">&Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail; </othercredit> + +<othercredit role="translator"><firstname>Antoni</firstname><surname>Bella</surname><affiliation><address><email>bella5@teleline.es</email></address></affiliation><contrib>Traductor</contrib></othercredit> </authorgroup> <copyright> -<year ->2003</year> -<holder ->Teemu Rytilahti</holder> +<year>2003</year> +<holder>Teemu Rytilahti</holder> </copyright> <copyright> -<year ->2003-04</year> -<holder ->Ravikiran Rajagopal</holder> +<year>2003-04</year> +<holder>Ravikiran Rajagopal</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2003-01-10</date> -<releaseinfo ->1.01.00</releaseinfo> +<date>2003-01-10</date> +<releaseinfo>1.01.00</releaseinfo> <abstract> -<para ->&ksplash; és una bella pantalla d'inici que mostra el progrés d'una aplicació mentre aquesta s'està carregant.</para> +<para>&ksplash; és una bella pantalla d'inici que mostra el progrés d'una aplicació mentre aquesta s'està carregant.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->tdebase</keyword> -<keyword ->ksplash</keyword> -<keyword ->ksplashml</keyword> -<keyword ->pantalla d'inici</keyword> -<keyword ->afegit visual</keyword> +<keyword>KDE</keyword> +<keyword>tdebase</keyword> +<keyword>ksplash</keyword> +<keyword>ksplashml</keyword> +<keyword>pantalla d'inici</keyword> +<keyword>afegit visual</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introducció</title> +<title>Introducció</title> -<para ->&ksplash; és una bella pantalla d'inici que mostra el progrés d'una aplicació mentre aquesta s'està carregant. Si us plau, informeu de qualsevol problema o requeriment de característica a les llistes de correu del &kde;. Les principals característiques de &ksplash;: </para> +<para>&ksplash; és una bella pantalla d'inici que mostra el progrés d'una aplicació mentre aquesta s'està carregant. Si us plau, informeu de qualsevol problema o requeriment de característica a les llistes de correu del &kde;. Les principals característiques de &ksplash;: </para> <simplelist> -<member ->Amb temes</member> -<member ->Empra connectors per a completar la capacitat de personalització</member> -<member ->Pot ser usat per qualsevol aplicació que empri DCOP</member> +<member>Amb temes</member> +<member>Empra connectors per a completar la capacitat de personalització</member> +<member>Pot ser usat per qualsevol aplicació que empri DCOP</member> </simplelist> -<para ->Aquest manual us ensenyarà com crear temes per usar-los amb connectors que ja estan disponibles. Si cap dels connectors disponibles us satisfà, podeu aprendre a personalitzar l'aparença de &ksplash; escrivint completament un connector en C++. </para> +<para>Aquest manual us ensenyarà com crear temes per usar-los amb connectors que ja estan disponibles. Si cap dels connectors disponibles us satisfà, podeu aprendre a personalitzar l'aparença de &ksplash; escrivint completament un connector en C++. </para> </chapter> <chapter id="using-themes"> -<title ->Ús de temes</title> - -<para ->Per emprar temes de <ulink url="http://www.kde-look.org" ->KDE-Look</ulink ->, feu-ne la extracció a <filename ->~/.trinity/share/apps/ksplash/Themes/</filename -> per a l'ús d'un únic usuari, o a <filename ->$<envar ->TDEDIR</envar ->/share/apps/ksplash/Themes/</filename -> per a que resti a l'abast de tots els usuaris del vostre sistema.</para> - -<para ->També podeu emprar el mòdul <guilabel ->Pantalla d'inici</guilabel -> que es troba sota la pestanya <guilabel ->Aparença</guilabel -> en el centre de control de &kde; per a fer-ho automàticament.</para> +<title>Ús de temes</title> + +<para>Per emprar temes de <ulink url="http://www.kde-look.org">KDE-Look</ulink>, feu-ne la extracció a <filename>~/.trinity/share/apps/ksplash/Themes/</filename> per a l'ús d'un únic usuari, o a <filename>$<envar>TDEDIR</envar>/share/apps/ksplash/Themes/</filename> per a que resti a l'abast de tots els usuaris del vostre sistema.</para> + +<para>També podeu emprar el mòdul <guilabel>Pantalla d'inici</guilabel> que es troba sota la pestanya <guilabel>Aparença</guilabel> en el centre de control de &kde; per a fer-ho automàticament.</para> <sect1 id="using-kcontrol-module"> -<title ->Usar el mòdul de &kcontrol;</title> - -<para ->Aquest mòdul us permet instal·lar, provar i eliminar temes de &ksplash;.</para> - -<para ->A l'esquerra del mòdul hi ha un llistat dels temes disponibles per a &ksplash;. Tan aviat com en seleccioneu un, es mostrarà una vista prèvia a la part principal de la finestra. Quan hageu fet la tria premeu <guibutton ->Bé</guibutton -> o <guibutton ->Aplica</guibutton ->. Premeu <guibutton ->Cancel·la</guibutton -> per sortir del mòdul sense aplicar cap canvi, i <guibutton ->Omissió</guibutton -> per a restaurar la pantalla d'inici per omissió del sistema.</para> - -<para ->Per instal·lar nous mòduls, premeu <guibutton ->Afegeix...</guibutton -> i cerqueu el tema al vostre ordinador. No cal que descomprimiu els fitxers del tema, seleccioneu el fitxer comprimit. Tingueu present que no n'hi ha prou amb instal·lar el tema doncs l'haureu de seleccionar i prémer un dels botons <guibutton ->Bé</guibutton -> o <guibutton ->Aplica</guibutton ->.</para> - -<para ->Podeu veure la vista prèvia de la pantalla d'inici per tal de decidir si us agrada l'aparença de la mateixa. Podeu provar els temes seleccionant-los en la llista i després fent clic en el botó <guibutton ->Prova</guibutton ->.</para> - -<para ->Podeu eliminar els temes que ja no us calguin seleccionant-los i prement el botó <guibutton ->Elimina</guibutton ->. Tingueu present que des del vostre compte d'usuari no teniu prou permisos per eliminar els temes que estiguin instal·lats a tot el sistema. També és molt recomanable que no desinstal·leu la pantalla d'inici <guilabel ->Omissió</guilabel ->.</para> +<title>Usar el mòdul de &kcontrol;</title> + +<para>Aquest mòdul us permet instal·lar, provar i eliminar temes de &ksplash;.</para> + +<para>A l'esquerra del mòdul hi ha un llistat dels temes disponibles per a &ksplash;. Tan aviat com en seleccioneu un, es mostrarà una vista prèvia a la part principal de la finestra. Quan hageu fet la tria premeu <guibutton>Bé</guibutton> o <guibutton>Aplica</guibutton>. Premeu <guibutton>Cancel·la</guibutton> per sortir del mòdul sense aplicar cap canvi, i <guibutton>Omissió</guibutton> per a restaurar la pantalla d'inici per omissió del sistema.</para> + +<para>Per instal·lar nous mòduls, premeu <guibutton>Afegeix...</guibutton> i cerqueu el tema al vostre ordinador. No cal que descomprimiu els fitxers del tema, seleccioneu el fitxer comprimit. Tingueu present que no n'hi ha prou amb instal·lar el tema doncs l'haureu de seleccionar i prémer un dels botons <guibutton>Bé</guibutton> o <guibutton>Aplica</guibutton>.</para> + +<para>Podeu veure la vista prèvia de la pantalla d'inici per tal de decidir si us agrada l'aparença de la mateixa. Podeu provar els temes seleccionant-los en la llista i després fent clic en el botó <guibutton>Prova</guibutton>.</para> + +<para>Podeu eliminar els temes que ja no us calguin seleccionant-los i prement el botó <guibutton>Elimina</guibutton>. Tingueu present que des del vostre compte d'usuari no teniu prou permisos per eliminar els temes que estiguin instal·lats a tot el sistema. També és molt recomanable que no desinstal·leu la pantalla d'inici <guilabel>Omissió</guilabel>.</para> </sect1> </chapter> <chapter id="themes"> -<title ->Com crear temes per a &ksplash;</title> +<title>Com crear temes per a &ksplash;</title> <sect1 id="themes-general"> -<title ->General</title> -<para ->Crear els vostres propis temes per a &ksplash; és fàcil. Una vegada els hageu finalitzat envieu-los a <ulink url="http://www.kde-look.org" ->KDE-Look</ulink -> a on en trobareu d'altres de disponibles.</para> +<title>General</title> +<para>Crear els vostres propis temes per a &ksplash; és fàcil. Una vegada els hageu finalitzat envieu-los a <ulink url="http://www.kde-look.org">KDE-Look</ulink> a on en trobareu d'altres de disponibles.</para> <sect2 id="theme-syntax"> -<title ->Identificar el vostre tema</title> - -<para ->Us permet crear un tema anomenat <literal ->MyCoolTheme</literal ->. Per a que el tema sigui reconegut per &ksplash;, aquest haurà de ser desat en una carpeta anomenada <filename class="directory" ->MyCoolTheme</filename -> sota <filename class="directory" ->~/.trinity/apps/ksplash/Themes/</filename ->. Aquesta haurà de contenir un fitxer anomenat <filename ->Theme.rc</filename ->, que contingui les opcions del tema. Podeu especificar un llarg nombre de coses especials per al tema, canviar l'enginy de connectors a usar, i molt més. No haureu pas d'emprar totes les opcions disponibles, usualment, les opcions tenen un valor per omissió força acceptable. La sintaxi de base per a les entrades en el fitxer <filename ->Theme.rc</filename -> és <literal ->[opció] = [valor]</literal ->. Podeu trobar les definicions de les diverses opcions en les següents seccions.</para> +<title>Identificar el vostre tema</title> + +<para>Us permet crear un tema anomenat <literal>MyCoolTheme</literal>. Per a que el tema sigui reconegut per &ksplash;, aquest haurà de ser desat en una carpeta anomenada <filename class="directory">MyCoolTheme</filename> sota <filename class="directory">~/.trinity/apps/ksplash/Themes/</filename>. Aquesta haurà de contenir un fitxer anomenat <filename>Theme.rc</filename>, que contingui les opcions del tema. Podeu especificar un llarg nombre de coses especials per al tema, canviar l'enginy de connectors a usar, i molt més. No haureu pas d'emprar totes les opcions disponibles, usualment, les opcions tenen un valor per omissió força acceptable. La sintaxi de base per a les entrades en el fitxer <filename>Theme.rc</filename> és <literal>[opció] = [valor]</literal>. Podeu trobar les definicions de les diverses opcions en les següents seccions.</para> <example> -<title ->Fitxer <filename ->Theme.rc</filename -> simple</title> -<programlisting ->[KSplash Theme: MyCoolTheme] +<title>Fitxer <filename>Theme.rc</filename> simple</title> +<programlisting>[KSplash Theme: MyCoolTheme] Name = MyCoolTheme Description = Un bonic tema que empra l'enginy XpLike Version = 1.0 @@ -215,95 +113,53 @@ Welcome Text = S'està carregant el KDE </programlisting> </example> -<para ->Després d'especificar el nom, la descripció i l'autor del tema, primer haureu de triar un enginy de tema (també conegut com a connector). Llavores, podreu personalitzar diverses característiques de l'enginy del tema assignant valors clau semblants a l'anterior fitxer d'exemple.</para> +<para>Després d'especificar el nom, la descripció i l'autor del tema, primer haureu de triar un enginy de tema (també conegut com a connector). Llavores, podreu personalitzar diverses característiques de l'enginy del tema assignant valors clau semblants a l'anterior fitxer d'exemple.</para> <important> -<para ->Assegureu-vos que el noms siguin idèntics: El directori sota el que deixeu els fitxers del tema (en el nostre cas seria <filename class="directory" ->~/.trinity/apps/ksplash/Themes/MyCoolTheme</filename ->) i l'identificador (en el nostre cas seria <literal ->[KSplash Theme: MyCoolTheme] </literal ->), tot amb el fitxer <filename ->Theme.rc</filename ->. D'altra manera &ksplash; no el reconeixerà.</para> +<para>Assegureu-vos que el noms siguin idèntics: El directori sota el que deixeu els fitxers del tema (en el nostre cas seria <filename class="directory">~/.trinity/apps/ksplash/Themes/MyCoolTheme</filename>) i l'identificador (en el nostre cas seria <literal>[KSplash Theme: MyCoolTheme] </literal>), tot amb el fitxer <filename>Theme.rc</filename>. D'altra manera &ksplash; no el reconeixerà.</para> </important> </sect2> <sect2 id="theme-files"> -<title ->Fitxers de fons</title> - -<para ->Quan s'inicia &ksplash;, aquest intenta trobar una imatge de fons adequada per a la vostra resolució de pantalla, sempre que l'enginy del tema n'empri una. El fitxer imatge de fons haurà d'estar anomenat en el següent format: <filename ->Background-<replaceable ->AAAxaaa</replaceable ->.png</filename ->.</para> - -<para ->Per exemple, hauríeu d'emprar un fitxer anomenat <filename ->Background-1024x768</filename ->. Si no es troba la imatge de fons per a la vostra resolució de pantalla, aquest intentarà redimensionar el <filename ->Background.png</filename -> original o el fitxer especificat a <filename ->Theme.rc</filename -> per adaptar-lo a la resolució actual. El redimensionament al vol es prendrà un cert temps, de manera que hauríeu de proveir imatges de fons per almenys les següents mides: 1280x1024, 1024x768 i 800x600.</para> +<title>Fitxers de fons</title> + +<para>Quan s'inicia &ksplash;, aquest intenta trobar una imatge de fons adequada per a la vostra resolució de pantalla, sempre que l'enginy del tema n'empri una. El fitxer imatge de fons haurà d'estar anomenat en el següent format: <filename>Background-<replaceable>AAAxaaa</replaceable>.png</filename>.</para> + +<para>Per exemple, hauríeu d'emprar un fitxer anomenat <filename>Background-1024x768</filename>. Si no es troba la imatge de fons per a la vostra resolució de pantalla, aquest intentarà redimensionar el <filename>Background.png</filename> original o el fitxer especificat a <filename>Theme.rc</filename> per adaptar-lo a la resolució actual. El redimensionament al vol es prendrà un cert temps, de manera que hauríeu de proveir imatges de fons per almenys les següents mides: 1280x1024, 1024x768 i 800x600.</para> </sect2> </sect1> <sect1 id="theme-engines"> -<title ->Opcions per als enginys de tema</title> +<title>Opcions per als enginys de tema</title> <sect2 id="default-themes"> -<title ->Tema per omissió</title> +<title>Tema per omissió</title> <table> -<title ->Opcions per al tema per omissió</title> +<title>Opcions per al tema per omissió</title> <tgroup cols="3"> <tbody> <row> -<entry ->Nom</entry> -<entry ->Argument</entry> -<entry ->Explicació</entry> +<entry>Nom</entry> +<entry>Argument</entry> +<entry>Explicació</entry> </row> <!-- Statusbar --> <row> -<entry ->Always Show Progress</entry> -<entry ->[true/false]</entry> -<entry ->Indica quan s'haurà de mostrar el progrés de càrrega. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Always Show Progress</entry> +<entry>[true/false]</entry> +<entry>Indica quan s'haurà de mostrar el progrés de càrrega. Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Label Foreground</entry> -<entry ->[color]</entry> -<entry ->Determina quin color usar per al text de la barra d'estat. Per omissió és #FFFFFF (blanc).</entry> +<entry>Label Foreground</entry> +<entry>[color]</entry> +<entry>Determina quin color usar per al text de la barra d'estat. Per omissió és #FFFFFF (blanc).</entry> </row> <!-- Misc. things --> <row> -<entry ->Icons Flashing</entry> -<entry ->[true/false]</entry> -<entry ->Indica si s'hauran de mostrar el <quote ->parpelleig</quote -> de les icones. Per omissió és <quote ->true</quote -> (vertader).</entry> +<entry>Icons Flashing</entry> +<entry>[true/false]</entry> +<entry>Indica si s'hauran de mostrar el <quote>parpelleig</quote> de les icones. Per omissió és <quote>true</quote> (vertader).</entry> </row> </tbody> </tgroup> @@ -311,155 +167,88 @@ Welcome Text = S'està carregant el KDE </sect2> <sect2 id="standard-themes"> -<title ->Standard Theme</title> +<title>Standard Theme</title> <table> -<title ->Opcions per al tema estàndard</title> +<title>Opcions per al tema estàndard</title> <tgroup cols="3"> <tbody> <row> -<entry ->Nom</entry> -<entry ->Argument</entry> -<entry ->Explicació</entry> +<entry>Nom</entry> +<entry>Argument</entry> +<entry>Explicació</entry> </row> <!-- Statusbar --> <row> -<entry ->Statusbar Position</entry> -<entry ->[top/bottom]</entry> -<entry ->Alterna la posició de la barra d'estat sobre la pantalla. Per omissió és <quote ->bottom</quote -> (a la part inferior).</entry> +<entry>Statusbar Position</entry> +<entry>[top/bottom]</entry> +<entry>Alterna la posició de la barra d'estat sobre la pantalla. Per omissió és <quote>bottom</quote> (a la part inferior).</entry> </row> <row> -<entry ->Statusbar Visible</entry> -<entry ->[true/false]</entry> -<entry ->Indica quan s'haurà de mostrar la barra d'estat. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Statusbar Visible</entry> +<entry>[true/false]</entry> +<entry>Indica quan s'haurà de mostrar la barra d'estat. Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Progress Visible</entry> -<entry ->[true/false]</entry> -<entry ->Indica quan s'haurà de mostrar el progrés de càrrega. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Progress Visible</entry> +<entry>[true/false]</entry> +<entry>Indica quan s'haurà de mostrar el progrés de càrrega. Per omissió és <quote>true</quote> (verdader).</entry> </row> <!-- Fonts --> <row> -<entry ->Statusbar Font</entry> -<entry ->[nom_de_font]</entry> -<entry ->La font emprada a la barra d'estat. Per omissió és Helvetica.</entry> +<entry>Statusbar Font</entry> +<entry>[nom_de_font]</entry> +<entry>La font emprada a la barra d'estat. Per omissió és Helvetica.</entry> </row> <row> -<entry ->Statusbar Font Size</entry> -<entry ->[mida]</entry> -<entry ->La mida de font emprada per la barra d'estat. Per omissió és 16.</entry> +<entry>Statusbar Font Size</entry> +<entry>[mida]</entry> +<entry>La mida de font emprada per la barra d'estat. Per omissió és 16.</entry> </row> <row> -<entry ->Statusbar Font Bold</entry> -<entry ->[true/false]</entry> -<entry ->Indica quan la barra d'estat haurà d'estar en negreta. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Statusbar Font Bold</entry> +<entry>[true/false]</entry> +<entry>Indica quan la barra d'estat haurà d'estar en negreta. Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Statusbar Font Italic</entry> -<entry ->[true/false]</entry> -<entry ->Indica quan la barra d'estat haurà d'estar en cursiva. Per omissió és <quote ->false</quote -> (fals).</entry> +<entry>Statusbar Font Italic</entry> +<entry>[true/false]</entry> +<entry>Indica quan la barra d'estat haurà d'estar en cursiva. Per omissió és <quote>false</quote> (fals).</entry> </row> <!-- Misc. things --> <row> -<entry ->Statusbar Foreground</entry> -<entry ->[color]</entry> -<entry ->El color de primer pla de la barra d'estat. Per omissió és <quote ->white</quote -> (blanc).</entry> +<entry>Statusbar Foreground</entry> +<entry>[color]</entry> +<entry>El color de primer pla de la barra d'estat. Per omissió és <quote>white</quote> (blanc).</entry> </row> <row> -<entry ->Statusbar Background</entry> -<entry ->[color]</entry> -<entry ->El color de fons de la barra d'estat. Per omissió és <quote ->black</quote -> (negre).</entry> +<entry>Statusbar Background</entry> +<entry>[color]</entry> +<entry>El color de fons de la barra d'estat. Per omissió és <quote>black</quote> (negre).</entry> </row> <row> -<entry ->Statusbar Icon</entry> -<entry ->[true/false]</entry> -<entry ->Indica quan la barra d'estat haurà de contenir una icona.</entry> +<entry>Statusbar Icon</entry> +<entry>[true/false]</entry> +<entry>Indica quan la barra d'estat haurà de contenir una icona.</entry> </row> <row> -<entry ->Icons Visible</entry> -<entry ->[true/false]</entry> -<entry ->Indica quan hauran de ser visibles les icones. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Icons Visible</entry> +<entry>[true/false]</entry> +<entry>Indica quan hauran de ser visibles les icones. Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Icons Jumping</entry> -<entry ->[true/false]</entry> -<entry ->Indica quan hauran de saltar les icones. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Icons Jumping</entry> +<entry>[true/false]</entry> +<entry>Indica quan hauran de saltar les icones. Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Icon Position</entry> -<entry ->[0-3,10-13]</entry> -<entry ->La posició a on s'hauran de mostrar les les icones. Per omissió és <quote ->bottom-left</quote -> (a la part inferior esquerra).</entry> +<entry>Icon Position</entry> +<entry>[0-3,10-13]</entry> +<entry>La posició a on s'hauran de mostrar les les icones. Per omissió és <quote>bottom-left</quote> (a la part inferior esquerra).</entry> </row> <row> -<entry ->Splash Screen</entry> -<entry ->[nom]</entry> -<entry ->Canvia la imatge de la pantalla d'inici que es mostrarà.</entry> +<entry>Splash Screen</entry> +<entry>[nom]</entry> +<entry>Canvia la imatge de la pantalla d'inici que es mostrarà.</entry> </row> </tbody> </tgroup> @@ -467,151 +256,88 @@ Welcome Text = S'està carregant el KDE </sect2> <sect2 id="redmond-themes"> -<title ->El tema Redmond</title> +<title>El tema Redmond</title> <table> -<title ->Opcions per al tema Redmond</title> +<title>Opcions per al tema Redmond</title> <tgroup cols="3"> <tbody> <row> -<entry ->Nom</entry> -<entry ->Argument</entry> -<entry ->Explicació</entry> +<entry>Nom</entry> +<entry>Argument</entry> +<entry>Explicació</entry> </row> <!-- Main elements --> <row> -<entry ->Background Image</entry> -<entry ->[nom_de_fitxer]</entry> -<entry ->Usa la imatge de fons definida.</entry> +<entry>Background Image</entry> +<entry>[nom_de_fitxer]</entry> +<entry>Usa la imatge de fons definida.</entry> </row> <row> -<entry ->User Icon</entry> -<entry ->[nom_icona]</entry> -<entry ->El nom de la icona estàndard a mostrar. Per omissió és <constant ->go</constant ->.</entry> +<entry>User Icon</entry> +<entry>[nom_icona]</entry> +<entry>El nom de la icona estàndard a mostrar. Per omissió és <constant>go</constant>.</entry> </row> <row> -<entry ->Welcome Text</entry> -<entry ->[text]</entry> -<entry ->El text a mostrar a la pantalla d'inici. Per omissió és <quote ->Welcome</quote -> (Benvingut).</entry> +<entry>Welcome Text</entry> +<entry>[text]</entry> +<entry>El text a mostrar a la pantalla d'inici. Per omissió és <quote>Welcome</quote> (Benvingut).</entry> </row> <row> -<entry ->Username Text</entry> -<entry ->[text]</entry> -<entry ->El text a mostrar en comptes del nom real de l'usuari.</entry> +<entry>Username Text</entry> +<entry>[text]</entry> +<entry>El text a mostrar en comptes del nom real de l'usuari.</entry> </row> <!-- Positioning elements --> <row> -<entry ->Welcome Text Position</entry> -<entry ->[x,y]</entry> -<entry ->Posició sobre la pantalla a on es mostrarà el Welcome Text.</entry> +<entry>Welcome Text Position</entry> +<entry>[x,y]</entry> +<entry>Posició sobre la pantalla a on es mostrarà el Welcome Text.</entry> </row> <row> -<entry ->Username Text Position</entry> -<entry ->[x,y]</entry> -<entry ->La posició a la pantalla a on es mostrarà el nom d'usuari.</entry> +<entry>Username Text Position</entry> +<entry>[x,y]</entry> +<entry>La posició a la pantalla a on es mostrarà el nom d'usuari.</entry> </row> <row> -<entry ->Action Text Position</entry> -<entry ->[x,y]</entry> -<entry ->La posició a la pantalla a on es mostrarà el text de l'acció actual.</entry> +<entry>Action Text Position</entry> +<entry>[x,y]</entry> +<entry>La posició a la pantalla a on es mostrarà el text de l'acció actual.</entry> </row> <row> -<entry ->Icon Position</entry> -<entry ->[x,y]</entry> -<entry ->La posició a la pantalla a on es mostrarà la icona d'usuari.</entry> +<entry>Icon Position</entry> +<entry>[x,y]</entry> +<entry>La posició a la pantalla a on es mostrarà la icona d'usuari.</entry> </row> <!-- Show to show.. --> <row> -<entry ->Show Welcome Text</entry> -<entry ->[true/false]</entry> -<entry ->Alterna el mostrar el text de benvinguda. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Show Welcome Text</entry> +<entry>[true/false]</entry> +<entry>Alterna el mostrar el text de benvinguda. Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Show Welcome Shadow</entry> -<entry ->[true/false]</entry> -<entry ->Alterna el mostrar l'ombra del text de benvinguda. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Show Welcome Shadow</entry> +<entry>[true/false]</entry> +<entry>Alterna el mostrar l'ombra del text de benvinguda. Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Show Username</entry> -<entry ->[true/false]</entry> -<entry ->Alterna el mostrar el nom d'usuari. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Show Username</entry> +<entry>[true/false]</entry> +<entry>Alterna el mostrar el nom d'usuari. Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Show Action</entry> -<entry ->[true/false]</entry> -<entry ->Alterna el mostrar de l'acció actualment en curs. El valor per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Show Action</entry> +<entry>[true/false]</entry> +<entry>Alterna el mostrar de l'acció actualment en curs. El valor per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Show Icon</entry> -<entry ->[true/false]</entry> -<entry ->Alterna quan s'haurà de mostrar la icona. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Show Icon</entry> +<entry>[true/false]</entry> +<entry>Alterna quan s'haurà de mostrar la icona. Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Use TDM User Icon</entry> -<entry ->[true/false]</entry> -<entry ->Mostra la icona d'accés de l'usuari. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Use TDM User Icon</entry> +<entry>[true/false]</entry> +<entry>Mostra la icona d'accés de l'usuari. Per omissió és <quote>true</quote> (verdader).</entry> </row> </tbody> </tgroup> @@ -619,76 +345,45 @@ Welcome Text = S'està carregant el KDE </sect2> <sect2 id="macx-themes"> -<title ->El tema MacX</title> +<title>El tema MacX</title> <table> -<title ->Opcions per al tema MacX</title> +<title>Opcions per al tema MacX</title> <tgroup cols="3"> <tbody> <row> -<entry ->Nom</entry> -<entry ->Argument</entry> -<entry ->Explicació</entry> +<entry>Nom</entry> +<entry>Argument</entry> +<entry>Explicació</entry> </row> <row> -<entry ->Icon Size Minimum</entry> -<entry ->[mida]</entry> -<entry ->Assigna la mida mínima per a les icones. Per omissió és 16.</entry> +<entry>Icon Size Minimum</entry> +<entry>[mida]</entry> +<entry>Assigna la mida mínima per a les icones. Per omissió és 16.</entry> </row> <row> -<entry ->Icon Size Maximum</entry> -<entry ->[mida]</entry> -<entry ->Assigna la mida màxima per a les icones. Per omissió és 64.</entry> +<entry>Icon Size Maximum</entry> +<entry>[mida]</entry> +<entry>Assigna la mida màxima per a les icones. Per omissió és 64.</entry> </row> <row> -<entry ->Optimized Icon Rendering</entry> -<entry ->[true/false]</entry> -<entry ->Optimitza el renderitzat de la icona. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Optimized Icon Rendering</entry> +<entry>[true/false]</entry> +<entry>Optimitza el renderitzat de la icona. Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Progress Bar Visible</entry> -<entry ->[true/false]</entry> -<entry ->Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Progress Bar Visible</entry> +<entry>[true/false]</entry> +<entry>Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Progress Bar Position</entry> -<entry ->[top/bottom]</entry> -<entry ->Alterna quan la barra d'estat haurà d'estar a baix o dalt. Per omissió és <quote ->bottom</quote -> (a la part inferior).</entry> +<entry>Progress Bar Position</entry> +<entry>[top/bottom]</entry> +<entry>Alterna quan la barra d'estat haurà d'estar a baix o dalt. Per omissió és <quote>bottom</quote> (a la part inferior).</entry> </row> <row> -<entry ->Icons Jumping</entry> -<entry ->[true/false]</entry> -<entry ->Indica quan hauran de saltar les icones. Per omissió és <quote ->false</quote -> (fals).</entry> +<entry>Icons Jumping</entry> +<entry>[true/false]</entry> +<entry>Indica quan hauran de saltar les icones. Per omissió és <quote>false</quote> (fals).</entry> </row> </tbody> </tgroup> @@ -696,58 +391,35 @@ Welcome Text = S'està carregant el KDE </sect2> <sect2 id="mac-classic-themes"> -<title ->El tema MacClassic</title> +<title>El tema MacClassic</title> <table> -<title ->Opcions per al tema MacClassic</title> +<title>Opcions per al tema MacClassic</title> <tgroup cols="3"> <tbody> <row> -<entry ->Nom</entry> -<entry ->Argument</entry> -<entry ->Explicació</entry> +<entry>Nom</entry> +<entry>Argument</entry> +<entry>Explicació</entry> </row> <row> -<entry ->Icon Position</entry> -<entry ->[0-3,10-13]</entry> -<entry ->La posició de les icones sobre la pantalla. Per omissió és <quote ->bottom left</quote -> (a la part inferior esquerra).</entry> +<entry>Icon Position</entry> +<entry>[0-3,10-13]</entry> +<entry>La posició de les icones sobre la pantalla. Per omissió és <quote>bottom left</quote> (a la part inferior esquerra).</entry> </row> <row> -<entry ->Icons Jumping</entry> -<entry ->[true/false]</entry> -<entry ->Indica quan hauran de saltar les icones. Per omissió és <quote ->false</quote -> (fals).</entry> +<entry>Icons Jumping</entry> +<entry>[true/false]</entry> +<entry>Indica quan hauran de saltar les icones. Per omissió és <quote>false</quote> (fals).</entry> </row> <row> -<entry ->Icons Visible</entry> -<entry ->[true/false]</entry> -<entry ->Indica quan hauran de ser visibles les icones. Per omissió és <quote ->true</quote -> (verdader).</entry> +<entry>Icons Visible</entry> +<entry>[true/false]</entry> +<entry>Indica quan hauran de ser visibles les icones. Per omissió és <quote>true</quote> (verdader).</entry> </row> <row> -<entry ->Splash Screen</entry> -<entry ->[nom]</entry> -<entry ->Canvia la imatge de la pantalla d'inici que es mostrarà.</entry> +<entry>Splash Screen</entry> +<entry>[nom]</entry> +<entry>Canvia la imatge de la pantalla d'inici que es mostrarà.</entry> </row> </tbody> </tgroup> @@ -755,92 +427,55 @@ Welcome Text = S'està carregant el KDE </sect2> <sect2 id="themes-2k"> -<title ->El tema 2k</title> +<title>El tema 2k</title> <table> -<title ->Opcions per al tema 2k</title> +<title>Opcions per al tema 2k</title> <tgroup cols="3"> <tbody> <row> -<entry ->Nom</entry> -<entry ->Argument</entry> -<entry ->Explicació</entry> +<entry>Nom</entry> +<entry>Argument</entry> +<entry>Explicació</entry> </row> <row> -<entry ->Title Background Color</entry> -<entry ->[color]</entry> -<entry ->El color de fons del títol. Per omissió és <quote ->dark blue</quote -> (blau fosc).</entry> +<entry>Title Background Color</entry> +<entry>[color]</entry> +<entry>El color de fons del títol. Per omissió és <quote>dark blue</quote> (blau fosc).</entry> </row> <row> -<entry ->Title Foreground Color</entry> -<entry ->[color]</entry> -<entry ->El color de primer pla del títol. Per omissió és <quote ->white</quote -> (blanc).</entry> +<entry>Title Foreground Color</entry> +<entry>[color]</entry> +<entry>El color de primer pla del títol. Per omissió és <quote>white</quote> (blanc).</entry> </row> <row> -<entry ->Status Text Color</entry> -<entry ->[color]</entry> -<entry ->El color dels texts d'estatus. Per omissió és el mateix que a Title Background Color.</entry> +<entry>Status Text Color</entry> +<entry>[color]</entry> +<entry>El color dels texts d'estatus. Per omissió és el mateix que a Title Background Color.</entry> </row> <row> -<entry ->Rotator Color 1</entry> -<entry ->[color]</entry> -<entry ->Defineix el primer color de rotació. El valor per omissió és <quote ->dark blue</quote -> (blau fosc).</entry> +<entry>Rotator Color 1</entry> +<entry>[color]</entry> +<entry>Defineix el primer color de rotació. El valor per omissió és <quote>dark blue</quote> (blau fosc).</entry> </row> <row> -<entry ->Rotator Color 2</entry> -<entry ->[color]</entry> -<entry ->Defineix el segon color de rotació. El valor per omissió és <quote ->cyan</quote -> (cian).</entry> +<entry>Rotator Color 2</entry> +<entry>[color]</entry> +<entry>Defineix el segon color de rotació. El valor per omissió és <quote>cyan</quote> (cian).</entry> </row> <row> -<entry ->Rotator Speed</entry> -<entry ->[valor]</entry> -<entry ->Defineix la velocitat de rotació. El valor per omissió és 30.</entry> +<entry>Rotator Speed</entry> +<entry>[valor]</entry> +<entry>Defineix la velocitat de rotació. El valor per omissió és 30.</entry> </row> <row> -<entry ->Window Title</entry> -<entry ->[text]</entry> -<entry ->Especifica el text del títol de la finestra.</entry> +<entry>Window Title</entry> +<entry>[text]</entry> +<entry>Especifica el text del títol de la finestra.</entry> </row> <row> -<entry ->Logo File</entry> -<entry ->[nom_de_fitxer]</entry> -<entry ->Defineix el logo emprat.</entry> +<entry>Logo File</entry> +<entry>[nom_de_fitxer]</entry> +<entry>Defineix el logo emprat.</entry> </row> </tbody> </tgroup> @@ -850,33 +485,22 @@ Welcome Text = S'està carregant el KDE </chapter> <chapter id="from-other-applications"> -<title ->L'ús de &ksplash; des de la vostra pròpia aplicació</title> +<title>L'ús de &ksplash; des de la vostra pròpia aplicació</title> -<para ->En aquest capítol descriurem un mètode simple per usar &ksplash; com a pantalla d'inici per a la vostra aplicació &kde;. Si no desenvolupeu aplicacions per al &kde; podeu ometre aquest capítol.</para> +<para>En aquest capítol descriurem un mètode simple per usar &ksplash; com a pantalla d'inici per a la vostra aplicació &kde;. Si no desenvolupeu aplicacions per al &kde; podeu ometre aquest capítol.</para> <sect1 id="basic-other-reqs"> -<title ->Requeriments bàsics</title> - -<para ->La vostra aplicació &kde; haurà d'entendre &DCOP;. &DCOP; és la tecnologia emprada pel &kde; per a la comunicació entre aplicacions. Si empreu l'<ulink url="http://developer.kde.org" ->entorn de treball estàndard per aplicacions &kde;</ulink ->, aquest se'n farà càrrec automàticament. Per a més informació quant a &DCOP; i les tecnologies &kde; relacionades, si us plau, visiteu el <ulink url="http://developer.kde.org" ->Racó dels desenvolupadors de &kde;</ulink ->.</para> +<title>Requeriments bàsics</title> + +<para>La vostra aplicació &kde; haurà d'entendre &DCOP;. &DCOP; és la tecnologia emprada pel &kde; per a la comunicació entre aplicacions. Si empreu l'<ulink url="http://developer.kde.org">entorn de treball estàndard per aplicacions &kde;</ulink>, aquest se'n farà càrrec automàticament. Per a més informació quant a &DCOP; i les tecnologies &kde; relacionades, si us plau, visiteu el <ulink url="http://developer.kde.org">Racó dels desenvolupadors de &kde;</ulink>.</para> </sect1> <sect1 id="other-using"> -<title ->Iniciar &ksplash;</title> +<title>Iniciar &ksplash;</title> -<para ->Abans de que la vostra aplicació comenci un intensiu treball de càlcul, o abans de que comenci a carregar els connectors, &etc;, invoqueu a &ksplash; tal i com segueix:</para> +<para>Abans de que la vostra aplicació comenci un intensiu treball de càlcul, o abans de que comenci a carregar els connectors, &etc;, invoqueu a &ksplash; tal i com segueix:</para> -<programlisting ->DCOPClient *c = kapp->dcopClient(); +<programlisting>DCOPClient *c = kapp->dcopClient(); QString error; QCString KSplashName; int pid = 0; @@ -890,19 +514,15 @@ if (kapp->startServiceByDesktopName("ksplash", args, &error, } </programlisting> -<para ->Assumirem que només hi ha en execució una sola instància de &ksplash;. En els altres casos és significativament més complex. Si us plau, per a més detalls consulteu la documentació de &DCOP;.</para> +<para>Assumirem que només hi ha en execució una sola instància de &ksplash;. En els altres casos és significativament més complex. Si us plau, per a més detalls consulteu la documentació de &DCOP;.</para> </sect1> <sect1 id="show-messages"> -<title ->Mostrar els missatges</title> +<title>Mostrar els missatges</title> -<para ->Abans de mostrar cap missatge, necessitareu establir les passes que es mostraran. Per exemple, L'inici del &kde; procedeix emprant 7 passes.</para> +<para>Abans de mostrar cap missatge, necessitareu establir les passes que es mostraran. Per exemple, L'inici del &kde; procedeix emprant 7 passes.</para> -<programlisting ->QByteArray data; +<programlisting>QByteArray data; QDataStream arg(data,IO_WriteOnly); arg << someNumber; if (!(c->send(KSplashName, "KSplashIface", "setStartupItemCount(int)", @@ -910,11 +530,9 @@ data)) // Some error processing here. </programlisting> -<para ->Si voleu afegir un missatge a mostrar amb una icona, useu</para> +<para>Si voleu afegir un missatge a mostrar amb una icona, useu</para> -<programlisting ->arg << QString("iconName") << QString("programName") << +<programlisting>arg << QString("iconName") << QString("programName") << QString("Some description"); if (!(c->send(KSplashName, "KSplashIface", "programStarted(QString,QString,QString)", data)) @@ -923,20 +541,15 @@ QString("Some description"); } </programlisting> -<para ->Cada vegada que crideu <constant ->programStarted</constant ->, les passes completades s'incrementaran. Quan el vostre programa hagi finalitzat el seu inici, feu el següent per eliminar la pantalla d'inici:</para> +<para>Cada vegada que crideu <constant>programStarted</constant>, les passes completades s'incrementaran. Quan el vostre programa hagi finalitzat el seu inici, feu el següent per eliminar la pantalla d'inici:</para> -<programlisting ->if (!(c->send(KSplashName, "KSplashIface", "startupComplete()", data)) +<programlisting>if (!(c->send(KSplashName, "KSplashIface", "startupComplete()", data)) { // Some error processing here. } </programlisting> -<para ->Això és tot! No us caldrà res més per a prendre l'avantatge de tot el que &ksplash; us ofereix.</para> +<para>Això és tot! No us caldrà res més per a prendre l'avantatge de tot el que &ksplash; us ofereix.</para> </sect1> </chapter> @@ -945,65 +558,25 @@ QString("Some description"); <!-- will have to still translate it ... --> <chapter id="wrplugins"> -<title ->Escriure nous connectors per a &ksplash;</title> +<title>Escriure nous connectors per a &ksplash;</title> -<para ->L'escriptura de nous connectors per a &ksplash; no és pas difícil. En aquest capítol, escriurem un simple connector que emularà la pantalla d'inici d'un conegut sistema operatiu. Aquest tutorial assumeix que coneixeu les bases de C++, i una mica de programació KDE/Qt.</para> +<para>L'escriptura de nous connectors per a &ksplash; no és pas difícil. En aquest capítol, escriurem un simple connector que emularà la pantalla d'inici d'un conegut sistema operatiu. Aquest tutorial assumeix que coneixeu les bases de C++, i una mica de programació KDE/Qt.</para> <sect1 id="basic-requirements"> -<title ->Requeriments bàsics</title> -<para ->Crearem un connector anomenat <literal ->2k</literal ->. El nom del connector serà usat a diversos indrets, i és important que n'useu un de coherent de manera que sigui reconegut per &ksplash;. Els connectors de &ksplash; actualment són biblioteques carregables dinàmicament amb la següent convenció de noms: </para> +<title>Requeriments bàsics</title> +<para>Crearem un connector anomenat <literal>2k</literal>. El nom del connector serà usat a diversos indrets, i és important que n'useu un de coherent de manera que sigui reconegut per &ksplash;. Els connectors de &ksplash; actualment són biblioteques carregables dinàmicament amb la següent convenció de noms: </para> <simplelist> -<member ->La biblioteca s'haurà d'anomenar com <filename ->ksplash+nom_del_tema_en_minúscules</filename ->. Per al nostre tema, aquest serà <filename ->ksplash2k</filename ->.</member> -<member ->Aquesta haurà de tenir un fitxer desktop corresponent anomenat <filename ->ksplash+nom_del_tema_en_minúscules.desktop</filename ->. Per al nostre tema, aquest serà <filename ->ksplash2k.desktop</filename ->. </member> -<member ->Finalment, l'objecte que serà retornat per la biblioteca haurà de ser una classe anomenada <literal ->Theme+nom_del_tema</literal ->. Per al nostre exemple, aquesta serà <literal ->Theme2k</literal ->.</member> +<member>La biblioteca s'haurà d'anomenar com <filename>ksplash+nom_del_tema_en_minúscules</filename>. Per al nostre tema, aquest serà <filename>ksplash2k</filename>.</member> +<member>Aquesta haurà de tenir un fitxer desktop corresponent anomenat <filename>ksplash+nom_del_tema_en_minúscules.desktop</filename>. Per al nostre tema, aquest serà <filename>ksplash2k.desktop</filename>. </member> +<member>Finalment, l'objecte que serà retornat per la biblioteca haurà de ser una classe anomenada <literal>Theme+nom_del_tema</literal>. Per al nostre exemple, aquesta serà <literal>Theme2k</literal>.</member> </simplelist> -<para ->No us preocupeu per si no compreneu tot el que s'ha explicat. Considerarem cadascun d'aquests punts més endavant. L'altre detall molt important és que la classe del connector hauria d'estar derivada de <literal ->ThemeEngine</literal ->. </para> +<para>No us preocupeu per si no compreneu tot el que s'ha explicat. Considerarem cadascun d'aquests punts més endavant. L'altre detall molt important és que la classe del connector hauria d'estar derivada de <literal>ThemeEngine</literal>. </para> </sect1> <sect1 id="skeleton"> -<title ->Construir l'esquelet de l'entorn de treball</title> -<para ->Nosaltres emprarem l'entorn de treball de les aplicacions &kde;, el qual té cura de construir el connector proveint-lo d'un ús independent de la plataforma sense cap treball per la nostra part. Per a fer això, primer assegureu-vos de tenir instal·lat el paquet <filename ->tdesdk</filename ->. Executeu el comandament <literal ->kapptemplate</literal -> per a produir una aplicació anomenada "2k". Aquest crearà una carpeta de primer nivell continguen fitxers genèrics com AUTHORS, &etc; Nosaltres estem més interessats en la subcarpeta anomenada <filename class="directory" ->2k</filename ->. Aneu-hi i esborreu tots els fitxers que hi hagi. Ara disposarem de l'esquelet requerit. </para> -<para ->La següent passa serà crear un fitxer <filename ->.desktop</filename ->, una vegada instal·lat, li indicarà a &ksplash; que el nostre connector està disponible. Consistent en les convencions anomenades en <link linkend="basic-requirements" ->la secció precedent</link ->, creeu un fitxer anomenat <filename ->ksplash2k.desktop</filename -> en aquesta carpeta. Aquest haurà de contenir les següents línies: </para> -<programlisting -><literal> +<title>Construir l'esquelet de l'entorn de treball</title> +<para>Nosaltres emprarem l'entorn de treball de les aplicacions &kde;, el qual té cura de construir el connector proveint-lo d'un ús independent de la plataforma sense cap treball per la nostra part. Per a fer això, primer assegureu-vos de tenir instal·lat el paquet <filename>tdesdk</filename>. Executeu el comandament <literal>kapptemplate</literal> per a produir una aplicació anomenada "2k". Aquest crearà una carpeta de primer nivell continguen fitxers genèrics com AUTHORS, &etc; Nosaltres estem més interessats en la subcarpeta anomenada <filename class="directory">2k</filename>. Aneu-hi i esborreu tots els fitxers que hi hagi. Ara disposarem de l'esquelet requerit. </para> +<para>La següent passa serà crear un fitxer <filename>.desktop</filename>, una vegada instal·lat, li indicarà a &ksplash; que el nostre connector està disponible. Consistent en les convencions anomenades en <link linkend="basic-requirements">la secció precedent</link>, creeu un fitxer anomenat <filename>ksplash2k.desktop</filename> en aquesta carpeta. Aquest haurà de contenir les següents línies: </para> +<programlisting><literal> [Desktop Entry] Encoding=UTF-8 Type=Service @@ -1014,94 +587,29 @@ X-TDE-Library=ksplash2k X-KSplash-Default=true X-KSplash-PluginName=2k X-KSplash-ObjectName=Theme2k -</literal -> +</literal> </programlisting> -<para ->Les línies <literal ->Encoding</literal ->, <literal ->Type</literal ->, <literal ->Comment</literal -> i <literal ->ServiceTypes</literal -> són les mateixes per a tots els connectors. El nom del connector i el de la biblioteca segueixen les convencions anotades anteriorment. L'entrada <literal ->X-KSplash-Default</literal -> pren un valor booleà que determinarà si aquest es mostrarà per omissió en el mòdul de configuració del plafó de control. Excepte per alguns casos rars, aquest valor hauria de ser <constant ->true</constant ->. </para> +<para>Les línies <literal>Encoding</literal>, <literal>Type</literal>, <literal>Comment</literal> i <literal>ServiceTypes</literal> són les mateixes per a tots els connectors. El nom del connector i el de la biblioteca segueixen les convencions anotades anteriorment. L'entrada <literal>X-KSplash-Default</literal> pren un valor booleà que determinarà si aquest es mostrarà per omissió en el mòdul de configuració del plafó de control. Excepte per alguns casos rars, aquest valor hauria de ser <constant>true</constant>. </para> </sect1> <sect1 id="headerfile"> -<title ->Declaració de la classe del connector</title> -<para ->Ara que ja tenim feta la feina preliminar, procedirem amb la part verdaderament divertida -crear una classe que proveeixi del comportament que desitgem-. Tot i que som ben lliures de crear aquesta classe per a que faci el que vulguem, hi ha algunes restriccions.</para> +<title>Declaració de la classe del connector</title> +<para>Ara que ja tenim feta la feina preliminar, procedirem amb la part verdaderament divertida -crear una classe que proveeixi del comportament que desitgem-. Tot i que som ben lliures de crear aquesta classe per a que faci el que vulguem, hi ha algunes restriccions.</para> <orderedlist> -<listitem -><para ->Les classes del connector hereta la classe <constant ->ThemeEngine</constant ->.</para -></listitem> -<listitem -><para ->Les classes del connector s'hauran d'anomenar d'acord a la regla: <classname ->Theme+NomConnector</classname ->.</para -></listitem> -<listitem -><para ->Les classes del connector hauran de proveir una funció <literal ->static</literal -> anomenada <function ->names</function -> que retorni una llista de noms per als quals ha estat invocada.</para -></listitem> -<listitem -><para ->Si el connector es pot configurar en el mòdul del centre de control, aquest haurà de proveir una classe <literal ->ThemeEngineConfig</literal -> per a la configuració.</para -></listitem> -<listitem -><para ->La classe del connector haurà de solapar a almenys una de les funcions virtuals <function ->slotSetText</function ->, <function ->slotSetPixmap</function ->, <function ->slotUpdateProgress</function -> i <function ->slotUpdateSteps</function -> per a fer-se usable.</para -></listitem> -<listitem -><para ->El constructor ha de prendre la forma <literal ->ThemeEngine( QWidget *parent, const char *name, const QStringList &args )</literal -> de manera que sigui emprat amb <classname ->KGenericFactory</classname ->.</para -></listitem> +<listitem><para>Les classes del connector hereta la classe <constant>ThemeEngine</constant>.</para></listitem> +<listitem><para>Les classes del connector s'hauran d'anomenar d'acord a la regla: <classname>Theme+NomConnector</classname>.</para></listitem> +<listitem><para>Les classes del connector hauran de proveir una funció <literal>static</literal> anomenada <function>names</function> que retorni una llista de noms per als quals ha estat invocada.</para></listitem> +<listitem><para>Si el connector es pot configurar en el mòdul del centre de control, aquest haurà de proveir una classe <literal>ThemeEngineConfig</literal> per a la configuració.</para></listitem> +<listitem><para>La classe del connector haurà de solapar a almenys una de les funcions virtuals <function>slotSetText</function>, <function>slotSetPixmap</function>, <function>slotUpdateProgress</function> i <function>slotUpdateSteps</function> per a fer-se usable.</para></listitem> +<listitem><para>El constructor ha de prendre la forma <literal>ThemeEngine( QWidget *parent, const char *name, const QStringList &args )</literal> de manera que sigui emprat amb <classname>KGenericFactory</classname>.</para></listitem> </orderedlist> -<para ->L'últim requeriment podria ser complicat, però, tal i com veurem més endavant, afegint una simple línia als vostres fitxers font, usualment podreu ignorar-lo.</para> +<para>L'últim requeriment podria ser complicat, però, tal i com veurem més endavant, afegint una simple línia als vostres fitxers font, usualment podreu ignorar-lo.</para> </sect1> <sect1 id="headercode"> -<title ->Codi per al fitxer de capçalera</title> -<para ->Tinguen en compte les constants, ara veurem que el fitxer de capçalera <filename ->theme2k.h</filename -> s'assembla a això:</para> +<title>Codi per al fitxer de capçalera</title> +<para>Tinguen en compte les constants, ara veurem que el fitxer de capçalera <filename>theme2k.h</filename> s'assembla a això:</para> <example> -<title ->Llistat de <filename ->theme2k.h</filename -></title> -<programlisting ->#ifndef __THEME2K_H__ +<title>Llistat de <filename>theme2k.h</filename></title> +<programlisting>#ifndef __THEME2K_H__ #define __THEME2K_H__ #include <qlabel.h> @@ -1165,50 +673,20 @@ private: #endif </programlisting> </example> -<para ->Analitzem l'anterior llistat. La classe <classname ->Theme2k</classname -> satisfà les convencions de nom, i és inherent de <classname ->ThemeEngine</classname ->. Aquesta proveeix un <methodname ->Theme2k::names()</methodname ->, i disposa d'un constructor que pren els paràmetres requerits: <function ->Theme2k( QWidget *, const char *, const QStringList& );</function -> i també proveeix d'un mètode <methodname ->Theme2k::slotSetText()</methodname -> simple. De moment, no us preocupeu per la classe <classname ->RotWidget</classname ->. Aquesta és un petit estri (en anglès "widjet") que proveeix d'alguns afegits visuals per l'usuari. El nostre connector és molt simple i no mostra cap icona o barra de progrés. Si us agradaria mostrar icones, solapeu la funció <function ->slotSetPixmap</function ->. Existeixen funcions similars per establir el rang de la barra de progrés (<function ->slotUpdateSteps</function ->) i l'increment de la passa actual (<function ->slotUpdateProgress</function ->). </para> +<para>Analitzem l'anterior llistat. La classe <classname>Theme2k</classname> satisfà les convencions de nom, i és inherent de <classname>ThemeEngine</classname>. Aquesta proveeix un <methodname>Theme2k::names()</methodname>, i disposa d'un constructor que pren els paràmetres requerits: <function>Theme2k( QWidget *, const char *, const QStringList& );</function> i també proveeix d'un mètode <methodname>Theme2k::slotSetText()</methodname> simple. De moment, no us preocupeu per la classe <classname>RotWidget</classname>. Aquesta és un petit estri (en anglès "widjet") que proveeix d'alguns afegits visuals per l'usuari. El nostre connector és molt simple i no mostra cap icona o barra de progrés. Si us agradaria mostrar icones, solapeu la funció <function>slotSetPixmap</function>. Existeixen funcions similars per establir el rang de la barra de progrés (<function>slotUpdateSteps</function>) i l'increment de la passa actual (<function>slotUpdateProgress</function>). </para> </sect1> <sect1 id="Implementation"> -<title ->Implementació del connector</title> -<para ->Nosaltres tan sols examinarem les parts significatives de la implementació. Per a un llistat complet, si us plau, consulteu l'apèndix. La primera cosa que farem serà treure el requeriment de la biblioteca de la manera:</para> +<title>Implementació del connector</title> +<para>Nosaltres tan sols examinarem les parts significatives de la implementació. Per a un llistat complet, si us plau, consulteu l'apèndix. La primera cosa que farem serà treure el requeriment de la biblioteca de la manera:</para> <example> -<title ->Requeriment de la biblioteca</title> -<programlisting ->K_EXPORT_COMPONENT_FACTORY( ksplash2k, KGenericFactory<Theme2k> ); +<title>Requeriment de la biblioteca</title> +<programlisting>K_EXPORT_COMPONENT_FACTORY( ksplash2k, KGenericFactory<Theme2k> ); </programlisting> </example> -<para ->La macro <constant ->K_EXPORT_COMPONENT_FACTORY</constant -> està declarada dintre de <filename ->kgenericfactory.h</filename ->. D'ara en endavant el constructor! Atès que aquest és un connector molt simple, el constructor serà molt minimalista.</para> +<para>La macro <constant>K_EXPORT_COMPONENT_FACTORY</constant> està declarada dintre de <filename>kgenericfactory.h</filename>. D'ara en endavant el constructor! Atès que aquest és un connector molt simple, el constructor serà molt minimalista.</para> <example> -<title ->Constructor del connector</title> -<programlisting ->Theme2k::Theme2k( QWidget *parent, const char *name, const QStringList &args +<title>Constructor del connector</title> +<programlisting>Theme2k::Theme2k( QWidget *parent, const char *name, const QStringList &args ) :ThemeEngine( parent, name, args ) { @@ -1217,15 +695,10 @@ private: } </programlisting> </example> -<para ->El mètode <function ->readSettings()</function -> il·lustra la manera adequada d'obtenir les opcions del vostre tema. (Voldreu que la gent usi els vostres connectors en els seus temes, voleu?)</para> +<para>El mètode <function>readSettings()</function> il·lustra la manera adequada d'obtenir les opcions del vostre tema. (Voldreu que la gent usi els vostres connectors en els seus temes, voleu?)</para> <example> -<title ->Obtenir les opcions del tema</title> -<programlisting ->void Theme2k::readSettings() +<title>Obtenir les opcions del tema</title> +<programlisting>void Theme2k::readSettings() { if( !mTheme ) return; @@ -1256,25 +729,14 @@ private: } </programlisting> </example> -<para ->Ja que ens agraden els nostres usuaris, s'hom sensibles i proveïm de paràmetres per omissió que no són presents en el fitxer de tema. Tingueu en compte que també hauríeu d'establir el nostre grup a "KSplash Theme: nom_del_tema" per a romandre compatible amb les futures especificacions de tema. El mètode <function ->initUI()</function -> no és gaire interessant, ja que ell essencialment construeix els estris. Si us plau, per a detalls consulteu l'apèndix. </para> +<para>Ja que ens agraden els nostres usuaris, s'hom sensibles i proveïm de paràmetres per omissió que no són presents en el fitxer de tema. Tingueu en compte que també hauríeu d'establir el nostre grup a "KSplash Theme: nom_del_tema" per a romandre compatible amb les futures especificacions de tema. El mètode <function>initUI()</function> no és gaire interessant, ja que ell essencialment construeix els estris. Si us plau, per a detalls consulteu l'apèndix. </para> </sect1> <sect1 id="compilingfile"> -<title ->Compilar el connector</title> -<para ->Ja que hem optat per emprar l'entorn de treball &kde; per a compilar el connector, necessitarem crear un <filename ->Makefile.am</filename ->. Aquest s'haurà d'assemblar a això:</para> +<title>Compilar el connector</title> +<para>Ja que hem optat per emprar l'entorn de treball &kde; per a compilar el connector, necessitarem crear un <filename>Makefile.am</filename>. Aquest s'haurà d'assemblar a això:</para> <example> -<title ->Llistat del <filename ->Makefile.am</filename -></title> -<programlisting ->INCLUDES = $(all_includes) +<title>Llistat del <filename>Makefile.am</filename></title> +<programlisting>INCLUDES = $(all_includes) kde_module_LTLIBRARIES = ksplash2k.la @@ -1293,103 +755,67 @@ themedir = $(kde_datadir)/ksplash/Themes/2k theme_DATA = Theme.rc Preview.png </programlisting> </example> -<para ->Per a més informació a sobre de l'escriptura de fitxers <filename ->Makefile.am</filename -> per al &kde;, si us plau, consulteu el <ulink url="http://developer.kde.org/documentation/other/makefile_am_howto.html" ->lloc web</ulink -> per als desenvolupadors de &kde;. L'única cosa a fer notar és que proveïm d'un tema per omissió basat en aquest connector, així com d'una imatge per al mateix. Per cortesia cap als vostres usuaris, hauríeu de proveir d'un fitxer exemple <filename ->Theme.rc</filename ->, il·lustrant l'ús de les diverses opcions.</para> +<para>Per a més informació a sobre de l'escriptura de fitxers <filename>Makefile.am</filename> per al &kde;, si us plau, consulteu el <ulink url="http://developer.kde.org/documentation/other/makefile_am_howto.html">lloc web</ulink> per als desenvolupadors de &kde;. L'única cosa a fer notar és que proveïm d'un tema per omissió basat en aquest connector, així com d'una imatge per al mateix. Per cortesia cap als vostres usuaris, hauríeu de proveir d'un fitxer exemple <filename>Theme.rc</filename>, il·lustrant l'ús de les diverses opcions.</para> </sect1> </chapter> <chapter id="faq"> -<title ->Preguntes i respostes</title> +<title>Preguntes i respostes</title> &reporting.bugs; &updating.documentation; <qandaset id="faqlist"> <qandaentry> <question> -<para ->No poc trobar cap tema que funcioni en &ksplash;. Què està passant?</para> +<para>No poc trobar cap tema que funcioni en &ksplash;. Què està passant?</para> </question> <answer> -<para ->Probablement no disposeu dels connectors correctes per al tema. Els connectors estan en el paquet <literal ->kde-artwork</literal ->. Feu-ne la descàrrega, instal·leu-lo i torneu-ho a provar.</para> +<para>Probablement no disposeu dels connectors correctes per al tema. Els connectors estan en el paquet <literal>kde-artwork</literal>. Feu-ne la descàrrega, instal·leu-lo i torneu-ho a provar.</para> </answer> </qandaentry> <qandaentry> <question> -<para ->Quin és el fitxer <filename ->Theme.rc</filename -> i com puc crear-ne un?</para> +<para>Quin és el fitxer <filename>Theme.rc</filename> i com puc crear-ne un?</para> </question> <answer> -<para -><filename ->Theme.rc</filename -> és el fitxer a on especifiqueu les opcions d'un tema. Per a més informació, feu un cop d'ull a <link linkend="themes" ->Com crear temes per a &ksplash;</link ->. </para> +<para><filename>Theme.rc</filename> és el fitxer a on especifiqueu les opcions d'un tema. Per a més informació, feu un cop d'ull a <link linkend="themes">Com crear temes per a &ksplash;</link>. </para> </answer> </qandaentry> </qandaset> </chapter> <chapter id="credits"> -<title ->Crèdits i llicència</title> +<title>Crèdits i llicència</title> -<para ->&ksplash;</para> +<para>&ksplash;</para> -<para ->Copyright del programa © 2003 &Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail;</para> +<para>Copyright del programa © 2003 &Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail;</para> <itemizedlist> -<title ->Col·laboradors</title> -<listitem -><para ->&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail;</para> +<title>Col·laboradors</title> +<listitem><para>&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail;</para> </listitem> </itemizedlist> -<para ->Copyright de la documentació © 2003 &Teemu.Rytilahti; &Teemu.Rytilahti.mail;</para> +<para>Copyright de la documentació © 2003 &Teemu.Rytilahti; &Teemu.Rytilahti.mail;</para> &underFDL; &underGPL; </chapter> <appendix id="installation"> -<title ->Instal·lació</title> +<title>Instal·lació</title> <sect1 id="requirements"> -<title ->Requeriments</title> +<title>Requeriments</title> -<para ->Per tal d'emprar &ksplash; amb èxit, necessitareu &kde; versió 3.2 o superior. Alguns temes poden requerir de connectors específics. Si un tema no funciona, si us plau, contacteu amb l'autor del tema per mirar d'obtenir el connector apropiat.</para> +<para>Per tal d'emprar &ksplash; amb èxit, necessitareu &kde; versió 3.2 o superior. Alguns temes poden requerir de connectors específics. Si un tema no funciona, si us plau, contacteu amb l'autor del tema per mirar d'obtenir el connector apropiat.</para> </sect1> <sect1 id="compilation"> -<title ->Compilació i instal·lació</title> +<title>Compilació i instal·lació</title> &install.compile.documentation; </sect1> </appendix> <appendix id="srccode"> -<title ->Codi font</title> +<title>Codi font</title> <sect1 id="theme2kcpp"> -<title ->Llistat de <filename ->theme2k.cpp</filename -></title> -<programlisting ->#include <qlabel.h> +<title>Llistat de <filename>theme2k.cpp</filename></title> +<programlisting>#include <qlabel.h> #include <qwidget.h> #include <tdeapplication.h> @@ -1500,12 +926,8 @@ void Theme2k::readSettings() </programlisting> </sect1> <sect1 id="rotwidgeth"> -<title ->Llistat de <filename ->rotwidget.h</filename -></title> -<programlisting ->#ifndef __ROTWIDGET_H__ +<title>Llistat de <filename>rotwidget.h</filename></title> +<programlisting>#ifndef __ROTWIDGET_H__ #define __ROTWIDGET_H__ #include <qlabel.h> @@ -1544,12 +966,8 @@ protected: </programlisting> </sect1> <sect1 id="rotwidgetcpp"> -<title ->Llistat de <filename ->rotwidget.cpp</filename -></title> -<programlisting ->#include <kdebug.h> +<title>Llistat de <filename>rotwidget.cpp</filename></title> +<programlisting>#include <kdebug.h> #include <kdialogbase.h> #include <kpixmapeffect.h> |