用于SQL的reStructuredText?

我正在尝试使用DocUtils和reStructuredText来评论SQL代码。当我在多行注释中包含标记时,我可以使用它。然后我使用--Some text ::来介绍每个代码块。 我无法获得内部超链接。我想写 - .. 步骤1_: 但由于领先的评论,解析器忽略了这一点。使用多行样式也会失败。有没有办法让这个工作? 这是一个例子:
/*
==========
this query
==========
:Author: Me

Outline
==========

- Create table 1

- Create table 2

- Output the result

*/

-- _Step1: build the table::

    create table table1

-- _Step2: use Step1_ to build table 2::

    create table table2
    
已邀请:
我使用Sphinx进行重组文本。例如,内部超链接的语法是 .. 步骤1: .. code-block :: sql    创建表table1 这是稍后发生内部超链接的文本。注意 create table table1的缩进。这是一部分 .. code-block :: sql指令,所以必须缩进。 现在来了内部链接。请参阅:ref:`step1` as 如何创建表。     
code-block
docutils
版本
0.10
支持,或者可能是
0.9
。     

要回复问题请先登录注册