详解用 python-docx 创建浮动图片

下面详细讲解如何使用 python-docx 创建浮动图片。

1. 安装 python-docx

首先要确保已经在计算机上安装了 Python。然后，使用以下命令在命令行或终端中安装 python-docx：

pip install python-docx

2. 导入必要的库

在创建浮动图片之前，需要导入一些必要的库：

from docx import Document
from docx.shared import Inches

同时，可以选择导入其他图像处理库，如PIL 安装后可以使用以下代码导入：

from PIL import Image

3. 创建文档对象

创建一个新的文档对象：

doc = Document()

4. 添加带浮动的图片

设置图片对象的位置、大小和描述，然后添加到文档中：

p = doc.add_paragraph()
r = p.add_run()
r.add_picture('image.jpg', width=Inches(2), height=Inches(4), align='center')

此处的r.add_picture()函数可以添加图片。注意图片应该放在与脚本相同的文件夹中或指定路径的文件夹中。同时，图片的大小和对齐方式也可以通过修改width, height和align参数进行调整。如果使用了PIL库，还可以通过其他参数进行图像处理。

5. 保存文档并检查输出

最后，使用以下代码保存新文档并检查输出：

doc.save('output.docx')

在生成文件后，可以打开 Microsoft Word 或其他兼容工具查看输出的文档

示例说明1

假设要向一个文档添加一张浮动图片作为文本的标题图，可以使用以下代码：

from docx import Document
from docx.shared import Inches

doc = Document()

p = doc.add_paragraph()
r = p.add_run()
r.add_picture('title_image.jpg', width=Inches(3), height=Inches(3), align='center')

doc.save('document.docx')

此代码将添加一个名为"title_image.jpg"的文件作为文本的标题图，并将其居中对齐，大小为3英寸 x 3英寸。

示例说明2

假设需要将一系列图片插入到文档的正文中， 可以使用以下代码：

from docx import Document
from docx.shared import Inches

doc = Document()

for i in range(1, 6):
    p = doc.add_paragraph()
    r = p.add_run()
    r.add_picture('image{}.jpg'.format(i), width=Inches(3), height=Inches(3), align='center')

doc.save('document.docx')

此代码将从名为"image1.jpg"到"image5.jpg"的图像文件插入文档的正文，并将它们的大小设置为3英寸 x 3英寸，居中对齐。