python-docx 中 add_style（）的参数有哪些

`add_style()` 方法是用来添加新的样式到 Python-docx 中的 `Document` 或者类似对象（如段落或列表项）。这个方法通常用于`docx.document.styles` 库，这里的样式指的是文档格式化的一部分，比如字体、对齐等。

`add_style(name, parent[, style])` 的参数有：

1. **name (str)**：这是新创建样式的名称。这是识别你的定制样式如何在整个文档中的唯一的标识符。

2. **parent ([Style] object or None)**：这是个可选参数，决定了新创建的样式基于哪种现有样式。如果不指定，则默认从 `styles` 集合的基础风格（通常 `body_text`）中创建一个新的简单文本样式。提供其他已存在的方式可以定义复杂的继承关系。

3. **style (DocumentStyle) object**：这是一个内部使用的参数，主要是在继承层次结构中有自定义的需求时用到。

示例用法（省略了详细的上下文）：

from docx import Document

# 获取根样式
root = document.styles["Normal"]
# 基于“Normal”样式添加新样式并命名为 "Custom Heading"
new_style = document.styles.add_style("Custom Heading", parent=root)
new_style.font.bold = True  # 设置字体粗体

相关问题

python-docx中add_paragraph

### Python-docx `add_paragraph` 方法详解

#### 创建新段落并设置基本属性

通过 `Document.add_paragraph()` 可以向文档中添加新的段落。此函数接受两个参数：

- **text**: (可选) 要作为初始文本插入到段落中的字符串，默认为空。
- **style**: (可选) 应用于该段落样式的名称。

from docx import Document

# 初始化一个新的Word文档实例
document = Document()

# 添加一个带有默认样式的简单段落
simple_para = document.add_paragraph('这是一个简单的段落')

# 添加带指定样式的段落
styled_para = document.add_paragraph(
    '这是应用特定风格的段落', 
    style='Heading 1'
)

# 保存修改后的文档至磁盘
document.save('example.docx')

#### 设置段落格式化选项

对于更复杂的排版需求，可以进一步配置段落的具体表现形式，比如调整缩进量等特性[^2]。

from docx.shared import Inches, Pt

para_format = simple_para.paragraph_format
para_format.left_indent = Inches(0.5)        # 设定左侧缩进为半英寸
para_format.first_line_indent = Inches(-0.2)  # 首行缩进减去两分之一英寸实现悬挂效果
para_format.line_spacing = 1.5                # 行距设为一点五倍行高
para_format.space_after = Pt(6)               # 段落后留白六磅

上述代码展示了如何利用 `ParagraphFormat` 对象来精细化控制所创建段落的各项视觉特征。

python-docx 中 build_header 的使用示例

在`python-docx`库中，`build_heading`函数主要用于创建Word文档中的标题或子标题，通常用于构建文档结构。`docx`是一个方便处理Microsoft Word .docx文件的Python库。

以下是一个简单的使用示例：

from docx import Document
from docx.shared import Inches

# 创建一个新的Word文档
document = Document()

# 定义标题级别及其对应的字体大小
heading_levels = {
    'title': 0,
    'subtitle': 1,
}

# 添加标题
def build_header(level, text):
    # 获取对应级别的段落样式
    style = document.styles[heading_levels[level]]
    
    # 创建一个新的段落，并添加文本
    para = document.add_paragraph(style=style)
    para.text = text
    
# 示例：创建一级标题
build_header('title', '这是文档的标题')

# 创建二级标题
build_header('subtitle', '这是子标题')

# 保存文档
document.save('example.docx')

在这个例子中，`build_header`函数接受一个级别（如'title'或'subtitle'）和一段文字作为输入。它会根据这个级别找到相应的样式并创建一个新的段落来插入标题。最后，将创建好的文档保存为`.docx`文件。