LE GUIDE DU REFUGE

Votre bibliothèque,
en toute simplicité.

Un site statique complet, sans dépendance à installer : les fichiers HTML, JavaScript, styles et images sont fournis ensemble.

Lire et organiser vos livres

Cliquez sur un livre pour ouvrir sa fiche. Choisissez Lire maintenant, À lire plus tard, Favoris ou Suivre les parutions. Les tomes sont présentés dans leur ordre de publication. La bibliothèque et le grenier présentent une œuvre par livre ; ses différents tomes restent accessibles dans la fiche et le lecteur.

Glissez un livre vers une autre étagère avec la souris, le doigt ou le stylet. Sur un écran tactile, touchez le bois entre les livres pour faire défiler les meubles. Le déplacement d’un livre ne fait pas défiler la page. Un repère doré indique l’étagère cible. Un espace occupé est ajusté pour limiter les chevauchements ; un nouveau meuble peut être créé si nécessaire.

Le bouton Choisir un emplacement dans la fiche permet aussi de ranger au clavier. Vue de tranche change l’apparence du livre. Ranger au grenier déplace l’œuvre sans perdre la progression. Le grenier possède une illustration unique.

Le lecteur propose page simple, double page, vertical, vertical double, horizontal et carrousel, dans les deux sens de lecture. La dernière page visible est enregistrée. Un changement d’ordre des pages conserve la reprise grâce à leurs identifiants. Si une page a été supprimée, la reprise utilise la position restante la plus proche. Ouvrir la dernière page marque le tome lu ; vous pouvez changer cet état avec Marquer le tome lu.

Installer ou mettre à jour avec FileZilla

1. Décompressez l’une des archives complètes. La version légère possède les mêmes fonctionnalités ; la version avec sources contient également les PNG originaux.
2. Ouvrez votre dossier de destination dans FileZilla, généralement le dossier public de votre hébergement.
3. Transférez le contenu de l’archive en conservant ses sous-dossiers. Le fichier index.html doit se trouver directement dans le dossier public.
4. Pour une mise à jour, envoyez d’abord les nouvelles images, puis les scripts/styles et enfin les deux fichiers contenu/catalogue.json et contenu/catalogue.js. Publiez ces deux catalogues ensemble pour éviter un décalage temporaire.
5. Ouvrez votre site en HTTPS et vérifiez la bibliothèque. Les préférences des visiteurs sont indépendantes du transfert et restent sur leurs appareils.

Le projet utilise des liens relatifs. Il peut fonctionner sur inkama.fr, pyranhas.com ou dans un sous-dossier. Dans l’atelier, modifiez l’Adresse principale avant d’exporter pour mettre à jour les métadonnées, le sitemap et les liens de partage. Le domaine et le DNS doivent déjà pointer vers votre hébergement.

Le fichier .htaccess propose uniquement des réglages Apache facultatifs. Sur un autre serveur, il est ignoré. Si votre hébergeur refuse les directives, retirez-le ; les fichiers statiques continuent de fonctionner. Les pages 403, 404 et 500 sont fournies ; leur association aux codes d’erreur dépend de l’hébergement.

Gérer le site sans toucher au code

Ouvrez administrateur.html ou gestion/index.html. Sur Windows, administrateur.bat est un raccourci facultatif : il ouvre la même interface dans votre navigateur. Sur iPhone, iPad, Android et Mac, utilisez directement la page HTML.

L’atelier est un éditeur local : il n’a pas d’accès en écriture au serveur. Il ne s’agit pas d’un espace d’administration protégé par mot de passe. Un visiteur peut préparer son propre brouillon dans son navigateur, mais ne peut pas modifier votre publication sans les accès à votre hébergement. Aucun identifiant FileZilla ne doit être saisi dans le site.

1. Auteurs : ajoutez le nom, l’image de profil, la biographie et le parcours.
2. Bandes dessinées : ajoutez une œuvre, associez son auteur, son résumé, ses catégories et sa couverture.
3. Ajoutez les tomes et leurs images. Les numéros sont propres à chaque œuvre. Les flèches permettent de changer l’ordre des tomes.
4. Sélectionnez plusieurs planches PNG/JPG. Elles sont classées par nom, puis peuvent être déplacées avec les flèches, remplacées, renommées ou supprimées. L’ajout est progressif, sans plafond de pages fixé dans le code.
5. Illustrations & thèmes : remplacez les trois bibliothèques, le grenier, les cloches, les médaillons et les cadres. Les hauteurs d’étagères sont modifiables en pourcentages pour aligner les livres avec vos nouvelles images.
6. Identité : personnalisez les textes et le domaine. Un nouveau logo produit les tailles PNG nécessaires à Android, iOS, Windows et aux favicons. Les illustrations de partage sont aussi remplaçables.
7. Enregistrez chaque formulaire. Ouvrez l’aperçu du brouillon. Puis utilisez Publier & sauvegarder → Sauvegarder pour FileZilla. Quand le panneau « Votre fichier est prêt » apparaît, cliquez sur son lien Télécharger.

