Leitura DS

---

Por que o Leitura DS?

O Leitura DS mantém livros, progresso, destaques e comentários no seu próprio Vault. Assim, sua leitura acompanha você entre macOS, iPhone e Android por meio da sincronização que você já usa no Obsidian.

Funcionalidades

EPUB

• Leitura de EPUB com sumário clicável e retomada no ponto exato.
• Progresso do livro ou capítulo, tempo restante estimado e marcadores.
• Destaques coloridos, comentários, etiquetas e exportação para notas Markdown.
• Seleção múltipla de destaques para copiar, adicionar etiquetas ou exportar uma nota com links de retorno.
• Biblioteca visual com capas, busca e página de todos os destaques.
• Temas, fontes, espaçamento, largura do texto, duas colunas e tela cheia.
• Estado compartilhado no Vault: posição e palavra em destaque continuam em outros dispositivos.
• Âncora textual robusta: a retomada usa texto exato e contexto, resistindo a mudanças de layout e pontuação.
• Estante instantânea com carregamento inteligente de capas, evitando abrir todos os arquivos grandes de uma vez.
• Notas de rodapé abrem sobre a leitura, tabelas largas podem ser roladas e imagens recebem carregamento e decodificação progressivos.
• Modo de recuperação mantém capítulos legíveis disponíveis quando um EPUB contém partes ausentes ou malformadas.

Modos de leitura

• Leitura rápida: RSVP com ponto de reconhecimento visual, velocidade e tamanho ajustáveis.
• Foco em Linha: acompanha palavra por palavra sem fazer o texto saltar.
• Fluxo de Cores: guia visual de leitura com cores configuráveis.
• Thread: trechos curtos em cartões verticais, para leitura contínua.
• Stories: um trecho por tela, com toque nas laterais para avançar ou voltar.
• Carrossel: trechos pequenos navegáveis lateralmente.
• Os modos sociais têm tamanho de texto e extensão dos cartões configuráveis, barra de progresso e retomada automática.
• Leitura em voz alta: usa a voz disponível no dispositivo a partir do ponto de leitura.

Quadrinhos

• Biblioteca e leitor para CBZ, com detecção de CBR.
• Zoom, ajuste de página, páginas duplas, leitura RTL e controles por teclado.
• Navegação por página, miniaturas próximas, marcadores e notas por página.
• Em páginas altas, as setas para cima e para baixo rolam a arte; ao trocar de página a leitura retorna ao topo.
• Zoom sem cortar o topo, restauração da posição vertical e preferências próprias de ajuste, página dupla e direção.

Desempenho e sincronização

• Capas EPUB e CBZ são carregadas somente quando aparecem na tela; CBRs pesados são preparados ao abrir.
• Imagens vizinhas de quadrinhos usam cache limitado e configurável.
• Gravações simultâneas são agrupadas para reduzir trabalho no iPhone e Android.
• Pontos de leitura, referências, marcadores, destaques e exclusões são reconciliados pelo arquivo de estado do Vault.
• Estado sincronizado v2 com revisão, identificação local do dispositivo, migração com backup e novas tentativas para arquivos incompletos do iCloud.
• Estatísticas usam contadores independentes por dispositivo, preservando os minutos de Mac, iPhone e Android sem duplicação.
• Destaques também usam âncoras de texto e contexto, permanecendo ligados ao trecho após mudanças de layout.

CBR depende do suporte ao formato RAR disponível no ambiente do Obsidian. Para maior compatibilidade entre dispositivos, CBZ é o formato recomendado.

Instalação

Enquanto o plugin não estiver listado na comunidade do Obsidian, use a instalação manual:

1. Baixe ou clone este repositório.
2. Gere a versão de produção com npm install e npm run build.
3. Copie main.js, manifest.json, styles.css e a pasta assets/ para:

<seu-vault>/.obsidian/plugins/leitura-ds/

4. No Obsidian, abra Configurações → Plugins não oficiais, habilite o Leitura DS e escolha as pastas em Leitura DS.

Abra um EPUB, CBZ ou CBR no Vault, ou use os comandos Minha biblioteca, Meus destaques e Continuar última leitura.

Privacidade

O Leitura DS é local-first: não envia seus livros, destaques, comentários ou posição de leitura para um serviço externo. O estado é salvo em arquivos do próprio Vault para que o seu método de sincronização possa levá-lo aos seus dispositivos.

Desenvolvimento

npm install
npm run build

Para desenvolvimento contínuo:

npm run dev

Roteiro

• Testes em uma variedade maior de EPUBs e aparelhos móveis.
• Aprimoramento da compatibilidade CBR.
• Acessibilidade, gestos configuráveis e mais estatísticas de leitura.

Autor

Desenvolvido por Douglas Santana.

Licença

Distribuído sob a licença MIT.