32

ハドックドキュメンテーションツールで番号付きリストを続ける方法は? ハドックの次の行

--  1. First line.
-- 
--  2. Second line with instructions to do something 
-- 
--     >>> command-linecmd param
--
--  3. Third line..
--

次の html を生成します。

</p><ol><li> First line.
</li><li> Second line with instructions to do something 
</li></ol><pre class="screen"><code class="prompt">&gt;&gt;&gt; </code><strong         class="userinput"><code>command-linecmd param
</code></strong></pre><ol><li> Third line..
</li></ol>

これにより、番号付けが中断されます。ハドックを HTML でも 3 番目の数字で継続させる方法はありますか、それとも別の方法を試す必要がありますか (>>> は適切な書式設定を提供します。なぜそれを使用したいのですか)?

4

1 に答える 1

5

できません。を使用しています>>>。これを例として表示するには、段落の先頭に配置する必要があります。

段落の始まりと見なされるものは何ですか?

  • Haddock コメントの先頭にあるものはすべて、その前の空白をスキップします。

  • 空行に続くもの。

あなたのシナリオでは、リスト要素、リスト要素、例、リスト要素の 4 つの段落があります。内部的には、Haddock はあなたが書き留めたリスト番号を完全に無視します: 必要に応じて 999 か​​ら開始することもできます。Haddock は、同じ種類のリストを持つ連続した段落を検出すると、それらを結合して番号を付けます。パターンを壊しているため、リストは継続として扱われません。>>>このシナリオでは、新しい段落に入るときにスペースが取り除かれるため、スペースでインデントすることは実際には無意味です。例が連続している場合は、スペースが重要であることに注意してください。インデントが同一である限り、同じ段落にそれらを配置できます。

独自の段落に配置する必要がある (したがって、リストの順序が崩れる) その他のものは、リスト、バードトラック、コードブロック ( の間@のテキストのみを含む段落)、およびプロパティ ( prop>) です。

これは、段落のネストを許可することで解決できますが、計画されていません。チケット #27 はネスト リスト (たまたま段落レベルのエンティティ) に関するものですが、この問題は解決しません。

番号が重要でない場合、または少しごまかし、名前付きリストを使用する場合は、順序なしリストを使用することをお勧めします ( [name] content)

名前付きリストと順序なしリストのソリューション

編集: 2014 年 1 月 12 日現在、Haddock チケット #27は解決されており、2 番目のリスト要素の後に例の 4 つのスペースをインデントすることでこれが可能になりました。これ:

1. First element

2. Second element

    >>> your example
    your example result

3. Third element

結果は次のようになります。

ハドックのネストされたリスト項目
(出典:風ゼツ.co.uk )

于 2013-08-22T20:11:36.857 に答える