Créer ses listes

Tout le contenu de Rakasu arrive par des fichiers JSON que vous écrivez vous-même. Cette page documente les quatre formats, champ par champ, exactement comme le tutoriel intégré à l'application. Les exemples sont copiables : partez du plus simple et complétez.

L'import est toujours « tout ou rien ». À la moindre erreur, l'application et ce site refusent le fichier en signalant chaque problème, champ par champ. Rien n'est jamais importé à moitié, donc rien ne peut être corrompu : corrigez et réessayez.

1. Liste minimale

Le strict nécessaire pour une liste de vocabulaire jouable. Copiez ce bloc, remplacez les valeurs, ajoutez des items : c'est déjà valide.

{
  "id": "ma-liste-01",
  "titre": "Ma liste",
  "categorie": "vocabulaire",
  "items": [
    { "id": "m001", "jp": "朝ご飯", "kana": "あさごはん",
      "fr": "petit-déjeuner", "lit": "matin + riz cuit", "type": "nom" }
  ]
}

Champs obligatoires de la liste : id, titre, categorie, items (non vide).

Champs obligatoires de chaque item : id (unique dans la liste), jp, kana, fr, lit, type.

lit est la traduction littérale, mot à mot : « matin + riz cuit » pour 朝ご飯. Pour un mot simple, elle peut être identique à fr.

2. Les valeurs autorisées

categorievocabulaire · outils · verbes · kanji · grammaire

typenom · verbe-godan · verbe-ichidan · verbe-irregulier · adj-i · adj-na · adverbe · expression · particule · demonstratif · interrogatif

Le type compte vraiment : les verbe-* et adj-* alimentent les modules de conjugaison. Et il ne s'infère pas : 帰る, 入る ou 走る sont des verbe-godan malgré leur terminaison trompeuse.

3. Une liste avec tous les champs

{
  "id": "vocab-maison-01",
  "titre": "La maison",
  "categorie": "vocabulaire",
  "priorite": 1,
  "version": 1,
  "description": "Description courte de la liste.",
  "items": [
    {
      "id": "m001",
      "jp": "家",
      "kana": "いえ",
      "romaji": "ie",
      "fr": "maison",
      "lit": "maison",
      "type": "nom",
      "accept": ["家", "いえ", "うち"],
      "note": "うち = sa propre maison"
    },
    {
      "id": "m002",
      "jp": "食べる",
      "kana": "たべる",
      "romaji": "taberu",
      "fr": "manger",
      "lit": "manger",
      "type": "verbe-ichidan"
    }
  ]
}

prioriteordre de travail conseillé des listes (1, 2, 3…). Optionnel, défaut 1.

versionvotre numéro de version de la liste. Optionnel, défaut 1.

descriptionune phrase affichée sous le titre de la liste. Optionnel.

romajioptionnel, affiché en aide sous le mot.

acceptles réponses acceptées à l'écrit. Défaut : [jp, kana]. N'ajoutez que les variantes vraiment courantes, comme un kanji alternatif.

noteune remarque affichée sur la fiche du mot. Optionnel.

