zimwriterfs

L'application zimwriterfs est un outil en ligne de commande destiné à produire une archive au format ouvert ZIM) à partir d'un répertoire local contenant un site web fonctionnant hors-ligne (avec images, code Javascript et feuilles de style CSS). Le fichier généré peut être lu à l'aide d'un lecteur ZIM tel que par exemple Kiwix.

zimwriterfs est un outil autonome développé par la fondation opemzim. Auparavant, il faisait partie des autres outils mis à disposition par l'auteur de Kiwix.

Parmi les contenus accessibles hors ligne à ce format, on compte Wikipédia dans toutes les langues, la collection des livres de la communauté Wikipedia mais aussi la documentation hors ligne de Ubuntu.

D'autres outils permettent la construction de fichiers ZIM mais ils sont intrinsèquement liés au wiki MediaWiki.

• Disposer des droits d'administration.
• Disposer d'une connexion à Internet configurée et activée.
• Avoir installé la GNU autotools suite automake et autoconf
• Avoir installé le paquet liblzma5 - librairie de compression au format XZ et celui de développement liblzma-dev (http://tukaani.org/xz/)
• Avoir installé le paquet libmagic1 - librairie de recherche des types MIME des fichiers et celui de développement libmagic-dev (http://www.darwinsys.com/file/)
• gcc - le compilateur C ou tout autre compilateur C;
• g++ - le compilateur C++ ou tout autre compilateur C++
• pkg-config
• zlib1g-dev
• libtool
• checkinstall (optionnel). Ce paquet permet de créer un paquet deb, valide uniquement sur le pc, permettant une désinstallation du logiciel directement par le gestionnaire de paquet. Voir Compilation sous Ubuntu

zimwriterfs.cpp:21:19: erreur fatale: magic.h : Aucun fichier ou dossier de ce type

 > configure: error: lzma header files not found

• Avoir installé le paquet script de prise en charge de bibliothèque générique

Le package libzim n'est pas disponible dans les dépôts. Il faut

1. récupérer les sources sur http://openzim.org/download (testé avec la version la plus récente du moment : zimlib-1.2.tar.gz 08-Jun-2014).
2. les compiler et les installer avec la séquence de commandes suivantes

./configure  ; make; make install

cp /usr/local/lib/libzim* /usr/lib

• Avoir installé le paquet library implementation of ZIM specifications et celui de développement libzim-dev (http://openzim.org/download)

zimwriterfs.cpp:23:35: fatal error: zim/writer/zimcreator.h: Aucun fichier ou dossier de ce type
 #include <zim/writer/zimcreator.h>

Pour récupérer une version du code source, il faut télécharger l'archive directement sur zimwriterfs. Il est possible de choisir le type d'archive. Puis, il faut le décompresser et se rendre dans zimwriterfs.

Lancer la génération du Makefile:

./autogen.sh

Puis la configuration de zimwriterfs:

./configure

Puis la compilation:

make

Et enfin l'installation:

sudo make checkinstall

Ou bien (déconseillé):

sudo make install

Lancez l'application via le terminal (toutes versions d'Ubuntu) avec la commande suivante :

zimwriterfs 

Sans argument, vous obtiendrez la sortie suivante :

You have too few arguments!
zimwriterfs --welcome=index.html --favicon=m/favicon.png --language=fra --title=foobar --description=mydescription --creator=Wikipedia --publisher=Kiwix [--minChunkSize=1024] DIRECTORY ZIM
	DIRECTORY is the path of the directory containing the HTML pages you want to put in the ZIM file,
	ZIM       is the path of the ZIM file you want to obtain.

Il est nécessaire de spécifier tous les paramètres (y compris le favicon).

• Le DIRECTORY désigne un chemin vers un répertoire contenant votre un site web fonctionnant hors-ligne
• les paramètres welcome et favicon désignent des chemins relatifs à DIRECTORY

• (en) Site officiel du logiciel zimwriterfs
• (en) La spécification du format ZIM
• (en) Lecteurs ZIM (avec/sans GUI, en python, en java…)
• (en) Liste d'outils pour construire des fichiers ZIM

Contributeurs principaux : nicolah, Darkjam.