Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
utilisateurs:nicolah:zimwriterfs [Le 20/05/2017, 11:49] – tags L'Africainutilisateurs:nicolah:zimwriterfs [Le 20/05/2017, 11:49] (Version actuelle) – doublon L'Africain
Ligne 1: Ligne 1:
-{{tag>Trusty logiciels archivage html}} 
  
----- 
- 
-====== zimwriterfs ====== 
- 
-L'application **[[http://sourceforge.net/p/kiwix/other/ci/master/tree/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). 
-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]]. 
- 
-zimwriterfs est un outil autonome faisant partie des [[http://sourceforge.net/p/kiwix/other/ci/master/tree/|autres outils]] mis à disposition par l'auteur de Kiwix. Kiwix est diffusé sous licence [[http://fr.wikipedia.org/wiki/Licence_publique_g%C3%A9n%C3%A9rale_GNU|GPL v3]] et zimwriterfs a une dépendance pour une bibliothèque diffusée sous licence [[http://www.apache.org/licenses/LICENSE-2.0|Apache V2]]. 
- 
-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]]. 
- 
-[[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]]. 
- 
-===== 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|outil de création de « Makefiles » conformes aux standards GNU]]**  et  **[[apt>autoconf|créateur de scripts de configuration automatique]]** 
-  * Avoir [[:tutoriel:comment_installer_un_paquet|installé le paquet]] **[[apt>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|librairie de recherche des types MIME des fichiers]]**  et celui de développement **[[apt>libmagic-dev]]** ([[http://www.darwinsys.com/file/]]) 
- 
-<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 [[http://doc.ubuntu-fr.org/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  ===== 
- 
-Récupérer une version du code source  
-soit en récupérant manuellement  un //[[http://sourceforge.net/p/kiwix/other/ci/master/tarball?path=/zimwriterfs|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  
-  
-===== Utilisation===== 
- 
-Lancez l'application via le [[:terminal]] (toutes versions d'Ubuntu) avec la [[:commande_shell|commande]] suivante : 
-  zimwriterfs  
- 
-Sans argument, vous obtiendrez la sortie suivante :   
-<code> 
-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. 
-</code> 
-Il est nécessaire de spécifier tous les paramètres (y compris le //[[http://fr.wikipedia.org/wiki/Favicon|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 ===== 
-<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]].</note> 
-===== Voir aussi ===== 
- 
-  * **(en)** [[http://sourceforge.net/p/kiwix/other/ci/master/tree/zimwriterfs/|Site officiel du logiciel zimwriterfs]] 
-  * **(en)** [[http://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)** [[http://www.openzim.org/wiki/Build_your_ZIM_file|Liste d'outils pour construire des fichiers ZIM]] 
- 
----- 
- 
-//Contributeurs principaux : [[utilisateurs:nicolah|nicolah]].//