Sauvegarde et import

À quoi sert la sauvegarde

Vos notes, commentaires et surlignages ne vivent que sur votre appareil : ils ne sont pas synchronisés et disparaissent avec l’extension. La sauvegarde permet d’en garder une copie dans un fichier, pour les retrouver après une réinstallation ou les déplacer vers un autre navigateur ou un autre appareil.

Elle se trouve dans les Réglages, dans le bloc déroulable « Sauvegarde », sous « Réinitialiser les réglages par défaut ». Elle est manuelle (aucune sauvegarde automatique ou planifiée), locale (rien n’est envoyé, aucune requête réseau) et n’exige aucune permission de plus.

Exporter ses données

Le bouton « Exporter mes données » produit un fichier scriptorium-AAAA-MM-JJ.json, daté du jour. Il contient :

vos notes 🔥, ❓ et 💬, avec le texte de vos commentaires ;
vos surlignages ;
vos réglages et votre thème.

Il ne contient ni la position de lecture ni aucun texte biblique. Le fichier est généré dans votre navigateur et remis à celui-ci comme n’importe quel téléchargement : il est placé dans votre dossier de téléchargements, ou le navigateur vous demande où le placer. Une fenêtre « Fichier généré » rappelle son nom et compte les notes de chaque type et les surlignages de chaque couleur qu’il contient.

Le fichier n’est pas chiffré : vos commentaires y sont lisibles. Gardez-le comme vous garderiez un carnet personnel.

Importer un fichier

Le bouton « Importer un fichier » vous laisse choisir un fichier de sauvegarde. L’extension le lit sur votre appareil (il n’est pas envoyé), vérifie qu’il s’agit bien d’une sauvegarde de Scriptorium, puis ouvre une fenêtre « Importer ce fichier ? » qui montre ce que l’import changerait, dans un tableau à trois colonnes :

Importé : ajouté à vos données ;
Fusionné : déjà présent ;
Ignoré : non ajouté (limite de notes atteinte, ou verset déjà surligné d’une autre couleur).

Rien n’est écrit tant que vous n’avez pas cliqué sur « Importer ». Si tout ce que contient le fichier est déjà dans vos données, la fenêtre l’indique et le bouton est désactivé ; importer deux fois le même fichier ne change donc rien.

Comment les données sont fusionnées

L’import fusionne le fichier avec vos données actuelles ; il n’existe pas de mode « remplacer ». Il ne supprime rien, sauf pour respecter le nombre de notes autorisé par verset.

Notes : une note déjà présente (même date de création, même type, mêmes versets) n’est pas dupliquée. Pour un commentaire, la version modifiée le plus récemment est conservée.
Limite par verset : si un verset dépasse le nombre de notes autorisé pour un type, seules les plus récentes sont gardées. Cela peut retirer des notes locales plus anciennes ; la fenêtre vous en avertit avant d’importer.
Surlignages : un verset non surligné reçoit la couleur du fichier ; un surlignage déjà présent n’est jamais remplacé, même si le fichier donne une autre couleur (votre couleur est gardée).
Réglages et thème : ils sont remplacés par ceux du fichier. Un fichier créé avant l’existence d’un réglage remet ce réglage à sa valeur par défaut.

Les notes sont enregistrées dans la numérotation de référence, indépendante de la Bible affichée : un fichier venant d’un autre appareil n’a besoin d’aucune conversion. Quand l’import est terminé, un message donne les comptes réels : notes ajoutées, commentaires mis à jour, notes retirées et surlignages ajoutés.

Fichiers refusés

L’extension refuse, avec un message précis, un fichier trop volumineux pour être une sauvegarde (plus de 5 Mo, qu’elle ne lit même pas), un fichier qui n’est pas du JSON valide, un fichier qui n’est pas une sauvegarde de Scriptorium, et un fichier venu d’une version plus récente de l’extension (mettez-la à jour pour l’importer). Une entrée illisible dans un fichier valide est ignorée et comptée. Si les notes ou les surlignages déjà enregistrés ont une forme inattendue, l’import est refusé pour ne rien écraser.

Limites

Pas de sauvegarde automatique ou planifiée, pas de synchronisation entre appareils, pas de chiffrement ;
pas de choix par catégorie : le fichier contient tout, et l’import applique tout ;
la position de lecture n’est pas exportée.

Un point reste flou ? Proposez une amélioration de la doc.