如何在没有警告的情况下将星号表情符号与 Sphinx 一起使用?
How to use asterisk emoji with Sphinx and without warnings?
如果我在我的文档中使用星号表情符号 (*️⃣),那么 Sphinx 会抱怨并发出警告:
WARNING: Inline emphasis start-string without end-string.
那是因为它将字符解释为一个单独的星号加上其他东西。
如何避免该警告?
我尽量避免使用 literal/:samp:,因为它们会在 HTML 输出中为字符添加灰色背景。
您可以使用反斜杠转义任何保留的 reStructuredText 标记字符:
\*️⃣
如果我在我的文档中使用星号表情符号 (*️⃣),那么 Sphinx 会抱怨并发出警告:
WARNING: Inline emphasis start-string without end-string.
那是因为它将字符解释为一个单独的星号加上其他东西。
如何避免该警告?
我尽量避免使用 literal/:samp:,因为它们会在 HTML 输出中为字符添加灰色背景。
您可以使用反斜杠转义任何保留的 reStructuredText 标记字符:
\*️⃣