Créer des decks et des fiches

1. Avant de commencer

Qu'est-ce qu'un deck

Un deck est une collection nommée de fiches. Chaque fiche a un Titre (libellé dans la liste, lu en premier) et un Contenu (corps principal ; Markdown pris en charge). Deck Reader prépare l'audio vocal (M4A) pour que vous puissiez étudier mains libres — comme une playlist de sujets.

Gratuit vs Plus (limites de création)

L'importation est disponible en version Gratuite dans ces limites.

Mode Formaté vs balises

Dans l'éditeur de fiches, l'icône markdown bascule entre Formaté (aperçu mis en forme ; images sous forme de pastilles [Alt: filename]) et balises visibles (source brute). Activez les balises visibles pour éditer les régions [caption] — Formaté les masque entièrement.

2. Comment créer un deck

1. Ouvrez la Bibliothèque de decks (écran d'accueil).
2. Appuyez sur + (créer) dans la barre d'outils inférieure.
3. Saisissez un nom de deck → confirmez.
4. Appuyez sur le nouveau deck pour ouvrir la liste de fiches.

Optionnel plus tard : renommer en mode édition de la bibliothèque ; activer la Génération automatique sur la liste de fiches pour que l'audio manquant se prépare à l'ouverture du deck ou à l'enregistrement des fiches ; utiliser Importer de la bibliothèque pour les fichiers .deckreader.csv ou les bundles ZIP ; parcourir le catalogue via Télécharger des decks.

Choisissez un nom clair et unique (l'importation correspond par nom). Lorsque vous publiez des mises à jour, incrémentez la Version du deck (MAJOR.MINOR.PATCH) pour que les lecteurs existants puissent choisir Mettre à jour.

3. Comment créer une fiche simple

Objectif : texte brut uniquement — Markdown non requis.

1. Ouvrez un deck → liste de fiches.
2. Appuyez sur + pour Ajouter une fiche (ou ouvrez une fiche → Modifier).
3. Renseignez le Titre (obligatoire pour enregistrer).
4. Renseignez le Contenu avec des paragraphes ordinaires. Séparez les idées par une ligne vide.
5. Appuyez sur Enregistrer.

Title: Photosynthesis

Content:
Plants convert light into chemical energy.

They use carbon dioxide and water.
Oxygen is released as a by-product.

Optionnel : définissez la langue/la voix sur les pastilles microphone ; utilisez la Génération automatique du deck ou le ↺ de la liste pour préparer la voix. En version Gratuite, le Contenu s'arrête à 150 caractères en édition.

4. Comment créer des fiches formatées (Markdown)

Deck Reader stocke le Markdown dans le Titre et le Contenu. Les délimiteurs doivent toucher le texte (**bold**, pas ** bold **). Utilisez la barre d'outils inférieure (Texte, Paragraphe, Insérer, Tableaux, Ω) ou saisissez le balisage avec les balises visibles.

4.1 Mise en forme du texte

Couleurs : Black, Gray, Brown, Blue, Cyan, Green, Purple, Red, Pink, Orange, Yellow, White. Fermez toujours avec [/]. La voix lit uniquement les mots intérieurs.

Titres : un à huit # au début d'une ligne, puis un espace (H1–H6, puis B1 / B2 en dessous de la taille du corps).

4.2 Paragraphes et structure

Les citations sur plusieurs paragraphes conservent > sur les lignes vides entre les paragraphes. Une ligne vide sans > termine la citation.

> First paragraph.
>
> Second paragraph.

4.3 Insertion d'éléments

Liens

• Lien → [label](https://example.com)
• Lien rapide → URL comme libellé et cible
• Lien vers la même fiche → [label](#heading-anchor) depuis un titre dans la même fiche

E-mail

• E-mail → <name@example.com>
• E-mail rapide → adresse nue

Images

1. Insérer → Image.
2. Choisissez un fichier ou réutilisez une image de la bibliothèque du deck.
3. Taille optionnelle en dp : {w:240}, {h:200}, ou les deux ; clés de bordure optionnelles.

![Sales chart](deckimg:a1b2c3d4e5f67890_chart.png){w:240}

• Plusieurs images sur la même ligne s'affichent côte à côte ; les images fonctionnent dans les cellules de tableau.
• Dans les blocs de code ou le code en ligne, la syntaxe d'image reste littérale (non dessinée comme bitmap).
• Les fichiers manquants affichent un avertissement rouge avec la source markdown complète sur le lecteur.
• Audio : mot image localisé + alt, puis [caption] optionnelle.

Symboles (Ω)

Mathématiques, symboles et caractères de dessin de boîtes. Sur tablette, la boîte à outils latérale insère les mêmes glyphes rapidement.

4.4 Tableaux

Utilisez le menu Tableaux (Plus) ou saisissez une grille de style GFM :

| Term | Meaning |
| :--- | :--- |
| ATP | Energy currency |
| Chlorophyll | Light-absorbing pigment |

• Alignement des colonnes : :--- / :---: / ---: ; chiffres de largeur % optionnels dans les tirets.
• Ligne de style optionnelle avant l'en-tête : |{w:200; t:1; b:1}| (largeur en caractères).
• Continuer une cellule : terminez par ^^ puis continuez sur la ligne suivante.
• [br] démarre un paragraphe visuel dans une cellule (l'audio joint avec un espace).
• Le w: de tableau est en caractères ; le {w:} d'image est en dp — ne mélangez pas les unités.

4.5 Balises audio spéciales Deck Reader

Depuis le menu Paragraphe :

• Ignorer — omet une section mais indique à l'auditeur qu'un passage a été ignoré.
• Couper — notes de l'enseignant ou spoilers à l'écran uniquement ; audio fluide.
• Légende — décrit un graphique ou une image dans l'audio sans encombrer la fiche.

![Trend](deckimg:trend-chart.png){w:280}
[caption]The line climbs steadily from left to right.[/caption]

[GREEN]Pass[/] criteria met. [skip](see appendix)[/skip] Next topic.
[mute]Teacher note: discuss edge cases here.[/mute] Continue with examples.

Ne confondez pas le texte alt de l'image, la pastille image en mode Formaté et [caption] — alt est le libellé court sur la fiche/dans l'audio ; la légende est la description plus longue, audio uniquement.

5. Voix, langues et préparation de l'audio

1. Voix par défaut de l'app — Paramètres → Configurer la voix.
2. Pastilles par champ — Titre et Contenu peuvent utiliser des langues/voix différentes (étude bilingue).
3. Génération automatique — bascule sur la liste de fiches ; met en file l'audio manquant à l'ouverture du deck / après enregistrement.
4. Générer à l'enregistrement — barre supérieure de l'éditeur lorsque la génération automatique est activée (ignorer la voix pour un enregistrement).
5. ↺ manuel — mettre en file ou actualiser ; appuyez sur l'indicateur/anneau pour retirer de la file.

Privilégiez des phrases claires ; les retours à la ligne forcés deviennent des phrases parlées distinctes. [br] est visuel uniquement. Les règles horizontales et le dessin de boîtes sont silencieux/omis dans l'audio.

6. Import, export et versions de deck

Export (Plus) : texte seul .deckreader.csv, texte + images .deckreader.images.zip, ou texte + images + M4A .deckreader.media.zip.

Import : Bibliothèque → Importer → choisissez CSV ou ZIP. Même nom de deck :

• Version du deck supérieure → Mettre à jour (titres correspondants remplacés) ou Annuler.
• Même / version inférieure → Fusionner (ajoute des fiches ; contenu différent en collision reçoit un suffixe) ou Annuler.

Incrémentez le SemVer lorsque vous publiez un deck amélioré pour que les lecteurs empruntent le chemin Mettre à jour.

7. Conseils, échappements et pièges courants

Afficher la syntaxe comme texte littéral

Privilégiez le code en ligne pour les exemples, ou échappez les caractères de balisage avec une barre oblique inverse (\*, \[, \{, …).

Appariement strict

**bold** fonctionne ; ** bold** non.

Retour à la ligne

Le retour à la ligne de l'éditeur est activé par défaut. Désactivez-le pour faire défiler les tableaux larges horizontalement.

Enregistrement vs reconstruction de la voix

L'audio existant est conservé lorsque le texte parlé, les cibles de liens et les réglages de voix sont inchangés. Joindre des lignes sans point reconstruit généralement la voix.

Liste de contrôle pour une fiche soignée

1. Titre clair.
2. Structurez le Contenu avec des titres / listes si utile.
3. Images dimensionnées en dp ; largeurs de tableau en caractères.
4. Légendes pour les graphiques via [caption].
5. Couper ou ignorer les notes réservées à l'enseignant.
6. Prévisualisez les pastilles voix si bilingue.
7. Enregistrer → confirmez que l'audio se prépare ou mettez en file ↺.

8. Référence rapide

Carte de la barre d'outils

Aide-mémoire de balisage

**bold**  *italic*  ++underline++  ~~strike~~  `code`
[RED]colored[/]
# H1 … ######## B2
:-  :-:  -:
- bullet    1. numbered
> quote
[label](https://…)   [label](#anchor)   <a@b.c>
![alt](deckimg:file.png){w:240}
[skip]…[/skip]  [mute]…[/mute]  [caption]…[/caption]
\  escapes the next markup character

9. Créer un deck hors de Deck Reader (éditeur de texte + ZIP)

Vous pouvez rédiger sur un ordinateur (éditeur de texte, tableur ou scripts) puis importer via Bibliothèque → Importer — les mêmes formats que Deck Reader exporte.

Choisir un format

Structure du ZIP (CSV + images)

Placez ces entrées au niveau racine du ZIP (pas dans un dossier supplémentaire) :

manifest.json minimal (images seules ; la voix sera générée plus tard dans l’app) :

{
  "formatVersion": 1,
  "bundleType": "text_only",
  "deckName": "My deck",
  "cardCount": 2,
  "cards": []
}

Bases de deck.csv

• Enregistrez en UTF-8 (UTF-8 avec BOM convenable depuis Excel).
• Incluez les lignes de métadonnées si possible (Deck Version en MAJOR.MINOR.PATCH). Une version manquante vaut 1.0.0.
• La ligne d’en-tête doit au moins contenir Title et Content (l’ancien Definition est encore accepté).
• Colonnes facultatives langue / voix / débit / hauteur — laissez-les vides pour les valeurs par défaut de l’app.

Images

1. Placez les fichiers sous media/ (ex. media/badge.png).
2. Référencez-les en markdown : ![Badge](deckimg:badge.png) (taille optionnelle {w:240} en dp).
3. Deck Reader réécrit les noms internes à l’import. Les fichiers manquants affichent un avertissement rouge dans le lecteur.

Construire et importer

1. Zippez deck.csv, media/ (le cas échéant) et manifest.json en {name}.deckreader.images.zip.
2. Copiez le fichier sur l’appareil.
3. Bibliothèque → Importer → sélectionnez le CSV ou le ZIP.

Astuce : exportez une fois un petit deck depuis Deck Reader et ouvrez le ZIP sur le PC — c’est le modèle le plus simple pour les noms et les métadonnées.

10. Suggestion : HTML → Markdown → deck

Si vous avez déjà des notes en HTML (exports Docs, Notion, site web ou wiki personnel), un flux pratique est :

1. HTML → Markdown — utilisez un convertisseur en ligne fiable (ou un outil local comme Pandoc) pour obtenir du Markdown que Deck Reader peut stocker.
2. Nettoyez le Markdown — vérifiez titres, listes, liens et tableaux ; remplacez les images distantes par des fichiers dans media/ et des références deckimg: ; ajoutez [skip] / [mute] / [caption] si utile.
3. Découpez en fiches — un sujet par fiche (Title clair, corps dans Content). Numérotez les titres (01:, 02:, …) si vous voulez que l’ordre alphabétique suive votre plan.
4. Construisez le CSV ou le ZIP — comme à la section 9, puis Importer dans Deck Reader et générez la voix.

La qualité des convertisseurs en ligne varie. Préférez ceux qui préservent titres et liens, puis vérifiez quelques fiches dans l’app avant de publier un deck complet. Conservez une copie de l’HTML d’origine jusqu’à ce que l’import soit correct.