Criar baralhos e cartas

1. Antes de começar

O que é um baralho

Um baralho é uma coleção nomeada de cartas. Cada carta tem um Título (rótulo na lista, falado primeiro) e Conteúdo (corpo principal; Markdown suportado). O Deck Reader prepara áudio de fala (M4A) para você estudar sem usar as mãos — como uma playlist de tópicos.

Free vs Plus (limites de criação)

A importação está disponível na versão Free dentro desses limites.

Modo Pretty vs tags

No editor de cartas, o ícone de markdown alterna entre Pretty (visualização formatada; imagens como chips [Alt: filename]) e tags visíveis (código-fonte bruto). Ative tags visíveis ao editar regiões [caption] — o Pretty as oculta por completo.

2. Como criar um baralho

1. Abra a Biblioteca de baralhos (tela inicial).
2. Toque em + (criar) na barra de ferramentas inferior.
3. Digite um nome para o baralho → confirme.
4. Toque no novo baralho para abrir a lista de cartas.

Opcionalmente, depois: renomeie no modo de edição da biblioteca; ative Auto-generate na lista de cartas para que o áudio ausente seja preparado ao abrir o baralho ou salvar cartas; use Import na biblioteca para arquivos .deckreader.csv ou pacotes ZIP; explore o catálogo em Download decks.

Use um nome claro e único (a importação corresponde pelo nome). Ao publicar atualizações, incremente a Deck Version (MAJOR.MINOR.PATCH) para que leitores existentes possam escolher Update.

3. Como criar uma carta simples

Objetivo: apenas texto simples — sem Markdown.

1. Abra um baralho → lista de cartas.
2. Toque em + para Add topic (ou abra uma carta → Edit).
3. Preencha o Título (obrigatório para salvar).
4. Preencha o Conteúdo com parágrafos comuns. Separe ideias com uma linha em branco.
5. Toque em Save.

Title: Photosynthesis

Content:
Plants convert light into chemical energy.

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

Opcional: defina idioma/voz nos chips de microfone; use Auto-generate do baralho ou o ↺ da lista para preparar a fala. Na versão Free, o Conteúdo para em 150 caracteres durante a edição.

4. Como criar cartas formatadas (Markdown)

O Deck Reader armazena Markdown no Título e no Conteúdo. Os delimitadores devem encostar no texto (**bold**, não ** bold **). Use a barra de ferramentas inferior (Text, Paragraph, Insert, Tables, Ω) ou digite a marcação com tags visíveis.

4.1 Formatação de texto

Cores: Black, Gray, Brown, Blue, Cyan, Green, Purple, Red, Pink, Orange, Yellow, White. Sempre feche com [/]. A fala lê apenas as palavras internas.

Títulos: de um a oito # no início da linha, seguidos de um espaço (H1–H6, depois B1 / B2 abaixo do tamanho do corpo).

4.2 Parágrafos e estrutura

Citações com vários parágrafos mantêm > nas linhas em branco entre parágrafos. Uma linha em branco sem > encerra a citação.

> First paragraph.
>
> Second paragraph.

4.3 Inserir elementos

Links

