4
edits
Difference between revisions of "Build your ZIM file"
Jump to navigation
Jump to search
→zimwriterfs: Fixed broken link
(→zimwriterfs: Fixed broken link) |
|||
| (10 intermediate revisions by 2 users not shown) | |||
| Line 28: | Line 28: | ||
=== Create a ZIM file from existing HTML contents === | === Create a ZIM file from existing HTML contents === | ||
See | See [[Zimwriterfs instructions]] for an overview and read the section below on zimwriterfs for some additional context. | ||
== Developers == | == Developers == | ||
| Line 35: | Line 35: | ||
=== MWoffliner === | === MWoffliner === | ||
MWoffliner is a tool which allows to "dump" a Wikimedia project (Wikipedia, Wiktionary, ...) to a local storage. It should also work for any Mediawiki instance | MWoffliner is a tool which allows to "dump" a Wikimedia project (Wikipedia, Wiktionary, ...) to a local storage. It should also work for any [https://mediawiki.org Mediawiki] instance. It goes through all articles (or a selection if specified) of the project and write HTML/pictures to your local filesystem as plain HTML/JS/CSS/... files or in a ZIM file. | ||
It is distributed via [https://www.npmjs.com/package/mwoffliner npm] and [https://hub.docker.com/r/openzim/mwoffliner Docker]. | |||
If you are a developer, you can download it directly from its [https://github.com/openzim/mwoffliner git repository]. | |||
=== zimwriterfs === | === zimwriterfs === | ||
zimwriterfs is a console tool to create ZIM files from a localy stored directory containing a "self-sufficient" HTML content (with pictures, javascript, stylesheets). The result will contain all the files of the local directory compressed and merged in the ZIM file. Nothing more, nothing less. For now, zimwriterfs only works on POSIX compatible systems. You simply need to compile it and run it. The software does not need a lot of resources, but if you create a pretty big ZIM files, then it could take a while to complete. | zimwriterfs is a console tool to create ZIM files from a localy stored directory containing a "self-sufficient" HTML content (with pictures, javascript, stylesheets). The result will contain all the files of the local directory compressed and merged in the ZIM file. Nothing more, nothing less. For now, zimwriterfs only works on POSIX compatible systems. You simply need to compile it and run it. The software does not need a lot of resources, but if you create a pretty big ZIM files, then it could take a while to complete. | ||
Instructions on how to prepare and use zimwriterfs are here [[zimwriterfs_instructions]] | Instructions on how to prepare and use zimwriterfs are here [[zimwriterfs_instructions]] | ||
[https://github.com | [https://github.com/openzim/zimwriterfs Go to zimwriterfs source code repository]. | ||
A virtual machine with zimwriterfs is provided [http://download.kiwix.org/dev/ZIMmaker.ova here]. | A virtual machine with zimwriterfs is provided [http://download.kiwix.org/dev/ZIMmaker.ova here]. | ||
| Line 78: | Line 78: | ||
===zimmer=== | ===zimmer=== | ||
The [https://github.com/vss-devel/zimmer zimmer] package allows creating a ZIM dump from | The [https://github.com/vss-devel/zimmer zimmer] package allows creating a ZIM dump from a Mediawiki-based wiki. This package is relatively easy to install and supports both old and new versions of Mediawiki. It is a kind of an alternative to MWoffliner. | ||
The package consists of two Node.js scripts: | The package consists of two Node.js scripts: | ||
* ''wikizimmer.js'' -- creates static HTML files from the wiki's articles | * ''wikizimmer.js'' -- creates static HTML files from the wiki's articles. It requires public access both to the normal web interface and to the wiki's API interface. Unlike mwoffliner, this script does not require Redis | ||
* ''zimmer.js'' -- creates a ZIM file from the static HTML files (without requiring the libzim). | |||
* ''zimmer.js'' -- creates a ZIM file from the static HTML files | |||
== See also == | == See also == | ||
* [[ZIM File Archive]] | * [[ZIM File Archive]] | ||
* [[Bindings]] | * [[Bindings]] | ||
* [[ | * [[Readers]] | ||