Importer un coffre Obsidian

Scriptorium peut importer un coffre Obsidian entier comme nouveau projet. L’arborescence de dossiers est reproduite, les [[wikilinks]] deviennent de véritables liens de page avec des rétroliens fonctionnels, les #tags deviennent des étiquettes sur lesquelles filtrer, les encadrés s’affichent comme des encadrés, et le frontmatter YAML devient des propriétés typées.

Vous obtenez au bout du compte un rapport nommant tout ce qui n’a pas pu être repris, de sorte que rien ne se perd en silence.

Importer votre coffre

1. Sur l’écran d’accueil, cliquez sur Importer.
2. Faites glisser le dossier de votre coffre sur la zone de dépôt. Il n’y a pas d’importateur de coffre distinct à chercher : la même zone accepte documents, archives et coffres, et détermine ce qu’on lui a donné. Un .zip du coffre fonctionne aussi, et si vous préférez cliquer que glisser, utilisez Choisir un dossier de coffre Obsidian.
3. Définissez un nom et une langue de projet, vérifiez le tableau et appuyez sur Importer.

Si vous ne changez rien, chaque note devient une note et votre structure de dossiers est préservée à l’identique. C’est le comportement par défaut sûr, et il n’est jamais mauvais.

Le tableau

Au lieu d’une liste de questions, vous obtenez une image du projet que vous êtes sur le point de créer.

┌── Wiki ────────────┐ ┌── Manuscript ──────┐ ┌── Entities ────────┐
│ ▸ Assets        4  │ │ ▾ Manuscript  ACT  │ │ Character      142 │
│ ▸ Events        61 │ │   ▾ Act One   CHAP │ │ Location        38 │
│ ▸ people       142 │ │     Ch. Two   SCENE│ │ Event           61 │
│   Index.md         │ │     Ch. Three SCENE│ │                    │
└────────────────────┘ └────────────────────┘ └────────────────────┘
  1,842 notes · 142 Character · 38 Location · 61 Event · 47 folders

Wiki et Manuscrit sont les deux endroits où un fichier peut se trouver. Tout commence dans Wiki. Faites glisser un dossier — ou une seule note — dans Manuscrit et il devient de la prose ; ramenez-le et c’est de nouveau une note. Chaque ligne possède aussi un menu … avec les mêmes déplacements, ce qui est généralement plus rapide que le glisser.

Entités n’est pas un troisième endroit. C’est une étiquette posée sur l’arborescence Wiki : une note groupée est toujours créée dans le dossier d’où elle vient, et survoler un groupe met en évidence ses notes là où elles se trouvent réellement.

La bande du bas, c’est tout l’import en chiffres, et elle se met à jour à mesure que vous déplacez des choses. Rien n’est écrit tant que vous n’appuyez pas sur Importer.

Votre prose

Un dossier déposé dans Manuscrit devient un Acte. Ses sous-dossiers deviennent des Chapitres, et les leurs des Scènes — la structure que vous avez déjà construite dans votre coffre est donc celle que vous obtenez dans la barre latérale. Chaque fichier est ensuite découpé en sections à ses titres.

Quatre niveaux, c’est le plafond. Un dossier plus profond n’obtient pas de section à lui ; ses fichiers sont placés dans la Scène la plus proche, et le rapport nomme chaque dossier concerné.

L’ordre entre frères suit vos noms de dossiers et de fichiers. Vous pourrez le réorganiser dans la barre latérale une fois le projet créé.

N’utilisez Manuscrit que pour les dossiers qui contiennent réellement de la prose — une page de wiki découpée à ses titres se lit comme un livre qui n’en est pas un. Liens de page, encadrés et étiquettes survivent tous au déplacement : une note qui s’avère appartenir au manuscrit n’y perd rien.

Personnages, lieux et événements

Si votre coffre utilise le frontmatter pour dire ce qu’est une note —

---
type: character
born: 1815-12-10
died: 1852-11-27
---

— ces groupes sont déjà sur le tableau à son ouverture. Vous les avez déclarés ; vous ne devriez pas avoir à les redéclarer un menu déroulant à la fois. type, class, category et kind sont tous reconnus, et chaque valeur obtient un groupe, si peu de notes la portent-elles : une catégorie que vous avez notée une fois reste une catégorie.

Un groupe devient un type d’entité — des fiches partageant un modèle, dans la table des entités, sur la carte mentale et sur une chronologie.

Chaque carte porte des Champs, qui disent ce que devient chaque clé de frontmatter : texte, nombre, oui/non, choix, date, une étiquette, la date de début ou la date de fin, ou rien du tout. Ils sont lus depuis les notes du groupe lui-même, de sorte qu’un status valant draft/done dans vos personnages devient un choix avec exactement ces deux options — et non toutes les valeurs que le mot status prend ailleurs dans votre coffre.