• Link → [label](https://example.com)
• Quick link → URL como rótulo e destino
• Same card link → [label](#heading-anchor) a partir de um título na mesma carta

E-mail

• Email → <name@example.com>
• Quick email → endereço simples

Imagens

1. Insert → Image.
2. Escolha um arquivo ou reutilize uma imagem da biblioteca do baralho.
3. Tamanho opcional em dp: {w:240}, {h:200}, ou ambos; chaves de borda opcionais.

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

• Várias imagens na mesma linha aparecem lado a lado; imagens funcionam em células de tabela.
• Dentro de cercas de código ou código inline, a sintaxe de imagem permanece literal (não é desenhada como bitmap).
• Arquivos ausentes exibem um aviso vermelho com o markdown completo no player.
• Fala: palavra de imagem localizada + alt, depois [caption] opcional.

Símbolos (Ω)

Matemática, símbolos e caracteres de desenho de caixas. Em tablets, a caixa de ferramentas lateral insere os mesmos glifos rapidamente.

4.4 Tabelas

Use o menu Tables (Plus) ou digite uma grade no estilo GFM:

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

• Alinhamento de coluna: :--- / :---: / ---:; dígitos de largura % opcionais nos traços.
• Linha de estilo opcional antes do cabeçalho: |{w:200; t:1; b:1}| (largura em caracteres).
• Continuar uma célula: termine com ^^ e continue na linha seguinte.
• [br] inicia um parágrafo visual em uma célula (a fala junta com um espaço).
• w: de tabela é em caracteres; {w:} de imagem é em dp — não misture as unidades.

4.5 Tags especiais de fala do Deck Reader

No menu Paragraph:

• Skip — omita uma seção, mas avise o ouvinte que algo foi pulado.
• Mute — notas do professor ou spoilers só na tela; áudio contínuo.
• Caption — descreva um gráfico ou imagem na fala sem poluir a carta.

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

Não confunda o texto alt da imagem, o chip de imagem no modo Pretty e [caption] — alt é o rótulo curto na carta/fala; caption é a descrição mais longa só no áudio.

5. Fala, vozes e preparação de áudio

1. Voz padrão do app — Settings → Configure speech voice.
2. Chips por campo — Título e Conteúdo podem usar idiomas/vozes diferentes (estudo bilíngue).
3. Auto-generate — alternância na lista de cartas; enfileira áudio ausente ao abrir o baralho / após salvar.
4. Generate on save — barra superior do editor quando auto-generate está ativo (pule a fala para um salvamento).
5. ↺ manual — enfileirar ou atualizar; toque no spinner/anel para remover da fila.

Prefira frases claras; quebras de linha rígidas viram frases faladas separadas. [br] é só visual. Regras horizontais e desenho de caixas são silenciosos/omitidos na fala.

6. Importação, exportação e versões de baralho

Export (Plus): apenas texto .deckreader.csv, texto + imagens .deckreader.images.zip, ou texto + imagens + M4A .deckreader.media.zip.

Import: Library → Import → escolha CSV ou ZIP. Mesmo nome de baralho:

• Deck Version mais alta → Update (títulos correspondentes substituídos) ou Cancel.
• Mesma versão / inferior → Merge (adiciona cartas; conteúdo diferente em colisão recebe sufixo) ou Cancel.

Incremente o SemVer ao publicar um baralho melhorado para que leitores usem o caminho Update.

7. Dicas, escapes e armadilhas comuns

Mostrar sintaxe como texto literal

Prefira código inline para exemplos, ou escape com barra invertida os caracteres de marcação (\*, \[, \{, …).

Emparelhamento estrito

**bold** funciona; ** bold** não.

Quebra de linha

A quebra no editor vem ativada por padrão. Desative para rolar tabelas largas horizontalmente.

Salvar vs reconstruir fala

O áudio existente é mantido quando texto falado, destinos de links e configurações de voz não mudam. Juntar linhas sem ponto final normalmente reconstrói a fala.

Checklist de carta polida

1. Título claro.
2. Estruture o Conteúdo com títulos / listas quando ajudar.
3. Imagens dimensionadas em dp; larguras de tabela em caracteres.
4. Legendas para gráficos via [caption].
5. Silencie ou pule notas só do professor.
6. Pré-visualize os chips de fala se for bilíngue.
7. Save → confirme que o áudio prepara ou enfileire ↺.

8. Referência rápida

Mapa da barra de ferramentas

Folha de consulta de marcação

**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. Criar um baralho fora do Deck Reader (editor de texto + ZIP)

Você pode criar no computador (editor de texto, planilha ou scripts) e importar com Biblioteca → Importar — os mesmos formatos que o Deck Reader exporta.

Escolha um formato

Estrutura do ZIP (CSV + imagens)

Coloque estas entradas no nível superior do ZIP (não dentro de uma pasta extra):

manifest.json mínimo (somente imagens; a fala é gerada depois no app):

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

Noções básicas de deck.csv

• Salve em UTF-8 (UTF-8 com BOM funciona bem no Excel).
• Inclua linhas de metadados quando puder (Deck Version como MAJOR.MINOR.PATCH). Se faltar, vale 1.0.0.
• A linha de cabeçalho precisa de pelo menos Title e Content (o legado Definition ainda importa).
• Colunas opcionais de idioma / voz / velocidade / tom — deixe em branco para os padrões do app.

Imagens

1. Coloque os arquivos em media/ (ex.: media/badge.png).
2. Referencie no markdown: ![Badge](deckimg:badge.png) (tamanho opcional {w:240} em dp).
3. O Deck Reader reescreve os nomes internos na importação. Arquivos ausentes mostram um aviso vermelho no player.

Montar e importar

1. Compacte deck.csv, media/ (se houver) e manifest.json como {name}.deckreader.images.zip.
2. Copie o arquivo para o dispositivo.
3. Biblioteca → Importar → selecione o CSV ou o ZIP.

Dica: exporte uma vez um baralho pequeno do Deck Reader e abra o ZIP no PC — é o modelo mais fácil para nomes e metadados.

10. Sugestão: HTML → Markdown → baralho

Se você já tem anotações em HTML (exportações do Docs, Notion, um site ou um wiki pessoal), um fluxo prático é:

1. HTML → Markdown — use um conversor online confiável (ou uma ferramenta local como o Pandoc) para obter Markdown que o Deck Reader possa armazenar.
2. Limpe o Markdown — confira títulos, listas, links e tabelas; troque imagens remotas por arquivos em media/ e referências deckimg:; adicione [skip] / [mute] / [caption] onde fizer sentido.
3. Divida em cartões — um tópico por cartão (Title claro, corpo em Content). Numere os títulos (01:, 02:, …) se quiser que a ordem alfabética acompanhe o seu esquema.
4. Monte o CSV ou ZIP — como na seção 9, depois Importar no Deck Reader e gere a fala.

A qualidade dos conversores online varia. Prefira ferramentas que preservem títulos e links e revise alguns cartões no app antes de publicar um baralho completo. Guarde uma cópia do HTML original até a importação ficar correta.