Conversor online gratuito de JPG para ADOC

Formato de origem

JPG (ou JPEG) é um formato de imagem raster amplamente utilizado, projetado para fotografias e outras imagens de tons contínuos. Ele é compatível com praticamente todos os dispositivos, câmeras, navegadores e editores de imagem. O JPG usa compressão com perdas, que mantém os tamanhos de arquivo pequenos, mas pode reduzir a qualidade da imagem após salvamentos repetidos. Ele é comumente usado para fotos, capturas de tela, gráficos da web e compartilhamento de imagens.

Formato de destino

ADOC é um formato de documento de texto simples AsciiDoc usado para escrever documentação técnica, manuais, livros e docs de software. Ele é popular entre desenvolvedores e redatores técnicos porque é fácil de editar em qualquer editor de texto, funciona bem com controle de versão e pode ser convertido em HTML, PDF, EPUB e outros formatos de publicação. Em comparação com arquivos de imagem binários, o ADOC é legível por humanos e estruturado com marcação.

Como realizar a conversão

Converter JPG para ADOC não é uma transformação direta de formato no sentido usual, porque uma imagem JPG não contém texto editável. Na prática, a conversão significa criar um arquivo AsciiDoc que referencia ou incorpora a imagem. A melhor abordagem é escrever um pequeno documento ADOC e colocar o JPG ao lado dele.

1. Coloque o arquivo JPG na mesma pasta do seu documento ou anote o caminho dele.
2. Crie um novo arquivo de texto chamado document.adoc em um editor de texto simples.
3. Adicione uma referência de imagem como image::photo.jpg[] para incorporar a imagem no AsciiDoc.
4. Se quiser uma legenda, use .Caption text na linha acima da macro da imagem.
5. Salve o arquivo com a extensão .adoc.

Exemplo de conteúdo para document.adoc:

= My document .Caption text image::photo.jpg[]

Se você quiser criar o arquivo com um editor de desktop, abra um editor de texto simples como VS Code, Notepad++, ou qualquer editor de código e, em seguida, salve o arquivo como .adoc. Se você precisar gerar um documento a partir da imagem automaticamente, também pode usar primeiro um software OCR para extrair texto do JPG e, depois, colocar esse texto na marcação do AsciiDoc.

Você pode converter o arquivo em 101convert.com gratuitamente, sem instalar nenhum software.

Notas sobre qualidade e limitações

A principal limitação é que JPG é um formato de imagem, não um documento de texto, então não existe uma conversão verdadeira de um clique para um conteúdo AsciiDoc significativo. Se o JPG contiver texto, você precisará de OCR para transformar a imagem em texto editável antes de salvá-la como ADOC. A precisão do OCR depende da qualidade da imagem, da nitidez da fonte, da clareza do contraste e da resolução.

Se o seu objetivo for apenas exibir a imagem dentro do AsciiDoc, a conversão é simples: o arquivo ADOC armazena uma referência ao JPG em vez de converter os pixels em si. Mantenha o JPG em um local estável em relação ao arquivo ADOC para que os links não sejam quebrados. Para publicação, processadores AsciiDoc como Asciidoctor renderizarão corretamente o JPG referenciado na saída em HTML ou PDF, desde que o caminho da imagem seja válido.