Referência técnica
Formatos de arquivo
Veja em quais formatos o Letravio guarda, copia, importa e exporta seus livros, e o que cada edição oferece.
O Letravio usa formatos diferentes para cada finalidade. Para guardar o livro inteiro, use a pasta de projeto (edição desktop) ou a cópia JSON (edição web). Para levar o texto a outros programas, use a exportação.
Formatos por edição
| Formato | Para quê | Edição web | Edição desktop |
|---|---|---|---|
Pasta .letravio | Guardar e transportar o projeto inteiro | Não incluído | Incluído |
Cópia JSON (.json) | Baixar e restaurar o projeto inteiro | Incluído | Restaurar cópias antigas |
TXT (.txt) | Importar e exportar texto simples | Incluído | Incluído |
Markdown (.md) | Importar e exportar texto com estrutura básica | Incluído | Incluído |
DOCX (.docx) | Exportar para Word e importar de Word | Não incluído | Requer Pandoc |
EPUB (.epub) | Exportar livro digital | Não incluído | Requer Pandoc |
PDF (.pdf) | Exportar PDF experimental | Não incluído | Requer Typst |
A exportação leva somente o manuscrito incluído na exportação. Fichas, tarefas e o restante do planejamento ficam no projeto e não vão para o arquivo exportado.
Pasta de projeto .letravio
Na edição desktop, cada livro é uma pasta com a extensão .letravio. Ela reúne o texto, a organização e os arquivos binários do livro, como imagens, em arquivos separados.
Para levar um livro a outro computador, copie sempre a pasta inteira. Em Arquivos, use Salvar cópia em outro local… para gravar a pasta onde quiser, e Abrir pasta de projeto para abrir um livro transportado. Veja Levar um projeto para outro computador.
As cópias de segurança novas da edição desktop também são pastas completas.
Versões mais antigas não abrem livros atualizados
A versão 0.2 atualizou o formato da pasta de projeto. Versões anteriores à 0.2 não abrem livros salvos por ela. Antes de atualizar um livro, o Letravio pede confirmação e guarda uma cópia do formato anterior.
Cópia JSON
A cópia JSON é um único arquivo .json com o projeto completo: texto, organização, versões de cenas, fichas, tarefas e imagens.
- Na edição web, é a forma de fazer backup. Baixe a cópia e restaure-a quando precisar; a restauração cria um novo livro. Veja Fazer e restaurar uma cópia JSON.
- Na edição desktop, cópias de segurança antigas em JSON continuam restauráveis. Quando uma cena fica protegida ou uma área do aplicativo falha, você também pode baixar uma cópia recuperável em JSON.
A cópia JSON da edição web não é uma pasta de projeto da edição desktop.
TXT e Markdown
As duas edições importam e exportam TXT e Markdown. Na importação de Markdown, o Letravio reconhece um subconjunto do formato:
- títulos de nível 1 a 6 (
#a######); - negrito, itálico e código em linha;
- links que começam com
http:,https:oumailto:; - citações em bloco, blocos de código e linhas horizontais;
- listas simples, com marcadores ou numeradas.
O que fica fora desse subconjunto é preservado como texto, com um aviso: imagens, tabelas, listas aninhadas, HTML e links para endereços locais. Recrie tabelas e imagens pelo editor. Nenhum HTML importado é executado.
Na exportação, o Letravio avisa quando precisa adaptar algum elemento do texto.
DOCX e EPUB
Na edição desktop, a exportação para DOCX e EPUB e a importação de DOCX usam o Pandoc instalado no seu computador. Sem ele, essas opções aparecem desativadas, com a indicação "requer Pandoc".
Ao importar DOCX, o texto passa pelo mesmo subconjunto usado no Markdown. O arquivo original não é alterado e o Letravio avisa o que se perdeu. Não há garantia de ida e volta integral com o Word.
PDF experimental
Na edição desktop, o PDF usa o Typst instalado no seu computador. Sem ele, a opção aparece desativada, com a indicação "requer Typst".
O PDF é experimental. Ele preserva o texto, os estilos básicos e as medidas do miolo, com tabelas convertidas em linhas de texto. Ainda não inclui capa, sangria nem estilos acadêmicos, e não está pronto para envio à gráfica. O Letravio nunca gera um PDF falso a partir da impressão da tela.
Veja também Importar e exportar texto e os limites de tamanho.
Algo desatualizado ou confuso? Consulte o glossário ou as novidades da versão.