mirror of
https://github.com/zint/zint
synced 2024-11-16 20:57:25 +13:00
Initial revision
This commit is contained in:
125
docs/installing.html
Normal file
125
docs/installing.html
Normal file
@ -0,0 +1,125 @@
|
||||
<!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> </P>
|
||||
</TD>
|
||||
<TD WIDTH=33%>
|
||||
<P ALIGN=RIGHT>Using the Front End</P>
|
||||
</TD>
|
||||
</TR>
|
||||
</TABLE>
|
||||
<P><BR><BR>
|
||||
</P>
|
||||
</BODY>
|
||||
</HTML>
|
Reference in New Issue
Block a user