用途:生成与处理 HWPX(아래아한글)文档。基于 Python 的 python-hwpx 库,遵循 OWPML 标准,产出可在 한컴오피스 打开的公文、起案文、请议书、报告与会议记录,并支持 HWP 转 HWPX 与文本提取。
主要能力:新建 HWPX 文档;HWP→HWPX 转换;从现有 HWPX 提取文本;保留模板版式后填空;段落、加粗/斜体/下划线、表格、页眉页脚、脚注尾注、书签、文本替换均列为稳定功能。
使用方式:pip install python-hwpx lxml,处理 HWP 二进制可选 pip install olefile。示例代码:from hwpx import HwpxDocument; hwp = HwpxDocument.new(); hwp.save("output.hwpx")。生成后验证 OWPML 结构并在 한컴오피스 中确认可打开。
输出与兼容:.hwpx 格式,OWPML 1.5,ZIP 压缩(XML 加资源),可在 한컴오피스 2014、2018、2020 打开。
限制:图形(线、矩形、椭圆)、图片插入、分栏被列为受限功能,可能触发 한글 错误警告或生成不完整 pic 元素。HWP 转换受文件版本(2010/2014/2018 等)影响,旧版可能仅能提取文本。한컴 专用字体(HY헤드라인、HY견고딕 等)需在安装了 한컴오피스 的环境才能正常显示,分发时建议内嵌字体或转 PDF。未安装 한컴오피스 时建议改用 moai-office:docx-generator。若生成失败,检查 python-hwpx 与 lxml 是否安装;结构报错可用 validate.py 校验;文件打不开时检查 OWPML 命名空间与 XML 头。完成后会自检占位符残留、OWPML 结构、编码与表格是否破损,必要时自动修正并报告 PASS/FAIL。