Obsidian-Vault importieren

Scriptorium kann einen ganzen Obsidian-Vault als neues Projekt importieren. Der Ordnerbaum wird gespiegelt, [[wikilinks]] werden zu echten Seitenverknüpfungen mit funktionierenden Rückverweisen, #tags werden zu Schlagwörtern, nach denen Sie filtern können, Hinweisboxen erscheinen als Hinweisboxen, und YAML-Frontmatter wird zu typisierten Eigenschaften.

Am Ende erhalten Sie einen Bericht, der alles benennt, was nicht übernommen werden konnte, sodass nichts stillschweigend verloren geht.

Ihren Vault importieren

Klicken Sie auf dem Begrüßungsbildschirm auf Importieren.
Ziehen Sie den Ordner Ihres Vaults auf die Ablagefläche. Es gibt keinen eigenen Vault-Importer zu suchen: Dieselbe Fläche nimmt Dokumente, Archive und Vaults entgegen und findet heraus, was sie bekommen hat. Eine .zip des Vaults funktioniert ebenso, und wenn Sie lieber klicken als ziehen, nutzen Sie Obsidian-Vault-Ordner auswählen.
Legen Sie Projektnamen und Sprache fest, prüfen Sie das Board und drücken Sie Importieren.

Wenn Sie nichts ändern, wird jede Notiz zu einer Notiz, und Ihre Ordnerstruktur bleibt genau erhalten. Das ist die sichere Voreinstellung, und sie ist nie falsch.

Das Board

Statt einer Liste von Fragen erhalten Sie ein Bild des Projekts, das Sie gleich anlegen.

┌── 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 und Manuskript sind die beiden Orte, an denen eine Datei liegen kann. Alles beginnt im Wiki. Ziehen Sie einen Ordner — oder eine einzelne Notiz — ins Manuskript, und sie wird zu Prosa; ziehen Sie sie zurück, und sie ist wieder eine Notiz. Jede Zeile hat außerdem ein Menü … mit denselben Zügen, was meist schneller ist als Ziehen.

Elemente ist kein dritter Ort. Es ist eine Beschriftung über dem Wiki-Baum: Eine gruppierte Notiz wird weiterhin in dem Ordner angelegt, aus dem sie kam, und das Überfahren einer Gruppe hebt ihre Notizen dort hervor, wo sie tatsächlich liegen.

Die Leiste am unteren Rand ist der ganze Import in Zahlen, und sie aktualisiert sich, während Sie Dinge verschieben. Es wird nichts geschrieben, bis Sie auf Importieren drücken.

Ihre Prosa

Ein ins Manuskript gezogener Ordner wird zu einem Akt. Seine Unterordner werden zu Kapiteln und deren Unterordner zu Szenen — die Struktur, die Sie in Ihrem Vault bereits gebaut haben, ist also die Struktur, die Sie in der Seitenleiste bekommen. Jede Datei wird dann an ihren Überschriften in Abschnitte geteilt.

Vier Ebenen sind die Obergrenze. Ein tieferer Ordner bekommt keinen eigenen Abschnitt; seine Dateien werden in die nächstgelegene Szene gelegt, und der Bericht nennt jeden Ordner, dem das widerfahren ist.

Die Reihenfolge unter Geschwistern folgt Ihren Ordner- und Dateinamen. Sie können sie in der Seitenleiste umstellen, sobald das Projekt existiert.

Nutzen Sie Manuskript nur für Ordner, die wirklich Prosa enthalten — eine an ihren Überschriften geteilte Wiki-Seite liest sich wie ein Buch, das keines ist. Seitenverknüpfungen, Hinweisboxen und Schlagwörter überstehen den Umzug alle, eine Notiz, die sich als zum Manuskript gehörig erweist, verliert dort also nichts.

Figuren, Orte und Ereignisse

Wenn Ihr Vault Frontmatter nutzt, um zu sagen, was eine Notiz ist —

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

— dann stehen diese Gruppen bereits auf dem Board, wenn es sich öffnet. Sie haben sie angegeben; Sie sollten sie nicht noch einmal einzeln über Ausklappmenüs angeben müssen. type, class, category und kind werden alle erkannt, und jeder Wert bekommt eine Gruppe, wie wenige Notizen ihn auch tragen: eine Kategorie, die Sie einmal notiert haben, ist immer noch eine Kategorie.

Eine Gruppe wird zu einem Elementtyp — Datensätze, die sich eine Vorlage teilen, in der Elementtabelle, auf der Mindmap und auf einem Zeitstrahl.

Jede Karte trägt Felder, die sagen, was aus jedem Frontmatter-Schlüssel wird: Text, Zahl, Ja/Nein, Auswahl, Datum, ein Schlagwort, das Startdatum oder Enddatum — oder gar nichts. Diese werden aus den Notizen der Gruppe selbst gelesen, sodass ein status, der über Ihre Figuren hinweg draft/done ist, zu einer Auswahl mit genau diesen beiden Optionen wird — nicht mit jedem Wert, den das Wort status irgendwo in Ihrem Vault hat.

Benennen Sie eine Karte um, indem Sie darin tippen. Gruppierung aufheben macht ihre Notizen wieder zu gewöhnlichen Notizen. Ziehen Sie eine Notiz auf eine andere Karte, um sie zu verschieben, oder ziehen Sie sie herunter, um sie herauszunehmen.

Wo Ihr Vault nichts sagt, bietet Scriptorium womöglich eine Gruppe Vorgeschlagen aus Notizen an, die eine Form teilen. Ein Vorschlag behauptet nichts, bis Sie auf Übernehmen drücken.

