Tópicos da documentação

2.0Plugin gratuito para WordPress · código aberto

Transforme documentos em páginas que as pessoas conseguem ler, ouvir e navegar.

O Jim transforma PDF, DOCX, Markdown e TXT em páginas de leitura publicáveis e acessíveis. Você envia o arquivo, o Jim organiza o conteúdo e entrega uma página que pode ser publicada no seu próprio site.

Menos trabalho manual para quem publica. Mais possibilidades para quem lê.

Ver o Jim funcionando ao vivo no blog
Página de leitura gerada pelo Jim, com o parágrafo em leitura destacado e a barra de controles.
Relatório.pdfResultados do ano
PDF
Tema SépiaCartilha de direitos
Tema EscuroEdital de seleção
Leitura em voz altaOuvir, pausar, velocidade
Guia.mdGuia do usuário
Lendo agoraCapítulo 1Há cerca de 13,5 bilhões de anos…

Do documento para a web. Da publicação para a leitura.

Ata.txtReunião do conselho
MD
Tema ClaroRegulamento interno
Shortcode[documento_acessivel id="123"]
DOCX
Manual.docxMódulo introdutório
Alto contrasteAviso público
  • 4formatos aceitos: PDF, DOCX, Markdown e TXT
  • 20arquivos TXT ou Markdown por lote
  • 0APIs externas para converter ou ler em voz alta. IA só com a sua chave.

Conteúdo não deveria terminar em um arquivo para baixar.

  • Um relatório.
  • Uma apostila.
  • Uma revista.
  • Um edital.
  • Uma ata.
  • Um artigo.
  • Um manual.
  • Um livro.

Muitos desses conteúdos ainda chegam ao leitor como um PDF que precisa ser baixado, aberto em outro programa e lido em uma interface que não foi pensada para aquela pessoa.

O problema não é o conteúdo. É a forma como ele chega.

O Jim transforma esse material em conteúdo HTML dentro do seu próprio WordPress, criando uma experiência de leitura que pode ser ajustada às necessidades de quem acessa.

Feito para quem publica conhecimento

O Jim pode ser útil para qualquer comunidade que produza, organize ou distribua conteúdo.

Blogs e revistas

Transforme documentos editoriais em páginas de leitura sem precisar reconstruir manualmente o conteúdo.

Jornalistas e publicações independentes

Publique relatórios, documentos públicos, entrevistas, pesquisas e materiais de apoio como páginas que podem ser lidas diretamente no site.

Escolas e projetos educacionais

Apostilas, materiais didáticos, manuais e conteúdos de apoio podem ganhar uma experiência de leitura mais flexível.

Associações e comunidades

Clubes de xadrez, grupos de colecionadores, organizações culturais, comunidades religiosas ou profissionais também produzem documentos.

Pesquisadores, doutores e filósofos

Artigos, textos de pesquisa, ensaios e materiais de estudo podem sair do formato de arquivo e ganhar uma página própria de leitura.

Pequenas equipes editoriais

Quando não existe uma equipe técnica disponível para transformar cada documento em uma página, o Jim reduz esse trabalho operacional.

O tema da comunidade muda. O problema continua sendo o mesmo: alguém precisa publicar e outra pessoa precisa conseguir consumir esse conteúdo.

O que muda para quem publica?

De arquivo para página

O documento convertido aparece no painel do WordPress com seu próprio shortcode. Você escolhe onde publicar e continua usando a estrutura que já existe no seu site.

Menos trabalho repetitivo

O Jim automatiza uma parte do trabalho que normalmente seria feito manualmente. Ele transforma em conteúdo HTML pronto para publicação:

  • PDF com texto selecionável
  • .docxdocumentos Word
  • .mdMarkdown
  • .txttexto simples

Os arquivos podem ser enviados em lote: até 20 de uma vez, de qualquer um destes tipos, convertidos em fila, um depois do outro.

Em vez de
  1. receber
  2. abrir
  3. copiar
  4. formatar
  5. revisar
  6. publicar
O fluxo pode ser
  1. enviar
  2. converter
  3. publicar

[documento_acessivel id="123"] cada documento ganha o seu shortcode

O objetivo não é criar mais uma etapa no processo editorial. É eliminar algumas delas.

E para quem lê? A página não termina quando o documento é convertido.

Ver ao vivo no blog

O leitor ganha controles para adaptar a experiência ao próprio jeito de consumir informação.

Experimente: toque em ouvir

Sapiens: uma breve história da humanidade

Aproximadamente 145.778 palavras.

Há cerca de 13,5 bilhões de anos, matéria, energia, tempo e espaço surgiram naquilo que ficou conhecido como o Big Bang.

