Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
zimwriterfs [Le 27/02/2016, 18:48] 90.31.28.121 [Pré-requis] |
zimwriterfs [Le 11/09/2022, 11:37] (Version actuelle) moths-art Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892) |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
- | {{tag>Precise Trusty logiciels archivage html}} | + | {{tag>Focal logiciels archivage html}} |
---- | ---- | ||
Ligne 5: | Ligne 5: | ||
====== zimwriterfs ====== | ====== zimwriterfs ====== | ||
- | L'application **[[https://git.wikimedia.org/tree/openzim.git/HEAD/zimwriterfs|zimwriterfs]]** est un outil en ligne de commande destiné à produire une archive au format ouvert [[http://www.openzim.org|ZIM]]) à partir d'un répertoire local contenant un site web fonctionnant hors-ligne (avec images, code Javascript et feuilles de style CSS). | + | L'application **[[hthttp://www.google.com/tp://www.openzim.org/wiki/Build_your_ZIM_file|zimwriterfs]]** est un outil en ligne de commande destiné à produire une archive au format ouvert [[http://www.openzim.org|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 [[http://openzim.org/wiki/ZIM_Readers|lecteur ZIM]] tel que par exemple [[http://www.kiwix.org|Kiwix]]. | + | Le fichier généré peut être lu à l'aide d'un [[https://openzim.org/wiki/ZIM_Readers|lecteur ZIM]] tel que par exemple [[:Kiwix]]. |
zimwriterfs est un outil autonome développé par la fondation [[http://www.openzim.org|opemzim]]. Auparavant, il faisait partie des [[http://sourceforge.net/p/kiwix/other/ci/master/tree/|autres outils]] mis à disposition par l'auteur de Kiwix. | zimwriterfs est un outil autonome développé par la fondation [[http://www.openzim.org|opemzim]]. Auparavant, il faisait partie des [[http://sourceforge.net/p/kiwix/other/ci/master/tree/|autres outils]] mis à disposition par l'auteur de Kiwix. | ||
- | Parmi les contenus accessibles hors ligne à ce format, on compte [[http://www.kiwix.org/wiki/Wikipedia_in_all_languages/fr|Wikipédia dans toutes les langues]], la [[https://en.wikipedia.org/wiki/Category:Wikipedia_books_%28community_books%29|collection des livres de la communauté Wikipedia]] mais aussi la [[http://doc.ubuntu-fr.org/documentation_hors_ligne|documentation hors ligne de Ubuntu]]. | + | Parmi les contenus accessibles hors ligne à ce format, on compte [[http://www.kiwix.org/wiki/Wikipedia_in_all_languages/fr|Wikipédia dans toutes les langues]], la [[wp>Category:Wikipedia_books_%28community_books%29|collection des livres de la communauté Wikipedia]] mais aussi la [[:documentation_hors_ligne|documentation hors ligne d'Ubuntu]]. |
- | [[http://openzim.org/wiki/Build_your_ZIM_file|D'autres outils permettent la construction de fichiers ZIM]] mais ils sont intrinsèquement liés au wiki [[http://www.mediawiki.org/wiki/MediaWiki/fr|MediaWiki]]. | + | [[https://openzim.org/wiki/Build_your_ZIM_file|D'autres outils permettent la construction de fichiers ZIM]] mais ils sont intrinsèquement liés au wiki [[http://www.mediawiki.org/wiki/MediaWiki/fr|MediaWiki]]. |
- | ===== Pré-requis ===== | ||
- | * Disposer des [[:sudo|droits d'administration]]. | ||
- | * Disposer d'une connexion à Internet configurée et activée. | ||
- | * Avoir installé la GNU autotools suite **[[apt>automake|automake]]** et **[[apt>autoconf|autoconf]]** | ||
- | * Avoir [[:tutoriel:comment_installer_un_paquet|installé le paquet]] **[[apt>liblzma5|liblzma5 - librairie de compression au format XZ]]** et celui de développement **[[apt>liblzma-dev]]** ([[http://tukaani.org/xz/]]) | ||
- | * Avoir [[:tutoriel:comment_installer_un_paquet|installé le paquet]] **[[apt>libmagic1|libmagic1 - librairie de recherche des types MIME des fichiers]]** et celui de développement **[[apt>libmagic-dev]]** ([[http://www.darwinsys.com/file/]]) | ||
- | * **[[apt>gcc|gcc - le compilateur C]]** ou tout autre compilateur C; | ||
- | * **[[apt>g++|g++ - le compilateur C++]]** ou tout autre compilateur C++ | ||
- | * **[[apt>pkg-config]]** | ||
- | * **[[apt>zlib1g-dev]]** | ||
- | * **[[apt>libtool]]** | ||
- | * **[[apt>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|Compilation sous Ubuntu]] | ||
- | |||
- | <note important>Le fichier README spécifie ces dépendances mais ne précise pas qu'il faut aussi installer les paquets de développement. | ||
- | Si vous ne le faites pas, vous risquez d'observer les messages d'erreur de la sorte lors de la compilation : | ||
- | <code>zimwriterfs.cpp:21:19: erreur fatale: magic.h : Aucun fichier ou dossier de ce type</code> | ||
- | ou <code> > configure: error: lzma header files not found</code> | ||
- | </note> | ||
- | |||
- | ==== Pré-requis sur Ubuntu 12.04 ==== | ||
- | |||
- | * Avoir [[:tutoriel:comment_installer_un_paquet|installé le paquet]] **[[apt>libtool|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 | ||
- | - 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). | ||
- | - les compiler et les installer avec la [[:tutoriel/compilation|séquence de commandes suivantes]] | ||
- | <code>./configure ; make; make install</code> | ||
- | |||
- | <note important> | ||
- | Si une fois zimwriterfs installée, vous obtenez le message suivant à l'exécution | ||
- | [[http://sourceforge.net/p/kiwix/discussion/604122/thread/bc4b6d0f|zimwriterfs: error while loading shared libraries: libzim.so.0: cannot open shared object file: No such file or directory]] alors une solution possible est de copier les fichiers // /usr/local/lib/libzim*// dans // /usr/lib// | ||
- | <code>cp /usr/local/lib/libzim* /usr/lib</code> | ||
- | </note> | ||
- | ==== Pré-requis sur Ubuntu 14.04 ==== | ||
- | |||
- | * Avoir [[:tutoriel:comment_installer_un_paquet|installé le paquet]] **[[apt>libzim0|library implementation of ZIM specifications]]** et celui de développement **[[apt>libzim-dev]]** ([[http://openzim.org/download]]) | ||
- | |||
- | <note important>Ne pas oublier le paquet développement sans quoi vous observerez le message d'erreur suivant à la compilation | ||
- | <code>zimwriterfs.cpp:23:35: fatal error: zim/writer/zimcreator.h: Aucun fichier ou dossier de ce type | ||
- | #include <zim/writer/zimcreator.h></code> | ||
- | </note> | ||
===== Installation ===== | ===== Installation ===== | ||
- | Pour récupérer une version du code source il faut télécharger l'archive directement sur //[[https://git.wikimedia.org/tree/openzim.git/HEAD/zimwriterfs|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 | + | *[[:PPA|Ajouter le PPA]] **ppa:kiwixteam/release**((https://launchpad.net/~kiwixteam/+archive/ubuntu/release)) dans vos sources de logiciels; |
- | ./autogen.sh | + | *[[:tutoriel:comment_installer_un_paquet|Installer le paquet]] **[[apt>zimwriterfs]]**. |
- | Puis la configuration de zimwriterfs | + | * |
- | ./configure | + | |
- | Puis la compilation | + | |
- | make | + | |
- | Et enfin l'installation | + | |
- | sudo make checkinstall | + | |
- | Ou bien (déconseillé) | + | |
- | sudo make install | + | |
- | + | ||
- | <note help>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é)</note> | + | |
===== Utilisation===== | ===== Utilisation===== | ||
Ligne 76: | Ligne 25: | ||
zimwriterfs | zimwriterfs | ||
- | Sans argument, vous obtiendrez la sortie suivante : | + | Sans argument, vous obtiendrez la sortie suivante : |
- | <code> | + | <code bash> |
You have too few arguments! | 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 | + | zimwriterfs --welcome=index.html --favicon=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, | 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. | ZIM is the path of the ZIM file you want to obtain. | ||
</code> | </code> | ||
- | Il est nécessaire de spécifier tous les paramètres (y compris le //[[http://fr.wikipedia.org/wiki/Favicon|favicon]]//). | + | Il est nécessaire de spécifier tous les paramètres (y compris le //[[wpfr>Favicon|favicon]]//). |
- | * Le //DIRECTORY// désigne un chemin vers un répertoire contenant votre un site web fonctionnant hors-ligne | + | *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// | + | *les paramètres //welcome// et //favicon// désignent des chemins relatifs à //DIRECTORY// |
- | ===== Avertissement ===== | + | Exemple de commande complète : |
- | <note warning>Le lecteur Kiwix vous permet de tester les ZIM que vous produisez. Mais attention, la version de [[http://sourceforge.net/projects/kiwix/|Kiwix for linux]] //0.9-rc2// [[http://sourceforge.net/p/kiwix/bugs/702/|présente un bug connu]] : affichage d'un icone //lien cassé// à la place d'images attendues. Pour remédier à ce problème télécharger la [[http://download.kiwix.org/nightly/bin/latest/|version de Kiwix la plus récente en cours de développement]]. FIXME Lien cassé, pas de version de développement.</note> | + | <code bash> |
- | <note important>Le problème a été résolu dans la dernière version stable de [[http://download.kiwix.org/bin/0.9/|Kiwix]]. Vérifié pour la version 64bits. A vérifier pour la version 32bits</note> | + | zimwriterfs --welcome=votre_fichier_d’index.html --favicon=votre_image.png --language=fra --description="La description de votre zim" --creator="L’auteur du zim" --publisher="L’éditeur du zim" --title="Le titre de votre zim" -v ./le_chemin_vers_vos_fichiers_htlml Le_nom_de_votre_zim_final.zim</code> |
===== Voir aussi ===== | ===== Voir aussi ===== | ||
- | * **(en)** [[http://sourceforge.net/p/kiwix/other/ci/master/tree/zimwriterfs/|Site officiel du logiciel zimwriterfs]] | + | ***(en)** [[https://github.com/openzim/zim-tools|Site officiel du logiciel zimwriterfs]] |
- | * **(en)** [[http://www.openzim.org/wiki/ZIM_file_format|La spécification du format ZIM]] | + | ***(en)** [[https://www.openzim.org/wiki/ZIM_file_format|La spécification du format ZIM]] |
- | * **(en)** [[http://www.openzim.org/wiki/Readers|Lecteurs ZIM]] (avec/sans GUI, en python, en java...) | + | ***(en)** [[https://www.openzim.org/wiki/Readers|Lecteurs ZIM]] (avec/sans GUI, en python, en java...) |
- | * **(en)** [[http://www.openzim.org/wiki/Build_your_ZIM_file|Liste d'outils pour construire des fichiers ZIM]] | + | ***(en)** [[https://www.openzim.org/wiki/Build_your_ZIM_file|Liste d'outils pour construire des fichiers ZIM]] |
+ | *[[:Zimmer]] alternative à zimwriterfs. | ||
---- | ---- | ||
//Contributeurs principaux : [[:utilisateurs:nicolah|nicolah]], [[:utilisateurs:darkjam|Darkjam]].// | //Contributeurs principaux : [[:utilisateurs:nicolah|nicolah]], [[:utilisateurs:darkjam|Darkjam]].// |