Dies falsch zu machen ist nicht zerstörerisch. Eigenschaften funktionieren auch auf gewöhnlichen Notizen, ein Fehler kostet also die gemeinsame Vorlage und die Platzierung auf dem Zeitstrahl, nicht Ihre Daten.

Alles, was Sie ins Manuskript verschieben, verlässt seine Gruppe. Verschieben Sie es zurück, und es tritt wieder bei — dazwischen geht nichts verloren.

Daten

Zwei Dinge, die zu wissen sich lohnt:

Mehrdeutige Daten werden abgelehnt, nicht erraten. 03/04/2024 ist in den meisten Teilen der Welt der 3. April und in den Vereinigten Staaten der 4. März, und nichts in der Datei klärt das. Scriptorium behält den Wert als Text und nennt Datei und Schlüssel im Bericht. Schreiben Sie 2024-03-04, 2024/03/04 oder March 4, 2024, und es wird als Datum gelesen.
Uhrzeiten verschieben nichts. Ein Geburtstag, geschrieben als 1885-03-12T10:30+02:00, wird als 12. März, 10:30 importiert. Zeitzonen verschieben nie ein Datum.

Scriptorium füllt die beiden Zeitstrahl-Plätze selbst, wenn es ein Paar erkennt — born/died, birth/death, start/end, from/to — sodass eine Figur mit born und died ohne Ihr Zutun als Zeitspanne auf dem Zeitstrahl landet.

Der Zeitstrahl hat einen Anfang und ein Ende, also höchstens ein Startdatum und einen Enddatum-Schlüssel je Gruppe — den Platz einem zweiten Feld zu geben nimmt ihn dem ersten. Jeder Datumsschlüssel wird dennoch zu einem Datumsfeld, sodass ein Vault mit born, died, crowned und modified born und died auf den Zeitstrahl setzen und trotzdem alle vier behalten kann.

Dinge weglassen

Ziehen Sie einen Ordner oder eine Notiz auf Nicht importiert, und sie wird vollständig übersprungen, samt allem darunter. Der Papierkorb erscheint erst, wenn etwas darin ist.

Was übernommen wird

Struktur

Obsidian	Scriptorium
Vault-Ordner	Ein neues Projekt, unter einem nach Ihrem Vault benannten Ordner
Verschachtelte Ordner	Dieselbe Verschachtelung in der Seitenleiste und Akt / Kapitel / Szene im Manuskript
`.md`-Dateien	Notizen, oder Elemente und Manuskriptabschnitte gemäß dem Board
Bilder, PDFs, Audio	Dateianhänge

Im Text

Obsidian	Scriptorium
Überschriften, Listen, Tabellen, Code, Aufgabenlisten, $math$	Dasselbe
`> [!note] Title`-Hinweisboxen	Hinweisboxen, mit dem Titel als erster Zeile
`==highlight==`	Eine Hervorhebung
`%%comment%%`	Eine Anmerkung, verankert an der Passage, in der er stand
`#tag` und Frontmatter `tags:`	Schlagwörter, Verschachtelung erhalten
Frontmatter	Typisierte Eigenschaften
`[^1]`-Fußnoten	Echte Fußnoten, mit dem Text der Definition darin

Verknüpfungen

Obsidian	Scriptorium
`[[Note]]`	Eine Seitenverknüpfung und ein Rückverweis am anderen Ende
`[[Note\|alias]]`	Eine Seitenverknüpfung, die „alias“ liest
`![[image.png]]`	Das Bild, in Ihrem Projekt gespeichert
`![[Note]]`	Eine Verknüpfungskarte — Scriptorium kennt keine Transklusion
`[[Note#Heading]]`	Eine Verknüpfung zur Notiz; die Überschrift erscheint im Verknüpfungstext
`[[Ghost]]`	Reiner Text, im Bericht aufgeführt
`[Ada](People/Ada.md)`	Eine Seitenverknüpfung, genau wie die Wikilink-Form
`![](Assets/map.png)`	Das Bild, in Ihrem Projekt gespeichert

Beide Verknüpfungsstile funktionieren, sodass ein Vault mit abgeschaltetem Use [[Wikilinks]] mit intakten Verknüpfungen importiert wird.

Verknüpfungen werden so aufgelöst, wie Obsidian sie auflöst, einschließlich kürzester eindeutiger Dateinamen und Frontmatter-Aliasse. Wo zwei Dateien hätten passen können, sagt der Bericht, welche gewählt wurde.

Was nicht übernommen wird

Canvases (.canvas) werden gezählt und übersprungen.
Dataview- und Templater-Blöcke werden wortgetreu als Code importiert. Sie werden nicht ausgewertet.
Blockverweise (^block-id) und Überschriften-Anker verweisen auf die Notiz statt auf den genauen Block.
Der Faltzustand von Hinweisboxen und HTML-Tags im Text entfallen; der Text darin bleibt erhalten.
Eine Fußnote ohne Definition irgendwo in der Datei bleibt das [^1], das Sie geschrieben haben — es gibt nichts, was hineingehörte.

All dies steht im Bericht am Ende des Imports, den Sie kopieren können, um ihn später abzuarbeiten.

Abbrechen

Ein großer Vault dauert eine Weile — ein paar tausend Notizen sind Dutzende von Sekunden. Der Fortschrittsbalken ist genau, und Abbrechen funktioniert zu jedem Zeitpunkt. Ein Abbruch lässt nichts zurück: Es erscheint kein halbfertiges Projekt in Ihrem Regal.