Question

我有以下reSt标记

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

使用在线编辑器呈现like this http://rst.ninjs.org/。但是Sphinx会渲染它like this（请注意，第二，第三和第四行缺少反斜杠）。为什么会这样呢？如何通过Sphinx获得在线编辑器的结果？

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

我正在Windows 10上使用python.org中的Python 3.7.5，并通过pip安装了Sphinx 2.2.1。

Answer 1

我无法复制您的问题。也许是不好的复制粘贴？我得到了第一个示例中的内容，而所有内容均已正确转义。

但是我建议使用内联文字（双反引号）而不是**，因为这实际上就是您所使用的。

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

Answer 2

我发现默认情况下启用的SmartQuotes引起了问题。禁用SmartQuotes，上面的标记将按预期工作。

<?php
class HttpClient
{
    private $errorList;

    public function __construct()
    {
        $this->errorList = []; // change to $this->errorList
    }

    public function getHttpErrorList() { return $this->errorList; } // change to $this->errorList

    //...
}

class Twitter extends HttpClient
{
    public function __construct()
    {
        parent::__construct();

        //..
    }

    public function getMessages()
    {
        //...

        var_dump($this->getHttpErrorList()); //outputs array(0) {}
    }
}

$twit = new Twitter();
$twit->getMessages(); // output: array(0) { }

Sphinx的reSt渲染不一致

2 个答案: