Sphinx/rst 的红宝石标签答案

【问题标题】：ruby tags for Sphinx/rstSphinx/rst 的红宝石标签
【发布时间】：2015-07-07 20:18:24
【问题描述】：

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

感谢the < ruby > tag，我想制作显示汉字的HTML。

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

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

有什么可以帮助我的吗？

【问题讨论】：

【解决方案1】：

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

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

【讨论】：