查看: 210|回复: 3

Python Spire.Doc批量设置Word页边框行号装订线

[复制链接]
发表于 2 小时前 | 显示全部楼层 |阅读模式
正式文书常常要求页面四周带边框、条款逐行编号、左侧预留装订边。页边框、行号和装订线都属于节级页面设置,写入Word后与手工设置结果一致。文档有几十个节时,逐节手工重复很麻烦,用Spire.Doc for Python可以把这些参数一次配置好。下面按页边框、行号、装订线以及组合场景说明实现方式和容易踩的坑。

环境准备:安装Spire.Doc并引入模块。
  1. pip install Spire.Doc
  2. from spire.doc import *
  3. from spire.doc.common import *
复制代码
这三项设置都挂在节上,通过document.Sections集合访问PageSetup。文档有几个节,就要设置几次。

一、给整篇文档加统一样式页边框
最直接的做法是把四条边设置成同一样式:
  1. from spire.doc import *
  2. from spire.doc.common import *
  3. document = Document()
  4. section = document.AddSection()
  5. paragraph = section.AddParagraph()
  6. paragraph.AppendText('The frame around this page is defined by the page border settings.')
  7. borders = document.Sections[0].PageSetup.Borders
  8. borders.BorderType = BorderStyle.DoubleWave
  9. borders.Color = Color.get_LightSeaGreen()
  10. borders.Left.Space = 24
  11. borders.Right.Space = 24
  12. document.SaveToFile('PageBorders.docx', FileFormat.Docx2013)
  13. document.Close()
复制代码
BorderType一次性作用于四条边,Color统一改颜色,之后还可以针对某一边单独调整间距。这里有两个常见错误:BorderType和Color在当前版本里都是可写属性,必须用赋值语法,写成BorderType(BorderStyle.DoubleWave)这类方法调用会抛出TypeError;Space表示边框与正文之间的距离,单位是磅,有效范围只有0到31,写成50会抛出Arg_ArgumentOutOfRangeException。

二、分别设置四条边
正式文书常见上粗下细、两侧虚线的边框,这时可以逐边设置:
  1. from spire.doc import *
  2. from spire.doc.common import *
  3. document = Document()
  4. section = document.AddSection()
  5. paragraph = section.AddParagraph()
  6. paragraph.AppendText('Only the top and bottom of this page are framed.')
  7. borders = document.Sections[0].PageSetup.Borders
  8. borders.Top.BorderType = BorderStyle.Thick
  9. borders.Top.Color = Color.get_Red()
  10. borders.Top.LineWidth = 2.0
  11. borders.Top.Space = 24
  12. borders.Bottom.BorderType = BorderStyle.Double
  13. borders.Bottom.Color = Color.get_Blue()
  14. borders.Bottom.LineWidth = 1.5
  15. borders.Bottom.Space = 24
  16. borders.Left.BorderType = BorderStyle.Dot
  17. borders.Left.Color = Color.get_Gray()
  18. borders.Left.LineWidth = 1.0
  19. borders.Right.BorderType = BorderStyle.Dot
  20. borders.Right.Color = Color.get_Gray()
  21. borders.Right.LineWidth = 1.0
  22. document.Sections[0].PageSetup.PageBorderOffsetFrom = PageBorderOffsetFrom.Text
  23. document.Sections[0].PageSetup.PageBordersApplyType = PageBordersApplyType.AllPages
  24. document.SaveToFile('PageBordersSides.docx', FileFormat.Docx2013)
  25. document.Close()
复制代码
四条边各有BorderType、Color、LineWidth、Space四个可调项。LineWidth的单位是磅,写2.0落盘后是16,因为文件内部以八分之一磅为单位存储。还有三个节级开关需要留意:PageBorderOffsetFrom决定边框相对什么定位,默认相对纸张边缘PageEdge,改成Text则相对正文边缘,两者画出来的位置差别明显;PageBordersApplyType控制边框作用范围,AllPages、FirstPage、AllExceptFirstPage分别对应全部页面、仅首页、首页除外;IsFrontPageBorder容易被误解成首页显示边框,实际上它控制边框层级,设为True后边框会覆盖在文字之上。如果要清除已有边框,把样式设回BorderStyle.none即可,此时读取borders.NoBorder会返回True。

