zint/docs/installing.html
2008-07-13 21:15:55 +00:00

125 lines
4.8 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Installing Zint</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080329;19111200">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="introduction.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="frontend.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1>2. Installing Zint</H1>
<P>These instructions relate to installing Zint on a GNU/Linux
machine but should be the same or similar for other POSIX compliant
systems (including UNIX and BSD based systems). Installation on
Windows or MacOS based system should be possible but is not covered
here.</P>
<P>Zint is currently only available as source code. First download
the source code .tar.gz file from <A HREF="http://www.sourceforge.net/projects/zint">SourceForge</A>
and unpack it. The package consists of two distinct parts: a <I>front
end</I> which provides a command line interface, and a <I>back end</I>
which provides an API which allows developers to integrate encoding
into their own project. You will notice that the sorce code is
suitably arranged into frontend and backend folders. The front end
requires the back end to be installed, so the back end should be
installed first.</P>
<P><A NAME="BACKEND"></A><FONT SIZE=5><B>2.1 Installing the back end</B></FONT></P>
<P>The Zint back end, <I>libzint</I>, requires the libpng and libz
libraries. The latest version of these libraries is available from
<A HREF="http://www.libpng.org/pub/png/libpng.html">http://www.libpng.org/pub/png/libpng.html</A>.
Install these first before trying to install Zint. In addition, if
you require QR Code support, Zint uses <I>libqrencode</I> which is
available from
<A HREF="http://megaui.net/fukuchi/works/qrencode/index.en.html">http://megaui.net/fukuchi/works/qrencode/index.en.html</A>.
If you don't need QR Code support this can be disabled during
compilation.</P>
<P STYLE="font-style: normal">To install libzint with QR Code support
follow these steps</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>cd
backend<BR>make<BR>make install</FONT></FONT></P>
<P STYLE="font-style: normal">If you do not want QR Code support use
the following steps</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>cd
backend<BR>make libzint_noqr<BR>make install</FONT></FONT></P>
<P><BR><BR>
</P>
<P STYLE="font-style: normal"><A NAME="FRONTEND"></A><FONT SIZE=5><B>2.2
Installing the front end</B></FONT></P>
<P STYLE="font-style: normal">To install the front end follow these
steps</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>cd
frontend<BR>make<BR>make install</FONT></FONT></P>
<P><BR><BR>
</P>
<P STYLE="font-style: normal"><A NAME="TESTING"></A><FONT SIZE=5><B>2.3
Testing the Installation</B></FONT></P>
<P STYLE="font-style: normal">To test that the installation has been
sucessful a shell script is included in the frontend folder. To run
the test type</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>./test.sh</FONT></FONT></P>
<P STYLE="font-style: normal">This should create numerous files
showing the many modes of operation which are available from Zint. If
you get the following message...</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>zint:
error while loading shared libraries: libzint.so: cannot open shared
object file: No such file or directory</FONT></FONT></P>
<P STYLE="font-style: normal">try the following as root:</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>ldconfig</FONT></FONT></P>
<P><BR><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="introduction.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="frontend.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Introduction</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Using the Front End</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>