python - 如何使用 python-docx 在文本中设置语言

Question

我使用 python-docx 库创建 word 文件。我希望能够将文档的不同部分设置为不同的语言。如何使用python-docx设置语言？最好是在运行级别进行，因为我需要在同一行上使用不同的语言(这是我正在创建的双语言文档)。但是，似乎没有任何语言属性用于运行，也没有用于段落。

Answer 1

我认为必须通过 word/styles.xml 中的文档样式设置语言
或在运行级别。
但是目前在 python-docx 中没有对这个任务的 API 支持。
引用 this answer ，
您可以尝试以下代码来更改 oxml 元素对象中的属性。p4 显示运行级别尝试。
(使用 python-docx==0.8.10 + LibreOffice Writer 和德语和英语词典进行测试。)
注意:Core Document Properties 中的语言字段只是一个元数据信息
并且不用于全局拼写检查。

import docx # python-docx==0.8.10


doc = docx.Document()

# For new document (document-wide):
# Set language value in the documents' default Run's Properties element.
styles_element = doc.styles.element
rpr_default = styles_element.xpath('./w:docDefaults/w:rPrDefault/w:rPr')[0]
lang_default = rpr_default.xpath('w:lang')[0]
lang_default.set(docx.oxml.shared.qn('w:val'),'de-DE')

title = doc.add_paragraph('Rechtschreibprüfung', style='Title')

p1 = doc.add_paragraph(
    'Das ist ein deutscher Satz. '
    'Die Rechtschreibprüfung sollte nichts anstreichen.',
    style='Normal'
    )

# For existing styles:
# For styles without a language value
# you can append one explicitly by
# iterating over those styles in the document.
for my_style in doc.styles:
    style = doc.styles[my_style.name]
    rpr = style.element.get_or_add_rPr()
    lang = docx.oxml.shared.OxmlElement('w:lang')
    if not rpr.xpath('w:lang'):
        lang.set(docx.oxml.shared.qn('w:val'),'de-DE')
        lang.set(docx.oxml.shared.qn('w:eastAsia'),'en-US')
        lang.set(docx.oxml.shared.qn('w:bidi'),'ar-SA')
        rpr.append(lang)

p2 = doc.add_paragraph(
    'This sentence is written in English. '
    'The automatic spell checking should complain, '
    'because all styles’ language was set to German.',
    style='Quote'
    )

# For addressing specifc styles:
# Update (or append to) a specific style,
# e.g. in order to use multiple styles
# to handle more than one language per document.
body_style = doc.styles['Body Text']
body_rpr = body_style.element.get_or_add_rPr()
body_lang = body_rpr.xpath('w:lang')[0]
body_lang.set(docx.oxml.shared.qn('w:val'),'en-US')

p3 = doc.add_paragraph(
    'This sentence is written again in English. '
    'The automatic spell checking should not complain, '
    'because this style’s language now has been set to English.',
    style='Body Text'
    )

# Run Level:
# For mixing multiple languages
# within the same style per paragraph.
p4 = doc.add_paragraph(style='Body Text')
p4_text = p4.add_run()
p4_text.add_text(
    'On Run Level: This sentence is written once again in English. '
    'Spell check = OK | '
    )
# Add a new run with its language
# differing from the style's language value.
p4_text = p4.add_run()
p4_rpr = p4_text.element.get_or_add_rPr()
p4_run_lang = docx.oxml.shared.OxmlElement('w:lang')
p4_run_lang.set(docx.oxml.shared.qn('w:val'),'de-DE')
p4_run_lang.set(docx.oxml.shared.qn('w:eastAsia'),'en-US')
p4_run_lang.set(docx.oxml.shared.qn('w:bidi'),'ar-SA')
p4_rpr.append(p4_run_lang)
p4_text.add_text(
    'Und das ist noch einmal ein deutscher Satz. '
    'Rechtschreibprüfung = okay'
    )

doc.save('my-document.docx')