Creare deck e schede

1. Prima di iniziare

Cos'è un deck

Un deck è una raccolta denominata di schede. Ogni scheda ha un Titolo (etichetta nell'elenco, letto per primo) e un Contenuto (corpo principale; Markdown supportato). Deck Reader prepara l'audio vocale (M4A) così puoi studiare a mani libere — come una playlist di argomenti.

Free vs Plus (limiti per autori)

L'importazione è disponibile con Free entro questi limiti.

Modalità Pretty vs tag visibili

Nell'editor delle schede, l'icona Markdown attiva Pretty (anteprima formattata; immagini come chip [Alt: filename]) oppure tag visibili (sorgente grezza). Attiva i tag visibili quando modifichi regioni [caption] — Pretty le nasconde del tutto.

2. Come creare un deck

1. Apri la Libreria deck (schermata iniziale).
2. Tocca + (crea) nella barra inferiore.
3. Inserisci un nome deck → conferma.
4. Tocca il nuovo deck per aprire l'elenco schede.

In seguito, opzionale: rinomina in modalità modifica libreria; attiva Generazione automatica sull'elenco schede così l'audio mancante viene preparato all'apertura del deck o al salvataggio; usa Importa in libreria per .deckreader.csv o pacchetti ZIP; sfoglia il catalogo con Scarica deck.

Usa un nome chiaro e univoco (l'importazione corrisponde per nome). Quando pubblichi aggiornamenti, incrementa la Versione deck (MAJOR.MINOR.PATCH) così i lettori esistenti possono scegliere Aggiorna.

3. Come creare una scheda semplice

Obiettivo: solo testo semplice — Markdown non richiesto.

1. Apri un deck → elenco schede.
2. Tocca + per Aggiungi scheda (oppure apri una scheda → Modifica).
3. Compila Titolo (obbligatorio per salvare).
4. Compila Contenuto con paragrafi ordinari. Separa le idee con una riga vuota.
5. Tocca Salva.

Title: Photosynthesis

Content:
Plants convert light into chemical energy.

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

Opzionale: imposta lingua/voce sui chip del microfono; usa la generazione automatica del deck o ↺ nell'elenco per preparare la voce. Con Free, il Contenuto si ferma a 150 caratteri durante la modifica.

4. Come creare schede formattate (Markdown)

Deck Reader memorizza Markdown in Titolo e Contenuto. I delimitatori devono toccare il testo (**bold**, non ** bold **). Usa la barra inferiore (Testo, Paragrafo, Inserimento, Tabelle, Ω) oppure digita il markup con i tag visibili.

4.1 Formattazione testo

Colori: Black, Gray, Brown, Blue, Cyan, Green, Purple, Red, Pink, Orange, Yellow, White. Chiudi sempre con [/]. La voce legge solo le parole interne.

Titoli: da uno a otto # all'inizio di riga, poi uno spazio (H1–H6, poi B1 / B2 sotto la dimensione del corpo).

4.2 Paragrafi e struttura

Le citazioni multi-paragrafo mantengono > sulle righe vuote tra i paragrafi. Una riga vuota senza > termina la citazione.

> First paragraph.
>
> Second paragraph.

4.3 Inserimento elementi

Link

• Link → [label](https://example.com)
• Link rapido → URL come etichetta e destinazione
• Link alla stessa scheda → [label](#heading-anchor) da un titolo nella stessa scheda

Email

• Email → <name@example.com>
• Email rapida → indirizzo nudo

Immagini

1. Inserimento → Immagine.
2. Scegli un file o riusa un'immagine della libreria del deck.
3. Dimensione opzionale in dp: {w:240}, {h:200}, o entrambe; chiavi bordo opzionali.

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

• Più immagini sulla stessa riga vengono renderizzate affiancate; le immagini funzionano nelle celle delle tabelle.
• Nei recinti di codice o nel codice inline, la sintassi immagine resta letterale (non disegnata come bitmap).
• I file mancanti mostrano un avviso rosso con l'intera sorgente markdown nel lettore.
• Voce: parola immagine localizzata + alt, poi opzionale [caption].

Simboli (Ω)

Matematica, simboli e caratteri box-drawing. Sui tablet, la toolbox laterale inserisce gli stessi glifi rapidamente.

4.4 Tabelle

Usa il menu Tabelle (Plus) oppure digita una griglia in stile GFM:

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

• Allineamento colonna: :--- / :---: / ---:; cifre % larghezza opzionali nei trattini.
• Riga stile opzionale prima dell'intestazione: |{w:200; t:1; b:1}| (larghezza in caratteri).
• Continua una cella: termina con ^^ poi continua sulla riga successiva.
• [br] avvia un paragrafo visivo in una cella (la voce unisce con uno spazio).
• Il w: della tabella è in caratteri; il {w:} dell'immagine è in dp — non confondere le unità.

4.5 Etichette vocali speciali Deck Reader

Dal menu Paragrafo:

• Salta — ometti una sezione ma informa l'ascoltatore che qualcosa è stato saltato.
• Silenzia — note del docente o spoiler solo a schermo; audio continuo.
• Didascalia — descrivi un grafico o un'immagine in voce senza ingombrare la scheda.

![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.

Non confondere il testo alt dell'immagine, il chip immagine in modalità Pretty e [caption] — alt è l'etichetta breve sulla scheda/in voce; la didascalia è la descrizione più lunga solo audio.

5. Voce, voci e preparazione audio

1. Voce predefinita app — Impostazioni → Configura voce sintesi.
2. Chip per campo — Titolo e Contenuto possono usare lingue/voci diverse (studio bilingue).
3. Generazione automatica — interruttore elenco schede; accoda l'audio mancante all'apertura del deck / dopo il salvataggio.
4. Genera al salvataggio — barra superiore editor quando la generazione automatica è attiva (salta la voce per un salvataggio).
5. ↺ manuale — accoda o aggiorna; tocca lo spinner/anello per rimuovere dalla coda.

Preferisci frasi chiare; le interruzioni di riga diventano frasi pronunciate separate. [br] è solo visivo. Regole orizzontali e box-drawing sono silenziosi/omessi in voce.

6. Importazione, esportazione e versioni deck

Esportazione (Plus): solo testo .deckreader.csv, testo + immagini .deckreader.images.zip, oppure testo + immagini + M4A .deckreader.media.zip.

Importazione: Libreria → Importa → scegli CSV o ZIP. Stesso nome deck:

• Versione deck più alta → Aggiorna (titoli corrispondenti sostituiti) o Annulla.
• Stessa versione / inferiore → Unisci (aggiunge schede; contenuto diverso in collisione riceve un suffisso) o Annulla.

Incrementa SemVer quando pubblichi un deck migliorato così i lettori ottengono il percorso Aggiorna.

7. Suggerimenti, escape e insidie comuni

Mostrare la sintassi come testo letterale

Preferisci il codice inline per gli esempi, oppure caratteri di escape con backslash (\*, \[, \{, …).

Accoppiamento rigoroso

**bold** funziona; ** bold** no.

A capo automatico

L'a capo automatico nell'editor è attivo per impostazione predefinita. Disattivalo per scorrere orizzontalmente tabelle larghe.

Salvataggio vs rigenerazione voce

L'audio esistente viene conservato quando testo parlato, destinazioni link e impostazioni voce restano invariati. Unire righe senza punto di solito rigenera la voce.

Checklist scheda rifinita

1. Titolo chiaro.
2. Struttura Contenuto con titoli / elenchi dove utile.
3. Immagini dimensionate in dp; larghezze tabella in caratteri.
4. Didascalie per grafici tramite [caption].
5. Silenzia o salta note solo per docente.
6. Anteprima chip voce se bilingue.
7. Salva → conferma che l'audio si prepara o accoda ↺.

8. Riferimento rapido

Mappa barra strumenti

Scheda sintassi markup

**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. Creare un mazzo fuori da Deck Reader (editor di testo + ZIP)

Puoi scrivere al computer (editor di testo, foglio di calcolo o script) e importare con Libreria → Importa — gli stessi formati che Deck Reader esporta.

Scegli un formato

Struttura dello ZIP (CSV + immagini)

Metti queste voci al livello principale dello ZIP (non dentro una cartella extra):

manifest.json minimo (solo immagini; la voce si genera dopo nell’app):

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

Basi di deck.csv

• Salva in UTF-8 (UTF-8 con BOM va bene da Excel).
• Includi le righe di metadati quando puoi (Deck Version come MAJOR.MINOR.PATCH). Se manca, vale 1.0.0.
• L’intestazione richiede almeno Title e Content (il legacy Definition viene ancora importato).
• Colonne opzionali lingua / voce / velocità / tono — lasciale vuote per i valori predefiniti dell’app.

Immagini

1. Metti i file in media/ (es. media/badge.png).
2. Riferiscile in markdown: ![Badge](deckimg:badge.png) (dimensione opzionale {w:240} in dp).
3. Deck Reader riscrive i nomi interni all’importazione. I file mancanti mostrano un avviso rosso nel player.

Creare e importare

1. Comprimi deck.csv, media/ (se presente) e manifest.json come {name}.deckreader.images.zip.
2. Copia il file sul dispositivo.
3. Libreria → Importa → seleziona il CSV o lo ZIP.

Suggerimento: esporta una volta un mazzo piccolo da Deck Reader e aprilo sul PC — è il modello più semplice per nomi e metadati.

10. Suggerimento: HTML → Markdown → mazzo

Se hai già appunti in HTML (export da Docs, Notion, un sito o un wiki personale), un flusso pratico è:

1. HTML → Markdown — usa un convertitore online affidabile (o uno strumento locale come Pandoc) per ottenere Markdown che Deck Reader può memorizzare.
2. Pulisci il Markdown — controlla titoli, elenchi, link e tabelle; sostituisci immagini remote con file in media/ e riferimenti deckimg:; aggiungi [skip] / [mute] / [caption] dove serve.
3. Dividi in schede — un argomento per scheda (Title chiaro, corpo in Content). Numera i titoli (01:, 02:, …) se vuoi che l’ordine alfabetico segua lo schema.
4. Crea il CSV o lo ZIP — come nella sezione 9, poi Importa in Deck Reader e genera l’audio.

La qualità dei convertitori online varia. Preferisci quelli che preservano titoli e link, poi verifica alcune schede nell’app prima di pubblicare un mazzo intero. Conserva una copia dell’HTML originale finché l’importazione non è a posto.