pitchne le mettez pas. L'application complète l'accent de hauteur depuis son dictionnaire embarqué (données Kanjium, dérivées du dictionnaire d'accent NHK). Un pitch inventé serait faux et enseignerait une mauvaise prononciation.

kanjisinutile dans une liste de vocabulaire : les kanji de vos mots sont détectés automatiquement, et leurs fiches viennent du référentiel KANJIDIC2 embarqué. Ne fournissez ni sens ni lectures.

4. Les phrases, optionnelles mais puissantes

Une phrase découpée en segments débloque à elle seule quatre modules : particules à trou, construction, décodage et lecture à voix haute. Ajoutez un tableau phrases à votre liste, ou collez ce format seul pour enrichir une liste déjà importée.

{
  "phrases": [
    {
      "id": "p001",
      "jp": "私は家でパンを食べます。",
      "kana": "わたしはいえでパンをたべます。",
      "fr": "Je mange du pain à la maison.",
      "lit": "moi [thème] maison [lieu] pain [COD] manger-poli",
      "niveau": 1,
      "segments": [
        { "txt": "私", "kana": "わたし", "role": "sujet", "fr": "moi" },
        { "txt": "は", "role": "particule", "fonction": "theme",
          "fr": "marque le thème" },
        { "txt": "家", "kana": "いえ", "role": "lieu", "fr": "maison" },
        { "txt": "で", "role": "particule", "fonction": "lieu-action",
          "fr": "lieu où se déroule l'action" },
        { "txt": "パン", "kana": "パン", "role": "objet", "fr": "pain" },
        { "txt": "を", "role": "particule", "fonction": "cod",
          "fr": "marque le COD" },
        { "txt": "食べます", "kana": "たべます", "role": "verbe",
          "fr": "manger (poli)" }
      ],
      "ordresValides": [[2, 3, 0, 1, 4, 5, 6]]
    }
  ]
}

obligatoirespour chaque phrase : id, jp, fr, lit et segments (non vide). Le kana est très fortement recommandé : c'est lui qui donne le furigana et la lecture à voix haute.

rolesujet · objet · lieu · temps · verbe · particule · adjectif · adverbe · expression

fonctionà ajouter quand role vaut particule : theme, sujet, cod, destination, direction, lieu-action, possession, question… Le fr du segment doit alors expliquer ce que marque la particule : c'est ce texte que l'application affiche pour corriger l'exercice à trous.

ordresValidesles autres ordres corrects des segments, en index (le premier segment est 0). Utile car les compléments de temps et de lieu sont mobiles en japonais. Sans ce champ, seul l'ordre écrit est accepté.

niveaudifficulté de la phrase : 1, 2, 3…

Règle d'or de la segmentation : mis bout à bout, les txt doivent reconstituer exactement le champ jp, ponctuation comprise.

Conseil de contenu : n'utilisez dans vos phrases que des mots de la liste, ou de listes que vous connaissez déjà. Un mot inconnu dans un exercice de grammaire ajoute une difficulté qui n'a rien à y faire.

5. Les listes de kanji (format à part)

{
  "titre": "Kanji de l'eau",
  "kanjis": ["水", "海", "川", "雨", "泳"]
}

Deux champs, et c'est tout : titre et kanjis.

Un seul caractère par entrée. "日本" est refusé : c'est un mot, il va dans une liste de vocabulaire. Écrivez ["日", "本"].
Ne fournissez rien d'autre : ni sens, ni lectures, ni niveau. L'application les remplit depuis KANJIDIC2. C'est volontaire : aucune donnée inventée.
Un kanji absent du référentiel est refusé, avec son nom dans le message d'erreur. En pratique, tous les kanji courants y sont (10 384 caractères).
Les doublons sont ignorés silencieusement, et l'id est dérivé du titre : pas besoin de le fournir.

La bonne stratégie : une liste de kanji pour travailler les caractères un par un, et une liste de vocabulaire assortie dont les mots réutilisent ces kanji. L'application fait le lien toute seule : la fiche de chaque kanji affiche les mots connus qui le contiennent.

6. Les conversations (format à part)

{
  "id": "ma-conv-01",
  "titre": "Au restaurant",
  "personnage": "店員さん",
  "genre": "femme",
  "age": "adulte",
  "description": "Commander un plat, poliment.",
  "messages": [
    { "de": "autre", "jp": "いらっしゃいませ。",
      "kana": "いらっしゃいませ。", "fr": "Bienvenue !" },
    { "de": "moi", "jp": "ラーメンをください。",
      "kana": "ラーメンをください。", "fr": "Un ramen, s'il vous plaît.",
      "choix": [
        { "jp": "ラーメンをください。", "kana": "ラーメンをください。",
          "fr": "Un ramen, s'il vous plaît.", "ok": true },
        { "jp": "ラーメン！", "kana": "ラーメン！", "fr": "Un ramen !",
          "erreur": "Trop abrupt avec un serveur : on ajoute をください.",
          "type": "registre" }
      ] }
  ]
}

obligatoiresid, titre, personnage et messages (non vide).

personnagele nom de l'interlocuteur, affiché comme un contact de messagerie (par exemple 田中さん).

genreoptionnel : homme ou femme. Choisit l'avatar du bon registre.

ageoptionnel : enfant, ado, lyceen, adulte ou senior. Affine l'avatar.

avataroptionnel : un emoji qui remplace l'avatar, par exemple 🦊.

deautre pour l'interlocuteur, moi pour vos répliques. Obligatoire sur chaque message, avec jp et fr.

kanaoptionnel mais recommandé : le furigana de la bulle, et la lecture utilisée par la voix.

audiooptionnel, true : le message arrive comme un message vocal, lu par la voix du téléphone. Texte et traduction restent masqués jusqu'au clic. Excellent pour la compréhension orale, à réserver à quelques messages.

choixoptionnel, uniquement sur les messages de moi : les répliques proposées en mode interactif. Au moins deux, avec exactement une portant "ok": true. Chaque mauvaise réponse doit expliquer son erreur.

typesur un choix faux : registre signifie faute de politesse, comprise mais inadaptée, et la conversation continue. Sans ce champ, c'est une faute de langue et l'interlocuteur ne comprend pas.

acceptoptionnel : les réponses supplémentaires admises au clavier, en plus de jp et kana. Une même idée se dit souvent de plusieurs façons.

Ce qui fait une bonne conversation : huit à seize messages, une scène du quotidien cohérente, un registre poli par défaut, et des choix qui piègent surtout sur la politesse. Au Japon, c'est la faute qui compte le plus.

7. Importer votre fichier

Ce que vous avez écrit	Reconnu par	Où l'importer dans l'application
Liste de vocabulaire	`"items"`	Onglet Listes, icône de téléchargement, puis « Importer le JSON collé » ou « Importer un fichier .json »
Phrases seules	un tableau, ou `"phrases"`	Détail d'une liste, « Ajouter une phrase », puis « Coller des phrases (JSON) »
Liste de kanji	`"kanjis"` sans `"items"`	Onglet Kanji, Apprendre, « Gérer mes listes (import JSON) »
Conversation	`"messages"` et `"personnage"`	Onglet Plus, Conversations, onglet « Importées »

Le plus simple : enregistrez votre JSON en fichier .json et ouvrez-le depuis votre téléphone. Rakasu apparaît dans les applications proposées et reconnaît toute seule de quel format il s'agit. Sinon, collez le texte dans l'écran d'import correspondant.

En cas de refus, l'application liste chaque problème avec l'item et le champ fautifs : corrigez, puis réessayez. Et si une erreur vous semble venir de l'application elle-même, signalez-la.

Et si je veux me faire aider par une IA ?

C'est possible, et parfois pratique pour dégrossir une longue liste. La méthode : copiez cette page (elle contient tout le format) et donnez-la à l'assistant de votre choix en précisant votre thème et votre niveau.

Mais relisez toujours ce qui en sort. Une IA se trompe régulièrement sur les lectures, invente des traductions littérales approximatives, et confond les types de verbes. Une liste fausse s'apprend aussi bien qu'une liste juste : c'est tout le problème. Le contenu que vous avez écrit ou vérifié vous-même vaudra toujours mieux.

Deux garde-fous qui vous protègent : l'application refuse tout fichier mal formé, et elle ignore les champs pitch et les fiches de kanji qu'une IA aurait inventés, puisque ces données viennent de ses propres référentiels.

Une fois vos listes prêtes

Gardez-les pour vous

Importez le fichier dans l'application : il reste sur votre appareil, comme tout le reste. Rien ne part sur un serveur.

Ou partagez-les

Publiez-les dans la bibliothèque du site pour que d'autres en profitent, et regroupez-les en parcours avec un code de partage.

Publier une liste

Repartez d'une liste existante

Dans l'application, un appui long sur un mot le copie en JSON : pratique pour voir un exemple réel, ou pour signaler une erreur.

Voir la bibliothèque