三、添加行号
行号让条款有可引用的编号,争议处理和交叉引用时很有用:
  1. from spire.doc import *
  2. from spire.doc.common import *
  3. document = Document()
  4. section = document.AddSection()
  5. for i in range(1, 15):
  6.     paragraph = section.AddParagraph()
  7.     paragraph.AppendText(f'Clause {i}: the parties agree to the following terms and conditions.')
  8. pageSetup = document.Sections[0].PageSetup
  9. pageSetup.LineNumberingStartValue = 1
  10. pageSetup.LineNumberingStep = 6
  11. pageSetup.LineNumberingDistanceFromText = 40
  12. pageSetup.LineNumberingRestartMode = LineNumberingRestartMode.Continuous
  13. document.SaveToFile('LineNumbers.docx', FileFormat.Docx2013)
  14. document.Close()
复制代码
四个参数各管一件事。LineNumberingStartValue是第一个被编号的行号,但文件内部存的是0起始偏移量,所以设置1写入的是0,设置5写入的是4,读取回来时不要直接当行号用。LineNumberingStep是编号间隔,6表示第6、12、18……行显示编号;这里极易踩坑:行号数的是排版后的实际行数,间隔大于总行数时一个编号都不会出现。例如全文只有3行而间隔是6,文件里设置一切正常,打开却看不到任何数字,所以示例特意生成了14行;想每行都编号,设为1即可。LineNumberingDistanceFromText是编号与正文之间的距离,单位磅,40磅在文件里是800缇。LineNumberingRestartMode决定编号是否重新开始:Continuous跨页连续,RestartPage每页从起始值重新计数,RestartSection每节重新计数。

四、添加装订线
装订线是页面一侧额外预留的空白,供装订打孔使用:
  1. from spire.doc import *
  2. from spire.doc.common import *
  3. document = Document()
  4. section = document.AddSection()
  5. for i in range(1, 9):
  6.     paragraph = section.AddParagraph()
  7.     paragraph.AppendText(f'Clause {i}: the parties agree to the following terms and conditions.')
  8. pageSetup = document.Sections[0].PageSetup
  9. pageSetup.Gutter = 100
  10. pageSetup.IsTopGutter = True
  11. borders = pageSetup.Borders
  12. borders.BorderType = BorderStyle.Single
  13. borders.Color = Color.get_Black()
  14. borders.Top.Space = 24
  15. borders.Bottom.Space = 24
  16. pageSetup.LineNumberingStartValue = 1
  17. pageSetup.LineNumberingStep = 1
  18. pageSetup.LineNumberingDistanceFromText = 24
  19. pageSetup.LineNumberingRestartMode = LineNumberingRestartMode.RestartPage
  20. document.SaveToFile('PageGutter.docx', FileFormat.Docx2013)
  21. document.Close()
复制代码
Gutter的单位同样是磅,100磅在文件里记为2000缇。IsTopGutter = True把装订线放到页面上方,用于横向装订的稿件,它会被写进文档的设置部分。上面的例子把三项设置合并到一起:黑色单线边框、每页重新开始的行号,再加上装订留白,这类组合常见于需要归档的正式文件。

五、批量处理时的实用技巧
页边框、行号、装订线都是节级设置,文档有几节就设几次,多节文档里逐节遍历document.Sections更稳妥。属性用赋值写法,BorderType、Color、LineWidth、Space都是属性,写成方法调用会报TypeError。间距别超31,Space超出0到31磅会抛Arg_ArgumentOutOfRangeException,这是最常见的报错来源。行号起始值是偏移量,设置1对应文件里的0,需要从某个值开始编号时直接写目标行号即可。行号间隔别超过实际行数,间隔6的文档至少要有6行排版内容,否则打开文件看不到任何编号。边框与装订线要一起规划,两者都会占用页边距,宽度较大的装订线需要配合页边距一起调整。清除边框用BorderStyle.none,设置后borders.NoBorder会变成True,便于后续判断。多节文档注意作用范围,PageBordersApplyType只对当前节生效,首页单独边框需要逐节设置。

