Sphinx代码块在HTML中奇怪地呈现

Question

我正在尝试使用Sphinx代码块，并且在HTML中出现奇怪的渲染。我的来源是：

The following image shows both the source code used and how it was rendered in HTML

这是页面的第一个来源

************
Testing Page
************

Used for testing Sphinx constructs

Why does the role get rendered in HTML?

..code-block:: python

    This is a code line
    and so is this.

It is very confused because it emits the following error::
   D:\Shared\WiseOldbird\Projects\Platform IndependentApplicationController\docs\source\Test.rst:12: WARNING: Block quote ends without a blank line; unexpected unindent

If I try it like this without the language specification it renders the role and displays the code block correctly -
note that it strips a single colon from the role directive

..code-block::

 This is a code line
 and so is this.

If I use a literal block.::

   I get a colon in the text that introduces the literal block

Heading
-------

我需要怎么做才能正确使用Sphinx代码块？

Answer 1

• code-block中缺少空格。

  将..code-block:: python更改为.. code-block:: python。

• code-block指令必须具有指定语言的参数。

  请参见http://www.sphinx-doc.org/en/stable/usage/restructuredtext/directives.html#directive-code-block。

• 在文字块之前的段落中，冒号之前也缺少空格。

  将literal block.::更改为literal block. ::，以删除呈现文本中的冒号。