Опис файлу сувою

Файл сувою - це один JSON-об'єкт: дані сувою, його розділи з ідеями та необов'язкові переклади. На цій сторінці описано кожен об'єкт і кожне поле, яке читає імпорт.

Файли для завантаження

• Приклад файлу: вигаданий сувій з усіма основними полями та повними версіями всіма 15 мовами інтерфейсу.
• JSON-схема: ті самі правила в машиночитному вигляді (JSON Schema 2020-12) для редакторів, скриптів і ШІ-агентів. Її обмеження беруться з того самого коду, який виконує імпорт.

Структура

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

Сувій (Scroll)

Кореневий об'єкт. Інші об'єкти в схемі називаються Chapter (розділ), Idea (ідея), Translation (переклад), TranslatedChapter і TranslatedIdea.

Розділ (Chapter)

Ідея (Idea)

Переклад (Translation)

Кожен запис у translations - повна версія сувою цією мовою. У ній мають бути ті самі розділи, ідеї й приклади, що й в оригіналі, у тому самому порядку й кількості.

TranslatedChapter має непорожній title та ideas - стільки ж ідей, скільки у вихідному розділі. TranslatedIdea має непорожній text та examples - стільки ж прикладів, скільки у вихідної ідеї, і жоден не порожній. У перекладених ідеях tier не вказують: він береться з оригіналу, а інше значення відхиляється.

Як імпорт читає значення

• У тексту обрізаються пробіли з обох країв, а довжина рахується в символах так, як ви їх бачите.
• Порожнє необов'язкове поле вважається відсутнім.
• Поля, не описані тут, ігноруються.
• Читач бачить версію своєю мовою, а якщо її немає, оригінал.

Приклад

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

Обмеження

Часті помилки імпорту

• Файл - некоректний JSON. Попросіть асистента відповісти "лише коректним JSON" або знайдіть пропущену кому чи лапки. Видаліть текст до й після JSON-об'єкта.
• Не вказано мову. Додайте "language" з кодом, наприклад uk.
• Ідея чи приклад задовгі. Повідомлення називає мову, розділ, ідею й приклад; скоротіть цей текст.
• Переклад не збігається. Кожна версія має мати однакову кількість розділів, ідей і прикладів у тому самому порядку.
• Забагато ідей або завеликий файл. Розділіть джерело на два сувої.
• У вас уже максимум сувоїв. Замініть сувій, який більше не потрібен; див. Редагування, заміна й доступ.