Cerca de 300 mil anos depois, matéria e energia começaram a se aglutinar em estruturas complexas, chamadas átomos, que então se combinaram em moléculas.

Há cerca de 70 mil anos, organismos da espécie Homo sapiens começaram a formar estruturas ainda mais elaboradas, chamadas culturas.

Shortcode
[documento_acessivel id="123"]

A voz é a do navegador de quem lê. Nenhum áudio sai do computador.

Ler

O conteúdo permanece como texto na página, em vez de depender exclusivamente do arquivo original.

Ouvir

A leitura em voz alta utiliza a voz disponível no navegador do próprio leitor, com escolha de voz, pausa e velocidade. Não é necessário contratar uma API de síntese de voz por caractere. As descrições das imagens também são lidas.

Ajustar

O leitor pode aumentar ou diminuir o tamanho do texto e escolher entre diferentes temas de leitura.

Contraste

Há temas Claro, Sépia e Escuro, além de uma opção de alto contraste.

Navegar

Documentos com estrutura de títulos podem apresentar um sumário para facilitar a localização de capítulos e seções.

Controlar

A barra de leitura acompanha o conteúdo e pode ser ocultada quando não for necessária.

A experiência é do leitor. O site continua sendo do editor.

Assistente de IA integrado

Desligado por padrão

Você pode adicionar um assistente personalizável ao Jim para auxiliar seus leitores com os documentos. É uma escolha sua: ligue o assistente apenas se quiser.

Quem lê pode abrir um balão na página e perguntar sobre aquele documento, escrevendo ou falando. As respostas aparecem aos poucos, conforme são geradas. Você decide se ele existe, onde aparece e como se comporta: nome, personalidade, instruções e mensagem de boas-vindas. Para ativar, basta cadastrar a sua própria chave de API.

Suporte para:

  • OpenRouter
  • Claude (Anthropic)
  • OpenAI
  • Gemini (Google)
  • DeepSeek
  • Outro serviço compatível com a API da OpenAIOllama, vLLM, LM Studio…

A chave fica segura no seu painel (cifrada no banco de dados, nunca exibida de novo), o uso tem limites por hora e por dia, e tudo é registrado.

Disponível em sete idiomas.

O código-fonte do Jim está em inglês, e o plugin acompanha traduções para o idioma do seu site ou do usuário. A página de leitura, o painel e o tutorial falam a língua de quem usa.

  • Portuguêspt-BR
  • Español
  • Français
  • 中文简体
  • हिन्दी
  • Русский
  • Deutsch

A leitura em voz alta usa as vozes que o navegador do leitor já oferece, e o conteúdo é lido no idioma do próprio documento.

As traduções ficam em um painel de revisão no WordPress, para que quem publica possa conferir cada texto.

Acessibilidade não é um botão no final do projeto.

No Jim, acessibilidade entra na própria experiência de leitura. O projeto foi desenvolvido tendo a WCAG 2.1 AA como referência e verifica aspectos como contraste, teclado, foco, semântica e movimento reduzido.

Contraste

Os três temas principais foram verificados nos pares de texto e fundo.

Acessibilidade aqui não é um selo decorativo. É uma série de decisões de produto.

O documento continua sendo seu.

O Jim foi pensado para reduzir dependências desnecessárias.

Conversão
Acontece em PHP no próprio servidor do WordPress, sem precisar enviar o documento para uma API externa. O conteúdo convertido permanece no seu site.
Leitura em voz alta
Utiliza a Web Speech API do navegador. A voz utilizada para leitura não precisa ser processada por um serviço externo.
Assistente de IA (opcional)
Desligado por padrão. Só funciona se você cadastrar uma chave de API própria, guardada cifrada. Ao ativá-lo, as perguntas dos leitores seguem para o provedor que você escolheu. Os detalhes estão na seção Privacy do readme do plugin.
Segurança
O projeto evita transformar o conteúdo enviado em uma sequência de shortcodes executáveis, sanitizando o HTML antes de armazená-lo.

Privacidade, segurança e controle não aparecem como recursos extras. Fazem parte da arquitetura.

Documentos que continuam funcionando como conteúdo.

Envio no painel: arquivo selecionado, conversão em andamento e documento pronto com o link e o shortcode.

Um tipo de conteúdo próprio no WordPress

Cada conversão é armazenada no WordPress como um tipo de conteúdo próprio. Isso permite que o documento faça parte da estrutura que você já conhece:

  1. WordPress
  2. Documentos
  3. Página
  4. Publicação
[documento_acessivel id="123"]

