Archive/Usage/Offline images

From XOWA: the free, open-source, offline wiki application


Overview

XOWA displays images by using online downloads as specified in Dev/File/Setup. However, XOWA can also be setup to use offline sources. If you have the time and storage space, you can download all the images for your wiki and run them from a hard drive. Note that the full tarball set for English Wikipedia is over 2 TB and may take 15 days to download and unzip. Even a small wiki like Simple Wikipedia requires 56 GB. Please prepare accordingly.

Download tarball

Unzip tarball

  • If you are on a Windows system, the current version of 7-Zip does not handle UTF-8 filenames (it default to CP-1252). You will need to download the latest 7-Zip alpha (I used 9.27).
You can try the latest alpha here: http://sourceforge.net/projects/sevenzip/forums/forum/45797/topic/6063877
  • Unzip the tarball to the hard-drive's root.
For example, on a Windows 7 system with a hard drive mounted at W, unzip to W:\. This will create a directory called W:\wikipedia\common\.

Change config file

Two changes will have to be made to the config file:

  1. commons source
    1. Search for the following: .set('src_http_commons', 'http://upload.wikimedia.org/wikipedia/commons/' , 'commons.wikimedia.org' ).ext_rules_('img_only').owner
    2. Replace it with the following: .set('src_http_commons', 'W:\wikipedia\commons\' , 'commons.wikimedia.org' ).fsys_('wnt').tarball_('y').ext_rules_('img_only').owner
  2. wiki source
    1. Search for the following: .set('src_http_~{wiki_key}', 'http://upload.wikimedia.org/~{wiki_type_name}/~{wiki_lang}/' , '~{wiki_key}').ext_rules_('img_only').owner
    2. Replace it with the following: .set('src_http_~{wiki_key}', 'W:\~{wiki_type_name}\~{wiki_lang}\' , '~{wiki_key}').fsys_('wnt').tarball_('y').ext_rules_('img_only').owner

Note: the .fsys_('wnt') is not needed for Linux systems. It is a "hack" for Windows systems to handle File titles that have invalid Windows NT filesystem characters (such as " or :)

Known limitations

  • The tarballs do not come with thumbnails for video or pdf files. XOWA will show them as blank.
These thumbnails are generated with other programs. Future versions of XOWA will try to generate them.
  • imageMagick/inkscape will improperly identify sizes for certain svgs.
For example, on en.wikipedia.org/wiki/Earth, Earth-Moon.svg is 512x320
imageMagick incorrectly identifies it as 1000,1000.
inkscape incorrectly identifies it as 1991,316. It provides an X,Y of -825,-2.9 which doesn't help.
  • inkscape will improperly show artifacts in certain svgs.
For example, on en.wikipedia.org/wiki/France, France_location_map-Regions_and_departements.svg will have random black lines around Paris

Offline thumbnails

Dumping all the thumbnails in a wiki is currently being implemented. See Dev/Design/Offline_files

Namespaces

XOWA

Getting started

Android

Help

Blog

Donate