结论:页边框、行号和装订线是正式文档里最常见、也最容易被手工操作拖慢的三项设置。在Spire.Doc for Python中,它们都通过节级PageSetup写入:用Borders设置边框的样式、颜色、线宽与间距,用LineNumberingStartValue、LineNumberingStep、LineNumberingDistanceFromText和LineNumberingRestartMode控制行号,用Gutter与IsTopGutter预留装订边。把这些参数抽成模板里的配置对象,就能让同一套排版规则稳定应用到所有生成的文档上。
回复

使用道具 举报

发表于 2 小时前 | 显示全部楼层

Re: Python Spire.Doc批量设置Word页边框行号装订线

这套整理挺实用,页边框、行号、装订线都归结到节的 PageSetup,多节文档用循环处理确实比逐节手工点省事。你提到的两个坑很关键:BorderType 和 Color 要直接赋值,不能写成方法调用;边框 Space 的有效范围只有 0 到 31。逐边设置那部分也讲得清楚,PageBorderOffsetFrom、PageBordersApplyType 和 IsFrontPageBorder 这几个开关容易混淆,尤其 IsFrontPageBorder 不是控制首页是否显示边框,这点提醒很有价值。行号部分好像没贴完,期待后续把装订线和组合场景补全。
回复 支持 反对

使用道具 举报

发表于 2 小时前 | 显示全部楼层

Re: Python Spire.Doc批量设置Word页边框行号装订线

感谢分享,内容很扎实。之前用Spire.Doc批量处理文书时也在页边框参数上折腾过,Space只能取0到31这个限制印象很深,写超了直接抛Arg_ArgumentOutOfRangeException,排查了好一会儿。楼主把BorderType和Color必须用赋值语法这点单独拎出来提醒很关键,我一开始也当成方法调用写过,结果TypeError,白折腾半天。 逐边设置那段里PageBorderOffsetFrom改成Text之后位置变化确实明显,做装订边预留的时候配合着调比较顺。PageBordersApplyType三个枚举值的区分讲得清楚,IsFrontPageBorder容易望文生义这一点提醒得好,我之前就理解错了。 另外多节文档我一般是遍历document.Sections统一设置,避免只改第0节把后面的漏了,楼主例子都是单节,实际几十节循环一下就行。不过正文好像到LineNumberingStep = 6那里就断了,行号后面的部分以及装订线、组合场景还没看到,方便的话补一下?行号间距和装订线宽度怎么跟页边距配合,还想再参考参考。
回复 支持 反对

使用道具 举报

发表于 2 小时前 | 显示全部楼层

Re: Python Spire.Doc批量设置Word页边框行号装订线

楼主这篇挺实用的,页边框、行号、装订线这三样确实都挂在节上,正式文书里几乎必须配齐,一个文档几十个节手点确实受不了。几个坑总结得很到位,尤其是 BorderType 和 Color 是属性赋值、不能当成方法来调这一点,报 TypeError 的时候提示信息不太直观,容易误以为是枚举用错了。Space 只有 0 到 31 磅这个范围也容易踩,超了直接抛范围异常,不看文档根本想不到。 LineWidth 写 2.0 落盘后变成 16 这个细节很有价值,之前读回文档发现数值对不上,一直以为是单位换算问题,原来内部是按八分之一磅存储的。PageBorderOffsetFrom 从 PageEdge 改成 Text 之后的差别确实肉眼可见,页边距稍大的模板里用默认值经常出现边框跑到页脚附近的情况。IsFrontPageBorder 那个命名也确实误导,看着像“只在首页显示”,实际是层级覆盖,设成 True 之后文字会被边框压住,排出来很难看。PageBordersApplyType 的三种取值对正式文书很合适,封面单独一节、正文统一加框这种场景正好能直接套用,不用再拆文档。 另外有两点想确认一下。一是行号那段好像断在 LineNumberingStep 之后了,装订线部分也没贴出来,是不是复制粘贴的时候掉了?挺想看 gutter 那块是怎么设的,是 PageSetup 上直接有对应属性,还是
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-11-21 04:40 , Processed in 0.030496 second(s), 17 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部