doc/book.xml

   1 <?xml version="1.0" standalone="no"?>
   2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1//EN"
   3     "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd"
   4 [
   5      <!ENTITY % local SYSTEM "local.ent">
   6      %local;
   7      <!ENTITY % entities SYSTEM "entities.ent">
   8      %entities;
   9      <!ENTITY % common SYSTEM "common/common.ent">
  10      %common;
  11 ]>
  12 <!-- $Id: book.xml,v 1.1 2007-01-10 09:44:20 adam Exp $ -->
  13 <book id="book">
  14  <bookinfo>
  15   <title>pazpar2 - User's Guide and Reference</title>
  16   <author>
  17    <firstname>Sebastian</firstname><surname>Hammer</surname>
  18   </author>
  19   <copyright>
  20    <year>&copyright-year;</year>
  21    <holder>Index Data</holder>
  22   </copyright>
  23   <abstract>
  24    <simpara>
  25     pazpar2 - High-performance, user-interface
  26     user-interface independtent metasearching middleware.
  27    </simpara>
  28    <simpara>
  29     This document is a guide and reference to pazpar version &version;.
  30    </simpara>
  31    <simpara>
  32     <inlinemediaobject>
  33      <imageobject>
  34       <imagedata fileref="common/id.png" format="PNG"/>
  35      </imageobject>
  36      <imageobject>
  37       <imagedata fileref="common/id.eps" format="EPS"/>
  38      </imageobject>
  39     </inlinemediaobject>
  40    </simpara>
  41   </abstract>
  42  </bookinfo>
  43
  44  <chapter id="introduction">
  45   <title>Introduction</title>
  46
  47   <para>
  48    <ulink url="&url.pazpar2;">pazpar2</ulink> is.. To be written.
  49   </para>
  50  </chapter>
  51
  52  <chapter id="license">
  53   <title>pazpar2 License</title>
  54   <para>To be decided and written.</para>
  55  </chapter>
  56
  57  <chapter id="installation">
  58   <title>Installation</title>
  59   <para>
  60    pazpar2 depends on the following tools/libraries:
  61    <variablelist>
  62     <varlistentry><term><ulink url="&url.yaz;">YAZ</ulink></term>
  63      <listitem>
  64       <para>
  65        The popular Z39.50 toolkit for the C language. YAZ must be
  66        compiled with Libxml2/Libxslt support.
  67       </para>
  68      </listitem>
  69     </varlistentry>
  70    </variablelist>
  71   </para>
  72   <para>
  73    In order to compile pazpar2 an ANSI C compiler is
  74    required. The requirements should be the same as for YAZ.
  75   </para>
  76
  77   <section id="installation.unix">
  78    <title>Installation on Unix (from Source)</title>
  79    <para>
  80     Here is a quick step-by-step guide on how to compile the
  81     tools that pazpar2 uses. Only few systems have none of the required
  82     tools binary packages. If, for example, Libxml2/libxslt are already
  83     installed as development packages use those (and omit compilation).
  84    </para>
  85
  86    <para>
  87     Ensure that the development libraries + header files are
  88     available on your system before compiling pazpar2. For installation
  89     of YAZ, refer to the YAZ installation chapter.
  90    </para>
  91    <screen>
  92     gunzip -c pazpar2-version.tar.gz|tar xf -
  93     cd pazpar2-version
  94     ./configure
  95     make
  96     su
  97     make install
  98    </screen>
  99   </section>
 100
 101   <section id="installation.debian">
 102    <title>Installation on Debian GNU/Linux</title>
 103    <para>
 104     All dependencies for pazpar2 are available as
 105     <ulink url="&url.debian;">Debian</ulink>
 106     packages for the sarge (stable in 2005) and etch (testing in 2005)
 107     distributions.
 108    </para>
 109    <para>
 110     The procedures for Debian based systems, such as
 111     <ulink url="&url.ubuntu;">Ubuntu</ulink> is probably similar
 112    </para>
 113    <screen>
 114     apt-get install libyaz-dev
 115    </screen>
 116    <para>
 117     With these packages installed, the usual configure + make
 118     procedure can be used for pazpar2 as outlined in
 119     <xref linkend="installation.unix"/>.
 120    </para>
 121   </section>
 122  </chapter>
 123
 124  <reference id="refguide">
 125   <title>Reference guide</title>
 126     <para>
 127      The material in this chapter is drawn directly from the individual
 128      manual entries.
 129     </para>
 130     &manref;
 131  </reference>
 132 </book>
 133
 134  <!-- Keep this comment at the end of the file
 135  Local variables:
 136  mode: sgml
 137  sgml-omittag:t
 138  sgml-shorttag:t
 139  sgml-minimize-attributes:nil
 140  sgml-always-quote-attributes:t
 141  sgml-indent-step:1
 142  sgml-indent-data:t
 143  sgml-parent-document: nil
 144  sgml-local-catalogs: nil
 145  sgml-namecase-general:t
 146  End:
 147  -->