pdfconcat
annotate README @ 1:6ea97e3f7cb5
ignore log and upload, because they change in a live setup
| author | markus schnalke <meillo@marmaro.de> |
|---|---|
| date | Thu, 29 Aug 2013 13:59:09 +0200 |
| parents | |
| children |
| rev | line source |
|---|---|
| meillo@0 | 1 pdfconcat |
| meillo@0 | 2 --------- |
| meillo@0 | 3 |
| meillo@0 | 4 This program concatenates PDF files and optionally converts text |
| meillo@0 | 5 within them into bitmaps. The concatenation is done with Ghostscript (gs); |
| meillo@0 | 6 the detextification is done with a gs-conversion to tiff and tiff2pdf |
| meillo@0 | 7 (package libtiff-tools) afterwards. Detextification is only in gray-scale. |
| meillo@0 | 8 |
| meillo@0 | 9 |
| meillo@0 | 10 Contents: |
| meillo@0 | 11 |
| meillo@0 | 12 - bin/pdfconcat shell script to concatenate PDF files |
| meillo@0 | 13 - bin/pdfdetextify shell script to convert text to images in PDF files |
| meillo@0 | 14 - pdfconcat.php web interface to invoke the scripts |
| meillo@0 | 15 |
| meillo@0 | 16 - log log file of web interface invocations (writable) |
| meillo@0 | 17 - bin/monthly shell script to sum up the usage by month |
| meillo@0 | 18 |
| meillo@0 | 19 - upload/ directory to store the converted files (writable) |
| meillo@0 | 20 - bin/cleanup.cron helper script to remove old uploaded files |
| meillo@0 | 21 |
| meillo@0 | 22 - .user.ini php config file to increase the max upload file size |
| meillo@0 | 23 |
| meillo@0 | 24 |
| meillo@0 | 25 Installation: |
| meillo@0 | 26 |
| meillo@0 | 27 You need a Unix system. Ensure you have gs and tiff2pdf (in the package |
| meillo@0 | 28 libtiff-tools) available. |
| meillo@0 | 29 |
| meillo@0 | 30 To use the bin/pdf* tools on the command line only, copy them to your $PATH |
| meillo@0 | 31 and make them executable. |
| meillo@0 | 32 |
| meillo@0 | 33 To set up the program including the web interface, copy the files to a place |
| meillo@0 | 34 below the webserver root. Make bin/pdf{concat,detextify} executable for |
| meillo@0 | 35 www-data. Make the log and the upload directory writable by www-data. Install |
| meillo@0 | 36 a cronjob to clean up the upload directory. Ensure that the max upload file |
| meillo@0 | 37 size of PHP is large enough. |
| meillo@0 | 38 |
| meillo@0 | 39 |
| meillo@0 | 40 More or less helpful information sources on the PDF conversion: |
| meillo@0 | 41 |
| meillo@0 | 42 http://stackoverflow.com/questions/6002261/pdf-to-tiff-imagemagick-problem |
| meillo@0 | 43 http://www.asmail.be/msg0055376363.html |
| meillo@0 | 44 http://kvz.io/blog/2007/11/28/php-tiff2pdf/ |
| meillo@0 | 45 http://phpdave.wordpress.com/tag/php-pdf-to-tiff/ |
| meillo@0 | 46 |
| meillo@0 | 47 |
| meillo@0 | 48 2013, markus schnalke <meillo@marmaro.de> |
| meillo@0 | 49 Written at KIT-Library, Karlsruhe. |
| meillo@0 | 50 |
| meillo@0 | 51 This program is in the public domain. -- Dieses Programm hat nicht die |
| meillo@0 | 52 notwendige Schoepfungshoehe um urheberrechtlich geschuetzt zu sein. If |
| meillo@0 | 53 you though need a license, use it under the CC0 license. |