python - 使用Python docx在Word中创建拼音指南/'Ruby text'？

Question

我想为 MS Word 中的单词添加拼音指南。在 MS Word 内部，原始单词称为“基本文本”，拼音指南称为“Ruby 文本”。

这是我尝试在 Word 中创建的内容:

docx 文档有一个页面讨论运行级别内容并引用 ruby​​:<xsd:element name="ruby" type="CT_Ruby"/>位于这里: https://python-docx.readthedocs.io/en/latest/dev/analysis/features/text/run-content.html

我不知道如何在我的代码中访问这些。

这是我的一次尝试的示例:

import docx
from docx import Document
document = Document()
base_text = '光栄'
ruby_text = 'こうえい'
p = document.add_paragraph(base_text)
p.add_run(ruby_text).ruby = True
document.save('ruby.docx')

但是此代码仅返回以下内容:

光栄こうえい

我尝试使用 ruby关于paragraph和p.text ，删除 = True但我不断收到错误消息 'X object has no attribute 'ruby'

有人可以告诉我如何实现这一点吗？

Answer 1

<xsd:element name="ruby" ...您提到的摘录来自运行的 XML 架构类型。这意味着 CT_Ruby 类型的子元素可以出现在带有标签名称 <w:r> 的运行元素 ( <w:ruby> ) 上.

python-docx 中尚无对此元素的任何 API 支持，因此如果您想使用它，您需要使用低级 lxml 来操作 XML来电。您可以访问 run._r 上的 run 元素。如果您搜索“python-docx 解决方法函数”以及“python-pptx 解决方法函数”，您会发现一些这样做来扩展功能的示例。