如何更改 python-docx 中的标题字体和大小？

Question

我将此作为 python-docx 问题提交： https: //github.com/python-openxml/python-docx/issues/805，但被要求在此处展开​​讨论。

https://python-docx.readthedocs.io/en/latest/user/styles-using.html意味着我应该能够更改标题字体样式，如下所示：

font = doc.styles['Heading 1'].font
font.name = 'Times New Roman'
font.size = docx.shared.Pt(16)

但这不起作用：生成的文档对所有标题都使用 Calibri。（它们也是蓝色的，标题 1 有下划线，我也需要以某种方式消除它。）

它也无法更改特定标题上的字体，也无法删除标题的 Latent_styles 。

下面是一个测试程序，它尝试了所有三种方法，但标题 1 和 2 仍然显示为蓝色 Calibri，尽管所有尝试都将其更改为 Times New Roman：

import docx

doc = docx.Document()

# Deleting heading latent styles seems to do nothing:
latent_styles = doc.styles.latent_styles
latent_styles['Heading 1'].delete()
latent_styles['Heading 2'].delete()

# Setting the Normal font works:
font = doc.styles['Normal'].font
font.name = 'Times New Roman'
font.size = docx.shared.Pt(12)

# Setting heading styles doesn't do anything:
# they all still end up as blue Calibri.
font = doc.styles['Heading 1'].font
font.name = 'Times New Roman'
font.size = docx.shared.Pt(16)

font = doc.styles['Heading 2'].font
font.name = 'Times New Roman'
font.size = docx.shared.Pt(14)

doc.add_heading("Heading 0", 0)
doc.add_paragraph('Here is a paragraph of text.')
doc.add_heading("Heading 1", 1)
doc.add_paragraph('Here is a paragraph of text.')
doc.add_heading("Heading 2", 2)
doc.add_paragraph('Here is a paragraph of text.')

# It also doesn't work to change the style of a specific heading:
heading = doc.add_heading("Another Heading 1", 1)
heading.style.font.name = "Times New Roman"
doc.add_paragraph('Here is a paragraph of text.')

doc.save('test.docx')

无法使用 docx 更改“标题 1”字体名称将此视为错误，并建议创建新样式作为解决方法。一个更简单的解决方法是在普通段落文本中创建连续行，然后设置这些连续行的样式。但如果可以将这些标题设置为蓝色 Calibri 以外的其他样式，那么使用“标题 1”等标准元素似乎会更好……并且文档暗示这是可能的。

Answer 1

正如您所观察到的，通常更改样式的字体 ( font.name) 是“有效的”。由于我不完全理解的原因，Title和 也许Heading 1、Heading 2等样式是一个例外。我希望这与主题指定的字体选择有关。也许这与它们在形成目录中的特殊作用有关。

首先，有几点观察：

• 应用的样式document.add_heading("0th-level Heading", 0)是Title. 我认为这在某种程度上是有道理的，因为最高级别的标题赋予了整个文档的标题。样式Heading 1、等分别在该函数调用中使用和Heading 2时应用。12

• 如果我们将字体名称“Times New Roman”应用于样式Title，然后检查生成的 XML，我们会看到以下内容：

>>> heading = document.add_heading("Title", 0)
>>> title_style = heading.style
>>> title_style.font.name = "Times New Roman"
>>> title_style.element.xml
<w:style xmlns:w=... w:type="paragraph" w:styleId="Title">
  <w:name w:val="Title"/>
  <w:basedOn w:val="Normal"/>
  <w:next w:val="Normal"/>
  <w:link w:val="TitleChar"/>
  <w:uiPriority w:val="10"/>
  <w:qFormat/>
  <w:rsid w:val="00FC693F"/>
  <w:pPr>
    <w:pBdr>
      <w:bottom w:val="single" w:sz="8" w:space="4" w:color="4F81BD" w:themeColor="accent1"/>
    </w:pBdr>
    <w:spacing w:after="300" w:line="240" w:lineRule="auto"/>
    <w:contextualSpacing/>
  </w:pPr>
  <w:rPr>
    <w:rFonts w:asciiTheme="majorHAnsi" w:eastAsiaTheme="majorEastAsia"
              w:hAnsiTheme="majorHAnsi" w:cstheme="majorBidi"
              w:ascii="Times New Roman" w:hAnsi="Times New Roman"/>
    <w:color w:val="17365D" w:themeColor="text2" w:themeShade="BF"/>
    <w:spacing w:val="5"/>
    <w:kern w:val="28"/>
    <w:sz w:val="52"/>
    <w:szCs w:val="52"/>
  </w:rPr>
</w:style>

• 从中我们可以看到很多有趣的项目，但我们目前的重点可以限于该<w:rFonts>元素：

>>> title_style.element.rPr.rFonts.xml
<w:rFonts w:asciiTheme="majorHAnsi" w:eastAsiaTheme="majorEastAsia"
          w:hAnsiTheme="majorHAnsi" w:cstheme="majorBidi"
          w:ascii="Times New Roman" w:hAnsi="Times New Roman"/>

我们可以看到“Times New Roman”确实已应用于两种字体设置，但标题仍然出现在 Calibri 中，而这恰好是“majorHAnsi”所映射的内容。

要跳转到解决方案，如果我们将w:asciiTheme字体名称设置为“Times New Roman”，标题将根据需要显示：

from docx.oxml.ns import qn

rFonts = title_style.element.rPr.rFonts
rFonts.set(qn("w:asciiTheme"), "Times New Roman")

我希望同样的程序也适用于其他标题样式。

请注意，如果您要“从头开始”生成文档而不是编辑现有文档，则从已具有所需样式的空白文档开始可能会更容易：

document = Document("my-starting-document.docx")