Desenvolvimento Editorial: Como amarrar o código da sua Obra Digital para passar no Valide Desktop

Quem acompanha o blog da Agência Nulo já entendeu a diferença entre o livro em HTML5 e o PDF Interativo. Mas na hora de colocar a mão na massa para o edital dos Anos Finais 2028-2031, o desafio muda de figura: como garantir que a estrutura de arquivos sobreviva à validação automatizada e funcione de ponta a ponta?

Para as editoras, o trabalho pesado não é a diagramação, mas sim a estrutura de pastas, vínculos e acessibilidade multimídia. Abaixo, destrinchamos as regras mais rígidas de implementação técnica que ditam o sucesso ou a desclassificação de uma obra.

1. A Anatomia do PDF Interativo (O Modelo de Vinculação B)

Muitas editoras acreditam que o PDF Interativo de inscrição é apenas um arquivo isolado com hiperlinks. Não é. Para que os Objetos Digitais (ODs) em HTML funcionem dentro dele, o pacote .zip precisa seguir uma arquitetura de vínculos locais milimétrica:

  • Raiz do Arquivo: O PDF interativo principal deve ficar obrigatoriamente na raiz do pacote .zip, funcionando como o ponto de entrada único.
  • A Rota do HTML: Se o PDF direciona para um Objeto Digital em HTML, o arquivo principal deve ser mapeado exatamente na rota: interactivities/<nome_do_od>/content/<nome_do_arquivo>.html.
  • Isolamento de Recursos: Todos os scripts, folhas de estilo e mídias desse objeto precisam estar organizados dentro da pasta resources/ daquele OD específico, respeitando a separação por tipo de mídia. Se o PDF tentar puxar um arquivo fora dessa estrutura, o vínculo quebra no validador.

2. O Spine e o TOC: O duplo funil da leitura sequencial

Um erro técnico muito comum que reprova obras em exames automatizados é a divergência de caminhos de navegação. O livro digital precisa refletir a ordem exata do conteúdo impresso em duas estruturas de código diferentes ao mesmo tempo:

  • A estrutura de navegação: O sumário interno (mapeado via arquivo toc.ncx ou mecanismo equivalente).
  • A estrutura de leitura sequencial: O elemento spine dentro do manifesto do livro (content.opf).

O edital proíbe qualquer divergência entre essas duas frentes. Da capa aos elementos pós-textuais (como a lista de créditos e a lista de URLs), a ordem de leitura no código deve corresponder rigorosamente à sequência visual do conteúdo. Se o desenvolvedor alterar a ordem dos arquivos HTML no spine para ajustar a performance, mas esquecer de atualizar o toc.ncx, a obra é invalidada.

3. Acessibilidade Multimídia na Prática (Expandir e Recolher)

As regras para áudios e vídeos são extremamente minuciosas e vão muito além de incluir legendas sincronizadas. A alternativa textual completa (transcrição integral de falas, interlocutores e sons relevantes) deve seguir comportamentos diferentes dependendo do formato:

  • No PDF Interativo: A transcrição deve estar acessível por meio de um link interno claramente identificado, com um link de retorno obrigatório no final do texto para que o usuário volte ao ponto original de leitura sem perder o fluxo.
  • No Livro Digital (HTML): A transcrição não pode ser um link para outra página. Ela deve estar posicionada no próprio corpo do livro, exatamente na sequência, sendo o próximo conteúdo logo após o áudio ou vídeo. A engenharia aqui exige a implementação de um botão nativo para expandir e recolher esse texto, garantindo que a acessibilidade esteja presente sem poluir o design visual de quem não necessita do recurso.

4. Janela de Libras: Proporções Técnicas Obrigatórias

Para os vídeos que contêm informações pedagógicas, instrucionais ou avaliativas, a inserção da janela de Libras não é opcional e precisa seguir critérios matemáticos de legibilidade:

  • Tamanho Mínimo: A janela com o intérprete deve possuir, no mínimo, a metade da altura 1/2 e um quarto da largura 1/4 do tamanho do vídeo original.
  • Ambiente Isolado: O fundo deve ser obrigatoriamente contrastante e com iluminação adequada, posicionada de forma a nunca encobrir informações visuais do conteúdo principal, mantendo sincronia temporal perfeita com o áudio e as legendas.

Validação sem “Jeitinho”: Valide Desktop

Não existe margem para aprovação aproximada. O edital exige que as obras passem por testes de ponta a ponta — da editora até o estudante — utilizando o leitor oficial: o Valide Desktop. É através desse sistema que a usabilidade, a acessibilidade e o funcionamento dos componentes em JavaScript ES6 são validados de forma oficial antes do envio ao sistema do governo.

Garantir que os arquivos content.opf, index.html e todas as tags WAI-ARIA conversem perfeitamente sob as regras do validador é o que separa um projeto aprovado de uma desclassificação técnica.

Na Agência Nulo, nós dominamos a estrutura de diretórios, os modelos de vinculação e a implementação de acessibilidade estrita exigida pelo programa. Deixe o código pesado conosco e foque na excelência do seu conteúdo pedagógico.

Entre em contato com o nosso time de desenvolvimento editorial e blinde o seu projeto!



Foto de Florian Olivo na Unsplash

Vamos trabalhar juntos

Você está precisando de
uma equipe que vai além?