zimwriterfs

Un bug empêche la création de zim assez gros sous Ubuntu 16.04. Pour suivre son évolution et son éventuel résolution, voir ici.

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.

Pré-requis

Il est également nécessaire d'installer la dernière version de xapian, pour cela :

Installation

Pour récupérer une version du code source, il faut télécharger l'archive directement sur github. Puis, il faut la décompresser et se rendre dans le dossier openzim-master. Une fois dans le dossier, ouvrez-y un terminal et exécutez les commandes suivantes :

cd ../zimlib && ./autogen.sh && ./configure && make && cd ../zimwriterfs

Lancer la génération du Makefile:

./autogen.sh

Puis la configuration de zimwriterfs :

./configure CXXFLAGS=-I../zimlib/include LDFLAGS=-L../zimlib/src/.libs

Puis la compilation :

make

Et enfin l'installation :

sudo make checkinstall

Ou bien (déconseillé) :

sudo make install
Si la compilation échoue, vérifiez bien que toutes les dépendances sont installées (la sortie du ./autogen.sh est assez explicite sur les dépendances) et que le make n'a pas été lancé en tant que super-utilisateur ( Erreurs de DMO et de FLAGS non déclarés).

Utilisation

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

Avertissement

Le lecteur Kiwix vous permet de tester les ZIM que vous produisez. Mais attention, la version de Kiwix for linux 0.9-rc2 présente un bug connu : affichage d'une icône lien cassé à la place des images attendues. Pour remédier à ce problème télécharger la version de Kiwix la plus récente en cours de développement. FIXME Lien cassé, pas de version de développement.
Le problème a été résolu dans la dernière version stable de Kiwix. Vérifié pour la version 64bits. A vérifier pour la version 32bits.

Voir aussi


Contributeurs principaux : nicolah, Darkjam.

  • zimwriterfs.txt
  • Dernière modification: Le 28/04/2018, 11:19
  • (modification externe)