Importar e exportar baralhos

Use CSV para trabalhar com uma planilha e JSON Retevi v1 para transferir conteúdo compatível entre instalações do Retevi. Os dois formatos portáteis priorizam texto e tags.

Requer conexão: importação e exportação não funcionam offline.

Antes de exportar: imagens e formatação rica não são preservadas integralmente. Guarde outra cópia dos arquivos importantes.

O que é transportado

Cartões importados são novos: não recebem o agendamento nem as avaliações do conteúdo de origem.

Exportar um baralho

1. Abra Baralhos e selecione o baralho desejado.
2. Na área de ações do baralho, selecione CSV ou JSON.
3. Guarde o arquivo baixado em um local conhecido.

É possível exportar um baralho arquivado. Cartões excluídos não fazem parte do arquivo.

O CSV usa as colunas front, back, tags e deck, em UTF-8. Todas as células são delimitadas de modo a preservar vírgulas e quebras de linha ao abrir em uma planilha compatível.

O JSON contém o esquema e a versão do formato. Para evitar incompatibilidade, use um arquivo exportado pelo próprio Retevi em vez de editar manualmente sua estrutura.

Preparar um CSV

A primeira linha precisa conter nomes únicos de colunas. Um exemplo mínimo é:

front,back,tags
"Qual é a capital do Canadá?","Ottawa","geografia, capitais"

O Retevi tenta reconhecer automaticamente:

• frente: front, frente, question ou pergunta;
• verso: back, verso, answer ou resposta;
• tags: tags, tag ou etiquetas.

Tags podem ser separadas por vírgula ou ponto e vírgula. Se o conteúdo contém vírgulas, aspas ou quebras de linha, exporte o arquivo pelo aplicativo de planilhas para manter a delimitação CSV correta.

Gerar e revisar uma prévia

1. Abra Importar ou use Importar dentro de um baralho.
2. Em Baralho de destino, escolha um baralho ativo.
3. Em Formato, escolha CSV ou JSON Retevi v1.
4. Em Escolher arquivo CSV ou JSON, selecione o arquivo correspondente.
5. Selecione Gerar prévia.
6. Para CSV, confirme o Mapeamento das colunas de Frente, Verso e Tags (opcional).
7. Se alterar o mapeamento, selecione Atualizar prévia.
8. Confira Total, Prontos, Duplicados e Inválidos.
9. Abra Ver erros e duplicados quando houver itens ignorados.

A prévia não cria flashcards. Ela permite corrigir o arquivo ou o mapeamento antes da gravação.

Concluir a importação

Selecione Importar N cartões válidos. Apenas as linhas com estado Pronto serão criadas. Linhas Duplicado e Inválido são ignoradas.

Ao final, Importação concluída informa quantos cartões foram importados, ignorados como duplicados ou rejeitados. Confira o baralho de destino antes de iniciar outra importação.

Uma duplicata possui a mesma frente e o mesmo verso normalizados que outro cartão no baralho de destino ou que uma linha anterior no mesmo arquivo. Tags diferentes não tornam o conteúdo único.

Limites do arquivo

• tamanho entre 1 byte e 5 MiB;
• texto em UTF-8;
• até 2.000 cartões;
• frente entre 1 e 5.000 caracteres;
• verso entre 1 e 10.000 caracteres;
• até 10 tags por cartão;
• cada tag com até 40 caracteres.

A tela lista no máximo os 100 primeiros problemas, mas os contadores da prévia consideram todo o arquivo.

Se algo der errado

Não existe baralho de destino

A mensagem Crie um baralho ativo antes de importar. aparece quando não existe um destino elegível. Crie um baralho ou restaure a coleção e o baralho arquivados.

As colunas não foram reconhecidas

Escolha manualmente colunas diferentes para Frente e Verso. A coluna de tags é opcional. Se os nomes se repetirem, corrija a primeira linha do CSV e gere outra prévia.

O arquivo não é aceito

Confirme que a extensão corresponde ao formato selecionado, que o arquivo está em UTF-8 e dentro dos limites. Para JSON, use o formato exportado como JSON Retevi v1.

Há muitos duplicados

Abra Ver erros e duplicados. Se os cartões já existem no destino, mantenha-os ignorados. Se deveriam ser diferentes, corrija frente ou verso no arquivo e gere outra prévia.

Há linhas inválidas

Leia a linha e o motivo exibidos. Corrija campos vazios, limites de caracteres ou tags e envie o arquivo novamente. Você também pode importar somente os cartões válidos e tratar os demais depois.

A operação falhou durante a gravação

Abra o baralho de destino e confira quais cartões existem antes de tentar outra vez. A importação grava em lotes e uma falha tardia pode preservar lotes já concluídos. Gere uma nova prévia: os itens existentes serão reconhecidos como duplicados.

Imagens ou formatação desapareceram

Esse é um limite dos formatos atuais. CSV e JSON transportam a versão textual da frente e do verso, não o documento rico nem os arquivos de imagem.

Veja também

• Organizar coleções e baralhos
• Criar e editar flashcards
• Resolver problemas comuns
• Voltar à central do guia