Le profil, l’auteur et les notifications utilisent les images fournies comme véritables fenêtres : textes, couvertures et actions occupent les zones du dessin. Sur téléphone, les contenus sont réorganisés à l’intérieur des mêmes bordures pour rester lisibles. Les albums et les annonces supplémentaires restent accessibles par pagination ; les textes longs défilent dans leur zone. Lorsque vous remplacez un cadre, conservez la même disposition pour préserver l’alignement.

Si vous ouvrez l’atelier directement depuis un fichier sur votre ordinateur, importez d’abord le ZIP complet du projet dans Publier & sauvegarder. Les navigateurs ne permettent pas de relire automatiquement tous les fichiers d’un dossier local. Cette importation ne nécessite aucune installation. Depuis le site hébergé, les fichiers sont récupérés automatiquement.

Une nouvelle œuvre, un nouveau tome ou de nouvelles pages créent des annonces pendant l’export. Les modifications de présentation importantes peuvent produire une annonce de mise à jour. Vous pouvez ajouter et supprimer vos propres annonces. Les annonces d’une œuvre sont visibles pour ses abonnés, les nouvelles œuvres et annonces générales pour tout le monde.

Les notifications sont internes au site : elles apparaissent à la prochaine visite ou lors du contrôle du catalogue, environ chaque minute lorsque l’onglet est visible. Aucune notification push, aucun e-mail et aucun SMS n’est envoyé quand le site est fermé.

Retrouver vos lectures et vos brouillons

Mon refuge → Personnaliser mon profil et sauvegarder permet d’exporter les préférences et la progression dans un fichier JSON, puis de les importer sur un autre appareil. Aucune synchronisation entre appareils n’est automatique. Les choix sont stockés dans IndexedDB, séparément des brouillons de l’atelier. Une transaction refusée produit un message d’erreur et n’annonce pas de succès.

Le brouillon de l’atelier et ses images restent dans le navigateur. Un export ZIP du site est la sauvegarde complète à conserver. Un catalogue JSON seul ne contient pas les images. L’import d’un projet ZIP restaure son catalogue et ses images ; l’archive chargée sert également de base pour l’export de la session.

En navigation privée, après un nettoyage ou si le stockage est saturé, les données locales peuvent disparaître. Le site signale une sauvegarde indisponible. Il ne revendique aucune conservation distante. Utilisez un seul onglet d’atelier à la fois ; un second onglet est bloqué dès qu’une modification dans l’autre est détectée pour éviter un écrasement silencieux.

Lumi et l’IA locale

Lumi apporte une recherche locale dans des rubriques d’aide, des tutoriels guidés, des raccourcis vers les fonctions du site et des suggestions basées sur le catalogue et vos lectures. Son mode intégré ne télécharge aucun modèle et ne contacte aucun service. Il utilise des intentions et des réponses préparées : il ne possède pas les capacités générales d’un grand modèle de langage.

Pour des réponses génératives, un branchement facultatif à Ollama est fourni. Il suppose qu’un service et un modèle compatibles soient déjà installés sur l’appareil du visiteur. Ouvrez Lumi → Réglages IA, cochez Utiliser mon modèle local, indiquez http://localhost:11434 et le nom exact du modèle installé. Seules les adresses de bouclage local sont acceptées.

Le service Ollama doit autoriser l’origine de votre site (réglage OLLAMA_ORIGINS propre à votre installation). Le navigateur peut aussi demander une permission de réseau local ou bloquer la requête. Le site n’installe ni Ollama ni ses modèles et ne modifie aucune configuration système. En cas d’échec, l’aide intégrée répond à la question. La qualité et la vitesse dépendent du modèle et du matériel ; aucune performance « parmi les meilleures » n’est garantie.

Le connecteur utilise POST /api/chat, des messages de rôle et stream:false, selon la documentation officielle Ollama. Le contexte envoyé à ce service local contient la question, les derniers messages de l’onglet et les informations du catalogue. Aucun outil d’écriture automatique n’est confié au modèle. Les conversations ne sont pas enregistrées après fermeture de l’onglet.

Application installable et lecture hors connexion

Le manifeste et le service worker sont fournis. En HTTPS, les navigateurs compatibles proposent l’installation ; sur iPhone et iPad, utilisez le menu Partager → Sur l’écran d’accueil lorsqu’il est disponible. L’application démarre sur la bibliothèque.

Les fichiers essentiels et les images consultées peuvent être gardés en cache. Une planche jamais consultée n’est pas garantie disponible hors connexion. Les mises à jour du catalogue sont récupérées en priorité sur le réseau. Après une mise à jour, le nouveau service worker remplace son ancien cache. Le mode fichier local ne peut pas activer le service worker et l’installation PWA.

En cas de difficulté

La compatibilité repose sur les versions modernes de Safari, Chrome, Edge et Firefox disposant de JavaScript, Pointer Events, IndexedDB et des éléments dialog. Les contraintes réelles des appareils et de l’hébergement peuvent varier.