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"
5 <!ENTITY % local SYSTEM "local.ent">
7 <!ENTITY % entities SYSTEM "entities.ent">
9 <!ENTITY % common SYSTEM "common/common.ent">
12 <!-- $Id: book.xml,v 1.1 2007-01-10 09:44:20 adam Exp $ -->
15 <title>pazpar2 - User's Guide and Reference</title>
17 <firstname>Sebastian</firstname><surname>Hammer</surname>
20 <year>©right-year;</year>
21 <holder>Index Data</holder>
25 pazpar2 - High-performance, user-interface
26 user-interface independtent metasearching middleware.
29 This document is a guide and reference to pazpar version &version;.
34 <imagedata fileref="common/id.png" format="PNG"/>
37 <imagedata fileref="common/id.eps" format="EPS"/>
44 <chapter id="introduction">
45 <title>Introduction</title>
48 <ulink url="&url.pazpar2;">pazpar2</ulink> is.. To be written.
52 <chapter id="license">
53 <title>pazpar2 License</title>
54 <para>To be decided and written.</para>
57 <chapter id="installation">
58 <title>Installation</title>
60 pazpar2 depends on the following tools/libraries:
62 <varlistentry><term><ulink url="&url.yaz;">YAZ</ulink></term>
65 The popular Z39.50 toolkit for the C language. YAZ must be
66 compiled with Libxml2/Libxslt support.
73 In order to compile pazpar2 an ANSI C compiler is
74 required. The requirements should be the same as for YAZ.
77 <section id="installation.unix">
78 <title>Installation on Unix (from Source)</title>
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).
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.
92 gunzip -c pazpar2-version.tar.gz|tar xf -
101 <section id="installation.debian">
102 <title>Installation on Debian GNU/Linux</title>
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)
110 The procedures for Debian based systems, such as
111 <ulink url="&url.ubuntu;">Ubuntu</ulink> is probably similar
114 apt-get install libyaz-dev
117 With these packages installed, the usual configure + make
118 procedure can be used for pazpar2 as outlined in
119 <xref linkend="installation.unix"/>.
124 <reference id="refguide">
125 <title>Reference guide</title>
127 The material in this chapter is drawn directly from the individual
134 <!-- Keep this comment at the end of the file
139 sgml-minimize-attributes:nil
140 sgml-always-quote-attributes:t
143 sgml-parent-document: nil
144 sgml-local-catalogs: nil
145 sgml-namecase-general:t