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 faisant partie des autres outils mis à disposition par l'auteur de Kiwix. Kiwix est diffusé sous licence GPL v3 et zimwriterfs a une dépendance pour une bibliothèque diffusée sous licence Apache V2.
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.
zimwriterfs.cpp:21:19: erreur fatale: magic.h : Aucun fichier ou dossier de ce type
ou
> configure: error: lzma header files not found
Le package libzim n'est pas disponible dans les dépôts. Il faut
./configure ; make; make install
cp /usr/local/lib/libzim* /usr/lib
zimwriterfs.cpp:23:35: fatal error: zim/writer/zimcreator.h: Aucun fichier ou dossier de ce type #include <zim/writer/zimcreator.h>
Récupérer une version du code source soit en récupérant manuellement un snapshot de kiwix-other ou bien en clonant le dépôt (30 Mib) :
git clone git://git.code.sf.net/p/kiwix/other kiwix-other
Se rendre dans le dossier kiwix-other/zimwriterfs/ puis lancer la configuration de zimwriterfs
./autogen.sh
Puis
./configure
Et la compilation
make
Et enfin l'installation
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).