Entendendo imagens e outras formas
Conceitualmente, os documentos do Word têm duas camadas , uma camada de texto
e uma camada
de desenho . Na camada de texto, os objetos de texto fluem da esquerda
para a direita e de cima para baixo, iniciando uma nova página quando
a anterior for preenchida. Na camada de desenho, objetos de desenho,
chamados de formas , são colocados em posições arbitrárias. Às vezes,
eles são chamados de formas flutuantes.
Uma imagem é uma forma que pode aparecer no texto ou na camada de
desenho. Quando aparece na camada de texto, é chamado de forma
embutida ou, mais especificamente, de imagem embutida .
As formas inline são tratadas como um caractere de texto grande (um
glifo de caractere ). A altura da linha é aumentada para acomodar a
forma e a forma é quebrada em uma linha na qual caberá na largura,
assim como o texto. Inserir texto na frente dele fará com que ele se
mova para a direita. Muitas vezes, uma imagem é colocada em um
parágrafo sozinha, mas isso não é obrigatório. Ele pode ter texto
antes e depois dele no parágrafo em que é colocado.
No momento da escrita, python-docxsuporta apenas imagens em linha.
Imagens flutuantes podem ser adicionadas. Se você tiver um caso de uso
ativo, envie uma solicitação de recurso no rastreador de problemas. O
Document.add_picture()método adiciona uma imagem especificada ao final
do documento em um parágrafo próprio. No entanto, cavando um pouco
mais fundo na API, você pode colocar texto em ambos os lados da imagem
em seu parágrafo, ou em ambos.
Fonte: documentação do python-docx 0.8.11
Como visto na documentação se adicionar diretamente uma imagem a um documento essa imagem será adicionada ao final do documento e como a lib não dá suporte a imagens flutuantes essas não podem ser reposicionadas gerando então o comportamento que não quer que ocorra.
Uma solução é manipular os parágrafos e inserir suas imagens dentro dum objeto run:
- O objeto parágrafo é o container principal em nível de bloco para conteúdo em um documento ooxml.
- O objeto run reside dentro dum paragrafo como um conjunto de objetos contendo propriedades em comum.
Use os métodos:
Usando como exemplo essas quatro imagens(img1, img2, img3, img4) e traduzindo isso em código:
from docx import Document
from docx.shared import Inches #O módulo só foi utilizado para fazer escalonamento das imagens para que caibam num mesmo parágrafo.
document = Document()
paragraph = document.add_paragraph() #Cria um novo parágrafo.
run = paragraph.add_run() #Adiciona um run ao parágrafo.
run.add_picture("dog1.jpg", width=Inches(1.25)) #Adiciona varias imagens ao parágrafo...
run.add_picture("dog2.jpg", width=Inches(1.25))
run.add_picture("dog3.jpg", width=Inches(1.25))
run.add_picture("dog4.jpg", width=Inches(1.25))
document.save('demonstracao.docx') #Salva o arquivo docx.
Teste o código no Replit
Resultando no documento: