Référence du fichier de parchemin

Un fichier de parchemin est un objet JSON : les détails du parchemin, ses chapitres d’idées et des traductions facultatives. Cette page décrit chaque objet et chaque champ que lit l’importation.

Téléchargements

• Fichier d’exemple : un parchemin fictif qui utilise tous les champs courants, avec des versions complètes dans les 15 langues de l’interface.
• Schéma JSON : les mêmes règles sous une forme lisible par les machines (JSON Schema 2020-12), pour les éditeurs, les scripts et les agents d’IA. Ses limites viennent du code même qu’exécute l’importation.

Structure

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

Parchemin (Scroll)

L’objet racine. Dans le schéma, les autres objets s’appellent Chapter (chapitre), Idea (idée), Translation (traduction), TranslatedChapter et TranslatedIdea.

Chapitre (Chapter)

Idée (Idea)

Traduction (Translation)

Chaque entrée de translations est une version complète du parchemin dans cette langue. Elle doit avoir les mêmes chapitres, idées et exemples que l’original, dans le même ordre et en même nombre.

Un TranslatedChapter a un title non vide et des ideas, autant que dans le chapitre d’origine. Une TranslatedIdea a un text non vide et des examples, autant que dans l’idée d’origine, aucun vide. Les idées traduites omettent tier : il vient de l’original, et une valeur différente est refusée.

Comment l’importation lit les valeurs

• Le texte est nettoyé des espaces aux deux extrémités, et les longueurs comptent les caractères tels qu’on les voit.
• Un champ facultatif vide est traité comme absent.
• Les champs non décrits ici sont ignorés.
• Chaque lecteur voit la version de sa langue et, à défaut, l’original.

Exemple

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

Limites

Erreurs d’importation courantes

• Le fichier n’est pas du JSON valide. Demandez à l’assistant « uniquement du JSON valide », ou cherchez une virgule ou un guillemet manquant. Supprimez tout texte avant ou après l’objet JSON.
• La langue manque. Ajoutez "language" avec un code comme fr.
• Une idée ou un exemple est trop long. Le message indique la langue, le chapitre, l’idée et l’exemple ; raccourcissez ce texte.
• Une traduction ne correspond pas. Chaque version doit avoir le même nombre de chapitres, d’idées et d’exemples, dans le même ordre.
• Trop d’idées, ou un fichier trop gros. Répartissez la source sur deux parchemins.
• Vous possédez déjà le maximum de parchemins. Remplacez-en un dont vous n’avez plus besoin ; voir Modifier, remplacer et partager.