Ceci est une ancienne révision du document !



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 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.

Le fichier README spécifie ces dépendances mais ne précise pas qu'il faut aussi installer les paquets de développement.

Pré-requis sur Ubuntu 12.04

Pré-requis sur Ubuntu 14.04

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 :

git clone git://git.code.sf.net/p/kiwix/other kiwix-other

Puis lancer la compilation de zimwriterfs

./autogen.sh

Puis

./configure

Et enfin

make

Et

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

Si vous considérez que votre contribution à la page de documentation est significative et/ou que vous souhaitez pouvoir être contacté par les lecteurs, vous avez la possibilité de la signer en ajoutant votre identifiant dans la ligne ci-dessous. Vous pouvez aussi vous abonner aux modifications de la page en cliquant sur "S'abonner à la page" (menu en haut à gauche).

Contributeurs principaux : votre nom ou pseudonyme, nom ou pseudo autre.

Si vous vous êtes basé sur un document existant pour écrire votre article, citez la source originale ! Ceci est indispensable afin de respecter les droits d'auteur.

Basé sur « Titre original de l'article » par Auteur Original.

—[ Modèle à copier/coller ]—

modèle_application
{{tag>Trusty BROUILLON}}
----
 
====== Nom affiché de l'application ======
 
[DESCRIPTION DE L'APPLICATION]
 
===== Pré-requis =====
 
  * Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.
  * Avoir activé l'accès au [[:depots#medibuntu|dépôt Medibuntu]].
  * Avoir [[:tutoriel:comment_installer_un_paquet|installé le paquet]] **[[apt>paquet1|paquet 1]]**.
[AUTRES PRÉ-REQUIS NÉCESSAIRES]
 
===== Installation =====
 
Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer les paquets]] **[[apt>paquet1,paquet2,paquet3|paquet1 paquet2 paquet3]]**.
 
Puis, …
 
===== Configuration =====
 
Tout d'abord, [[:tutoriel:comment_modifier_un_fichier|ouvrez le fichier]] **/truc/machin/bidule** en modification puis …
 
===== Utilisation =====
 
Lancez l'application via le [[:unity#tableau_de_bord_dash|dash]] (Unity) ou via le [[:terminal]] (toutes versions d'Ubuntu) avec la [[:commande_shell|commande]] suivante :
<code>machin-chose</code>
 
===== Désinstallation =====
 
Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
 
===== Voir aussi =====
 
  * **(en)** [[Site officiel du logiciel]]
  * **(fr)** [[Site de la communauté francophone du logiciel Bidule]]
  * [[http://forum.ubuntu-fr.org/viewtopic.php?id=64840|Discussion « J'ai un soucis avec le logiciel Bidule »]] sur le forum Ubuntu-fr
 
----
//Contributeurs principaux : [[utilisateurs:votre_identifiant|votre nom ou pseudonyme]], [[utilisateurs:autre_identifiant|nom ou pseudo autre]].//
 
//Basé sur [[http://www.document_source.com|« Titre original de l'article »]] par Auteur Original.//
  • utilisateurs/nicolah/zimwriterfs.1412803800.txt.gz
  • Dernière modification: Le 08/10/2014, 23:30
  • par nicolah