Wie Sie einen Day One JSON-Export offline lesen, ohne ihn zu verändern
Um einen Day One-Export zu prüfen, lassen Sie die heruntergeladene ZIP-Datei unverändert, erstellen Sie eine separate Arbeitskopie, entpacken Sie diese lokal und öffnen Sie die `.json`-Datei mit einem Texteditor oder den Standard-JSON-Werkzeugen von Python. Die ZIP-Datei ist ein Container; das JSON ist strukturierter Text; etwaige Medienordner enthalten separate Dateien. Sie können prüfen, ob die JSON-Syntax gültig ist, und potenzielle Text-, Datums- oder Anhangswerte finden, ohne Annahmen über die Bedeutung undokumentierter Schlüssel zu treffen. Lesbares JSON allein beweist weder, dass jede Mediendatei vorhanden ist, noch, dass das Archiv wiederhergestellt werden kann.
Zuerst ZIP, JSON und Medien unterscheiden
Day One beschreibt seinen JSON-Export als eine ZIP-Datei, die eine `.json`-Datei mit ausgewählten Einträgen enthält; Medien können in Ordnern für Fotos, Videos, Audio und PDFs enthalten sein. Laut Anleitung ist JSON für den Reimport archivierter Daten gedacht und kann von Day One sowie von Apps gelesen werden, die Day One JSON-Dateien unterstützen. [Day Ones Export-Leitfaden](https://dayoneapp.com/guides/tips-and-tutorials/exporting-entries/) definiert kein vollständiges Schema Feld für Feld; betrachten Sie daher einen vertraut wirkenden Dateinamen oder Schlüssel nicht als Beweis für dessen Bedeutung.
Lassen Sie die originale ZIP-Datei unberührt. Verwenden Sie das Archivierungswerkzeug Ihres Betriebssystems, um eine Kopie in einen neuen lokalen Ordner zu entpacken. Vermeiden Sie es, ein persönliches Tagebuch bei einem Online-Formatierer hochzuladen. Notieren Sie sich vor dem Öffnen oder Verschieben von Dateien, ob das Archiv eine JSON-Datei, mehrere oder Medienordner enthält; der genaue Inhalt hängt von den Exporteinstellungen ab. Das Öffnen einer `.zip`-Datei als wäre sie JSON schlägt fehl, da die ZIP-Datei ein anderes Dateiformat ist.
Die JSON-Syntax lokal überprüfen
Ein JSON-Dokument ist Text, der strukturierte Werte beschreibt. Die oberste Ebene kann ein Objekt, ein Array oder ein anderer gültiger JSON-Wert sein; JSON-Objekte enthalten benannte Elemente, während Arrays geordnete Werte enthalten. Zeichenketten verwenden doppelte Anführungszeichen, und Kommas, Doppelpunkte sowie Klammern müssen der JSON-Syntax folgen. [MDNs JSON-Leitfaden](https://developer.mozilla.org/en-US/docs/Learn_web_development/Core/Scripting/JSON) erläutert diese Strukturen und gängige Syntaxbeschränkungen.
Für eine schnelle lokale Überprüfung und lesbare Einrückung dokumentiert Python diesen Befehlszeilenaufruf:
`python3 -m json.tool < journal.json`
Verwenden Sie den Befehl mit dem Pfad zu Ihrer entpackten Datei und leiten Sie die Ausgabe nur dann in eine neue Datei um, wenn Sie eine separate, formatierte Kopie wünschen. Der Befehl gibt formatiertes JSON aus, wenn das Parsen erfolgreich ist; schlägt das Parsen fehl, meldet Python den Fehlerort. Ein erfolgreicher Parse-Vorgang bedeutet, dass der Text für den Parser gültiges JSON ist. Er stellt nicht fest, dass die Datei vollständig ist, dass ihre Werte die von Ihnen erwartete Bedeutung haben oder dass Day One sie importieren kann. [Pythons `json`-Dokumentation](https://docs.python.org/3/library/json.html) dokumentiert auch `json.load()` und `json.loads()` zum Einlesen einer Datei oder Zeichenkette.
Die tatsächliche Struktur des Dokuments ermitteln
Beginnen Sie beim ersten Zeichen, das kein Leerzeichen ist. Ein öffnendes `{` weist auf ein Objekt hin; ein `[` weist auf ein Array hin. Erweitern Sie in einer formatierten Kopie die äußere Ebene und untersuchen Sie Elementnamen und Werttypen. Arrays können Objekte enthalten; diese Objekte können wiederum Arrays oder verschachtelte Objekte enthalten. Sich wiederholende Objektstrukturen können Ihnen helfen, potenzielle Eintragsdatensätze zu finden, aber die Wiederholung allein beweist noch nicht das vom Exporter vorgesehene Schema.
Durchsuchen Sie den Text nach einer Phrase, von der Sie wissen, dass sie in einem Eintrag vorkommt, und untersuchen Sie dann die umgebenden Klammern und Werte. Notieren Sie den genauen Schlüssel neben dem Wert, anstatt ihn auf Basis einer Vermutung umzubenennen. Ein Wert, der wie ein Datum aussieht, kann ein potenzielles Datum sein; eine Zeichenkette, die einem Pfad ähnelt, kann ein potenzieller Anhangsverweis sein. Behandeln Sie beides als unbestätigt, bis die Day One-Dokumentation oder der Kontext des Exports selbst deren Bedeutung bestätigt. Bewahren Sie die ursprüngliche Schreibweise, Zeichensetzung, Escape-Sequenzen und Werttypen in Ihren Notizen auf.
Escape-Sequenzen und Medienverweise vorsichtig interpretieren
Eine sichtbare Sequenz wie `\n` innerhalb einer JSON-Zeichenkette stellt einen maskierten Zeilenumbruch dar; es handelt sich im ursprünglichen Eintrag nicht zwingend um zwei Zeichen. Anführungszeichen und Backslashes werden ebenfalls maskiert. Ein Parser kann „Zeile eins Zeile zwei“ als eine Zeichenkette darstellen, die einen Zeilenumbruch enthält, während der JSON-Text diesen Umbruch mit `\n` kodiert. Vergleichen Sie Werte in einem Reader oder Parser, ohne die Quelldatei zu bearbeiten.
Wenn ein Wert einem Dateinamen eines Mediums oder einem relativen Pfad ähnelt, prüfen Sie, ob in den entpackten Medienordnern eine entsprechende Datei vorhanden ist. Halten Sie den genauen Verweis und die Übereinstimmung als Beobachtung fest, nicht als Beweis dafür, dass der Verweis in Day One korrekt aufgelöst wird. Eine fehlende Übereinstimmung könnte auf Exportoptionen, Benennungsunterschiede oder andere Details zurückzuführen sein, die sich nicht allein aus dem Feld ergeben. Führen Sie eine Bestandsaufnahme getrennt vom Originalexport.
Ein Prüfprotokoll verwenden statt Feldnamen zu erraten
Eine kleine Tabelle macht Unsicherheiten explizit und hilft anderen Personen, Ihre Überprüfung nachzuvollziehen:
Ein generisches JSON-Objekt könnte beispielsweise `{"text":"Eine Notiz","date":"2024-05-06","attachment":"photos/example.jpg"}` enthalten. Dies sind lediglich illustrative Namen und Werte, keine Aussage über das Schema von Day One. Behalten Sie den ursprünglichen Wert in Ihren Notizen unverändert bei; vermeiden Sie es, Datumsformate zu konvertieren, Pfade durch Vermutungen aufzulösen oder unbekannte Elemente zu löschen.
Wissen, was eine Inspektion nicht leisten kann
Eine gültige Syntax beweist nicht, dass der Export jeden ausgewählten Eintrag oder jede vorgesehene Mediendatei enthält. Das Auffinden eines potenziellen Anhangswerts beweist nicht, dass die referenzierte Datei vorhanden ist, und das Auffinden einer ähnlich benannten Datei bestätigt nicht das Importverhalten. Die Anleitung von Day One nennt JSON als Archivierungs- und Reimportformat, doch eine reine Lese-Inspektion ist kein Wiederherstellungstest. Wenn Sie Gewissheit über Übertragbarkeit oder Wiederherstellung benötigen, ziehen Sie die aktuellen Day One-Anweisungen zu Rate und führen Sie jegliche Importprüfung separat an einer sicheren Kopie durch, während Sie den unangetasteten Export aufbewahren.