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