Internet Archive Upload Tool

A small tool to import DjVu files from Internet Archive to Wikimedia Commons. See it in operation at ia-upload.wmcloud.org (or the test site at ia-upload-test.wmcloud.org) and read the documentation at wikitech.wikimedia.org/wiki/Tool:IA_Upload.

Please report bugs on Phabricator under the #IA Upload project.

Prerequesites

The actual format conversions are done by the following external tools, called from within IA Upload:

1. ImageMagick
2. DjVuLibre

Installation

1. Clone from GitHub: git clone https://github.com/wikisource/ia-upload

2. Install dependencies: composer install

3. Set up URL rewriting:

   • For Apache use the following in public/.htacess:

     RewriteEngine On
     RewriteCond %{REQUEST_FILENAME} !-f
     RewriteRule ^(.*)$ index.php/$1 [L]
     

   • For Lighttpd, use:

     url.rewrite-if-not-file += ( "/(.*)" => "/index.php$0" )
     

4. Register an OAuth consumer on Meta with a callback to e.g. http://localhost/ia-upload/public/oauth/callback (i.e. ending in oauth/callback) and rights to "Create, edit, and move pages" and "Upload new files".

5. Edit config.ini to add your consumer key and secret, and the OAuth consumer's ID number (this is used to link to recent changes).

6. Make sure the jobqueue directory is writable by the web server.