1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/README	Thu Aug 29 13:58:17 2013 +0200
     1.3 @@ -0,0 +1,53 @@
     1.4 +pdfconcat
     1.5 +---------
     1.6 +
     1.7 +This program concatenates PDF files and optionally converts text
     1.8 +within them into bitmaps. The concatenation is done with Ghostscript (gs);
     1.9 +the detextification is done with a gs-conversion to tiff and tiff2pdf
    1.10 +(package libtiff-tools) afterwards. Detextification is only in gray-scale.
    1.11 +
    1.12 +
    1.13 +Contents:
    1.14 +
    1.15 +- bin/pdfconcat		shell script to concatenate PDF files
    1.16 +- bin/pdfdetextify	shell script to convert text to images in PDF files
    1.17 +- pdfconcat.php		web interface to invoke the scripts
    1.18 +
    1.19 +- log			log file of web interface invocations (writable)
    1.20 +- bin/monthly		shell script to sum up the usage by month
    1.21 +
    1.22 +- upload/		directory to store the converted files (writable)
    1.23 +- bin/cleanup.cron	helper script to remove old uploaded files
    1.24 +
    1.25 +- .user.ini		php config file to increase the max upload file size
    1.26 +
    1.27 +
    1.28 +Installation:
    1.29 +
    1.30 +You need a Unix system. Ensure you have gs and tiff2pdf (in the package
    1.31 +libtiff-tools) available.
    1.32 +
    1.33 +To use the bin/pdf* tools on the command line only, copy them to your $PATH
    1.34 +and make them executable.
    1.35 +
    1.36 +To set up the program including the web interface, copy the files to a place
    1.37 +below the webserver root. Make bin/pdf{concat,detextify} executable for
    1.38 +www-data. Make the log and the upload directory writable by www-data. Install
    1.39 +a cronjob to clean up the upload directory. Ensure that the max upload file
    1.40 +size of PHP is large enough.
    1.41 +
    1.42 +
    1.43 +More or less helpful information sources on the PDF conversion:
    1.44 +
    1.45 +	http://stackoverflow.com/questions/6002261/pdf-to-tiff-imagemagick-problem
    1.46 +	http://www.asmail.be/msg0055376363.html
    1.47 +	http://kvz.io/blog/2007/11/28/php-tiff2pdf/
    1.48 +	http://phpdave.wordpress.com/tag/php-pdf-to-tiff/
    1.49 +
    1.50 +
    1.51 +2013, markus schnalke <meillo@marmaro.de>
    1.52 +Written at KIT-Library, Karlsruhe.
    1.53 +
    1.54 +This program is in the public domain. -- Dieses Programm hat nicht die
    1.55 +notwendige Schoepfungshoehe um urheberrechtlich geschuetzt zu sein. If
    1.56 +you though need a license, use it under the CC0 license.