mirror of https://github.com/ZeroHawkeye/wordZero.git synced 2026-04-22 23:57:30 +08:00

Files

T

copilot-swe-agent[bot] fd5cb2f7e2 Update documentation for paragraph formatting features

- Add paragraph_format_demo README
- Update README_zh.md with new features
- Add new example to examples list
- Update feature descriptions

Co-authored-by: ZeroHawkeye <161401688+ZeroHawkeye@users.noreply.github.com>

2025-11-24 12:48:35 +00:00

2.3 KiB

Raw Blame History

段落格式自定义功能演示

本示例演示了WordZero库提供的全面段落格式自定义功能。

功能特性

分页控制

SetKeepWithNext - 确保段落与下一段落保持在同一页
SetKeepLines - 防止段落被分页拆分
SetPageBreakBefore - 在段落前强制插入分页符

其他高级功能

SetWidowControl - 孤行控制，提升排版质量
SetOutlineLevel - 大纲级别设置，便于文档导航
SetParagraphFormat - 一次性设置多个格式属性

运行示例

go run ./examples/paragraph_format_demo/main.go

运行后将生成 examples/output/paragraph_format_demo.docx 文件。

示例内容

演示文档包含以下场景：

章节标题格式 - 使用居中对齐、段前分页、与下段保持、大纲级别
正文段落格式 - 使用两端对齐、行间距、首行缩进、孤行控制
二级标题格式 - 使用段前段后间距、与下段保持、大纲级别
悬挂缩进列表 - 演示负首行缩进和左缩进组合
引用块格式 - 使用左右缩进、行保持、居中对齐
多级标题 - 演示不同大纲级别的设置

API使用方式

方法1：单独设置各个属性

title := doc.AddParagraph("第一章 概述")
title.SetAlignment(document.AlignCenter)
title.SetKeepWithNext(true)
title.SetPageBreakBefore(true)
title.SetOutlineLevel(0)

方法2：使用ParagraphFormatConfig一次性设置

para := doc.AddParagraph("重要内容")
para.SetParagraphFormat(&document.ParagraphFormatConfig{
    Alignment:       document.AlignJustify,
    Style:           "Normal",
    LineSpacing:     1.5,
    BeforePara:      12,
    AfterPara:       6,
    FirstLineCm:     0.5,
    KeepWithNext:    true,
    KeepLines:       true,
    WidowControl:    true,
    OutlineLevel:    0,
})

应用场景

文档结构化 - 使用大纲级别创建清晰的文档层次结构
专业排版 - 使用分页控制确保标题和内容的关联性
内容保护 - 使用行保持防止重要段落被分页
章节管理 - 使用段前分页实现章节的页面独立性

2.3 KiB Raw Blame History