reStructuredText for SQL？

Question

我正在尝试使用DocUtils和reStructuredText注释SQL代码。当我在多行注释中包含标记时，可以使它起作用。然后，我使用--Some text ::来介绍每个代码块。

我无法使内部超链接正常工作。我想写-.. Step1_：但是解析器由于前导注释而忽略了这一点。使用多行样式也会失败。有没有办法让它工作？

这是一个例子：

/*
==========
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

Answer 1

我使用Sphinx重组文本。内部超链接的语法例如为

.. 步骤1：

..代码块:: SQL

   创建表table1     

这是稍后的文本，其中发生内部超链接。注意创建表table1 
的缩进。这是一部分
对的..代码块:: SQL指令，所以它必须缩进。
现在是内部链接。请参阅：ref：`step1`作为
如何创建表格。