Html Sphinx读取文档-仅在文本中使用图标
我想使用一些描述特定含义的信息图标。将鼠标悬停在图标上,您会看到一个工具提示,显示其含义。允许非图形用户代理(例如,不支持CSS的浏览器、文本到语音设备)也读取它 假设你写了一份清单Html Sphinx读取文档-仅在文本中使用图标,html,css,python-sphinx,read-the-docs,Html,Css,Python Sphinx,Read The Docs,我想使用一些描述特定含义的信息图标。将鼠标悬停在图标上,您会看到一个工具提示,显示其含义。允许非图形用户代理(例如,不支持CSS的浏览器、文本到语音设备)也读取它 假设你写了一份清单 鸡肉三明治 豆腐三明治-素食主义者 鸡肉沙拉 家庭沙拉-素食主义者 您希望如下所示进行更改,其中创建一个(自定义)指令。使用replace::放置一些其他文本,image::放置图像,unicode::放置(特殊)unicode字符 在最初的问题中,我希望黄瓜字符代表每个|素食者。在同一重构文本源文档或conf
- 鸡肉三明治
- 豆腐三明治-素食主义者
- 鸡肉沙拉
- 家庭沙拉-素食主义者
replace::
放置一些其他文本,image::
放置图像,unicode::
放置(特殊)unicode字符
在最初的问题中,我希望黄瓜字符代表每个|素食者。在同一重构文本源文档或conf.py
中的rst_prolog
中创建以下指令,允许您在整个文档中应用此指令
.. |vegan| unicode:: U+1F952
运行makehtml
并用浏览器打开创建的html文件。您将看到如下结果:
限制:简单地用另一个文本或图像替换指令文本将导致web可访问性问题
如原问题所述,这些指令方法都不能具有title
属性。在HTML文件中,您需要用以下HTML代码替换| vegan |
:
<span title="Vegan">🥒</span>
🥒
示例指令只会使编写自定义ReST指令成为您寻找的明显特性。这是否回答了您的问题?不,示例“@deceze-如果您对您的答案有信心,您可以将其作为答案发布吗?”中的表情符号图标使用信息性图标,就好像它是纯图标GUI一样,从版本2.3开始,它不是Sphinx标准产品功能的一部分;您需要制定一个自定义ReST指令”。
<span title="Vegan">🥒</span>