python-docx官方文档翻译--用户指南07--API 基础

API 基础

python-docx 的 API 旨在使简单的事情变得简单，同时允许通过适度的增量投资来获得更复杂的结果。
可以仅使用一个对象（打开文件时返回的 docx.api.Document 对象）来创建基本文档。docx.api.Document 上的方法允许将块级对象添加到文档的末尾。块级对象包括段落，内嵌图片和表格。标题，项目符号和编号列表只是应用了特定样式的段落。
这样，可以从上到下“写”文档，就像人们完全知道要说的话一样。这个基本的用例总是将内容添加到文档的末尾。可能占实际用例的80％，因此在不影响整个 API 功能的前提下，使其尽可能简单是当务之急。

内联（内嵌）对象

docx.api.Document 上的每个块级方法（例如 add_paragraph()）都返回创建的块级对象。通常不需要引用。但是当必须单独创建内联（内嵌）对象时，您需要使用块实例的引用来执行。
… 在 API 固化时在此处添加示例 …