Renommez une carte en tapant dedans. Dégrouper rend ses notes de nouveau ordinaires. Faites glisser une note sur une autre carte pour la déplacer, ou hors des cartes pour l’en sortir.

Là où votre coffre ne dit rien, Scriptorium peut proposer un groupe Suggéré de notes partageant une même forme. Une suggestion n’affirme rien tant que vous n’appuyez pas sur Accepter.

Se tromper ici n’a rien de destructeur. Les propriétés fonctionnent aussi sur des notes ordinaires : une erreur coûte le modèle partagé et le placement sur la chronologie, pas vos données.

Tout ce que vous déplacez vers Manuscrit quitte son groupe. Ramenez-le et il le rejoint — rien n’est perdu entre-temps.

Les dates

Deux choses à savoir :

• Les dates ambiguës sont refusées, pas devinées. 03/04/2024 est le 3 avril dans la plupart des pays et le 4 mars aux États-Unis, et rien dans le fichier ne permet de trancher. Scriptorium conserve la valeur comme texte et nomme le fichier et la clé dans le rapport. Écrivez 2024-03-04, 2024/03/04 ou March 4, 2024 et elle est lue comme une date.
• Les heures ne décalent rien. Un anniversaire écrit 1885-03-12T10:30+02:00 est importé comme le 12 mars, 10 h 30. Les fuseaux horaires ne décalent jamais une date.

Scriptorium remplit lui-même les deux emplacements de chronologie quand il reconnaît une paire — born/died, birth/death, start/end, from/to — de sorte qu’un personnage ayant born et died atterrit sur la chronologie comme une durée sans rien faire de votre part.

La chronologie a un début et une fin : donc au plus une clé de date de début et une clé de date de fin par groupe — confier l’emplacement à un second champ le retire au premier. Chaque clé de date devient malgré tout un champ de date, de sorte qu’un coffre avec born, died, crowned et modified peut mettre born et died sur la chronologie et conserver les quatre.

Laisser des choses de côté

Faites glisser un dossier ou une note vers Non importé et il est entièrement ignoré, avec tout ce qu’il contient. La corbeille n’apparaît qu’une fois qu’il y a quelque chose dedans.

Ce qui est repris

Structure

Obsidian	Scriptorium
Dossier du coffre	Un nouveau projet, sous un dossier portant le nom de votre coffre
Dossiers imbriqués	La même imbrication dans la barre latérale, et Acte / Chapitre / Scène dans le manuscrit
Fichiers .md	Des notes, ou des entités et des sections de manuscrit selon le tableau
Images, PDF, audio	Des fichiers joints

Dans le texte

Obsidian	Scriptorium
Titres, listes, tableaux, code, listes de tâches, $math$	Identiques
Encadrés > [!note] Title	Des encadrés, avec le titre comme première ligne
==highlight==	Un surlignage
%%comment%%	Une annotation ancrée au passage où il se trouvait
#tag et tags: du frontmatter	Des étiquettes, imbrication préservée
Frontmatter	Des propriétés typées
Notes de bas de page [^1]	De vraies notes de bas de page, avec le texte de la définition à l’intérieur

Liens

Obsidian	Scriptorium
[[Note]]	Un lien de page, et un rétrolien à l’autre bout
[[Note|alias]]	Un lien de page affichant « alias »
![[image.png]]	L’image, stockée dans votre projet
![[Note]]	Une carte de lien — Scriptorium n’a pas de transclusion
[[Note#Heading]]	Un lien vers la note ; le titre est affiché dans le texte du lien
[[Ghost]]	Du texte brut, listé dans le rapport
[Ada](People/Ada.md)	Un lien de page, comme la forme wikilink
	L’image, stockée dans votre projet

Les deux styles de liens fonctionnent : un coffre avec Use [[Wikilinks]] désactivé s’importe donc avec ses liens intacts.

Les liens sont résolus comme Obsidian les résout, y compris les noms de base les plus courts et uniques et les alias de frontmatter. Là où deux fichiers auraient pu correspondre, le rapport indique lequel a été choisi.

Ce qui n’est pas repris

• Les canevas (.canvas) sont comptés et ignorés.
• Les blocs Dataview et Templater sont importés tels quels comme du code. Ils ne s’évalueront pas.
• Les références de bloc (^block-id) et les ancres de titre renvoient à la note plutôt qu’au bloc exact.
• L’état replié des encadrés et les balises HTML en ligne sont abandonnés ; le texte qu’ils contiennent est conservé.
• Une note de bas de page sans définition nulle part dans le fichier reste le [^1] que vous avez écrit — il n’y a rien à mettre dedans.

Tout cela est listé dans le rapport à la fin de l’import, que vous pouvez copier pour le traiter plus tard.

Annuler

Un gros coffre prend un moment — quelques milliers de notes représentent des dizaines de secondes. La barre de progression est exacte, et Annuler fonctionne à tout instant. Annuler ne laisse rien derrière : aucun projet à moitié construit n’apparaît sur votre étagère.