与 Sphinx 不一致的 reSt 渲染答案

【问题标题】：Inconsistent reSt rendering with Sphinx与 Sphinx 不一致的 reSt 渲染
【发布时间】：2019-11-23 16:12:18
【问题描述】：

我有以下剩余标记

==================  =====================
**\\v**              vertical tab
**\\\\**             backslash
**\\'**              single quote
**\\"**              double quote
**\\?**              question mark
==================  =====================

使用在线编辑器呈现like this http://rst.ninjs.org/。然而，Sphinx 将其呈现为like this（请注意第 2、第 3 和第 4 行缺少反斜杠）。为什么会这样？如何使用 Sphinx 获得在线编辑器的结果？

注意： imgur 在我的国家被禁止，这就是为什么我必须提供图片的外部链接。

我在 Windows 10 上使用来自 python.org 的 Python 3.7.5，安装了 pip 的 Sphinx 2.2.1。

【问题讨论】：

标签： python-sphinx restructuredtext

【解决方案1】：

我无法重现您的问题。也许这是一个糟糕的复制粘贴？我得到了你在第一个例子中得到的东西，一切都被正确地转义了。

不过，我建议使用内联文字（双反引号）而不是 **，因为这就是您真正使用的内容。

==================  =====================
``\v``              vertical tab
``\\``              backslash
``\'``              single quote
``\"``              double quote
``\?``              question mark
==================  =====================

【讨论】：

【解决方案2】：

我发现默认启用的 SmartQuotes 导致了问题。禁用 SmartQuotes 和上面的标记按预期工作。

# add the following line to conf.py
smartquotes = False

【讨论】：