Sphinx/rst 的 ruby 标签

Question

我在 Sphinx 的帮助下从第一个格式的文本创建 HTML 文档。我需要用 furiganas （=单词上方的小字符）显示一些日语单词，如下所示：

借助 < ruby > 标签，我想生成显示注音假名的 HTML。

我不知道如何得到这个结果。我尝试过：

• 使用 .. raw:: html 指令插入原始 HTML 代码，但它会将我的行分成几个段落。
• 使用 :superscript: 指令，但注音文本写在旁边文本，而不是上面。
• 使用 :role: 指令 在文本和我自己的 CSS 类之间创建链接。但是 :role: 指令只能应用于一段文本，而不能应用于 furigana 所要求的两个段（= 文本 + 其上方的文本）。

有什么想法可以帮助我吗？

Answer 1

据我所知，没有简单的方法可以得到预期的结果。

对于特定项目，我选择不借助 Sphinx 生成注音假名，而是随后修改 .html 文件。请参阅

add_ons/add_furiganas.py

脚本和结果此处。是的，这是一个快速而肮脏的技巧:(

Answer 2

将整行（即所有字符，包括未标记的字符）放入

.. raw:: html

指令中可能会解决问题。这是一个例子：

.. raw:: html

    你<ruby>好<rt>hǎo</rt></ruby>呀！