Html Sphinx读取文档-仅在文本中使用图标

Html Sphinx读取文档-仅在文本中使用图标,html,css,python-sphinx,read-the-docs,Html,Css,Python Sphinx,Read The Docs,我想使用一些描述特定含义的信息图标。将鼠标悬停在图标上,您会看到一个工具提示,显示其含义。允许非图形用户代理(例如,不支持CSS的浏览器、文本到语音设备)也读取它 假设你写了一份清单 鸡肉三明治 豆腐三明治-素食主义者 鸡肉沙拉 家庭沙拉-素食主义者 您希望如下所示进行更改,其中创建一个(自定义)指令。使用replace::放置一些其他文本,image::放置图像,unicode::放置(特殊)unicode字符 在最初的问题中,我希望黄瓜字符代表每个|素食者。在同一重构文本源文档或conf

我想使用一些描述特定含义的信息图标。将鼠标悬停在图标上,您会看到一个工具提示,显示其含义。允许非图形用户代理(例如,不支持CSS的浏览器、文本到语音设备)也读取它

假设你写了一份清单

  • 鸡肉三明治
  • 豆腐三明治-素食主义者
  • 鸡肉沙拉
  • 家庭沙拉-素食主义者
您希望如下所示进行更改,其中创建一个(自定义)指令。使用
replace::
放置一些其他文本,
image::
放置图像,
unicode::
放置(特殊)unicode字符

在最初的问题中,我希望黄瓜字符代表每个
|素食者
。在同一重构文本源文档或
conf.py
中的
rst_prolog
中创建以下指令,允许您在整个文档中应用此指令

.. |vegan|  unicode:: U+1F952 
运行
makehtml
并用浏览器打开创建的html文件。您将看到如下结果:

限制:简单地用另一个文本或图像替换指令文本将导致web可访问性问题

如原问题所述,这些指令方法都不能具有
title
属性。在HTML文件中,您需要用以下HTML代码替换
| vegan |

<span title="Vegan">&#x1f952</span>
🥒

示例指令只会使
编写自定义ReST指令成为您寻找的明显特性。这是否回答了您的问题?不,示例“@deceze-如果您对您的答案有信心,您可以将其作为答案发布吗?”中的表情符号图标使用信息性图标,就好像它是纯图标GUI一样,从版本2.3开始,它不是Sphinx标准产品功能的一部分;您需要制定一个自定义ReST指令”。
<span title="Vegan">&#x1f952</span>