Aparece na listagem de Documentos, ao lado de cada conversão.

Um shortcode, qualquer página

Você não precisa reconstruir a página inteira. Só precisa decidir onde aquele conteúdo deve aparecer.

Um documento, duas formas de leitura: leitor ou post

Na versão 2.0, cada documento pode ser apresentado como Leitor — uma experiência dedicada à leitura, com barra flutuante, voz, temas e navegação — ou como Post — uma apresentação mais próxima de um artigo tradicional, com tempo de leitura, opção de ouvir e compartilhamento.

Um manual pode ser um leitor. Um comunicado pode ser um post. Uma apostila pode ser uma página de leitura. A escolha fica na Edição rápida de cada documento, no painel do WordPress.

Imagens também fazem parte do conteúdo

Quando possível, imagens presentes em PDF e DOCX são extraídas e adicionadas à Biblioteca de Mídia do WordPress. No DOCX, o texto alternativo existente é preservado. Imagens sem descrição recebem uma indicação temporária para que o responsável possa corrigi-las antes da publicação.

O documento também pode apresentar as imagens em um lightbox acessível, com navegação, descrição, contador e fechamento pelo teclado. Porque converter o texto e esquecer as imagens seria apenas transferir metade do problema.

Conteúdo preparado para a web

Na versão 2.0, as páginas geradas podem receber descrição, Open Graph, Twitter Card, JSON-LD, imagens associadas ao documento, estrutura de leitura e tempo estimado de leitura no modo post.

Se um plugin de SEO compatível já estiver ativo, o Jim evita assumir essa responsabilidade. A ideia é complementar o WordPress, não competir com cada plugin instalado nele.

Um fluxo simples para quem publica

Ver instalação
  1. 01

    Envie

    No painel do WordPress, acesse Jim › Novo Documento e envie o arquivo.

  2. 02

    Converta

    O Jim processa o conteúdo e mostra o andamento. Documentos maiores podem ser processados em etapas, sem depender de uma única requisição longa.

  3. 03

    Revise

    O documento aparece no painel com seu conteúdo, imagens e informações de conversão.

  4. 04

    Publique

    Copie o shortcode e coloque o documento na página ou post desejado.

O arquivo entra. Uma página de leitura sai.

Publique direto em posts, páginas e tipos personalizados

  1. 01

    Escolha onde

    Em Novo Documento › Também publicar em, escolha posts, páginas ou um tipo personalizado. O Jim cria um item por arquivo, já com o shortcode dentro; o endereço é o nome do arquivo.

  2. 02

    Defina o modo e o status

    Escolha Leitor acessível ou Padrão blog e se o item sai publicado, rascunho, pendente, privado ou agendado. Categorias e tags do WordPress também classificam o documento.

  3. 03

    Agende

    Ao agendar, a data vale pelo relógio do site. Cada arquivo vira um evento do Action Scheduler, e o aviso depois do envio mostra o nome dele.

  4. 04

    Acompanhe e cancele

    Em Ferramentas › Scheduled Actions, procure pelo nome do evento para ver, executar ou cancelar. A lista de documentos mostra onde cada um foi publicado.

Nada de copiar shortcode um a um. E um tour guiado mostra o caminho.

Painéis, barra de leitura e limites

Um resumo do que existe hoje no plugin, do painel do WordPress à página de leitura, com os limites que protegem o seu servidor.

A barra de leitura

A barra flutuante tem, nesta ordem: menu (buscar no documento e sumário), ajustes (idioma e tipo de voz, narrador, tema claro, sépia, escuro e alto contraste), Aa (tamanho do texto), ouvir/pausar, velocidade (cada clique passa para o próximo valor: 1×, 1,25×, 1,5×, 2×), parar, a paginação ‹ 2/93 › (só em documentos longos, divididos em partes) e ocultar. O botão de ouvir fica sempre no centro da barra.

Página de leitura com a barra flutuante.Gravação: um trecho é marcado, o sumário é aberto e o tamanho do texto é ajustado.
Marcar trecho, sumário e tamanho do texto.
Popover de ajustes aberto sobre a página de leitura.Gravação: o popover de ajustes com voz e tema; a página muda para sépia e para escuro.
Ajustes: voz e temas.
Poema em uma página de leitura, com um trecho em destaque.Gravação: a leitura em voz alta destaca o trecho que está sendo lido.
Leitura em voz alta com o trecho em destaque.
Painel Buscar no documento aberto sobre o texto, com o assistente ao lado.Gravação: a busca no documento procura um trecho do livro e leva o leitor ao resultado, com o assistente aberto ao lado.
Buscar no documento, com o assistente aberto.

