스크롤 파일 설명

스크롤 파일은 하나의 JSON 객체입니다. 스크롤 정보, 아이디어가 담긴 장, 선택 사항인 번역이 들어 있습니다. 이 페이지에서는 가져오기가 읽는 모든 객체와 필드를 설명합니다.

내려받기

• 예시 파일: 자주 쓰는 필드를 모두 담은 가상의 스크롤로, 화면에서 지원하는 15개 언어의 완전한 버전이 모두 들어 있습니다.
• JSON 스키마: 같은 규칙을 기계가 읽을 수 있는 형식(JSON Schema 2020-12)으로 정리한 것으로, 편집기, 스크립트, AI 에이전트용입니다. 한도는 가져오기가 실행하는 코드에서 그대로 가져옵니다.

구조

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 객체 앞뒤의 글은 지우세요.
• 언어가 없음. ko 같은 코드로 "language"를 넣으세요.
• 아이디어나 예시가 너무 김. 메시지에 언어, 장, 아이디어, 예시가 나오니 그 글을 줄이세요.
• 번역이 맞지 않음. 모든 버전은 장, 아이디어, 예시의 수와 순서가 같아야 합니다.
• 아이디어가 너무 많거나 파일이 너무 큼. 자료를 두 개의 스크롤로 나누세요.
• 가질 수 있는 스크롤 수를 다 채움. 더는 필요 없는 스크롤을 바꾸세요. 편집, 바꾸기, 공유를 참고하세요.