Créer ses listes

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.

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.

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.

Une conversation n'est pas forcément un couloir. Plusieurs choix peuvent être justes en même temps : chacun ouvre alors sa propre branche, grâce au champ suite. Accepter ou refuser une invitation sont deux réponses correctes qui mènent à deux suites différentes.

{
  "de": "moi",
  "jp": "うん、好きだよ。",
  "kana": "うん、すきだよ。",
  "fr": "Oui, j'aime bien.",
  "choix": [
    { "jp": "うん、好きだよ。", "kana": "うん、すきだよ。",
      "fr": "Oui, j'aime bien.", "ok": true,
      "suite": [
        { "de": "autre", "jp": "私も！", "kana": "わたしも！",
          "fr": "Moi aussi !" }
      ] },
    { "jp": "あまり好きじゃない。", "kana": "あまりすきじゃない。",
      "fr": "Pas trop.", "ok": true,
      "suite": [
        { "de": "autre", "jp": "そっか。", "kana": "そっか。",
          "fr": "Ah bon." }
      ] },
    { "jp": "好きがない。", "kana": "すきがない。", "fr": "(tournure fausse)",
      "erreur": "La négation de 好き est 好きじゃない, pas 好きがない." }
  ]
}

Après la suite, la conversation reprend au tronc commun, c'est-à-dire aux messages qui suivent dans la liste principale. Pour créer de vraies fins différentes, mettez tout dans les suite et ne placez plus rien après ce message dans le tronc.

Les règles à respecter :

• suite n'est permise que sur un choix juste ou une faute de registre : une erreur de langue ne fait pas avancer le dialogue, l'apprenant doit se reprendre ;
• les messages d'une suite suivent exactement les mêmes règles que les autres, et peuvent contenir leurs propres choix, donc des sous-branches ;
• gardez les branches courtes, deux à quatre messages, et faites-les reconverger sur le tronc ;
• au clavier, votre saisie est comparée à tous les choix justes et route vers la bonne branche : écrivez donc des choix justes bien distincts les uns des autres.

Inutile de lister toutes les variantes dans accept : la validation est déjà souple.

• la ponctuation et les espaces sont ignorés (。、！？ facultatifs) ;
• une coquille d'un caractère est tolérée sur une réponse d'au moins cinq caractères ;
• l'analyse morphologique accepte la même phrase sous une autre forme, avec une remarque (飲みます pour 飲む, ですよ pour だよ) ;
• une réplique au registre inadapté, si elle figure dans les choix, est reconnue comme faute de politesse et non comme erreur.

accept ne sert donc qu'aux vraies variantes : une autre formulation naturelle (ラーメンおねがいします), une version raccourcie plausible (そうだね → うん).

• 8 à 14 messages, en alternant l'interlocuteur et vous, avec un début et une fin naturels ;
• 2 à 4 répliques avec des choix (deux ou trois choix chacune), les autres peuvent être simples ;
• le registre doit coller au personnage : un inconnu adulte parle poli, un ami ado parle familier, et les pièges de registre doivent correspondre à la scène ;
• des pièges plausibles : une particule crédible mais fausse, une réponse littérale qui répond à côté, un registre décalé. Jamais du charabia évident ;
• la faute de politesse est la plus importante à travailler en japonais : mettez-en souvent une dans les choix.

Pas besoin de tout retaper : l'application importe un deck Anki exporté en JSON par l'extension CrowdAnki, dans le même écran que les listes de vocabulaire. La détection est automatique.

Ce qui est repris tout seul :

• les champs sont reconnus par leur nom (Expression, Vocab, Word, Reading, Furigana, Meaning, Sens, Translation…) ;
• le furigana à la mode Anki, 食[た]べる, est décomposé en mot et lecture ;
• le HTML et les balises [sound:…] sont nettoyés.

Trois limites, dites franchement :

• le format natif .apkg ne fonctionne pas (c'est une base compressée) : il faut l'export JSON de l'extension CrowdAnki. Les exports CSV ou texte ne sont pas lus non plus ;
• tous les mots arrivent avec le type expression, donc sans conjugaison : reprécisez les verbes et les adjectifs dans un JSON de liste si vous voulez ces exercices ;
• une note contenant des kanji sans champ de lecture est refusée, note par note. C'est volontaire : l'application n'invente jamais une prononciation.

La traduction littérale reprend la traduction simple, faute de mieux : à compléter à la main si ce champ vous intéresse.

Le champ id d'une liste sert à la reconnaître. La règle est la même dans l'application et sur ce site :

• Même id et même titre : c'est une mise à jour. La liste est remplacée par la nouvelle version, et votre progression sur les mots identiques est conservée. C'est ainsi que l'on corrige une liste ou qu'on la complète.
• Même id mais titre différent : ce sont deux listes différentes qui portent le même identifiant, par hasard. Rien n'est écrasé : un identifiant libre est dérivé automatiquement (ma-liste-2).

Autrement dit, vous ne pouvez pas perdre une liste par accident, ni écraser celle de quelqu'un d'autre. Sur le site, une mise à jour n'est possible que sur vos propres listes, et elle conserve le lien public ainsi que le compteur de téléchargements.

Mettre à jour une liste déjà publiée

Depuis votre compte, chaque liste porte un bouton Mettre à jour : vous envoyez le nouveau fichier, il remplace l'ancien sous le même lien. Ce qui se passe ensuite est automatique :

• Le site incrémente lui-même le numéro de version. Vous n'avez rien à écrire dans le fichier, et un numéro qui s'y trouve n'est pas repris : c'est le site qui fait autorité.
• Les personnes qui ont déjà importé la liste dans l'application se voient proposer la mise à jour au lancement suivant, et leur progression est conservée mot par mot.
• Si le contenu envoyé est identique à celui en ligne, rien ne bouge : personne n'est invité à retélécharger pour rien.
• Le titre doit rester exactement le même. C'est lui, avec l'identifiant, qui permet à l'application de reconnaître la liste ; s'il change, elle croit à une autre liste et ne propose aucune mise à jour. Le site refuse donc ce cas et vous le dit.

Cas particuliers : une liste de kanji n'a pas de champ id (il est dérivé du titre), donc réimporter la même crée une seconde liste. Une conversation de même id est, elle, toujours remplacée.

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.