From e189592768bc79c93d4ef51e053fdb21cbe3de61 Mon Sep 17 00:00:00 2001 From: Willy Date: Fri, 31 Oct 2025 00:30:43 +0100 Subject: [PATCH] Update README.md --- README.md | 29 ++++++++++++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 5192d8d..f581f81 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,29 @@ -# Archivage-ZIM +# Archivage-ZIM avec Kiwix et Zimit +Voici la méthode que j'utilise afin d'archiver une page web ou bien un site internet complet pour une lecture hors ligne. + +J'utilise un serveur Kiwix afin de lire mes archives ZIM, l'outil Zimit pour créer les archives et celle-ci sont stockées sur un serveur externe au service. + +:one: Créer un utilisateur/mdp sur le serveur de stockage ainsi qu'un dossier de partage smb/cifs avec les droits qui vont bien. + +:two: Installer le paquet `cifs-utils` sur le serveur Kiwix, puis monter le partage à l'emplacement voulu ici : `/srv/kiwix` +> :arrow_forward: Exemple fstab : +>``` +>//serveur-de-stockage/kiwix /srv/kiwix cifs credentials=/etc/.smbcredentials-kiwix,uid=0000,gid=000,file_mode=0770,dir_mode=0770,iocharset=utf8 0 0 +>``` +:warning: J'utilise pour l'authentification un fichier de conf credentials, afin de ne pas laisser en clair le user/pass, car le fichier fstab est par défaut autorisé en lecture par tous, ne pas oublier d'adapter également uid et gid. + +> :arrow_forward: Exemple credentials : +>``` +>username=user +>password=MotDePasse +>``` + +:three: Ce [docker-compose](https://git.selfitdeploy.com/Willy/Archivage-ZIM/src/branch/main/docker-compose.yml) pour déployer le serveur Kiwix. + +:four: Cette commande pour exécuter un archivage web en fichier zim : + +``` +docker run --rm -it -v /srv/kiwix/zim:/output ghcr.io/openzim/zimit zimit --seeds="https://lien-du-site" --name="nom-de-l'archive" --title="titre-de-l'archive" --output=/output --pageLimit=20 --waitUntil=networkidle0 --workers=4 --scopeExcludeRx="(\?q=|signup-landing\?|\?cid=)" +``` +> Plus d'infos sur les variables dans le dépot du projet https://github.com/openzim/zimit \ No newline at end of file