Referenz der Scroll-Datei

Eine Scroll-Datei ist ein JSON-Objekt: die Angaben zum Scroll, seine Kapitel mit Ideen und optionale Übersetzungen. Diese Seite beschreibt jedes Objekt und jedes Feld, das der Import liest.

Downloads

• Beispieldatei: ein erfundener Scroll, der alle gängigen Felder nutzt, mit vollständigen Fassungen in allen 15 Sprachen der Oberfläche.
• JSON-Schema: dieselben Regeln maschinenlesbar (JSON Schema 2020-12), für Editoren, Skripte und KI-Agenten. Die Grenzen stammen aus demselben Code, den der Import ausführt.

Aufbau

Scroll
├── language, title, authors, description, tags,
│   sourceUrl, originalYear, originalPeriod
├── summaries: Chapter[]
│   └── ideas: Idea[]
│       └── examples: string[]
└── translations: { language: Translation }
    └── summaries: TranslatedChapter[]
        └── ideas: TranslatedIdea[]

Scroll

Das Wurzelobjekt. Die anderen Objekte heißen im Schema Chapter (Kapitel), Idea (Idee), Translation (Übersetzung), TranslatedChapter und TranslatedIdea.

Kapitel (Chapter)

Idee (Idea)

Übersetzung (Translation)

Jeder Eintrag in translations ist eine vollständige Fassung des Scrolls in dieser Sprache. Er muss dieselben Kapitel, Ideen und Beispiele wie das Original haben, in derselben Reihenfolge und Anzahl.

Ein TranslatedChapter hat einen nicht leeren title und ideas mit so vielen Ideen wie das Kapitel im Original. Eine TranslatedIdea hat einen nicht leeren text und examples mit so vielen Einträgen wie die Idee im Original, keiner davon leer. Übersetzte Ideen lassen tier weg: Er kommt aus dem Original, und ein abweichender Wert wird abgelehnt.

Wie der Import Werte liest

• Text wird an beiden Enden getrimmt, und Längen zählen Zeichen so, wie man sie sieht.
• Ein leeres optionales Feld gilt als nicht vorhanden.
• Felder, die hier nicht beschrieben sind, werden ignoriert.
• Leser sehen die Fassung in ihrer Sprache und, wenn es keine gibt, das Original.

Beispiel

{
  "language": "en",
  "title": "Small steps",
  "authors": ["Ada Example"],
  "description": "How small, repeated actions shape what you notice and do.",
  "tags": ["habits", "attention"],
  "sourceUrl": "https://example.org/small-steps",
  "originalYear": 1841,
  "summaries": [
    {
      "title": "Starting small",
      "ideas": [
        {
          "text": "Make the first step so small that you can take it on a bad day.",
          "tier": "important",
          "examples": ["Read one page every evening."]
        },
        {
          "text": "You notice more of what you have decided to look for.",
          "tier": "common",
          "examples": []
        }
      ]
    }
  ],
  "translations": {
    "de": {
      "title": "Kleine Schritte",
      "authors": ["Ada Beispiel"],
      "description": "Wie kleine, wiederholte Handlungen prägen, was wir bemerken und tun.",
      "tags": ["gewohnheiten", "aufmerksamkeit"],
      "summaries": [
        {
          "title": "Klein anfangen",
          "ideas": [
            {
              "text": "Mach den ersten Schritt so klein, dass er dir auch an einem schlechten Tag gelingt.",
              "examples": ["Lies jeden Abend eine Seite."]
            },
            {
              "text": "Du bemerkst mehr von dem, wonach du zu suchen beschlossen hast.",
              "examples": []
            }
          ]
        }
      ]
    }
  }
}

Grenzen

Häufige Importfehler

• Die Datei ist kein gültiges JSON. Bitte den Assistenten um "nur gültiges JSON" oder such nach einem fehlenden Komma oder Anführungszeichen. Entferne jeden Text vor oder nach dem JSON-Objekt.
• Die Sprache fehlt. Ergänze "language" mit einem Code wie de.
• Eine Idee oder ein Beispiel ist zu lang. Die Meldung nennt Sprache, Kapitel, Idee und Beispiel; kürze diesen Text.
• Eine Übersetzung passt nicht. Jede Fassung braucht dieselbe Zahl an Kapiteln, Ideen und Beispielen in derselben Reihenfolge.
• Zu viele Ideen oder eine zu große Datei. Teile die Quelle auf zwei Scrolls auf.
• Du besitzt schon die Höchstzahl an Scrolls. Ersetze einen, den du nicht mehr brauchst; siehe Bearbeiten, ersetzen und teilen.