4

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
4

2 に答える 2

6

テキストの再構成には Sphinx を使用します。内部ハイパーリンクの構文は、たとえば次のようになります。

.. ステップ1：

.. コードブロック:: sql

   テーブル table1 を作成     

これは、内部ハイパーリンクが発生する後のテキストです。ノートcreate table table1
のインデント。一部です.. code-block:: sqlディレクティブの、したがって
、インデントする必要があります。
ここに内部リンクがあります。:ref:`step1` を参照してください。
テーブルの作り方まで。
于 2011-04-24T17:30:02.463 に答える
0

code-blockdocutilsバージョンによってサポートされている0.10か、可能性があります0.9。

于 2014-04-05T14:13:57.023 に答える