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.

Edição web e desktop4 min de leitura

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

FormatoPara quêEdição webEdição desktop
Pasta .letravioGuardar e transportar o projeto inteiroNão incluídoIncluído
Cópia JSON (.json)Baixar e restaurar o projeto inteiroIncluídoRestaurar cópias antigas
TXT (.txt)Importar e exportar texto simplesIncluídoIncluído
Markdown (.md)Importar e exportar texto com estrutura básicaIncluídoIncluído
DOCX (.docx)Exportar para Word e importar de WordNão incluídoRequer Pandoc
EPUB (.epub)Exportar livro digitalNão incluídoRequer Pandoc
PDF (.pdf)Exportar PDF experimentalNão incluídoRequer 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: ou mailto:;
  • 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.