<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [ <!ENTITY kudesigner "Kugar Report Designer"> <!ENTITY kugar "Kugar"> <!ENTITY kappname "&kugar;"> <!ENTITY package "koffice"> <!ENTITY % addindex "IGNORE"> <!ENTITY % English "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>The &kugar; Handbook</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> <!-- TRANS:ROLES_OF_TRANSLATORS --> </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> &kugar; is a template based &XML; report engine. &kudesigner; is a flexible &GUI; report template designer for Kugar report engine. </para> </abstract> <keywordset> <keyword>KDE</keyword> <keyword>kdeutils</keyword> <keyword>kugar</keyword> <keyword>kudesigner</keyword> <keyword>report</keyword> <keyword>generator</keyword> <keyword>engine</keyword> <keyword>designer</keyword> </keywordset> </bookinfo> <chapter id="introduction"> <title>Introduction</title> <para> &kugar; is a report creation tool for &Qt; and &kde;. It includes &GUI; report template designer, report engine, &konqueror; part for easy report preview and a set of examples. </para> <para> The &kugar; Report Designer is a report template creation tool for &kugar; report engine. &kugar; report engine uses a &XML; based report template file (which can be created by hand or with &kudesigner;) and data file (also in &XML; format) to create reports. To get more information on &kudesigner; refer to the <link linkend="designer-manual">Report Template Designer Manual</link>. </para> <para> See <link linkend="template-dtd"> The KugarTemplate Document Type Definition</link> for an overview of template's <acronym>DTD</acronym> (file format), <link linkend="kugardata-dtd">KugarData Document Type Definition</link> and <link linkend="tutorial">Tutorial</link> for step-by-step explanation on how reports can be created. </para> <para> Programmers should also refer to the <link linkend="prog-guide">Programmer's guide</link> to find information about using &kugar; in their own applications.</para> </chapter> &tutorial; &starting; &designermanual; &progguide; <chapter> <title>Credits and License</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>Portions of the documentation Copyright 2000,2001 Phil Thompson and Copyright 2002 Alexander Dymo</para> <!-- TRANS:CREDIT_FOR_TRANSLATORS --> &underGPL; &underFDL; </chapter> <appendix id="document-structure"> <title>Document Structure</title> &templatedtd; &template; &templateelements; &datadtd; &dataelements; </appendix> <appendix id="installation"> <title>Installation</title> &install.intro.documentation; &install.compile.documentation; </appendix> </book>