Описание файла свитка

Файл свитка - это один 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" с кодом, например ru.
• Идея или пример слишком длинные. Сообщение называет язык, главу, идею и пример; сократите этот текст.
• Перевод не совпадает. В каждой версии должно быть одинаковое число глав, идей и примеров в том же порядке.
• Слишком много идей или слишком большой файл. Разделите источник на два свитка.
• У вас уже максимум свитков. Замените свиток, который больше не нужен; см. Изменение, замена и доступ.