diff options
Diffstat (limited to 'koffice-i18n-ca/docs/koffice/kugar')
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/Makefile.am | 4 | ||||
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/datadtd.docbook | 90 | ||||
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/dataref.docbook | 162 | ||||
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/designer.docbook | 679 | ||||
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/index.docbook | 197 | ||||
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/progguide.docbook | 671 | ||||
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/starting.docbook | 100 | ||||
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/template-elements.docbook | 3577 | ||||
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/template.docbook | 515 | ||||
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/templatedtd.docbook | 522 | ||||
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/tutorial.docbook | 380 |
11 files changed, 6897 insertions, 0 deletions
diff --git a/koffice-i18n-ca/docs/koffice/kugar/Makefile.am b/koffice-i18n-ca/docs/koffice/kugar/Makefile.am new file mode 100644 index 00000000..0c0cc07b --- /dev/null +++ b/koffice-i18n-ca/docs/koffice/kugar/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = ca +SUBDIRS = $(AUTODIRS) +KDE_DOCS = AUTO +KDE_MANS = AUTO diff --git a/koffice-i18n-ca/docs/koffice/kugar/datadtd.docbook b/koffice-i18n-ca/docs/koffice/kugar/datadtd.docbook new file mode 100644 index 00000000..900d1c8c --- /dev/null +++ b/koffice-i18n-ca/docs/koffice/kugar/datadtd.docbook @@ -0,0 +1,90 @@ +<!-- To validate this document separately, uncomment this prolog +<?xml version="1.0" ?> +<!DOCTYPE appendix PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> +--> + +<sect1 id="kugardata-dtd"> +<sect1info> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +> <firstname +>Rafael</firstname +> <surname +>Carreras</surname +> <affiliation +><address +><email +>rcarreras@caliu.cat</email +></address +></affiliation +> <contrib +>Traductor</contrib +> </othercredit +> +</authorgroup> +</sect1info> +<title +><sgmltag class="element" +>KugarData</sgmltag +> Document Type Definition</title> + +<synopsis +><?xml version="1.0" encoding="UTF-8"?> + +<!DOCTYPE KugarData [ + <!ELEMENT <link linkend="kugar-data-element" +>KugarData</link +> (<link linkend="row-element" +>Row</link +>*)> + <!ATTLIST KugarData + <link linkend="template-att" +>Template</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="row-element" +>Row</link +> EMPTY> + <!ATTLIST Row + <link linkend="level-att" +>level</link +> CDATA #REQUIRED + <link linkend="column-att" +>col1</link +> CDATA #IMPLIED + <link linkend="column-att" +>col2</link +> CDATA #IMPLIED + <link linkend="column-att" +>...</link +> CDATA #IMPLIED + <link linkend="column-att" +>coln</link +> CDATA #IMPLIED> + ]> +</synopsis> +</sect1> diff --git a/koffice-i18n-ca/docs/koffice/kugar/dataref.docbook b/koffice-i18n-ca/docs/koffice/kugar/dataref.docbook new file mode 100644 index 00000000..9b00ec2a --- /dev/null +++ b/koffice-i18n-ca/docs/koffice/kugar/dataref.docbook @@ -0,0 +1,162 @@ +<!-- if you want to validate this file separately, uncomment this prolog: + +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> + +<sect1 id="kugardata-element"> +<sect1info> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +> <firstname +>Rafael</firstname +> <surname +>Carreras</surname +> <affiliation +><address +><email +>rcarreras@caliu.cat</email +></address +></affiliation +> <contrib +>Traductor</contrib +> </othercredit +> +</authorgroup> +</sect1info> +<title +><sgmltag class="element" +>element KugarData</sgmltag +></title> + +<para +>L'element <sgmltag class="element" +>KugarData</sgmltag +> defineix una font de dades d'informe. L'estructura bàsica és una col·lecció de files i columnes. Aquest document no defineix tipus de dades i els seus atributs. La plantilla d'informe defineix la informació de tipus de dades de columna. </para> + +<para +>El creador de documents pot aplicar un full d'estil &XSL; a un document existent per a convertir-lo a aquest format. Si s'usa &XSL;, el creador pot aplicar macros personalitzades usant &XSL; per a càlculs de columna, ordenació, &etc;. </para> + +<synopsis +><!ELEMENT KugarData (Row*)> +<!ATTLIST KugarData + Template CDATA #REQUIRED> + +<!ELEMENT Row EMPTY> +<!ATTLIST Row + level CDATA #REQUIRED + col1 CDATA #IMPLIED + col2 CDATA #IMPLIED + ... CDATA #IMPLIED + coln CDATA #IMPLIED> +</synopsis> + + +<sect2 id="kugar-data-element"> +<title +>Element de dades del Kugar</title> +<para +>L'element <sgmltag class="element" +>KugarData</sgmltag +> conté zero o més elements de <sgmltag class="element" +>Fila</sgmltag +>. Un <sgmltag class="element" +>Fila</sgmltag +> ha de contenir un atribut <sgmltag class="attribute" +>nivell</sgmltag +> amb un valr corresponent al nivell de detall de la plantilla. Altres atributs representen columnes de dades. </para> +<para +><anchor id="template-att"/>El valor de l'atribut <sgmltag class="attribute" +>Plantilla</sgmltag +> és la &URL; de la plantilla d'informe usada per a formatar les dades. </para> +<!-- +<variablelist> +<varlistentry id="template-att"> +<term +><sgmltag class="attribute" +>Template</sgmltag +></term> +<listitem> +<para> +This is an attribute of the <sgmltag class="element" +>KugarData</sgmltag> +element. The value of the attribute is the &URL; of the report template +used to format the data. +</para> +</listitem> +</varlistentry> +--> +</sect2> + +<sect2 id="row-element"> +<title +>Element de fila</title> + +<variablelist> + +<varlistentry> +<term +>Atributs</term> +<listitem> + +<variablelist> + +<varlistentry> +<term +><anchor id="level-att"/><sgmltag class="attribute" +>nivell</sgmltag +></term> +<listitem> +<para +>El valor atribut indica quin detall s'usa en la plantilla d'informe per a mostrar les dades. Les files poden contenir diversos conjunts de columnes per a diversos nivells, de manera que qualsevol atribut excepte<sgmltag class="attribute" +>nivell</sgmltag +> es podria posar com a #IMPLIED. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="column-att"/><sgmltag class="attribute" +>columna</sgmltag +></term> +<listitem> +<para +>El nom de l'atribut és el nom de la columna, i usa el format donat a la definició de <sgmltag class="element" +>KugarData</sgmltag +>. El nom de l'atribut s'usa a la plantilla d'informe per a vincular les dades als camps de l'informe. </para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +</sect1> + diff --git a/koffice-i18n-ca/docs/koffice/kugar/designer.docbook b/koffice-i18n-ca/docs/koffice/kugar/designer.docbook new file mode 100644 index 00000000..1f5f429a --- /dev/null +++ b/koffice-i18n-ca/docs/koffice/kugar/designer.docbook @@ -0,0 +1,679 @@ +<!-- If you want to validate or edit this document separately, uncomment +this prolog + +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> +<chapter id="designer-manual"> +<chapterinfo> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +> <firstname +>Rafael</firstname +> <surname +>Carreras</surname +> <affiliation +><address +><email +>rcarreras@caliu.cat</email +></address +></affiliation +> <contrib +>Traductor</contrib +> </othercredit +> +</authorgroup> +</chapterinfo> +<title +>Manual del dissenyador de plantilles d'informe</title> + +<para +>El &kudesigner; permet la creació interactiva i la modificació de plantilles d'informe, i el reemplaçament d'ítems de seccions d'informe en un informe.</para> + +<para +>El &kudesigner; és una aplicació <acronym +>WYSIWYG</acronym +>. <guilabel +>Mida de pàgina de l'informe</guilabel +> defineix les dimensions de l'informe a la pantalla. De moment, l'escala està arranjada al 100% automàticament i no es pot canviar.</para> + +<itemizedlist> +<title +>Cada plantilla d'informe pot contenir les següents seccions d'informe:</title> +<listitem +><para +>Capçalera d'informe</para +></listitem> +<listitem +><para +>Capçalera de pàgina</para +></listitem> +<listitem +><para +>Capçalera de detall</para +></listitem> +<listitem +><para +>Detall</para +></listitem> +<listitem +><para +>Peu de detall</para +></listitem> +<listitem +><para +>Peu de pàgina</para +></listitem> +<listitem +><para +>Peu d'informe</para +></listitem> +</itemizedlist> + +<itemizedlist> +<title +>Les seccions d'informe poden contenir els següents ítems d'informe:</title> +<listitem +><para +>Etiqueta</para +></listitem> +<listitem +><para +>Camp</para +></listitem> +<listitem +><para +>Camp calculat</para +></listitem> +<listitem +><para +>Camp especial</para +></listitem> +<listitem +><para +>Línia</para +></listitem> +</itemizedlist> + +<para +>Les seccions d'informe i els ítems es poden emplaçar a la plantilla d'informe usant menús o barres d'eines.</para> + +<para +>Cada element, com una plantilla d'informe, una secció d'informe i un ítem té les seves propietats. Aquestes propietats defineixen la geometria, el text i qualsevol altre paràmetre. Cada cop que s'afegeix un elements, s'aplica un conjunt de propietats per omissió. Per exemple, quan s'afegeix <guilabel +>Etiqurta</guilabel +>, el seu valor de propietat Text s'arranja a <quote +>Text</quote +>.</para> + +<para +>Per a canviar les propietats, useu el diàleg <guilabel +>Opcions d'ítem d'informe</guilabel +>. Aquest diàlog es pot cridar dretclicant en un ítem o amb un botó <guilabel +>Edita les propietats</guilabel +> de la <guilabel +>Carra d'eines Edita</guilabel +>. Mireu la captura de pantalla de sota (propietats per a un ítem de Camp): </para> + +<para +>Per a esborrar un ítem, cliqueu-hi amb el botó del mig o useu el botó <guilabel +>Esborra</guilabel +> de la <guilabel +>Barra d'eines Edita</guilabel +>. </para> + +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="props.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>El diàleg<guilabel +>Nou informe</guilabel +></phrase> +</textobject> +</mediaobject> +</screenshot> + +<variablelist> +<title +>La referència de menú del &kudesigner;</title> +<varlistentry> +<term +><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl; <keycap +>N</keycap +></keycombo +> </shortcut +> <guimenu +>Fitxer</guimenu +> <guimenuitem +>Nou</guimenuitem +> </menuchoice +></term> +<listitem> +<para +><action +>Porta</action +> el diàleg <guilabel +>Nou informe</guilabel +> per a crear una nova plantilla d'informe.</para> +<para +>Com ja s'ha vist a la captura de pantalla, la mida de pàgina de l'informe, l'orientació i els marges s'han d'arranjar abans de crear l'informe. </para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="file_new.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>El diàleg <interface +>Nou informe</interface +></phrase> +</textobject> +</mediaobject> +</screenshot> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>O</keycap +> </keycombo +></shortcut +> <guimenu +>Fitxer</guimenu +> <guimenuitem +>Obre...</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Obre</action +> la plantilla d'informe desada prèviament.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Fitxer</guimenu +> <guimenuitem +>Obre recent</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Mostra</action +> una llista de plantilles obertes recentment. Seleccioneu un fitxer per a obrir-lo.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>S</keycap +> </keycombo +></shortcut +> <guimenu +>Fitxer</guimenu +> <guimenuitem +>Desa</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Desa</action +> la plantilla d'informe actual en un fitxer de text en format &XML;.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Fitxer</guimenu +> <guimenuitem +>Desa com a...</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Desa</action +> la plantilla d'informe actual en un fitxer i li dóna un altre nom.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>W</keycap +> </keycombo +></shortcut +> <guimenu +>Fitxer</guimenu +> <guimenuitem +>Tanca</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Tanca</action +> la plantilla d'informe actual.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>P</keycap +> </keycombo +></shortcut +> <guimenu +>Fitxer</guimenu +> <guimenuitem +>Imprimeix</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Imprimeix...</action +> l'actual plantilla d'informe com a text en format &XML;.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>Q</keycap +> </keycombo +></shortcut +> <guimenu +>Fitxer</guimenu +> <guimenuitem +>Abandona</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Abandona</action +> el programa.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Edita</guimenu +> <guimenuitem +>Neteja la selecció</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Cancel·la</action +> qualsevol acció d'edició, de manera que no s'editarà cap propietat ni s'esborrarà cap ítem.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Edita</guimenu +> <guimenuitem +>Edita les propietats</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Edita</action +> les propietats de l'ítem seleccionat.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Edita</guimenu +> <guimenuitem +>Esborra</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Esborra</action +> l'ítem seleccionat.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seccions</guimenu +> <guimenuitem +>Capçalera d'informe</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa la secció capçalera d'informe</action +> a la plantilla d'informe.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seccions</guimenu +> <guimenuitem +>Capçalera de pàgina</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa la secció capçalera de pàgina</action +> a la plantilla d'informe.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seccions</guimenu +> <guimenuitem +>Capçalera de detall</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa la secció capçalera de detall</action +> a la plantilla d'informe.</para> +<para +>Abans de posar-hi la secció, es mostrarà el diàleg <guilabel +>Afegeix capçalera de detall</guilabel +> per a especificar el nivell de detall. La capçalera de detall s'afegirà a la secció de detall del nivell donat.</para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="add_detail_header.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>El diàleg <guilabel +>Afegeix capçalera de detall</guilabel +></phrase> +</textobject> +</mediaobject> +</screenshot> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seccions</guimenu +> <guimenuitem +>Detall</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa la secció detall</action +> a la plantilla d'informe.</para> +<para +>Abans de posar-hi la secció, es mostrarà el diàleg <guilabel +>Afegeix detall</guilabel +> per a especificar el nivell de detall.</para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="add_detail.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>El diàleg <interface +>Afegeix detall</interface +></phrase> +</textobject> +</mediaobject> +</screenshot> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seccions</guimenu +> <guimenuitem +>Peu de detall</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa la secció Peu de Detall</action +> a la plantilla d'informe.</para> +<para +>Abans de posar-hi la secció, es mostrarà el diàleg <guilabel +>Afegeix Peu de detall</guilabel +> per a especificar el nivell de detall. El peu de detall s'afegirà a la secció de detall del nivell donat.</para> +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="add_detail_footer.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>El diàleg <guilabel +>Afegeix Peu de Detall</guilabel +></phrase> +</textobject> +</mediaobject> +</screenshot> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seccions</guimenu +> <guimenuitem +>Peu de pàgina</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa la secció Peu de Pàgina</action +> a la plantilla d'informe.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Seccions</guimenu +> <guimenuitem +>Peu d'informe</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa la secció Peu d'informe</action +> a la plantilla d'informe.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Ítems</guimenu +> <guimenuitem +>Neteja la selecció</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Neteja</action +> la selecció d'ítem, de manera que no s'afegirà cap ítem d'informe a la secció.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Ítems</guimenu +> <guimenuitem +>Etiqueta</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa l'element Etiqueta</action +> a la secció.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Ítems</guimenu +> <guimenuitem +>Camp</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa l'element Camp</action +> a la secció.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Ítems</guimenu +> <guimenuitem +>Camp calculat</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa l'element Camp calculat</action +> a la secció.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Ítems</guimenu +> <guimenuitem +>Camp especial</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa l'element Camp especial</action +> a la secció.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Ítems</guimenu +> <guimenuitem +>Línia</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Posa l'element Línia</action +> a la secció.</para +></listitem> +</varlistentry> + +</variablelist> +</chapter> diff --git a/koffice-i18n-ca/docs/koffice/kugar/index.docbook b/koffice-i18n-ca/docs/koffice/kugar/index.docbook new file mode 100644 index 00000000..cce98fcd --- /dev/null +++ b/koffice-i18n-ca/docs/koffice/kugar/index.docbook @@ -0,0 +1,197 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kudesigner "Kugar Report Designer"> + <!ENTITY kugar "Kugar"> + <!ENTITY kappname "&kugar;"> + <!ENTITY package "koffice"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % Catalan "INCLUDE"> + <!ENTITY template SYSTEM "template.docbook"> + <!ENTITY templatedtd SYSTEM "templatedtd.docbook"> + <!ENTITY templateelements SYSTEM "template-elements.docbook"> + <!ENTITY datadtd SYSTEM "datadtd.docbook"> + <!ENTITY dataelements SYSTEM "dataref.docbook"> + <!ENTITY progguide SYSTEM "progguide.docbook"> + <!ENTITY starting SYSTEM "starting.docbook"> + <!ENTITY designermanual SYSTEM "designer.docbook"> + <!ENTITY tutorial SYSTEM "tutorial.docbook"> +]> + +<book lang="&language;"> + +<bookinfo> +<title +>El manual del &kugar;</title> + +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +> <firstname +>Rafael</firstname +> <surname +>Carreras</surname +> <affiliation +><address +><email +>rcarreras@caliu.cat</email +></address +></affiliation +> <contrib +>Traductor</contrib +> </othercredit +> +</authorgroup> +<copyright> +<year +>2000</year> +<year +>2001</year> +<holder +>Phil Thompson</holder> +</copyright> +<copyright> +<year +>2002</year> +<holder +>Alexander Dymo</holder> +</copyright> +<!--&underFDL;--> +<legalnotice +>&FDLNotice;</legalnotice> + +<date +>2002-06-11</date> +<releaseinfo +>1.02.00</releaseinfo> + +<!-- Abstract about this handbook --> + +<abstract> +<para +>El &kugar; és un motors de plantilles d'informe basat en &XML;. El &kudesigner; és una &IGU; flexible de disseny de plantilles d'informe per al motor d'informes &kugar;. </para> +</abstract> + +<keywordset> +<keyword +>KDE</keyword> +<keyword +>kdeutils</keyword> +<keyword +>kugar</keyword> +<keyword +>kudesigner</keyword> +<keyword +>informe</keyword> +<keyword +>generador</keyword> +<keyword +>motor</keyword> +<keyword +>dissenyador</keyword> +</keywordset> + +</bookinfo> + +<chapter id="introduction"> +<title +>introducció</title> + +<para +>El &kugar; és una eina de creació d'informes per a les &Qt; i el &kde;. Inclou una &IGU; de dissenyador de plantilles d'informe, un motor d'informes, una part del &konqueror; per a previsualitzacions fàcils d'informes i un conjunt d'exemples.</para> + +<para +>El &kudesigner; és una eina de creació de plantilles d'informe per al &kugar;. El motor d'informe del &kugar; usa un fitxer de plantilles d'informe basat en &XML; (que es pot crear a mà o amb el &kudesigner;) un fitxer de dades (també en format &XML;) per a crear informes. Per a obtenir més informació sobre el &kudesigner;, referiu-vos al <link linkend="designer-manual" +>Manual del Dissenyador de plantilles d'informe</link +>. </para> + +<para +>Mireu la <link linkend="template-dtd" +> Definició de tipus de document del KugarTemplate</link +> per a una vista general dels <acronym +>DTD</acronym +> (format de fitxer) de plantilla, la <link linkend="kugardata-dtd" +>Definició de tipus de document del KugarData</link +> i el <link linkend="tutorial" +>Tutorial</link +> per a una explicació pas per pas de com es poden crear els informes. </para> + +<para +>Els programadors també es poden referir a la <link linkend="prog-guide" +>Guia del programador</link +> per a trobar informació sobre l'ús del &kugar; a les seves pròpies aplicacions.</para> +</chapter> + +&tutorial; + +&starting; + +&designermanual; + +&progguide; + +<chapter> +<title +>Crèdits i llicència</title> + +<para +>&kugar; </para> + +<para +>Copyright 2000 Mutiny Bay Software </para> +<para +>Copyright 2000, 2001, Phil Thompson </para> +<para +>Copyright 2002 Alexander Dymo </para> + +<para +>Parts de la documentació Copyright 2000, 2001 Phil Thompson i Copyright 2002 Alexander Dymo</para> + +<para +>Traductor de la documentació: Rafael Carreras <email +>rcarreras@caliu.cat</email +></para +> +&underFDL; &underGPL; </chapter> + +<appendix id="document-structure"> +<title +>Estructura del document</title> +&templatedtd; +&template; +&templateelements; +&datadtd; +&dataelements; +</appendix> + +<appendix id="installation"> +<title +>Instal·lació</title> + +&install.intro.documentation; +&install.compile.documentation; +</appendix> + +</book> diff --git a/koffice-i18n-ca/docs/koffice/kugar/progguide.docbook b/koffice-i18n-ca/docs/koffice/kugar/progguide.docbook new file mode 100644 index 00000000..72020fec --- /dev/null +++ b/koffice-i18n-ca/docs/koffice/kugar/progguide.docbook @@ -0,0 +1,671 @@ +<!-- If you want to validate or edit this document separately, uncomment +this prolog + +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> + +<chapter id="prog-guide"> +<chapterinfo> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +> <firstname +>Rafael</firstname +> <surname +>Carreras</surname +> <affiliation +><address +><email +>rcarreras@caliu.cat</email +></address +></affiliation +> <contrib +>Traductor</contrib +> </othercredit +> +</authorgroup> +</chapterinfo> +<title +>Guia del programador</title> + +<sect1 id="how-to-use-in-progs"> +<title +>Com usar el &kugar; per a la creació d'informes en els vostres programes</title> + +<itemizedlist> +<title +>Hi ha moltes maneres d'usar el &kugar;</title> +<listitem> +<para +>Creeu un fitxer temporal i ompliu-lo amb dades, organitzades d'acord amb la <link linkend="kugardata-dtd" +>Definició de tipus de document del KugarData</link +>. Llavors crideu la comanda <command +>kugar</command +> ( <cmdsynopsis +> <command +>kugar</command +> <group +> <option +>-d <replaceable +>Kugar data file</replaceable +></option +> </group +> <group +> <option +>-r <replaceable +>Kugar template file</replaceable +></option +> </group +> </cmdsynopsis +> ) per a previsualitzar i imprimir l'informe. Mireu <link linkend="prog-using-for-preview" +>Usant el terminal del &kugar; per a previsualitzar informes</link +> per a uns descripció detallada. </para> +</listitem> +<listitem> +<para +>Useu el &kugar; directament al codi de l'aplicació. Mireu <link linkend="prog-using-widget" +>Usant les classes del &kugar; per a fer informes</link +> per a una descripció detallada. </para> +</listitem> +<listitem> +<para +>Crea un endollable de dissenyador de &Qt;, useu-lo per a construir l'&IGU; de l'aplicació en el dissenyador i enllaceu-hi al programa dinàmicament. Mireu <link linkend="prog-designer-plugin" +>Creació d'un endollable de dissenyador per a &Qt;</link +> per a una descripció detallada. </para> +</listitem> +</itemizedlist> + +<para +>Les dues últimes maneres són acceptables per als desenvolupadors de les &Qt; i el &kde;; però el &kugar; està dissenyat per a ser un generador d'informes, independent d'un llenguatge de programació i/o <acronym +>IDE</acronym +>. Usa el format &XML; per a descriure les plantilles d'informe i els fitxers de dades. Així, qualsevol programa pot produir una sortida en el format de fitxer de dades del &kugar; descrit a <link linkend="kugardata-dtd" +>KugarData <acronym +>DTD</acronym +></link +> o, fins i tot, un format de fitxer de plantilla d'informe (mireu <link linkend="template-dtd" +>KugarTemplate <acronym +>DTD</acronym +></link +>). L'espai de treball del &kugar; (visualitzador d'informes) es pot usar per a previsualitzar i imprimir l'informe generat. </para> + +</sect1> + +<sect1 id="prog-using-for-preview"> +<title +>Usant l'espai de treball del &kugar; per a previsualitzar informes</title> + +<orderedlist> +<title +>La manera de crear i previsualitzar (imprimir) un informe és:</title> +<listitem> +<para +>Crear un fitxer de plantilla d'informe amb el &kudesigner; </para> +</listitem> +<listitem> +<para +>Crear un fitxer de dades amb valors de columna per a bandes detallades de l'informe. Useu <link linkend="kugardata-dtd" +>KugarData <acronym +>DTD</acronym +></link +> per a produir fitxers correctes de dades. </para> +</listitem> +<listitem> +<para +>Executeu l'espai de treball del &kugar; per a previsualitzar i imprimir l'informe. Per exemple, per a fer-ho, en els llenguatges C o C++, crideu:</para> + +<programlisting +><function +>system(<option +>"kugar -r <replaceable +>template_file.ktf</replaceable +>-d <replaceable +>data_file.kdf</replaceable +>"</option +>)</function +>. +</programlisting> + +<para +>No oblideu incloure <filename class="headerfile" +>stdlib.h</filename +>. </para> +</listitem> +</orderedlist> +</sect1> + +<sect1 id="prog-using-widget"> +<title +>Usant les classes del &kugar; per a fer informes</title> +<para +>La biblioteca del &kugar; inclou dos endollats per a usar-los. </para> +<para +>La classe <classname +>KReportViewer</classname +> està dissenyada per desenvolupadors del &kde;. Dóna suport al sistema d'impressió del &kde; i localització del &UNIX; via cridades <function +>i18n()</function +>. </para> +<para +>La classe <classname +>MReportViewer</classname +> està dissenyada per desenvolupadors de &Qt; i ésrealment multiplataforma. Es pot usar no només amb plataformes &UNIX;, sinó també en &Windows; i &MacOS;. </para> +<para +>Per tal de construir un programa que faci servir la biblioteca del &kugar;. s'ha d'enllaçar amb la biblioteca compartida <filename +>libkugar.so</filename +>, que ofereix la distribució del &kugar; en totes les plataformes &UNIX;. </para> +<para +>Els fitxers inclosos són <filename +>kugarqt.h</filename +> i <filename +>kugar.h</filename +> per als programes &Qt; i &kde; respectivament. </para> +<para +>Per a un exemple detallat de com es poden usar les classes del &kugar;, mireu a la carpeta <filename class="directory" +>/shell</filename +> de les fonts del &kugar;. </para> +<para +><classname +>MReportViewer</classname +> (i <classname +>KReportViewer</classname +> també) conté molts modes públics que es poden usar. </para> +<funcsynopsis> +<funcprototype> +<funcdef +>void <function +>renderReport</function +></funcdef> +<void/> +</funcprototype> +<funcsynopsisinfo +>Renderitza l'informe en una pantalla.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype> +<funcdef +>void <function +>printReport</function +></funcdef> +<void/> +</funcprototype> +<funcsynopsisinfo +>Crida el diàleg d'impressió per a impriir l'informe.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype> +<funcdef +>void <function +>clearReport</function +></funcdef> +<void/> +</funcprototype> +<funcsynopsisinfo +>Neteja l'informe en una pantalla i lliure les dades de l'informe. Crideu-lo abans d'obrir el nou informe.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype +><funcdef +>bool <function +>setReportData</function +></funcdef +> <paramdef +>const QString &<parameter +>data_file_name</parameter +></paramdef +> </funcprototype> +<funcsynopsisinfo +>Arranja des dades d'informe des del fitxer <replaceable +>data_file_name</replaceable +>.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype +><funcdef +>bool <function +>setReportData</function +></funcdef +> <paramdef +>const QIODevice &<parameter +>data_io_device</parameter +></paramdef +> </funcprototype> +<funcsynopsisinfo +>Arranja les dades d'informe des del fitxer <replaceable +>data_io_device</replaceable +>. El dispositiu IO pot ser qualsevol successor de la classe <classname +>QIODevice</classname +>. Per exemple, per a agafar registres directament de la base de dades, creeu un successor <classname +>QIODevice</classname +> i redefiniu totes les funcionalitats necessàries. </funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype +><funcdef +>bool <function +>setReportTemplate</function +></funcdef +> <paramdef +>const QString &<parameter +>template_file_name</parameter +></paramdef +> </funcprototype> +<funcsynopsisinfo +>Arranja la plantilla d'informe des del fitxer <replaceable +>template_file_name</replaceable +>.</funcsynopsisinfo> +</funcsynopsis> + +<funcsynopsis> +<funcprototype +><funcdef +>bool <function +>setReportTemplate</function +></funcdef +> <paramdef +>const QIODevice &<parameter +>template_io_device</parameter +></paramdef +> </funcprototype> +<funcsynopsisinfo +>Arranja la plantilla d'informe des del fitxer <replaceable +>template_io_device</replaceable +>. El dispositiu IO pot ser qualsevol successor de la classe <classname +>QIODevice</classname +>. Per exemple, per a obtenir una plantilla d'informe des d'un dispositiu d'emmagatzematge en xarxa o una base de dades, creeu un siccessor QIODevice i redefiniu totes les funcionalitats necessàries. </funcsynopsisinfo> +</funcsynopsis> + +</sect1> + +<sect1 id="prog-designer-plugin"> +<title +>Creant un endollable de dissenyador de &Qt;</title> + +<para +>Aquest és el codi d'exemple de com es crea un endollable de dissenyador. El codi de sota crea un endollable per a l'estri del &kde; <classname +>KReportViewer</classname +>. </para> + +<para +>Si es vol un estri de &Qt;, reemplaceu <classname +>KReportViewer</classname +> per <classname +>MReportViewer</classname +> i <filename +>kugar.h</filename +> per <filename +>kugarqt.h</filename +> al codi de l'endollable. </para> + +<sect2 id="plugin-usage"> +<title +>Ús de l'endollable</title> +<para +>L'endollable dissenyador us permetrà l'ús del &Qt; Designer per a emplaçar un estri <classname +>KReportViewer</classname +> en una finestra i previsualitzar-lo correctament. </para> + +<para +>Els programes que fan ús d'aquest endollables s'han d'enllaçar dinàmica ment amb ell. La biblioteca corresponent es diu <filename +>libkugar_plugin.so</filename +>. Els estris o diàlegs que inclouen l'estri <classname +>KReportViewer</classname +> han d'incloure <kugar.h> en la implementació i tenir una declaració <classname +>class KReportViewer</classname +>. Es poden fer inclusions amb l'explorador d'objectes de disseny &Qt; (pestanya de font). </para> + +<para +>Per a construir l'endollable, executeu: <cmdsynopsis +><command +>qmake</command +> <arg +>kugar_plugin.pro</arg +> </cmdsynopsis> +<cmdsynopsis> +<command +>make</command> +</cmdsynopsis> +</para> + +</sect2> + +<sect2 id="plugin-code"> +<title +>Codi de l'endollable</title> + +<segmentedlist> +<title +>El codi de l'endollable consta de tres fitxers:</title> +<segtitle +><link linkend="plugin-h-source" +>kugar_plugin.h</link +></segtitle> +<segtitle +><link linkend="plugin-cpp-source" +>kugar_plugin.cpp</link +></segtitle> +<segtitle +><link linkend="plugin-pro-source" +>kugar_plugin.pro</link +></segtitle> +<seglistitem> +<seg +>Un fitxer de capçalera per al successor <classname +>KugarWidgetPlugin</classname +>, <classname +>QWidgetPlugin</classname +>;</seg> +<seg +>Un fitxer de font per al successor <classname +>KugarWidgetPlugin</classname +>, <classname +>QWidgetPlugin</classname +>;</seg> +<seg +>Un fitxer de projecte per a la utilitat <application +>QMake</application +>.</seg> +</seglistitem> +</segmentedlist> + +<sect3 id="plugin-h-source"> +<title +>kugar_plugin.h</title> + +<programlisting +>#include <qwidgetplugin.h> + +class KugarWidgetPlugin:public QWidgetPlugin +{ +public: + KugarWidgetPlugin (); + + QStringList keys () const; + QWidget *create (const QString & classname, QWidget * parent = + 0, const char *name = 0); + QString group (const QString &) const; + QIconSet iconSet (const QString &) const; + QString includeFile (const QString &) const; + QString toolTip (const QString &) const; + QString whatsThis (const QString &) const; + bool isContainer (const QString &) const; +}; +</programlisting> +</sect3> + + +<sect3 id="plugin-cpp-source"> +<title +>kugar_plugin.cpp</title> + +<programlisting +>#include "kugar_plugin.h" +#include <kugar.h> + +static const char *kugar_pixmap[] = { + "22 22 127 2", + ".d c #000000", + ".c c #131313", + ".b c #282828", + ".a c #434241", + ".e c #4e463a", + ".# c #595551", + ".G c #66553b", + "#F c #68635f", + "#R c #6b4f23", + "#q c #6e6862", + "#M c #6f5229", + ".n c #6f6146", + ".w c #735310", + ".V c #755c2a", + ".I c #775f34", + ".0 c #77694a", + "#n c #7e6434", + ".o c #806f50", + "#C c #835d2d", + ".P c #837c75", + "#B c #85653a", + "#k c #85827e", + ".x c #866d46", + ".U c #877967", + ".X c #888888", + ".F c #89724d", + "#x c #8b6d2a", + ".S c #8d7759", + ".z c #8e733b", + "#L c #906e49", + "#Q c #947b56", + ".r c #948058", + ".J c #957844", + ".4 c #987736", + ".q c #998969", + ".k c #999897", + ".R c #9a8a75", + "#i c #9f8348", + "#I c #a37c4b", + ".u c #a38d66", + ".E c #a58558", + "#A c #a8834b", + ".s c #a9967a", + ".t c #aa9467", + ".C c #ae9f8d", + "#6 c #afa49d", + "#5 c #afa9a4", + "#W c #b18e4d", + ".K c #b1935a", + ".B c #b39660", + "#V c #b49866", + "#a c #b49d6c", + "## c #b49d72", + ".j c #b5b4b4", + "#0 c #b7a597", + ".O c #b9b1a9", + ".L c #bb9c61", + ".M c #bb9e6b", + ".A c #bca778", + "#j c #bea46b", + ".T c #bfb37d", + ".v c #c0b391", + ".W c #c3a262", + ".i c #c4c4c4", + "#m c #c5b7aa", + "#8 c #c69f80", + ".D c #c6b79b", + "#3 c #c7a589", + ".7 c #c7a76c", + "#u c #c7bbaf", + ".6 c #c8ad74", + "#7 c #c8b7a9", + "#r c #c8beb5", + ".m c #c8c8c8", + "#U c #cbad96", + "#f c #ccb681", + "#h c #cdac6c", + "#P c #cdb49f", + "#X c #cdb8a6", + "#H c #ceb7a4", + ".y c #ceb892", + ".N c #cecac3", + "#Z c #cfb16f", + "#O c #cfbdad", + ".Z c #cfc7c0", + "#w c #d0bcab", + ".5 c #d1ad6b", + "#s c #d1bfb1", + ".h c #d5d5d5", + "#l c #d6cdc6", + "#D c #d8b36e", + ".H c #dac592", + "#t c #dbb977", + ".g c #dcdcdc", + ".1 c #e0dcc1", + ".f c #e0e0df", + "#1 c #e3c8b1", + "#S c #e4cdb9", + ".3 c #e4d9a3", + "#4 c #e6c1a1", + "#2 c #e7c4a5", + "#K c #e9c179", + "#g c #e9c47e", + "#Y c #e9c8ac", + ".2 c #eae6c0", + "#T c #ebcdb3", + ".Q c #ebd4b9", + "#E c #ecca87", + "#z c #ecd799", + ".l c #ececeb", + "#G c #efd7c2", + "#e c #efe3ab", + ".8 c #efe8e3", + "#v c #f1dcca", + "#. c #f2e2d4", + ".p c #f4f4f4", + "#y c #f5daa0", + "#J c #f6cf7f", + ".9 c #f7ede4", + "#p c #f9d995", + ".Y c #fcf9f6", + "#d c #fefcc5", + "#c c #fefdda", + "#b c #fefee1", + "#N c #ffd685", + "#o c #fff0a9", + "Qt c #ffffff", + "QtQtQtQtQtQt.#.a.a.a.b.b.b.c.c.d.d.dQtQtQtQt", + "QtQtQtQtQtQt.e.f.g.g.f.g.g.h.i.j.d.k.dQtQtQt", + "QtQtQtQtQtQt.a.gQtQtQtQtQtQt.l.f.c.m.k.dQtQt", + "QtQtQtQtQt.n.n.n.n.n.o.g.pQtQt.l.bQt.m.k.dQt", + "QtQtQt.q.q.r.q.s.t.r.q.u.u.g.pQt.a.fQt.m.k.d", + "QtQt.s.s.v.w.x.y.y.t.z.A.t.B.i.p.#.a.b.c.d.d", + "Qt.C.C.D.E.F.G.A.H.F.I.J.K.L.M.i.p.l.N.O.P.d", + "Qt.s.v.Q.q.R.S.T.A.R.U.V.L.W.W.X.g.Y.f.Z.k.d", + ".0.s.t.Q.1.U.R.2.3.S.U.4.5.6.6.7.j.8.9#..O.d", + ".G##.V#a#b.1#c#c#d#e#f#g#h#i#j.W#k#l.9#.#m.d", + ".G.4.F#n#c#c#c#d#d#o#p#g.x.w#i.L#q#r#.#.#s.d", + ".e.J.J.I.3#d.H#j.6#f#p#t#n.w.E.L#q#u#.#v#w.d", + ".G.A#x.z#y#z#A#B#B#C#D#E.4.4.6#h#F#m#v#G#H.d", + ".o.s.A#j#E#t#I#I#I#C#A#J#p#p#K#t#F#m#v#G#H.d", + "Qt##.A.6.7#I#I#A.E#L#M.W#N#J#K.a.U#O#G.Q#P.d", + "Qt#a.M.L.J#A#I.4.E#Q.x#R#D#J#g.#.C#S.Q#T#U.d", + "QtQt#V.K.z#Q.s.S.x.S#B#M#W#E.a.U#X.Q#T#Y#U.d", + "QtQtQt.M#i#B.r#Q#Q.r#Q.z#Z.a#q#0#1#T#Y#2#3.d", + "QtQtQtQtQt#j.L.L.W.5#t.a.#.U#0#1#T#Y#2#4#3.d", + "QtQtQtQtQtQt.d#F#q#q#q.P.C#O#S.Q#T#Y#2#4#3.d", + "QtQtQtQtQtQt.d#5#5#6#6#0#7#w#H#P#U#U#3#3#8.d", + "QtQtQtQtQtQt.d.d.d.d.d.d.d.d.d.d.d.d.d.d.d.d" +}; + +KugarWidgetPlugin::KugarWidgetPlugin () +{ +} + +QStringList KugarWidgetPlugin::keys () const +{ + QStringList list; + list << "KReportViewer"; + return list; +} + +QWidget* KugarWidgetPlugin::create (const QString & key, QWidget * parent, + const char *name) +{ + if (key == "KReportViewer") + return new KReportViewer (parent, name); + return 0; +} + +QString KugarWidgetPlugin::group (const QString & feature) const +{ + if (feature == "KReportViewer") + return "Display"; + return QString::null; +} + +QIconSet KugarWidgetPlugin::iconSet (const QString &) const +{ + return QIconSet (QPixmap (kugar_pixmap)); +} + +QString KugarWidgetPlugin::includeFile (const QString & feature) const +{ + if (feature == "KReportViewer") + return "kugar.h"; + return QString::null; +} + +QString KugarWidgetPlugin::toolTip (const QString & feature) const +{ + if (feature == "KReportViewer") + return "Kugar report viewer widget"; + return QString::null; +} + +QString KugarWidgetPlugin::whatsThis (const QString & feature) const +{ + if (feature == "KReportViewer") + return "A widget to view xml reports"; + return QString::null; +} + +bool KugarWidgetPlugin::isContainer (const QString &) const +{ + return FALSE; +} + +Q_EXPORT_PLUGIN( KugarWidgetPlugin ) +</programlisting> +</sect3> + +<sect3 id="plugin-pro-source"> +<title +>kugar_plugin.pro</title> + +<programlisting +>SOURCES += kugar_plugin.cpp +HEADERS += kugar_plugin.h + +DESTDIR = $(QTDIR)/plugins/designer +TARGET = kugar_plugin + +target.path=$$plugins.path +isEmpty(target.path):target.path=$$QT_PREFIX/plugins +PROJECTNAME = KugarPlugin +TEMPLATE = lib +CONFIG += qt warn_on release plugin +unix:LIBS += -lkugar +LANGUAGE = C++ +</programlisting> +</sect3> + +</sect2> + +</sect1> +</chapter> diff --git a/koffice-i18n-ca/docs/koffice/kugar/starting.docbook b/koffice-i18n-ca/docs/koffice/kugar/starting.docbook new file mode 100644 index 00000000..82c23837 --- /dev/null +++ b/koffice-i18n-ca/docs/koffice/kugar/starting.docbook @@ -0,0 +1,100 @@ +<!-- If you want to validate or edit this document separately, uncomment +this prolog + +<?xml version="1.0" ?> +<!DOCTYPE appendix PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> +<chapter id="starting"> +<chapterinfo> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +> <firstname +>Rafael</firstname +> <surname +>Carreras</surname +> <affiliation +><address +><email +>rcarreras@caliu.cat</email +></address +></affiliation +> <contrib +>Traductor</contrib +> </othercredit +> +</authorgroup> +</chapterinfo> +<title +>Iniciant el &kugar; i el &kudesigner;</title> +<para +>EL &kugar; admet dos arguments de línia de comandes: </para> + +<cmdsynopsis +><command +>kugar</command +> <group +> <option +>-d <replaceable +>fitxer de dades Kugar</replaceable +></option +> </group +> <group +> <option +>-r <replaceable +>Fitxer de plantilla Kugar</replaceable +></option +> </group +> </cmdsynopsis> + +<para +>Per exemple, <userinput +><command +>kugar</command +> <option +>-d</option +> <parameter +>sample1.kdf</parameter +> <option +>-r</option +> <parameter +>sample1.ktf</parameter +></userinput +> </para> + +<para +>EL &kudesigner; es pot iniciar sense arguments o amb un fitxer de plantilla d'informe com a argument: </para> +<cmdsynopsis +><command +>kudesigner</command +> <group +> <replaceable +>plantilla.ktf</replaceable +> </group +> </cmdsynopsis> + +</chapter> diff --git a/koffice-i18n-ca/docs/koffice/kugar/template-elements.docbook b/koffice-i18n-ca/docs/koffice/kugar/template-elements.docbook new file mode 100644 index 00000000..e6f1f7bf --- /dev/null +++ b/koffice-i18n-ca/docs/koffice/kugar/template-elements.docbook @@ -0,0 +1,3577 @@ +<!-- If you want to edit or validate this document separately, uncomment --> +<!-- this prolog +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> +--> +<sect1 id="template-elements"> +<sect1info> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +> <firstname +>Rafael</firstname +> <surname +>Carreras</surname +> <affiliation +><address +><email +>rcarreras@caliu.cat</email +></address +></affiliation +> <contrib +>Traductor</contrib +> </othercredit +> +</authorgroup> +</sect1info> +<title +><sgmltag class="element" +>KugarTemplate</sgmltag +> elements de plantilla</title> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Bandes de secció</entry> +<entry +>Elements de secció</entry> +</row> +</thead> +<tbody> +<row> +<entry +><link linkend="report-header-and-footer" +><sgmltag class="element" +>ReportHeader</sgmltag +></link +></entry> +<entry +><link linkend="line-element" +><sgmltag class="element" +>Línia</sgmltag +></link +></entry> +</row> +<row> +<entry +><link linkend="page-header-and-footer" +><sgmltag class="element" +>PageHeader</sgmltag +></link +></entry> +<entry +><link linkend="label-element" +><sgmltag class="element" +>Etiqueta</sgmltag +></link +></entry> +</row> +<row> +<entry +><link linkend="detail-header-and-footer" +><sgmltag class="element" +>DetailHeader</sgmltag +></link +></entry> +<entry +><link linkend="field-element" +><sgmltag class="element" +>Camp</sgmltag +></link +></entry> +</row> +<row> +<entry +><link linkend="detail" +><sgmltag class="element" +>Detall</sgmltag +></link +></entry> +<entry +><link linkend="calculated-field-element" +><sgmltag class="element" +>CalculatedField</sgmltag +></link +></entry> +</row> +<row> +<entry +><link linkend="detail-header-and-footer" +><sgmltag class="element" +>DetailFooter</sgmltag +></link +></entry> +<entry +><link linkend="special-element" +><sgmltag class="element" +>Especial</sgmltag +></link +></entry> +</row> +<row> +<entry +><link linkend="page-header-and-footer" +><sgmltag class="element" +>PageFooter</sgmltag +></link +></entry> +<entry +>Peu de pàgina</entry> +</row> +<row> +<entry +><link linkend="report-header-and-footer" +><sgmltag class="element" +>ReportFooter</sgmltag +></link +></entry> +<entry +>Peu d'informe</entry> +</row> +</tbody> +</tgroup> +</informaltable> + + +<sect2 id="report-header-and-footer"> +<title +>Seccions <sgmltag class="element" +>ReportHeader</sgmltag +> i <sgmltag class="element" +>ReportFooter</sgmltag +></title> + +<para +>Els elements <sgmltag class="element" +>ReportHeader</sgmltag +> i <sgmltag class="element" +>ReportFooter</sgmltag +> defineixen seccions d'informe que s'imprimeixen normalment al principi i al final de l'informe. </para> + +<synopsis +><!ELEMENT ReportHeader (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> +<!ATTLIST ReportHeader + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> +</synopsis> + +<synopsis +><!ELEMENT ReportFooter (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*, <link linkend="calculated-field-element" +>CalculatedField</link +>*)> +<!ATTLIST ReportFooter + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> +</synopsis> + +<variablelist> + +<varlistentry> +<term +>Atributs</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="rhf-height"/><sgmltag class="attribute" +>Alçada</sgmltag +></term> +<listitem> +<para +>Arranja l'alçada de la secció d'informe. Si no voleu aquesta secció, arrangeu aquest valor a <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="rhf-printfrequency"/><sgmltag class="attribute" +>PrintFrequency</sgmltag +></term> +<listitem> +<para +>Arranja de freqüència d'impressió de la secció. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Freqüència d'impressió</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Primera pàgina</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Cada pàgina</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Última pàgina</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="page-header-and-footer"> +<title +>Seccions <sgmltag class="element" +>PageHeader</sgmltag +> i <sgmltag class="element" +>PageFooter</sgmltag +></title> + +<para +>Els elements <sgmltag class="element" +>PageHeader</sgmltag +> i <sgmltag class="element" +>PageFooter</sgmltag +> defineixen seccions d'informe que s'imprimeixen normalment en cada pàgina de l'informe. </para> + +<synopsis +><!ELEMENT PageHeader (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> +<!ATTLIST PageHeader + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> +</synopsis> + +<synopsis +><!ELEMENT PageFooter (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> +<!ATTLIST PageFooter + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> +</synopsis> + +<variablelist> + +<varlistentry> +<term +>Atributs</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="phf-height"/><sgmltag class="attribute" +>Alçada</sgmltag +></term> +<listitem> +<para +>Arranja l'alçada de la secció d'informe. Si no voleu aquesta secció, arrangeu aquest valor a <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="phf-printfrequency"/><sgmltag class="attribute" +>PrintFrequency</sgmltag +></term> +<listitem> +<para +>Arranja de freqüència d'impressió de la secció. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Freqüència d'impressió</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Primera pàgina</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Cada pàgina</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Última pàgina</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="detail-header-and-footer"> +<title +>Seccions <sgmltag class="element" +>DetailHeader</sgmltag +> i <sgmltag class="element" +>DetailFooter</sgmltag +></title> + +<para +>Els elements <sgmltag class="element" +>DetailHeader</sgmltag +> i <sgmltag class="element" +>DetailFooter</sgmltag +> defineixen seccions d'informe que s'imprimeixen abans i després dels detalls d'un nivell donat i a la part de sota de l'informe. </para> + +<synopsis +><!ELEMENT DetailHeader (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> +<!ATTLIST DetailHeader + Height CDATA #REQUIRED + Level CDATA #REQUIRED> +</synopsis> + +<synopsis +><!ELEMENT DetailFooter (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> +<!ATTLIST DetailFooter + Height CDATA #REQUIRED + Level CDATA #REQUIRED> +</synopsis> + +<variablelist> + +<varlistentry> +<term +>Atributs</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="dhf-height"/><sgmltag class="attribute" +>Alçada</sgmltag +></term> +<listitem> +<para +>Arranja l'alçada de la secció d'informe. Si no voleu aquesta secció, arrangeu aquest valor a <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="dhf-level"/><sgmltag class="attribute" +>Nivell</sgmltag +></term> +<listitem> +<para +>Arranja el nivell de jerarquia de la secció, Les seccions amb nivells alts es poden imprimir abans de les seccions amb nivells baixos. El nivell pot ser qualsevol número que comenci per 0. </para> + +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="detail"> +<title +>Secció <sgmltag class="element" +>Detail</sgmltag +></title> + +<para +>L'element <sgmltag class="element" +>Detail</sgmltag +> defineix la secció d'informe que conté les dades d'informe. L¡informe pot tenir múltiples detalls, que s'accedeixen amb l'atribut de nivell de detall. </para> + +<synopsis +><!ELEMENT Detail (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*, <link linkend="field-element" +>Field</link +>*)> +<!ATTLIST Detail + Height CDATA #REQUIRED + Level CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributs</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="d-height"/><sgmltag class="attribute" +>Alçada</sgmltag +></term> +<listitem> +<para +>Arranja l'alçada de la secció d'informe. Si no voleu aquesta secció, arrangeu aquest valor a <sgmltag class="attvalue" +>0</sgmltag +>. </para> +</listitem> +</varlistentry> +<varlistentry> +<term +><anchor id="d-level"/><sgmltag class="attribute" +>Nivell</sgmltag +></term> +<listitem> +<para +>Arranja el nivell de jerarquia de la secció. Les seccions amb nivells més alts s'imprimiran abans que les de nivells més baixos. El nivell pot tenir qualsevol número que comenci per 0. Aquest és un atribut d'un element <sgmltag class="attribute" +>row</sgmltag +> en un fitxer de dades. </para> + +</listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="line-element"> +<title +><sgmltag class="element" +>Línia</sgmltag +></title> + +<para +>L'element <sgmltag class="element" +>Line</sgmltag +> defineix un objecte d'informe usat per a dibuixar línies en un informe. </para> + +<synopsis +><!ELEMENT Line EMPTY> +<!ATTLIST Line + X1 CDATA #REQUIRED + Y1 CDATA #REQUIRED + X2 CDATA #REQUIRED + Y2 CDATA #REQUIRED + Width CDATA #REQUIRED + Color CDATA #REQUIRED + Style CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributs</term> +<listitem> +<variablelist> + +<varlistentry> +<term +><anchor id="l-x1"/><sgmltag class="attribute" +>X1</sgmltag +></term> +<listitem> +<para +>Arranja la coordenada d'inici x (relatiu a la secció superior esquerra) per a la línia. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-y1"/><sgmltag class="attribute" +>Y1</sgmltag +></term> +<listitem> +<para +>Arranja la coordenada d'inici y (relatiu a la secció superior esquerra) per a la línia. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-x2"/><sgmltag class="attribute" +>X2</sgmltag +></term> +<listitem> +<para +>Arranja la coordenada final x (relatiu a la secció superior esquerra) per a la línia. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-y2"/><sgmltag class="attribute" +>Y2</sgmltag +></term> +<listitem> +<para +>Arranja la coordenada final y (relatiu a la secció superior esquerra) per a la línia. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-width"/><sgmltag class="attribute" +>Amplada</sgmltag +></term> +<listitem> +<para +>Arranja l'amplada de la línia. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-color"/><sgmltag class="attribute" +>Color</sgmltag +></term> +<listitem> +<para +>Arranja el color de la línia. El color està definit com a un valor RGB (Red Green Blue)(r,g,b). r, g i b han d'estar en el rang de 0 a 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="l-style"/><sgmltag class="attribute" +>Estil</sgmltag +></term> +<listitem> +<para +>Arranja l'estil de dibuix per a la línia. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estil de línia</entry> +</row> +</thead> + +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Sense llapis</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sòlig</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Traç</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Punt</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Punt de traç</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>Traç punt punt</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="label-element"> +<title +><sgmltag class="element" +>Etiqueta</sgmltag +></title> + +<para +>L'element <sgmltag class="element" +>Label</sgmltag +> defineix un objecte d'informe usat per a dibuixar text fixat en un informe. </para> + +<synopsis +><!ELEMENT Label EMPTY> + <!ATTLIST Label + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributs</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="la-text"/><sgmltag class="attribute" +>Text</sgmltag +></term> +<listitem> +<para +>Arranja el text de l'etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-x"/><sgmltag class="attribute" +>X</sgmltag +></term> +<listitem> +<para +>Arranja la coordinada x (relativa a la cantonada superior esquerra de la secció) per a col·locar l'etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Arranja la coordinada y (relativa a la cantonada superior esquerra de la secció) per a col·locar l'etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-width"/><sgmltag class="attribute" +>Amplada</sgmltag +></term> +<listitem> +<para +>Arranja l'amplada de l'etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-height"/><sgmltag class="attribute" +>Alçada</sgmltag +></term> +<listitem> +<para +>Arranja l'alçada de l'etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de fons de l'etiqueta. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de primer pla de l'etiqueta. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-bordercolor"/><sgmltag class="element" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de la vora de l'etiqueta. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Arranja l'amplada de la vora per a l'etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Arranja l'estil de la vora per a l'etiqueta. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estil de la vora</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Cap</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sòlig</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Traç</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Punt</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Punt de traç</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>Traç punt punt</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-fontfamily"/><sgmltag class="attribute" +>FontFamily</sgmltag +></term> +<listitem> +<para +>Arranja la família de la font per al text de l'etiqueta. </para> +<!--<informalexample> +<para +>For example: <userinput +><sgmltag +class="attribute" +>FontFamily</sgmltag +>="<sgmltag +class="attvalue" +>Helvetica</sgmltag +>"</userinput +></para> +</informalexample +>--> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-fontsize"/><sgmltag class="attribute" +>FontSize</sgmltag +></term> +<listitem> +<para +>Arranja la mida de la font per al text de l'etiqueta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Arranja el pes de la font per al text de l'etiqueta. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Pes de la font</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>25</sgmltag +></entry> +<entry +>Lleuger</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>50</sgmltag +></entry> +<entry +>Normal</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>63</sgmltag +></entry> +<entry +>Mig negreta</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>75</sgmltag +></entry> +<entry +>Negreta</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>87</sgmltag +></entry> +<entry +>Negre</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-fontitalic"/><sgmltag class="attribute" +>FontItalic</sgmltag +></term> +<listitem> +<para +>Arranja la bandera itàlica de font per al text de l'etiqueta. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Itàlica</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Vertader</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Arranja l'aliniament horitzontal de l'etiqueta. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Aliniament horitzontal</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Esquerra</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centre</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Dreta</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Arranja l'aliniament vertical de l'etiqueta. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Aliniament vertical</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Dalt</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Mig</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Sota</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="la-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Arranja la bandera ajustament de paraula per al text de l'etiqueta. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Ajustament de paraula</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Vertader</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="field-element"> +<title +><sgmltag class="element" +>Camp</sgmltag +></title> + +<para +>L'element <sgmltag class="element" +>Field</sgmltag +> defineix un objecte d'informe usat per a dibuixar dades en un informe. </para> + +<synopsis +><!ELEMENT Field EMPTY> +<!ATTLIST Field + Field CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DataType CDATA #REQUIRED + DateFormat CDATA #REQUIRED + Precision CDATA #REQUIRED + Currency CDATA #REQUIRED + NegValueColor CDATA #REQUIRED + CommaSeparator CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributs</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="f-field"/><sgmltag class="attribute" +>Camp</sgmltag +></term> +<listitem> +<para +>Arranja el camp de dades per a l'objecte. Aquest és un atribut d'un element <sgmltag class="attribute" +>fila</sgmltag +> a cada fitxer de dades. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-text"/><sgmltag class="attribute" +>Text</sgmltag +></term> +<listitem> +<para +>No usat. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-x"/><sgmltag class="attribute" +>X</sgmltag +></term> +<listitem> +<para +>Arranja la coordenada x (relativa a la cantonada superior esquerra de la secció) per a posicionar el camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Arranja la coordenada y (relativa a la cantonada superior esquerra de la secció) per a posicionar el camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-width"/><sgmltag class="attribute" +>Amplada</sgmltag +></term> +<listitem> +<para +>Arranja l'amplada del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-height"/><sgmltag class="attribute" +>Alçada</sgmltag +></term> +<listitem> +<para +>Arranja l'alçada del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de fons del camp. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de primer pla del camp. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-bordercolor"/><sgmltag class="attribute" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de la vora del camp. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Arranja l'amplada de la vora del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Arranja l'estil de la vora del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estil de la vora</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Cap</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sòlig</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Traç</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Punt</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Punt de traç</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>Traç punt punt</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-fontfamily"/><sgmltag class="attribute" +>FontFamily</sgmltag +></term> +<listitem> +<para +>Arranja la família de font del text del camp. </para> +<!--<informalexample> +<para +><userinput +><sgmltag +class="attribute" +>FontFamily</sgmltag +>="<sgmltag +class="attvalue" +>Helvetica</sgmltag +>"</userinput +></para> +</informalexample +>--> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-fontsize"/><sgmltag class="attribute" +>FontSize</sgmltag +></term> +<listitem> +<para +>Arranja la mida de font del text del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Arranja el pes de font del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Pes de la font</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>25</sgmltag +></entry> +<entry +>Lleuger</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>50</sgmltag +></entry> +<entry +>Normal</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>63</sgmltag +></entry> +<entry +>Mig negreta</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>75</sgmltag +></entry> +<entry +>Negreta</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>87</sgmltag +></entry> +<entry +>Negre</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-fontitalic"/><sgmltag class="attribute" +>FontItalic</sgmltag +></term> +<listitem> +<para +>Arranja la bandera itàlica font del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Itàlica</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Vertader</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Arranja l'aliniament horitzontal del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Aliniament horitzontal</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Esquerra</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centre</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Dreta</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Arranja l'aliniament vertical del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Aliniament vertical</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Dalt</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Mig</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Sota</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Arranja la bandera d'ajustament del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Ajustament de paraula</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Vertader</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +<!--</variablelist> +</listitem> +</varlistentry +>--> + +<varlistentry> +<term +><anchor id="f-datatype"/><sgmltag class="attribute" +>DataType</sgmltag +></term> +<listitem> +<para +>Arranja el tipus de dades del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Tipus de dades</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Cadena</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sencer</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Flotant</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Data</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Moneda</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-dateformat"/><sgmltag class="attribute" +>DateFormat</sgmltag +></term> +<listitem> +<para +>Arranja el format de data del camp. Per a que funcioni, el format de la data del document de dades ha d'estar en el format mm/dd/aaaa o mm-dd-aaaa, sinó s'usarà el format de data original. Si el tipus de dada és diferent del de la data, arrangeu-lo a <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Format de data</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>m/d/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>m-d-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>mm/dd/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>mm-dd-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>m/d/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>m-d-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>6</sgmltag +></entry> +<entry +>mm/dd/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>7</sgmltag +></entry> +<entry +>mm-dd-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>8</sgmltag +></entry> +<entry +>aaaa/m/d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>9</sgmltag +></entry> +<entry +>aaaa-m-d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>10</sgmltag +></entry> +<entry +>dd.mm.aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>11</sgmltag +></entry> +<entry +>dd.mm.aaaa</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-precision"/><sgmltag class="attribute" +>Precisió</sgmltag +></term> +<listitem> +<para +>Arranja la precisió numèrica del camp. Si el tipus de dades és diferent d'un tipus numèric, arrangeu-lo a 0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-currency"/><sgmltag class="attribute" +>Moneda</sgmltag +></term> +<listitem> +<para +>Arranja el símbol de moneda. Si el tipus de dada és diferent de la moneda, arrangeu-lo a <sgmltag class="attvalue" +>36</sgmltag +> ($). El valor és un número que representa un caràcter Unicode. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-negvaluecolor"/><sgmltag class="attribute" +>NegValueColor</sgmltag +></term> +<listitem> +<para +>Arranja el color per a valors numèrics negatius. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b ha d'estar en el rang de 0 a 255. Si les dades són diferents d'un tipus numèric, arrangeu-lo a 255,0,0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="f-commaseparator"/><sgmltag class="attribute" +>CommaSeparator</sgmltag +></term> +<listitem> +<para +>Arranja si s'usen comes en els camps numèrics. Si el tipus de dades és diferent d'un tpus numèric, arrangeu-lo a <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Separador de coma</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Vertader</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="calculated-field-element"> +<title +><sgmltag class="element" +>CalculatedField</sgmltag +></title> + +<para +>L'element <sgmltag class="element" +>CalculatedField</sgmltag +> defineix un objecte d'informe usat per a dibuixar valors calculats en un informe. </para> + +<synopsis +><!ELEMENT CalculatedField EMPTY> +<!ATTLIST CalculatedField + CalculationType CDATA #REQUIRED + Field CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DataType CDATA #REQUIRED + DateFormat CDATA #REQUIRED + Precision CDATA #REQUIRED + Currency CDATA #REQUIRED + NegValueColor CDATA #REQUIRED + CommaSeparator CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributs</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="c-calculationtype"/><sgmltag class="attribute" +>CalculationType</sgmltag +></term> +<listitem> +<para +>Arranja el tipus de càlcul per al camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Càlcul</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Compte</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Suma</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Mitjana</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Variació</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Std Deviation</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-field"/><sgmltag class="attribute" +>Camp</sgmltag +></term> +<listitem> +<para +>Arranja el camp de dades per a l'objecte. Aquest és un atribut d'un element <sgmltag class="attribute" +>fila</sgmltag +> a cada fitxer de dades. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-text"/><sgmltag class="attribute" +>Text</sgmltag +></term> +<listitem> +<para +>No usat. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-x"/><sgmltag class="attribute" +>X</sgmltag +></term> +<listitem> +<para +>Arranja la coordenada x (relativa a la cantonada superior esquerra de la secció) per a posicionar el camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Arranja la coordenada y (relativa a la cantonada superior esquerra de la secció) per a posicionar el camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-width"/><sgmltag class="attribute" +>Amplada</sgmltag +></term> +<listitem> +<para +>Arranja l'amplada del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-height"/><sgmltag class="attribute" +>Alçada</sgmltag +></term> +<listitem> +<para +>Arranja l'alçada del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de fons del camp. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de primer pla del camp. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-bordercolor"/><sgmltag class="attribute" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de la vora del camp. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Arranja l'amplada de la vora del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Arranja l'estil de la vora del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estil de la vora</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Cap</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sòlig</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Traç</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Punt</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Punt de traç</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>Traç punt punt</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-fontfamily"/><sgmltag class="attribute" +>FontFamily</sgmltag +></term> +<listitem> +<para +>Arranja la família de font del text del camp. </para> +<!--<informalexample> +<para +><userinput +><sgmltag +class="attribute" +>FontFamily</sgmltag +>="<sgmltag +class="attvalue" +>Helvetica</sgmltag +>"</userinput +></para> +</informalexample +>--> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-fontsize"/><sgmltag class="attribute" +>FontSize</sgmltag +></term> +<listitem> +<para +>Arranja la mida de font del text del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Arranja el pes de font del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Pes de la font</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>25</sgmltag +></entry> +<entry +>Lleuger</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>50</sgmltag +></entry> +<entry +>Normal</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>63</sgmltag +></entry> +<entry +>Mig negreta</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>75</sgmltag +></entry> +<entry +>Negreta</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>87</sgmltag +></entry> +<entry +>Negre</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-fontitalic"/><sgmltag class="attribute" +>FontItalic</sgmltag +></term> +<listitem> +<para +>Arranja la bandera itàlica font del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Itàlica</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Vertader</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Arranja l'aliniament horitzontal del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Aliniament horitzontal</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Esquerra</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centre</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Dreta</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Arranja l'aliniació de text vertical del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Aliniament vertical</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Dalt</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Mig</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Sota</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Arranja la bandera d'ajustament del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Ajustament de paraula</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Vertader</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-datatype"/><sgmltag class="attribute" +>DataType</sgmltag +></term> +<listitem> +<para +>Arranja el tipus de dades del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Tipus de dades</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Cadena</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sencer</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Flotant</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Data</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Moneda</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-dateformat"/><sgmltag class="attribute" +>DateFormat</sgmltag +></term> +<listitem> +<para +>Arranja el format de data del camp. Per a que funcioni, el format de la data del document de dades ha d'estar en el format mm/dd/aaaa o mm-dd-aaaa, sinó s'usarà el format de data original. Si el tipus de dada és diferent del de la data, arrangeu-lo a <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Format de data</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>m/d/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>m-d-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>mm/dd/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>mm-dd-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>m/d/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>m-d-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>6</sgmltag +></entry> +<entry +>mm/dd/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>7</sgmltag +></entry> +<entry +>mm-dd-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>8</sgmltag +></entry> +<entry +>aaaa/m/d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>9</sgmltag +></entry> +<entry +>aaaa-m-d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>10</sgmltag +></entry> +<entry +>dd.mm.aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>11</sgmltag +></entry> +<entry +>dd.mm.aaaa</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-precision"/><sgmltag class="attribute" +>Precisió</sgmltag +></term> +<listitem> +<para +>Arranja la precisió numèrica del camp. Si el tipus de dades és diferent d'un tipus numèric, arrangeu-lo a 0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-currency"/><sgmltag class="attribute" +>Moneda</sgmltag +></term> +<listitem> +<para +>Arranja el símbol de moneda del camp. Si el tipus de dada és diferent de la moneda, arrangeu-lo a <sgmltag class="attvalue" +>36</sgmltag +> ($). El valor és un número que representa un caràcter Unicode. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-negvaluecolor"/><sgmltag class="attribute" +>NegValueColor</sgmltag +></term> +<listitem> +<para +>Arranja el color per a valors numèrics negatius. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b ha d'estar en el rang de 0 a 255. Si les dades són diferents d'un tipus numèric, arrangeu-lo a 255,0,0. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="c-commaseparator"/><sgmltag class="attribute" +>CommaSeparator</sgmltag +></term> +<listitem> +<para +>Arranja si s'usen comes en els camps numèrics. Si el tipus de dades és diferent d'un tpus numèric, arrangeu-lo a <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Separador de coma</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Vertader</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="special-element"> +<title +><sgmltag class="element" +>Especial</sgmltag +></title> + +<para +>L'element <sgmltag class="element" +>Special</sgmltag +> defineix un objecte d'informe usat per a dibuixar números de pàgina i la data actual en un informe. </para> + +<synopsis +><!ELEMENT Special EMPTY> +<!ATTLIST Special + Type CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DateFormat CDATA #REQUIRED> +</synopsis> + +<variablelist> +<varlistentry> +<term +>Atributs</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="s-type"/><sgmltag class="attribute" +>Tipus</sgmltag +></term> +<listitem> +<para +>Arranja el tipus de l'objecte especial. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Tipus</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Data actual</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Número de pàgina</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-text"/><sgmltag class="attribute" +>Text</sgmltag +></term> +<listitem> +<para +>No usat. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-x"/><sgmltag class="attribute" +>X</sgmltag +></term> +<listitem> +<para +>Arranja la coordenada x (relativa a la cantonada superior esquerra de la secció) per a posicionar el camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-y"/><sgmltag class="attribute" +>Y</sgmltag +></term> +<listitem> +<para +>Arranja la coordenada y (relativa a la cantonada superior esquerra de la secció) per a posicionar el camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-width"/><sgmltag class="attribute" +>Amplada</sgmltag +></term> +<listitem> +<para +>Arranja l'amplada del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-height"/><sgmltag class="attribute" +>Alçada</sgmltag +></term> +<listitem> +<para +>Arranja l'alçada del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-backgroundcolor"/><sgmltag class="attribute" +>BackgroundColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de fons del camp. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-foregroundcolor"/><sgmltag class="attribute" +>ForegroundColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de primer pla del camp. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +><anchor id="s-bordercolor"/><sgmltag class="attribute" +>BorderColor</sgmltag +></term> +<listitem> +<para +>Arranja el color de la vora del camp. El color està definit com a valor RGB (Red Green Blue) (r,g,b). r, g i b han d'estar en el rang entre 0 i 255. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-borderwidth"/><sgmltag class="element" +>BorderWidth</sgmltag +></term> +<listitem> +<para +>Arranja l'amplada de la vora del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-borderstyle"/><sgmltag class="element" +>BorderStyle</sgmltag +></term> +<listitem> +<para +>Arranja l'estil de la vora del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Estil de la vora</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Cap</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Sòlig</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Traç</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>Punt</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>Punt de traç</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>Traç punt punt</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-fontfamily"/><sgmltag class="attribute" +>FontFamily</sgmltag +></term> +<listitem> +<para +>Arranja la família de font del text del camp. </para> +<!--<informalexample> +<para +><userinput +><sgmltag +class="attribute" +>FontFamily</sgmltag +>="<sgmltag +class="attvalue" +>Helvetica</sgmltag +>"</userinput +></para> +</informalexample +>--> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-fontsize"/><sgmltag class="attribute" +>FontSize</sgmltag +></term> +<listitem> +<para +>Arranja la mida de font del text del camp. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-fontweight"/><sgmltag class="attribute" +>FontWeight</sgmltag +></term> +<listitem> +<para +>Arranja el pes de font del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Pes de la font</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>25</sgmltag +></entry> +<entry +>Lleuger</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>50</sgmltag +></entry> +<entry +>Normal</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>63</sgmltag +></entry> +<entry +>Mig negreta</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>75</sgmltag +></entry> +<entry +>Negreta</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>87</sgmltag +></entry> +<entry +>Negre</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-fontitalic"/><sgmltag class="attribute" +>FontItalic</sgmltag +></term> +<listitem> +<para +>Arranja la bandera itàlica font del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Itàlica</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Vertader</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-halignment"/><sgmltag class="attribute" +>HAlignment</sgmltag +></term> +<listitem> +<para +>Arranja l'aliniament horitzontal del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Aliniament horitzontal</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Esquerra</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Centre</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Dreta</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-valignment"/><sgmltag class="attribute" +>VAlignment</sgmltag +></term> +<listitem> +<para +>Arranja l'aliniació de text vertical del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Aliniament vertical</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>Dalt</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Mig</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>Sota</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-wordwrap"/><sgmltag class="attribute" +>WordWrap</sgmltag +></term> +<listitem> +<para +>Arranja la bandera d'ajustament del text del camp. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Ajustament de paraula</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>False</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>Vertader</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-dateformat"/><sgmltag class="attribute" +>DateFormat</sgmltag +></term> +<listitem> +<para +>Arranja el format de data del camp. Per a que funcioni, el format de la data del document de dades ha d'estar en el format mm/dd/aaaa o mm-dd-aaaa, sinó s'usarà el format de data original. Si el tipus de dada és diferent del de la data, arrangeu-lo a <sgmltag class="attvalue" +>0</sgmltag +>. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Format de data</entry> +</row> +</thead> +<tbody> +<row> +<entry +><sgmltag class="attvalue" +>0</sgmltag +></entry> +<entry +>m/d/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>1</sgmltag +></entry> +<entry +>m-d-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>2</sgmltag +></entry> +<entry +>mm/dd/aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>3</sgmltag +></entry> +<entry +>mm-dd-aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>4</sgmltag +></entry> +<entry +>m/d/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>5</sgmltag +></entry> +<entry +>m-d-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>6</sgmltag +></entry> +<entry +>mm/dd/aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>7</sgmltag +></entry> +<entry +>mm-dd-aaaa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>8</sgmltag +></entry> +<entry +>aaaa/m/d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>9</sgmltag +></entry> +<entry +>aaaa-m-d</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>10</sgmltag +></entry> +<entry +>dd.mm.aa</entry> +</row> +<row> +<entry +><sgmltag class="attvalue" +>11</sgmltag +></entry> +<entry +>dd.mm.aaaa</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="s-precision"/><sgmltag class="attribute" +>Precisió</sgmltag +></term> +<listitem> +<para +>Arranja la precisió numèrica del camp. Si el tipus de dades és diferent d'un tipus numèric, arrangeu-lo a 0. </para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +</sect1> + + + diff --git a/koffice-i18n-ca/docs/koffice/kugar/template.docbook b/koffice-i18n-ca/docs/koffice/kugar/template.docbook new file mode 100644 index 00000000..3a3589c9 --- /dev/null +++ b/koffice-i18n-ca/docs/koffice/kugar/template.docbook @@ -0,0 +1,515 @@ +<!-- If you want to edit or validate this document separately, uncomment +this prolog +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> +--> +<sect1 id="kugartemplate"> +<sect1info> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +> <firstname +>Rafael</firstname +> <surname +>Carreras</surname +> <affiliation +><address +><email +>rcarreras@caliu.cat</email +></address +></affiliation +> <contrib +>Traductor</contrib +> </othercredit +> +</authorgroup> +</sect1info> +<title +>Element <sgmltag class="element" +>KugarTemplate</sgmltag +></title> + +<para +>L'element <sgmltag class="element" +>KugarTemplate</sgmltag +> defineix els atributs de l'informe relatiu a la mida de la pàgina, l'orientació, i els marges. </para> + +<synopsis +><!ELEMENT KugarTemplate (<link linkend="report-header-and-footer" +>ReportHeader</link +>, <link linkend="page-header-and-footer" +>PageHeader</link +>, <link linkend="detail-header-and-footer" +>DetailHeader</link +>*, <link linkend="detail" +>Detail</link +>*, <link linkend="detail-header-and-footer" +>DetailFooter</link +>*, <link linkend="page-header-and-footer" +>PageFooter</link +>, <link linkend="report-header-and-footer" +>ReportFooter</link +>)> +<!ATTLIST KugarTemplate +PageSize CDATA #REQUIRED +PageOrientation CDATA #REQUIRED +TopMargin CDATA #REQUIRED +BottomMargin CDATA #REQUIRED +LeftMargin CDATA #REQUIRED +RightMargin CDATA #REQUIRED> +</synopsis> + +<variablelist> + +<varlistentry> +<term +>Elements</term> + +<listitem> + +<para +>L'element <sgmltag class="element" +>KugarTemplate</sgmltag +> conté els següents elements: </para> + +<variablelist> +<varlistentry> +<term +><link linkend="report-header-and-footer" +><sgmltag class="element" +>ReportHeader</sgmltag +></link +></term> +<listitem> +<para +>L'element <sgmltag class="element" +>ReportHeader</sgmltag +> defineix seccions d'informe que s'imprimeixen normalment al principi de l'informe. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="page-header-and-footer" +><sgmltag class="element" +>PageHeader</sgmltag +></link +></term> +<listitem> +<para +>L'element <sgmltag class="element" +>PageHeader</sgmltag +> defineix les seccions d'informe que s'imprimeixen normalment a la part de dalt de cada pàgina de l'informe. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="detail-header-and-footer" +><sgmltag class="element" +>DetailHeader</sgmltag +></link +></term> +<listitem> +<para +>L'element <sgmltag class="element" +>DetailHeader</sgmltag +> defineix les seccions de l'informe que s'imprmeixen abans dels detalls d'un nivell donat a l'informe. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="detail" +><sgmltag class="element" +>Detall</sgmltag +></link +></term> +<listitem> +<para +>L'element <sgmltag class="element" +>Detail</sgmltag +> defineix la secció d'informe que conté les dades d'informe. L'informe pot tenir un número il·limitat de detalls. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="detail-header-and-footer" +><sgmltag class="element" +>DetailFooter</sgmltag +></link +></term> +<listitem> +<para +>L'element <sgmltag class="element" +>DetailFooter</sgmltag +> defineix les seccions d'informe que s'imprimeixen després dels detalls d'un nivell donat i a la part de sota de l'informe. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="page-header-and-footer" +><sgmltag class="element" +>PageFooter</sgmltag +></link +></term> +<listitem> +<para +>L'element <sgmltag class="element" +>PageFooter</sgmltag +> defineix les seccions d'informe que s'imprimeixen al final de cada pàgina de l'informe. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><link linkend="report-header-and-footer" +><sgmltag class="element" +>ReportFooter</sgmltag +></link +></term> +<listitem> +<para +>L'element <sgmltag class="element" +>ReportFooter</sgmltag +> defineix les seccions d'informe que s'imprimeixen al final de l'informe. </para> +</listitem> +</varlistentry> + +</variablelist> + +</listitem> + +</varlistentry> + +<varlistentry> +<term +>Atributs</term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="kut-pagesize"/><sgmltag class="attribute" +>PageSize</sgmltag +></term> +<listitem> +<para +>Arranja la mida de pàgina d'informe. Estan disponibles els següents valors: </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Mida de pàgina</entry> +</row> +</thead> + +<tbody> +<row> +<entry +>0</entry> +<entry +>A4</entry> +</row> +<row> +<entry +>1</entry> +<entry +>B5</entry> +</row> +<row> +<entry +>2</entry> +<entry +>Carta</entry> +</row> +<row> +<entry +>3</entry> +<entry +>Legal</entry> +</row> +<row> +<entry +>4</entry> +<entry +>Executiu</entry> +</row> +<row> +<entry +>5</entry> +<entry +>A0</entry> +</row> +<row> +<entry +>6</entry> +<entry +>A1</entry> +</row> +<row> +<entry +>7</entry> +<entry +>A2</entry> +</row> +<row> +<entry +>8</entry> +<entry +>A3</entry> +</row> +<row> +<entry +>9</entry> +<entry +>A5</entry> +</row> +<row> +<entry +>10</entry> +<entry +>A6</entry> +</row> +<row> +<entry +>11</entry> +<entry +>A7</entry> +</row> +<row> +<entry +>12</entry> +<entry +>A8</entry> +</row> +<row> +<entry +>13</entry> +<entry +>A9</entry> +</row> +<row> +<entry +>14</entry> +<entry +>B0</entry> +</row> +<row> +<entry +>15</entry> +<entry +>B1</entry> +</row> +<row> +<entry +>16</entry> +<entry +>B10</entry> +</row> +<row> +<entry +>17</entry> +<entry +>B2</entry> +</row> +<row> +<entry +>18</entry> +<entry +>B3</entry> +</row> +<row> +<entry +>19</entry> +<entry +>B4</entry> +</row> +<row> +<entry +>20</entry> +<entry +>B6</entry> +</row> +<row> +<entry +>21</entry> +<entry +>B7</entry> +</row> +<row> +<entry +>22</entry> +<entry +>B8</entry> +</row> +<row> +<entry +>23</entry> +<entry +>B9</entry> +</row> +<row> +<entry +>24</entry> +<entry +>C5E</entry> +</row> +<row> +<entry +>25</entry> +<entry +>Comm10E</entry> +</row> +<row> +<entry +>26</entry> +<entry +>DLE</entry> +</row> +<row> +<entry +>27</entry> +<entry +>Foli</entry> +</row> +<row> +<entry +>28</entry> +<entry +>Llibre de comptabilitat</entry> +</row> +<row> +<entry +>29</entry> +<entry +>Tabloid</entry> +</row> +<row> +<entry +>30</entry> +<entry +>NPageSize</entry> +</row> + +</tbody> +</tgroup> +</informaltable> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="kut-pageorient"/><sgmltag class="attribute" +>PageOrientation</sgmltag +></term> +<listitem> +<para +>Arranja l'orientació de pàgina de l'informe. </para> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Valor</entry> +<entry +>Orientació</entry> +</row> +</thead> +<tbody> +<row> +<entry +>0</entry> +<entry +>Retrat</entry> +</row> +<row> +<entry +>1</entry> +<entry +>Apaïsat</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="kut-topmargin"/><sgmltag class="attribute" +>TopMargin</sgmltag +></term> +<listitem> +<para +>Arranja el marge superior de la pàgina d'informe. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="kut-botmargin"/><sgmltag class="attribute" +>BottomMargin</sgmltag +></term> +<listitem> +<para +>Arranja el marge inferior de la pàgina d'informe. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="kut-leftmargin"/><sgmltag class="attribute" +>LeftMargin</sgmltag +></term> +<listitem> +<para +>Arranja el marge esquerre de la pàgina d'informe. </para> +</listitem> +</varlistentry +><varlistentry> +<term +><anchor id="kut-rightmargin"/><sgmltag class="attribute" +>RightMargin</sgmltag +></term> +<listitem> +<para +>Arranja el marge dret de la pàgina d'informe. </para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> +</sect1> diff --git a/koffice-i18n-ca/docs/koffice/kugar/templatedtd.docbook b/koffice-i18n-ca/docs/koffice/kugar/templatedtd.docbook new file mode 100644 index 00000000..4b8a945d --- /dev/null +++ b/koffice-i18n-ca/docs/koffice/kugar/templatedtd.docbook @@ -0,0 +1,522 @@ +<!-- If you want to validate or edit this document separately, uncomment +this prolog + +<?xml version="1.0" ?> +<!DOCTYPE appendix PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> + +<sect1 id="template-dtd"> +<sect1info> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +> <firstname +>Rafael</firstname +> <surname +>Carreras</surname +> <affiliation +><address +><email +>rcarreras@caliu.cat</email +></address +></affiliation +> <contrib +>Traductor</contrib +> </othercredit +> +</authorgroup> +</sect1info> +<title +>La definició de tipus de document de KugarTemplate</title> + +<synopsis +><?xml version="1.0" encoding="UTF-8"?> + +<!DOCTYPE KugarTemplate [ + <!ELEMENT <link linkend="kugartemplate" +>KugarTemplate</link +> (<link linkend="report-header-and-footer" +>ReportHeader</link +>, <link linkend="page-header-and-footer" +>PageHeader</link +>, <link linkend="detail-header-and-footer" +>DetailHeader</link +>*, <link linkend="detail" +>Detail</link +>*, <link linkend="detail-header-and-footer" +>DetailFooter</link +>*, <link linkend="page-header-and-footer" +>PageFooter</link +>, <link linkend="report-header-and-footer" +>ReportFooter</link +>)> + <!ATTLIST KugarTemplate + <link linkend="kut-pagesize" +>PageSize</link +> CDATA #REQUIRED + <link linkend="kut-pageorient" +>PageOrientation</link +> CDATA #REQUIRED + <link linkend="kut-topmargin" +>TopMargin</link +> CDATA #REQUIRED + <link linkend="kut-botmargin" +>BottomMargin</link +> CDATA #REQUIRED + <link linkend="kut-leftmargin" +>LeftMargin</link +> CDATA #REQUIRED + <link linkend="kut-rightmargin" +>RightMargin</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="report-header-and-footer" +>ReportHeader</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> + <!ATTLIST ReportHeader + <link linkend="rhf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="rhf-printfrequency" +>PrintFrequency</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="page-header-and-footer" +>PageHeader</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> + <!ATTLIST PageHeader + <link linkend="phf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="phf-printfrequency" +>PrintFrequency</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="detail-header-and-footer" +>DetailHeader</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> + <!ATTLIST DetailHeader + <link linkend="dhf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="dhf-level" +>Level</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="detail" +>Detail</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*, <link linkend="field-element" +>Field</link +>*)> + <!ATTLIST Detail + <link linkend="d-height" +>Height</link +> CDATA #REQUIRED + <link linkend="d-level" +>Level</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="detail-header-and-footer" +>DetailFooter</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> + <!ATTLIST DetailFooter + <link linkend="dhf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="dhf-level" +>Level</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="page-header-and-footer" +>PageFooter</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*)> + <!ATTLIST PageFooter + <link linkend="phf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="phf-printfrequency" +>PrintFrequency</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="report-header-and-footer" +>ReportFooter</link +> (<link linkend="line-element" +>Line</link +>*, <link linkend="label-element" +>Label</link +>*, <link linkend="special-element" +>Special</link +>*, <link linkend="calculated-field-element" +>CalculatedField</link +>*)> + <!ATTLIST ReportFooter + <link linkend="rhf-height" +>Height</link +> CDATA #REQUIRED + <link linkend="rhf-printfrequency" +>PrintFrequency</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="line-element" +>Line</link +> EMPTY> + <!ATTLIST Line + <link linkend="l-x1" +>X1</link +> CDATA #REQUIRED + <link linkend="l-y1" +>Y1</link +> CDATA #REQUIRED + <link linkend="l-x2" +>X2</link +> CDATA #REQUIRED + <link linkend="l-y2" +>Y2</link +> CDATA #REQUIRED + <link linkend="l-width" +>Width</link +> CDATA #REQUIRED + <link linkend="l-color" +>Color</link +> CDATA #REQUIRED + <link linkend="l-style" +>Style</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="label-element" +>Label</link +> EMPTY> + <!ATTLIST Label + <link linkend="la-text" +>Text</link +> CDATA #REQUIRED + <link linkend="la-x" +>X</link +> CDATA #REQUIRED + <link linkend="la-y" +>Y</link +> CDATA #REQUIRED + <link linkend="la-width" +>Width</link +> CDATA #REQUIRED + <link linkend="la-height" +>Height</link +> CDATA #REQUIRED + <link linkend="la-backgroundcolor" +>BackgroundColor</link +> CDATA #REQUIRED + <link linkend="la-foregroundcolor" +>ForegroundColor</link +> CDATA #REQUIRED + <link linkend="la-bordercolor" +>BorderColor</link +> CDATA #REQUIRED + <link linkend="la-borderwidth" +>BorderWidth</link +> CDATA #REQUIRED + <link linkend="la-borderstyle" +>BorderStyle</link +> CDATA #REQUIRED + <link linkend="la-fontfamily" +>FontFamily</link +> CDATA #REQUIRED + <link linkend="la-fontsize" +>FontSize</link +> CDATA #REQUIRED + <link linkend="la-fontweight" +>FontWeight</link +> CDATA #REQUIRED + <link linkend="la-fontitalic" +>FontItalic</link +> CDATA #REQUIRED + <link linkend="la-halignment" +>HAlignment</link +> CDATA #REQUIRED + <link linkend="la-valignment" +>VAlignment</link +> CDATA #REQUIRED + <link linkend="la-wordwrap" +>WordWrap</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="field-element" +>Field</link +> EMPTY> + <!ATTLIST Field + <link linkend="f-field" +>Field</link +> CDATA #REQUIRED + <link linkend="f-text" +>Text</link +> CDATA #REQUIRED + <link linkend="f-x" +>X</link +> CDATA #REQUIRED + <link linkend="f-y" +>Y</link +> CDATA #REQUIRED + <link linkend="f-width" +>Width</link +> CDATA #REQUIRED + <link linkend="f-height" +>Height</link +> CDATA #REQUIRED + <link linkend="f-backgroundcolor" +>BackgroundColor</link +> CDATA #REQUIRED + <link linkend="f-foregroundcolor" +>ForegroundColor</link +> CDATA #REQUIRED + <link linkend="f-bordercolor" +>BorderColor</link +> CDATA #REQUIRED + <link linkend="f-borderwidth" +>BorderWidth</link +> CDATA #REQUIRED + <link linkend="f-borderstyle" +>BorderStyle</link +> CDATA #REQUIRED + <link linkend="f-fontfamily" +>FontFamily</link +> CDATA #REQUIRED + <link linkend="f-fontsize" +>FontSize</link +> CDATA #REQUIRED + <link linkend="f-fontweight" +>FontWeight</link +> CDATA #REQUIRED + <link linkend="f-fontitalic" +>FontItalic</link +> CDATA #REQUIRED + <link linkend="f-halignment" +>HAlignment</link +> CDATA #REQUIRED + <link linkend="f-valignment" +>VAlignment</link +> CDATA #REQUIRED + <link linkend="f-wordwrap" +>WordWrap</link +> CDATA #REQUIRED + <link linkend="f-datatype" +>DataType</link +> CDATA #REQUIRED + <link linkend="f-dateformat" +>DateFormat</link +> CDATA #REQUIRED + <link linkend="f-precision" +>Precision</link +> CDATA #REQUIRED + <link linkend="f-currency" +>Currency</link +> CDATA #REQUIRED + <link linkend="f-negvaluecolor" +>NegValueColor</link +> CDATA #REQUIRED + <link linkend="f-commaseparator" +>CommaSeparator</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="calculated-field-element" +>CalculatedField</link +> EMPTY> + <!ATTLIST CalculatedField + <link linkend="c-calculationtype" +>CalculationType</link +> CDATA #REQUIRED + <link linkend="c-field" +>Field</link +> CDATA #REQUIRED + <link linkend="c-text" +>Text</link +> CDATA #REQUIRED + <link linkend="c-x" +>X</link +> CDATA #REQUIRED + <link linkend="c-y" +>Y</link +> CDATA #REQUIRED + <link linkend="c-width" +>Width</link +> CDATA #REQUIRED + <link linkend="c-height" +>Height</link +> CDATA #REQUIRED + <link linkend="c-backgroundcolor" +>BackgroundColor</link +> CDATA #REQUIRED + <link linkend="c-foregroundcolor" +>ForegroundColor</link +> CDATA #REQUIRED + <link linkend="c-bordercolor" +>BorderColor</link +> CDATA #REQUIRED + <link linkend="c-borderwidth" +>BorderWidth</link +> CDATA #REQUIRED + <link linkend="c-borderstyle" +>BorderStyle</link +> CDATA #REQUIRED + <link linkend="c-fontfamily" +>FontFamily</link +> CDATA #REQUIRED + <link linkend="c-fontsize" +>FontSize</link +> CDATA #REQUIRED + <link linkend="c-fontweight" +>FontWeight</link +> CDATA #REQUIRED + <link linkend="c-fontitalic" +>FontItalic</link +> CDATA #REQUIRED + <link linkend="c-halignment" +>HAlignment</link +> CDATA #REQUIRED + <link linkend="c-valignment" +>VAlignment</link +> CDATA #REQUIRED + <link linkend="c-wordwrap" +>WordWrap</link +> CDATA #REQUIRED + <link linkend="c-datatype" +>DataType</link +> CDATA #REQUIRED + <link linkend="c-dateformat" +>DateFormat</link +> CDATA #REQUIRED + <link linkend="c-precision" +>Precision</link +> CDATA #REQUIRED + <link linkend="c-currency" +>Currency</link +> CDATA #REQUIRED + <link linkend="c-negvaluecolor" +>NegValueColor</link +> CDATA #REQUIRED + <link linkend="c-commaseparator" +>CommaSeparator</link +> CDATA #REQUIRED> + + <!ELEMENT <link linkend="special-element" +>Special</link +> EMPTY> + <!ATTLIST Special + <link linkend="s-type" +>Type</link +> CDATA #REQUIRED + <link linkend="s-text" +>Text</link +> CDATA #REQUIRED + <link linkend="s-x" +>X</link +> CDATA #REQUIRED + <link linkend="s-y" +>Y</link +> CDATA #REQUIRED + <link linkend="s-width" +>Width</link +> CDATA #REQUIRED + <link linkend="s-height" +>Height</link +> CDATA #REQUIRED + <link linkend="s-backgroundcolor" +>BackgroundColor</link +> CDATA #REQUIRED + <link linkend="s-foregroundcolor" +>ForegroundColor</link +> CDATA #REQUIRED + <link linkend="s-bordercolor" +>BorderColor</link +> CDATA #REQUIRED + <link linkend="s-borderwidth" +>BorderWidth</link +> CDATA #REQUIRED + <link linkend="s-borderstyle" +>BorderStyle</link +> CDATA #REQUIRED + <link linkend="s-fontfamily" +>FontFamily</link +> CDATA #REQUIRED + <link linkend="s-fontsize" +>FontSize</link +> CDATA #REQUIRED + <link linkend="s-fontweight" +>FontWeight</link +> CDATA #REQUIRED + <link linkend="s-fontitalic" +>FontItalic</link +> CDATA #REQUIRED + <link linkend="s-halignment" +>HAlignment</link +> CDATA #REQUIRED + <link linkend="s-valignment" +>VAlignment</link +> CDATA #REQUIRED + <link linkend="s-wordwrap" +>WordWrap</link +> CDATA #REQUIRED + <link linkend="s-dateformat" +>DateFormat</link +> CDATA #REQUIRED> + ]> +</synopsis> +</sect1> diff --git a/koffice-i18n-ca/docs/koffice/kugar/tutorial.docbook b/koffice-i18n-ca/docs/koffice/kugar/tutorial.docbook new file mode 100644 index 00000000..2dfcbf5e --- /dev/null +++ b/koffice-i18n-ca/docs/koffice/kugar/tutorial.docbook @@ -0,0 +1,380 @@ +<!-- If you want to validate or edit this document separately, uncomment +this prolog + +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +--> +<chapter id="tutorial"> +<chapterinfo> +<authorgroup> +<author +><firstname +>Alexander</firstname +> <surname +>Dymo</surname +> <affiliation +> <address +><email +>cloudtemple@mksat.net</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>phil@river-bank.demon.co.uk</email +></address> +</affiliation> +</author> +<othercredit role="translator" +> <firstname +>Rafael</firstname +> <surname +>Carreras</surname +> <affiliation +><address +><email +>rcarreras@caliu.cat</email +></address +></affiliation +> <contrib +>Traductor</contrib +> </othercredit +> +</authorgroup> +</chapterinfo> +<title +>Tutorial</title> + +<para +>Aquest tutorial pretén ser una breu introducció al Kugar.</para> + +<para +>Podeu crear una plantilla d'informe de prova amb el &kudesigner;, un fitxer de dades de prova i, finalment, generar un informe complet.</para> + +<para +>El codi font per a les plantilles de prova i els fitxers de dades es poden trobar a <filename +>sample1.ktf</filename +> i <filename +>sample1.kdf</filename +>, que es distribueixen amb el &kugar;.</para> + + +<sect1 id="tut-1"> +<title +>Creant la plantilla d'informe amb el &kudesigner;</title> + +<para +>Executeu el Kugar Designer teclejant <command +>kudesigner</command +> al terminal. </para> + +<para +>Després d'iniciar el dissenyador, escolliu <guimenu +>Fitxer</guimenu +>|<guilabel +>Nou</guilabel +> i arrangeu la mida de la pàgina <guilabel +>Carta</guilabel +> i orientació del paper a <guilabel +>Apaïsat</guilabel +>. Arrangeu els marges esquerre i dret a 48, els marges dalt i baix a 40. Totes les dimensions en el &kudesigner; (marges de pàgina, mides, posicions, &etc;) es mesuren en mil·límeters. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_file_new.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Diàleg <interface +>Nou informe</interface +></phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Ara s'ha creat un nou informe i estan disponibles tots els botons de la <guilabel +>Barra d'eines Ítems</guilabel +> i la <guilabel +>Barra d'eines Seccions Toolbar</guilabel +> (els corresponents ítems de menú d'<guilabel +>Ítems</guilabel +> i <guilabel +>Seccions</guilabel +> també estan disponibles). <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_empty_report.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Finestra d'informe buida</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Ara és hora d'afegir algunes seccions a l'informe i determina les seves mides. Afegirem un <link linkend="report-header-and-footer" +>capçalera i peu d'informe</link +>, <link linkend="page-header-and-footer" +>capçalera i peu de pàgina</link +> i una única secció <link linkend="detail" +>detall</link +>. Les capçaleres i peus d'informe s'imprimeixen a la primera i última pàgina de l'informe abans i després de qualsevol altra dada d'informe. Els peus d'informe són bons llocs per a <link linkend="calculated-field-element" +>camps calculats</link +>. Les capçaleres i peus de pàgina s'imprimeixen a la part superior i inferior de cada pàgina. El nostre informe tindrà una secció de detall amb nivell 0. Això vol dir que totes les nostres files de dades tenen idèntica estructura (és a dir, camps). Si l'estructura de dades és més complexa o està organitzada d'acord amb una relació master-detall, s'hauran de crear més nivells de detall. Mireu <filename +>sample3.ktf</filename +> i <filename +>sample3.kdf</filename +> per a un exemple de com es pot fer això. Referiu-vos a les <link linkend="template-elements" +>descripcions d'elements de plantilla</link +> per a informacions addicionals. </para> + +<para +>Les seccions s'afegeixen usant el menú <guilabel +>Seccions</guilabel +> o una <guilabel +>Barra d'eines Seccions</guilabel +>. Ara afegiu una capçalera i peu d'informe, una capçalera i peu de pàgina i llavors una secció detall. Quan afegiu una secció detall, arrangeu el seu nivell a 0 com es mostra a la captura de pantalla de sota. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_set_level.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Arranjant el nivell de detall</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>El nostre informe ha de semblar-se a aquest a la captura de pantalla. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_rep_look1.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Informe amb seccions</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Totes les nostres seccions tenen una alçada predefinida - 50mm. Canviem-la. Per a fer-ho, dretcliqueu a la secció Capçalera d'informe o cliqueu el botó <guilabel +>Edita les propietats</guilabel +> a la <guilabel +>Barra d'eines Edita</guilabel +> i llavors escolliu una secció. S'hauria de mostrar la finestra de Propietats. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_edit_height.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Editant l'alçada de la secció</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Ara arrangeu l'alçada de la capçalera d'informe a 70. Fem el mateix peer a totes les altres seccions. Arrangeu l'alçada de capçalera de pàgina a 45 i la de detalls a 30. Els peus de pàgina i d'informe han de ser de 32 mm d'alçada. </para> + +<para +>Una plantilla d'informe amb les seccions correctament amidades està llesta per a omplir-se amb ítems d'informe. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_rep_look2.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Informe amb les seccions amidades</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +<para +>Ara podeu afegir-hi ítems a les seccions de l'informe. Es poden afegir cinc tipus diferents d'ítems a l'informe. <link linkend="label-element" +>Etiqueta</link +> és una àrea rectangular que poden tenir vores i es poden omplir amb qualsevol tipus de dades textuals. Els colors de primer pla i de fons de l'etiqueta, així com fonts, es poden afegir. Els tipus de línia de les vores i els colors de línia també són personalitzables. Els <link linkend="field-element" +>Camps</link +> es poden emplaçar en una secció detall. Els Camps representen camps de dades; els seus valors es recolliran des d'un fitxer de dades mentre es genera un informe. Els comptes, sumatoris, mitjanes, &etc; per als valors de camp es poden imprimir a l'informe mitjançant <link linkend="calculated-field-element" +>Camps calculats</link +>. <link linkend="special-element" +>Especials</link +> són etiquetes amb text predefinit, com a dada actual o número de pàgina. L'aparença d'informe general es pot refinar amb <link linkend="line-element" +>Línies</link +>. </para> + +<para +>Per a afegir un ítem d'informe, cliqueu el botó de l'ítem corresponent de la <guilabel +>Barra d'eines d'ítems</guilabel +> i emplaceu-lo (clic) a la secció. L'ítem escollit s'emplaçarà a la secció seleccionada amb la cantonada superior esquerra a les coordenades donades. Altres propietats s'arrangen als valors per omissió i es poden canviar amb el diàleg <guilabel +>Opcions d'ítem d'informe</guilabel +> (la mateixa manera que vam fer servir per a canviar l'alçada de la secció). </para> + +<para +>Bé, anem a afegir etiquetes a les capçaleres d'informe i de pàgina com es mostra a la captura de pantalla de sota. Noteu que l'etiqueta <quote +>Mutiny Bay Software</quote +> té les seves <guilabel +>BorderStyle</guilabel +> i <guilabel +>BorderWidth</guilabel +> arranjades a 0 i <quote +>Software Inventory Report</quote +> a 1mm. Qualsevol color està arranjat a una combinació de tres valors (RGB - red,green,blue) separats per comes. </para> + +<para +>També volem afegir elements a la secció detall. Just assumiu que tenim quatre camps - títol, versió, plataforma i còpies. Per tant, s'emplaçaran quatre elements de <guilabel +>Camp</guilabel +> i els seus conjunts de propietats de <guilabel +>Camp</guilabel +>. Noteu que la propietat <guilabel +>Text</guilabel +> s'arranja automàticament a <quote +>[<userinput +>field_name</userinput +>]</quote +>. </para> + +<para +>El nostre peu de pàgina és un bon lloc per a mostrar la data actual i el número de pàgina, així que hi afegim dos camps especials i arranjats les seves propietats de <guilabel +>Tipus</guilabel +> a 0 i 1. Un especial amb Type=0 representarà la data i una amb Type=1 el número de pàgina. Noteu que la propietat especial de <guilabel +>Text</guilabel +> es canvia automàticament. </para> + +<para +>L'últim element per a emplaçar és un <guilabel +>Camp calculat</guilabel +> per al camo <quote +>còpies</quote +>. Per a adquirir un sumatori (còpies) arrangeu la propietat del camp calculat <guilabel +>Camp</guilabel +> a <quote +>còpies</quote +> i <guilabel +>CalculationType</guilabel +> a 1 (funció sum). </para> + +<para +>Finalment, la nostra plantilla d'informe hauria de semblar-se a això: <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_rep_complete.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Informe complet</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +</sect1> + + + +<sect1 id="tut-2"> +<title +>Crea el fitxer de dades d'informe</title> + +<para +>Generalment, els fitxers de dades es poden crear de moltes maneres. Algunes usaran taules de transformació xsl per a generar &XML; correcte des d'un altre document &XML; (com el full de càlcul &kspread;); altres usaran el seu propi programa per a agafar les dades des d'una base de dades i omplir el fitxer de dades. En aquest tutorial, el crearem simplement a mà. El codi font per a l'exemple es pot trobar al fitxer <filename +>sample1.kdf</filename +> o es pot copiar des de l'exemple de sota. </para> + +<programlisting +><?xml version=<quote +>1.0</quote +> encoding=<quote +>UTF-8</quote +>?> + +<!DOCTYPE KugarData [ + <!ELEMENT KugarData (Row* )> + <!ATTLIST KugarData + Template CDATA #REQUIRED> + + <!ELEMENT Row EMPTY> + <!ATTLIST Row + level CDATA #REQUIRED + title CDATA #REQUIRED + version CDATA #REQUIRED + platform CDATA #REQUIRED + copies CDATA #REQUIRED> +]> + +<KugarData Template="sample1.ktf"> + <Row level="0" title=" BRU" version="15.0" platform="x86" copies="1"/> + <Row level="0" title=" Caldera Open Linux" version="2.2" platform="x86" copies="3"/> + <Row level="0" title=" K Desktop" version="1.1.1" platform="x86" copies="1"/> + <Row level="0" title=" Netscape Communicator" version="4.6" platform="x86" copies="10"/> + <Row level="0" title=" Redhat Linux" version="5.0" platform="x86" copies="11"/> + <Row level="0" title=" Redhat Linux" version="5.1" platform="x86" copies="12"/> + <Row level="0" title=" Redhat Linux" version="5.2" platform="x86" copies="14"/> + <Row level="0" title=" Redhat Linux" version="6.0" platform="x86" copies="15"/> + <Row level="0" title=" Star Office" version="5.0" platform="x86" copies="1"/> + <Row level="0" title=" Star Office" version="5.1" platform="x86" copies="3"/> + <Row level="0" title=" Microsoft Windows NT" version="3.1" platform="x86" copies="1"/> + <Row level="0" title=" Microsoft Windows NT" version="3.51" platform="x86" copies="1"/> + <Row level="0" title=" Microsoft Windows NT" version="4.0" platform="x86" copies="1"/> + <Row level="0" title=" Microsoft Windows NT" version="5.0" platform="x86" copies="1"/> + <Row level="0" title=" Sun Solaris" version="2.5" platform="Sparc" copies="1"/> +</KugarData> +</programlisting> + +</sect1> + +<sect1 id="tut-3"> +<title +>Generant l'informe</title> + +<para +>En aquest moment, tenim una plantilla d'informe (<filename +>sample1.ktf</filename +>) i un fitxer de dades d'informe (<filename +>sample1.kdf</filename +>). </para> +<para +>Per a generar un informe, teclegeu la següent comanda al terminal: <command +>kugar <option +>-r <replaceable +>sample1.ktf</replaceable +></option +> <option +>-d <replaceable +>sample1.kdf</replaceable +></option +></command +> </para> + +<para +>Això presentarà una finestra d'espai de treball del &kugar; amb l'informe generat. <screenshot +> <mediaobject> +<imageobject> +<imagedata fileref="tut_rep_generated.png" format="PNG"/> +</imageobject> +<textobject> +<phrase +>Informe generat</phrase> +</textobject> +</mediaobject> +</screenshot> +</para> + +</sect1> + +</chapter> |