--- trunk/INSTALL 2004/02/05 11:04:03 220 +++ trunk/INSTALL 2004/03/09 12:17:05 255 @@ -1,4 +1,4 @@ -beta-beta-beta INSTALL INSTRUCTIONS +INSTALL INSTRUCTIONS Feel free to contact me via e-mail to dpavlin@rot13.org if those instructions don't work for you. @@ -50,20 +50,21 @@ to get this one from http://savannah.nongnu.org/projects/unac/ Config::IniFiles - DBD::Pg or some other DBD driver, you can also - use the one which came with distribution - (e.g. libdbd-pg-perl on Debian) + DBD::Pg or some other DBD driver like DBD::SQLite CGI::Application HTML::Pager HTML::Template HTML::FillInForm SWISH SWISH::Fork and of course, swish-e executable - (e.g. swish-e package on Debian) XML::Simple + Text::Iconv + TDB_File + HTML::Entities (part of HTML::Parser) CPAN shell will also download some more modules to satisfy dependencies. + If you plan to use M$ Excel files for import (type=excel), you will need: Spreadsheet::ParseExcel @@ -72,26 +73,81 @@ MARC + +2.1 Installation on Debian GNU/Linux + + You will need following packages to get started: + + perl + swish-e + + and all additional packages which are dependencies. + + You also don't have to install all CPAN modules manually. Just use + following Debian packages: + + libtext-unaccent-perl + libconfig-inifiles-perl + libdbd-pg-perl or some other DBD driver + libdbd-sqlite-perl like DBD::SQLite + libhtml-template-perl + libxml-simple-perl + libtext-iconv-perl + tdb-dev (for TDB_File module later) + libhtml-parser-perl + + and install following packages by hand from CPAN + because they are not part of Debian distribution: + + CGI::Application + HTML::Pager + HTML::FillInForm + SWISH + SWISH::Fork + + and optionally some of those modules: + + Spreadsheet::ParseExcel + MARC + + For compilation of OpenIsis in next step, you will also need following + packages: + + make + gcc + libc-dev + 3. You will need OpenIsis if you are using ISIS as an import format. Currently, WebPAC uses OpenIsis 0.9.0 which *HAVE TO BE PATCHED* with special patch so that perl module OpenIsis.pm have close call (because there is hard-limit of 32 ISIS files in OpenIsis.pm, and that is too low for our use). - Get OpenIsis from: + You can do that yourself, or if you did checkout of our subversion repository + you will already have latest OpenIsis in webpac/openisis/ directory. + + If you want to do it yourself, first get OpenIsis from: http://openisis.org/Doc/GetIt - Get patch for close from: + Then get patch for close from: http://www.rot13.org/~dpavlin/projects/openisis-0.9.0-perl_close.diff - Unpack OpenIsis archive and apply patch -p0 to source tree. Type make, and - than: + Unpack OpenIsis archive and apply patch -p0 to source tree. + + Eater way, now you got OpenIsis 0.9.0 with close support for perl. So, + first compile C parts: + + make + And then compile perl module and install it: + + make perl cd perl - perl Makefile.PL - make sudo make install + Since you need development tools on target machine to compile OpenIsis, + you might want to compile it on another machine and just copy perl module. + 4. edit global.conf and all2xml.conf to suit your needs. Comments inside those files should help get you started.