diff options
Diffstat (limited to 'koffice-i18n-ca/docs/koffice/kugar/tutorial.docbook')
| -rw-r--r-- | koffice-i18n-ca/docs/koffice/kugar/tutorial.docbook | 380 |
1 files changed, 380 insertions, 0 deletions
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> |