Como escrever um baralho

Um baralho é texto simples. Você pode escrever no Notas, em qualquer editor de texto ou numa conversa, e depois colar no iToth. Não precisa de nenhum app ou formato especial.

Nesta página: O modelo · As regras · Fórmulas · Imagens · Um exemplo completo · Adicione ao iToth

O modelo

Copie, troque as palavras e pronto: você tem um baralho.

= Meu primeiro baralho
Subject: Geografia
Tags: capitais, exemplo

Card: Qual é a capital do Japão?
Answer: Tóquio
Explanation: Opcional. Aparece abaixo da resposta.

MCard: Qual é a capital do Brasil?
Option 1: Rio de Janeiro
Option 2: Brasília
Option 3: São Paulo
Answer: Option 2

As palavras-chave (Card:, Answer:, Option 1:…) ficam em inglês; o resto você escreve no idioma que quiser.

As regras

Linha	O que faz	Obrigatória?
`= Título`	Começa um baralho. Cada linha com `=` começa um novo, então um texto pode ter vários baralhos.	Sim
`Subject:`	O assunto do baralho, usado para ordenar a Biblioteca. Vem antes do primeiro cartão.	Não
`Tags:`	Palavras para buscar e ordenar, separadas por vírgulas. Vem antes do primeiro cartão.	Não
`Card:`	Um cartão para virar: a pergunta fica na frente.	Um `Card:` ou `MCard:` por pergunta
`Description:`	Texto extra para a frente do cartão, como uma imagem ou uma pergunta mais longa.	Não
`Answer:`	O verso do cartão. No `MCard:`, a opção certa.	Sim
`Explanation:`	Aparece abaixo da resposta, para explicar o porquê.	Não
`MCard:`	Um cartão de múltipla escolha. Liste as opções com `Option 1:`, `Option 2:` e assim por diante.	—

Bom saber

Qualquer texto pode ocupar várias linhas; ele continua até a próxima palavra-chave.
No MCard:, o Answer: pode ser Option 2, só 2, a letra B ou o próprio texto da opção.
As opções também podem ser linhas simples começando com - .
Deixe uma linha em branco entre os cartões para o texto ficar fácil de ler.
Se o iToth encontrar um problema, ele mostra o número da linha para você corrigir.

Fórmulas

Escreva fórmulas em LaTeX, o jeito padrão de digitar matemática:

Você escreve	Você vê
$x^2$	Uma fórmula no meio da frase
`$$\int_0^1 x^2\,dx = \frac{1}{3}$$`	Uma fórmula numa linha só, centralizada
`\$5`	Um cifrão comum, não uma fórmula

Algumas peças úteis: \frac{a}{b} (fração), \sqrt{x} (raiz quadrada), x^{2} (potência), x_{1} (índice), \int \sum \lim (integral, somatório, limite), \alpha \beta \pi (letras gregas), \rightarrow (seta). Para química, use índices: $H_2O$ , $CO_2$ .

Imagens

Adicione uma imagem numa linha só:

![Descrição curta da imagem](endereço da imagem)

A descrição entre colchetes é lida em voz alta pelo VoiceOver e aparece se a imagem não carregar. O endereço entre parênteses depende de onde está a sua imagem. Escolha o caso certo:

De um site

Use o endereço da própria imagem, não da página que a mostra. Na maioria dos sites, clique com o botão direito (ou toque e segure) na imagem e escolha Copiar endereço da imagem. O endereço costuma terminar em .png, .jpg, .gif ou .webp.

