Skip to content

Tool to import DjVU files from the Internet Archive to Wikimedia Commons.

Notifications You must be signed in to change notification settings

wikisource/ia-upload

Repository files navigation

Internet Archive Upload Tool

CI

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

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)

  5. Edit config.ini to add your consumer key and secret

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