狮身人面像-使用椭圆(…)在代码块片段中

Question

假设您记录了一个很长的代码片段，并且希望用省略号…表示其中的重复值和行。(…)和垂直椭圆⋮(⋮)。

下面是JSON中的一个示例记录。有26个孩子，你不想把他们都展示出来。

.. code-block:: json

   {
       "total": 26,
       "kids" [
           {
               "_id":  1,
               "name": "Alice",
               "age":  3
           },
           {
               "_id":  2,
               "name": "Becky",
               "age":  3
           },
           ...,
           {
               "_id":  26,
               "name": "Zoe",
               "age":  4
           }
       ]
   }

人类读者仍然可以看到这是一个JSON片段/代码，概括和猜测由省略号(.)表示的"Becky“和"Zoe”之间的模式。

但是Sphinx返回错误，因为这个代码段的语法无效。

$ make html
...
/.../docs/source/sample.rst:3: WARNING: Could not lex literal_block as "json". Highlighting skipped.

我可以在代码块中使用省略号(语法高亮显示)吗？请注意，示例不一定是在JSON中。在Python等其他语言中也会看到这个问题。

Answer 1

添加选项:force:并添加自定义CSS以禁用错误突出显示：

.highlight .err {
    border: inherit;
    box-sizing: inherit;
}

​

​