![Lobos do cérebro](https://upload.wikimedia.org/wikipedia/commons/thumb/0/0e/Lobes_of_the_brain_NL.svg/960px-Lobes_of_the_brain_NL.svg.png)

Do Google Drive

No Google Drive, abra as opções de Compartilhar da imagem e mude o Acesso geral para Qualquer pessoa com o link.
Escolha Copiar link. Você recebe algo assim:
https://drive.google.com/file/d/1AbCdEfGhIjKlMnOp/view?usp=sharing
Copie o trecho entre /d/ e /view (aqui, 1AbCdEfGhIjKlMnOp). Esse é o ID do arquivo.
Coloque o ID neste endereço:

![Meu diagrama](https://drive.google.com/thumbnail?id=1AbCdEfGhIjKlMnOp&sz=w1600)

O link de compartilhamento do Drive abre uma página, não a imagem, então ele não funciona do jeito que vem.

Do Dropbox

No Dropbox, escolha Compartilhar na imagem e depois Copiar link. Você recebe algo assim:
https://www.dropbox.com/scl/fi/abc123/coracao.png?rlkey=xyz789&dl=0
No final, troque dl=0 por raw=1. Mantenha todo o resto, inclusive o rlkey=…:

![Diagrama do coração](https://www.dropbox.com/scl/fi/abc123/coracao.png?rlkey=xyz789&raw=1)

Dentro do arquivo do baralho (funciona sem internet)

Coloque o baralho num arquivo chamado exatamente deck.cards, junto com as imagens:
deck.cards, coracao.png, braco.jpg
No baralho, use só o nome do arquivo da imagem: ![Diagrama do coração](coracao.png)
Compacte os arquivos em um zip e renomeie o zip para terminar em .cardsz (por exemplo, anatomia.cardsz).
No iToth, toque em +, depois em Adicionar cartões, e escolha o arquivo .cardsz.

As imagens ficam salvas na sua biblioteca e sincronizam pelo iCloud, então aparecem mesmo sem internet.

Se uma imagem não aparecer

O endereço precisa começar com https://. Endereços com http:// são bloqueados pelo iOS por segurança.
A imagem precisa ser pública. Qualquer pessoa com o endereço precisa conseguir abri-la sem fazer login. Para conferir, cole o endereço numa janela anônima do navegador: você deve ver só a imagem.
O endereço não pode ter o caractere ). Alguns têm (por exemplo, páginas da Wikipédia com parênteses no nome). Envie a imagem para outro lugar ou coloque-a dentro do arquivo do baralho.
Imagens da web precisam de internet. Para estudar sem conexão, coloque as imagens dentro do arquivo do baralho.

Quando uma imagem não carrega, o cartão mostra a descrição no lugar dela, então ele continua fazendo sentido.

Um exemplo completo

Este baralho usa tudo o que está nesta página: cabeçalho, uma imagem da web, fórmulas no meio da frase e numa linha só, e múltipla escolha. Copie e cole no iToth para testar.

= Amostra de Ciências
Subject: Ciências
Tags: exemplo, fórmulas, imagens

Card: O lobo azul
Description: ![Vista lateral do cérebro com os lobos coloridos](https://upload.wikimedia.org/wikipedia/commons/thumb/0/0e/Lobes_of_the_brain_NL.svg/960px-Lobes_of_the_brain_NL.svg.png)
Qual lobo aparece em azul?
Answer: O lobo frontal.
Explanation: Cuida do planejamento, das decisões, do movimento e da fala.

Card: Área do círculo
Answer: $A = \pi r^2$, em que $r$ é o raio.

Card: A fórmula de Bhaskara
Description: Resolva $ax^2 + bx + c = 0$.
Answer: $$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$

MCard: Quanto vale $\int_0^1 x^2\,dx$?
Option 1: $\frac{1}{2}$
Option 2: $\frac{1}{3}$
Option 3: $1$
Answer: Option 2
Explanation: $\int_0^1 x^2\,dx = \left[\frac{x^3}{3}\right]_0^1 = \frac{1}{3}$

Card: Água
Answer: $H_2O$: dois átomos de hidrogênio e um de oxigênio.

Adicione ao iToth

Cole: copie o texto inteiro, abra o iToth e toque em + e depois em Colar baralho. (O iToth também pode oferecer o baralho sozinho quando você voltar ao app.)
Importe um arquivo: salve o texto num arquivo terminado em .cards (ou .cardsz, com imagens) e toque em + e depois em Adicionar cartões.

Se o texto tiver vários baralhos, você pode adicioná-los separados ou como um livro, com cada baralho virando um capítulo. No app, + → Como escrever um baralho também mostra este modelo, com o botão Copiar modelo.