O leitor também pode marcar trechos, compartilhar um trecho marcado como imagem (no celular abre o menu de compartilhar) e exportar os trechos marcados em um arquivo de texto. A conversa com o assistente também pode ser baixada.

O assistente e os textos rápidos

As sugestões do início do chat e do botão = são os textos rápidos. Em Configurações › JIM › Avançado › Textos rápidos você escolhe quais aparecem, renomeia, muda o texto que cai no campo, marca Enviar na hora (bom para desafios), adiciona os seus (até 12) ou desliga todos. O botão Restaurar volta aos cinco originais.

Chat do assistente aberto ao lado do texto.Gravação: o assistente é aberto, uma pergunta é feita e a resposta aparece aos poucos.
Perguntar ao assistente.
Tema sépia: chat do assistente com o menu de textos rápidos aberto.Gravação no tema sépia: o assistente responde a uma pergunta e o botão = abre os textos rápidos, de onde sai um desafio.
Textos rápidos e desafio, no tema sépia.
Configurações do Jim, passo 3 (Ligar) e o bloco Avançado com nome, personalidade e instruções do assistente.
Configurações › JIM: ligar e opções avançadas.
Opções avançadas do assistente com o seletor Quem pode usar aberto: todos os visitantes ou só usuários logados.
Quem pode usar o assistente.

Os painéis do WordPress

  • Todos os Documentos: a lista com o shortcode, o modo de exibição, onde cada documento foi publicado e a revisão da conversão.
  • Novo Documento: envio em lote, título, modo de exibição, publicar direto em post, página ou tipo personalizado, status e agendamento. Tem um tour guiado de 9 passos.
  • Configurações: tipos de arquivo, tamanho máximo, limites de imagens, velocidade padrão da voz, o cartão do JIM – Assistente (conectar, escolher o modelo, ligar e as opções avançadas) e o registro de atividade em tempo real. Tem o seu próprio tour guiado de 7 passos.
  • Tutorial: explica cada opção e reabre os dois tours.
Editor de blocos do WordPress com um bloco de shortcode contendo documento_acessivel.
O shortcode em um bloco do editor.
Página de leitura com o painel de sumário aberto à esquerda e o livro Comunicação Não-Violenta.
O sumário em um livro.
Página de leitura com o sumário e o chat do assistente com os textos rápidos.
Sumário, barra e assistente juntos.

Lote, PDFs grandes e documentos longos

Cada arquivo é uma requisição própria, enviada em fila. Um livro longo é convertido em passos de até 20 segundos que salvam onde pararam, então não depende de uma única requisição. Documentos com mais de ~350 KB de HTML (cerca de 50 mil palavras) são divididos em partes de ~60 KB; a busca roda no servidor, no livro todo.

Seleção de vários arquivos de texto para enviar de uma vez.Gravação: vários arquivos são selecionados e enviados em lote ao Jim.
Envio de vários arquivos em lote.
Conversão de um PDF de 2.055 páginas, com um cronômetro ao lado.Gravação: PDFs grandes convertidos em lote; um livro de 2.055 páginas com imagens termina em cerca de 3 minutos e meio no cronômetro e o PDF seguinte começa.
PDFs grandes em lote: 2.055 páginas em cerca de 3 minutos e meio.

Limites

LimiteValor
Arquivos por vez20, enviados em fila; a tela precisa ficar aberta até o último terminar.
Tamanho por arquivoVocê define de 1 a 100 MB nas Configurações, dentro do limite do servidor (upload_max_filesize e post_max_size).
Tamanho de PDFCalculado pela memória do PHP: cerca de 42 MB com 256 MB, 19 MB com 128 MB e 89 MB com 512 MB. A tela mostra o valor do seu servidor.
Imagens por documentoAté 300 e um limite de MB, ambos configuráveis. O texto é sempre processado por inteiro.
PDF digitalizadoRecusado: não há OCR. O mesmo vale para PDFs cujas fontes não dizem qual letra é cada caractere (o Jim avisa e não liga o assistente nesse documento).
AssistenteLimite de perguntas por leitor por hora e por dia no site, configurável; respostas reaproveitadas quando a primeira pergunta é quase igual.
Busca no documento20 resultados por vez e 30 buscas por minuto por visitante.

Segurança

A chave de IA é cifrada (libsodium) com uma chave derivada dos salts do wp-config.php e nunca volta para a tela. A chamada ao provedor é feita pelo servidor; o leitor nunca vê a chave. Mensagens de erro do provedor passam por uma limpeza antes de ir ao registro. As páginas com o shortcode enviam frame-ancestors 'self' para impedir que outro site as emoldure (clickjacking); quem incorpora de propósito libera o endereço com o filtro jimca_frame_ancestors.

