Difference between revisions of "Build your ZIM file"

From openZIM
Jump to navigation Jump to search
Line 1: Line 1:
[[Image:Schema ZIM File Creation.png|500px|right]]
[[Image:Schema ZIM File Creation.png|500px|right]]
There is for now only a few tools allowing people to create ZIM files.


== MediaWiki Collection Extension ==
== Users ==
The Collection extension for MediaWiki provides the ability to select articles and export them in different formats, such as PDF, ODF and ZIM. The main purpose of Collection extension is to create printed books - instead of export you can also choose to have the selected articles printed on demand as a real book.
You can create on Wikipedia and all other Wikimedia projects, ZIM files of article selections. [https://en.wikipedia.org/wiki/Special:Book For example on http://en,wikipedia.org]. This is based on the MediaWiki Collection Extension (see below).


The Collection extension can be easily added to any MediaWiki installation.
== Developers ==


* Get the extension here: http://www.mediawiki.org/wiki/Extension:Collection
=== MediaWiki Collection Extension ===
* Details on Collection and openZIM: http://www.mediawiki.org/wiki/Extension:Collection/openZIM
The Collection extension for MediaWiki provides the ability to select articles and export them in different formats, such as PDF, ODF and ZIM. The main purpose of Collection extension is to create printed books - instead of export you can also choose to have the selected articles printed on demand as a real book.
 
== ZIM Writer ==
<tt>zimwriter</tt> is part of the openZIM software package that can be downloaded here: [[Releases]].
 
This binary uses a pre-filled Postgres Database with a [http://svn.openzim.org/viewvc.cgi/trunk/zimwriter/db/zim-postgresql.sql?view=markup predefined scheme]. For example :
 
<source lang="bash">
zimwriter -s 1024
  --db "postgresql:dbname=mydb" my_zim_file
</source>


We want to provide in the future a binary able to work with other input (for example: Wikimedia Foundation XML dumps, or HTML directory).
The Collection extension can be easily added to any MediaWiki installation:
* [http://www.mediawiki.org/wiki/Extension:Collection Get the extension]
* [http://www.mediawiki.org/wiki/Extension:Collection/openZIM Details on Collection and openZIM]


One tool is currently able to create/fill this database:
== zimwriterdb ==
[[zimwriterdb]] is part of the openZIM project. This binary uses a pre-filled Postgres Database and create the corresponding ZIM file.


=== buildZimFileFromDirectory.pl ===
=== buildZimFileFromDirectory.pl ===
Line 35: Line 29:


== See also ==
== See also ==
* [[Publish your ZIM File]]
* [[Bindings]]
* [[Reader]]

Revision as of 20:16, 11 January 2013

Schema ZIM File Creation.png

There is for now only a few tools allowing people to create ZIM files.

Users

You can create on Wikipedia and all other Wikimedia projects, ZIM files of article selections. For example on http://en,wikipedia.org. This is based on the MediaWiki Collection Extension (see below).

Developers

MediaWiki Collection Extension

The Collection extension for MediaWiki provides the ability to select articles and export them in different formats, such as PDF, ODF and ZIM. The main purpose of Collection extension is to create printed books - instead of export you can also choose to have the selected articles printed on demand as a real book.

The Collection extension can be easily added to any MediaWiki installation:

zimwriterdb

zimwriterdb is part of the openZIM project. This binary uses a pre-filled Postgres Database and create the corresponding ZIM file.

buildZimFileFromDirectory.pl

This script is part of the Kiwix tools and allows to build a ZIM file from a HTML directory containing all necessary ressources.

You need:

  1. Checkout the dumping tools : svn co http://kiwix.svn.sourceforge.net/viewvc/kiwix/dumping_tools/
  2. Install all necessary Perl modules
  3. run the script like following: ./buildZimFileFromDirectory.pl --htmlPath=./html [--indexerPath=./zimindexer] [--zimFilePath=articles.zim]

Wiki2html

(can be used to prepare static HTML files from a running Mediawiki instance.)

See also