sphinx / rst

Question

我在Sphinx的帮助下，从rst形式的文本创建HTML文档。我需要用furiganas（=单词上方的小字符）显示一些日语单词，类似于：

由于the < ruby > tag，我想制作展示furiganas的HTML。

我无法弄清楚如何得到这个结果。我试着：

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

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

Answer 1

只要我知道，没有简单的方法可以获得预期的结果。

For a specific project，我选择不在Sphinx的帮助下生成furiganas，但之后修改.html文件。请参阅add_ons/add_furiganas.py脚本和结果here。是的，这是一个快速而肮脏的伎俩:(