PDF
PDFs com texto selecionável. O Jim também pode interpretar estruturas de sumário e títulos presentes em determinados documentos.
DOCX
Documentos do Microsoft Word, incluindo estrutura de títulos e descrições de imagens quando disponíveis.
Markdown
Arquivos .md podem ser convertidos em HTML, preservando títulos, listas, tabelas, código e links.
TXT
Para textos simples, atas, comunicados e outros conteúdos sem formatação complexa.
E o que não funciona?
PDFs escaneados que contenham apenas imagens não possuem texto para ser extraído. O formato antigo .doc também não é suportado. O Jim prefere dizer isso antes da instalação. Humanos já têm problemas suficientes depois de instalar coisas que prometiam milagres.

Criado para não transformar um servidor comum em laboratório da NASA.

Conversões grandes podem consumir memória e tempo de processamento. Por isso o Jim possui limites para imagens e mecanismos de proteção durante conversões mais pesadas.

O texto do documento continua sendo processado integralmente, enquanto imagens que ultrapassarem os limites configurados podem ser deixadas de fora com uma indicação do motivo. Isso permite trabalhar com documentos maiores sem fingir que servidor compartilhado possui recursos infinitos.

PDFDOCXMDTXTWCAG 2.1 AAGPL v2+v2.0

Software livre sob GPL v2 ou posterior

Você pode usar, estudar, modificar e redistribuir o projeto, inclusive em projetos comerciais, respeitando os termos da licença.

Código público no GitHub

Cada versão pode ser acompanhada pelo histórico do projeto, e problemas podem ser relatados diretamente no repositório.

No diretório oficial do WordPress

Instale direto pela tela de Plugins do seu site e receba as atualizações por lá, como em qualquer outro plugin.

O Jim é uma ferramenta para comunidades que publicam.

Não importa se a sua comunidade fala sobre:

  • xadrez
  • educação
  • filosofia
  • ciência
  • religião
  • jornalismo
  • literatura
  • colecionismo
  • pesquisa
  • ou qualquer outra coisa

Se existe conhecimento sendo produzido, organizado e compartilhado, existe alguém tentando publicá-lo. O Jim existe para tornar esse processo mais simples para quem publica e mais flexível para quem lê.

Publique documentos como páginas que as pessoas conseguem realmente usar.

Gratuito, de código aberto e dentro do seu próprio WordPress.

Perguntas frequentes

Quem pode usar o Jim?

Qualquer pessoa ou equipe que utilize WordPress e precise transformar documentos em páginas de leitura. Isso inclui blogs, revistas, jornalistas, escolas, associações, comunidades, projetos independentes, pesquisadores e organizações.

Quais arquivos são aceitos?

PDF com texto selecionável, DOCX, Markdown e TXT.

O Jim funciona com PDF escaneado?

Não. Um PDF formado apenas por imagens não possui texto para a conversão extrair.

Preciso enviar meus documentos para outro serviço?

Não. A conversão acontece no próprio servidor do WordPress, sem API externa.

A leitura em voz alta envia o áudio para algum servidor?

Não. A leitura utiliza a voz disponível no navegador de quem está lendo.

O Jim usa inteligência artificial?

Só se você quiser. O assistente de IA vem desligado: para ativá-lo, o administrador cadastra a própria chave de um provedor compatível (OpenRouter, Claude, OpenAI, Gemini ou DeepSeek). A conversão e a leitura em voz alta nunca dependem de IA.

Em quais idiomas o Jim está disponível?

Português do Brasil, espanhol, francês, chinês simplificado, hindi, russo e alemão, conforme o idioma do site ou do usuário.

Preciso reconstruir a página depois da conversão?

Não. O documento convertido recebe um shortcode que pode ser colocado em uma página ou post existente.

Posso usar o Jim em um projeto comercial?

Sim. O projeto é distribuído sob GPL v2 ou posterior, respeitando os termos da licença.

O Jim substitui um plugin de SEO?

Não. Ele fornece metadados específicos para as páginas geradas e desativa essa parte quando detecta plugins de SEO compatíveis.

O Jim garante conformidade total com WCAG?

Não existe motivo para prometer isso como se uma ferramenta pudesse carimbar um site inteiro com “acessível” e ir embora. O Jim é desenvolvido e testado com critérios da WCAG 2.1 AA, cobrindo aspectos específicos da experiência que ele controla. A acessibilidade final também depende do conteúdo, do tema, do WordPress e de outras partes do site.