Opis pliku zwoju

Plik zwoju to jeden obiekt JSON: szczegóły zwoju, jego rozdziały z ideami i opcjonalne tłumaczenia. Ta strona opisuje każdy obiekt i każde pole, które odczytuje import.

Do pobrania

• Przykładowy plik: zmyślony zwój ze wszystkimi typowymi polami i pełnymi wersjami we wszystkich 15 językach interfejsu.
• Schemat JSON: te same zasady w formie czytelnej dla maszyn (JSON Schema 2020-12), dla edytorów, skryptów i agentów AI. Jego limity pochodzą z tego samego kodu, który wykonuje import.

Budowa

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

Zwój (Scroll)

Obiekt główny. Pozostałe obiekty nazywają się w schemacie Chapter (rozdział), Idea (idea), Translation (tłumaczenie), TranslatedChapter i TranslatedIdea.

Rozdział (Chapter)

Idea (Idea)

Tłumaczenie (Translation)

Każdy wpis w translations to pełna wersja zwoju w danym języku. Musi mieć te same rozdziały, idee i przykłady co oryginał, w tej samej kolejności i liczbie.

TranslatedChapter ma niepusty title i ideas z taką samą liczbą idei jak rozdział oryginalny. TranslatedIdea ma niepusty text i examples z taką samą liczbą wpisów jak idea oryginalna, bez pustych. Przetłumaczone idee pomijają tier: pochodzi on z oryginału, a inna wartość jest odrzucana.

Jak import odczytuje wartości

• Z tekstu usuwane są spacje na obu końcach, a długość liczy się w znakach tak, jak je widać.
• Puste pole opcjonalne traktowane jest jak brakujące.
• Pola nieopisane tutaj są ignorowane.
• Czytelnik widzi wersję w swoim języku, a jeśli jej nie ma, oryginał.

Przykład

{
  "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": []
            }
          ]
        }
      ]
    }
  }
}

Limity

Częste błędy importu

• Plik nie jest poprawnym JSON. Poproś asystenta o "wyłącznie poprawny JSON" lub poszukaj brakującego przecinka albo cudzysłowu. Usuń tekst przed obiektem JSON i po nim.
• Brakuje języka. Dodaj "language" z kodem, np. pl.
• Idea lub przykład jest za długi. Komunikat wskazuje język, rozdział, ideę i przykład; skróć ten tekst.
• Tłumaczenie się nie zgadza. Każda wersja musi mieć tę samą liczbę rozdziałów, idei i przykładów, w tej samej kolejności.
• Za dużo idei lub za duży plik. Podziel źródło na dwa zwoje.
• Masz już maksymalną liczbę zwojów. Zastąp zwój, którego już nie potrzebujesz; zobacz Edytowanie, zastępowanie i udostępnianie.