.. -*- mode: rst ; ispell-local-dictionary: "american" -*- ==================================== pdfjoin Installation Instructions ==================================== :Author: Hartmut Goebel :Version: Version 0.1dev :Copyright: 2012 by Hartmut Goebel :Licence: GNU Public Licence v3 (GPLv3) :Homepage: http://pdfposter.origo.ethz.ch/ Requirements ~~~~~~~~~~~~~~~~~~~~ ``pdfjoin`` requires * Python 2.x (tested with 2.7, but other versions should work, too), * `pyPdf `_ > 1.10, * setuptools for installation (see below). Installation on Windows-Systems ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Installation Requirements ---------------------------- ``pdfjoin`` uses setuptools for installation. Thus you need either * network access, so the install script will automatically download and install setuptools if they are not already installed or * the correct version of setuptools preinstalled using the `EasyInstall installation instructions`__. Those instructions also have tips for dealing with firewalls as well as how to manually download and install setuptools. __ http://peak.telecommunity.com/DevCenter/EasyInstall#installation-instructions Installation ------------------------- Install ``pdfjoin`` by just running:: python ./setup.py install Custom Installation Locations ------------------------------ ``pdfjoin`` is just a single script (aka Python program). So you can copy it where ever you want (maybe fixing the first line). But it's easier to just use:: # install to /usr/local/bin python ./setup.py install --prefix /usr/local # install to your Home directory (~/bin) python ./setup.py install --home ~ Please mind: This effects also the installation of pyPdf (and setuptools) if they are not already installed. For more information about Custom Installation Locations please refer to the `Custom Installation Locations Instructions`__ before installing ``pdfjoin``. __ http://peak.telecommunity.com/DevCenter/EasyInstall#custom-installation-locations