Haskell 黑线鳕编号列表继续
如何使用haddock文档工具继续编号列表?黑线鳕中的以下几行Haskell 黑线鳕编号列表继续,haskell,haddock,Haskell,Haddock,如何使用haddock文档工具继续编号列表?黑线鳕中的以下几行 -- 1. First line. -- -- 2. Second line with instructions to do something -- -- >>> command-linecmd param -- -- 3. Third line.. -- 生成下一个html: </p><ol><li> First line. </li><
-- 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">>>> </code><strong class="userinput"><code>command-linecmd param
</code></strong></pre><ol><li> Third line..
</li></ol>
这会破坏编号。有没有办法让haddock继续使用HTML格式的第三个数字,或者我应该尝试其他格式(>>>提供了很好的格式,为什么我要使用它)?你不能。您正在使用
>
。为了将其作为示例呈现,需要将其放在本段开头
这一段的开头是什么
- Haddock注释开头的任何内容,跳过其前面的任何空白
- 空行后的任何内容
>
,实际上是毫无意义的,因为当我们在一个新段落中时,它们将被剥离。请注意,如果有连续的示例,空格很重要:只要缩进相同,就可以将它们放在同一段落中
其他必须放在自己段落中的内容(因此会打破列表顺序)是列表、鸟笼、代码块(段落只包含@
s之间的文本)和属性(prop>
)
虽然这可以通过允许段落嵌套来解决,但这并不是计划中的。Ticket#27只涉及嵌套列表(恰好是段落级实体),但无法解决此问题
如果数字不重要或有点作弊,我建议您使用无序列表,并使用命名列表([name]content
)
编辑:截至2014年1月12日,已解决,现在可以通过在第二个列表元素后缩进示例4空格来实现。这:
1. First element
2. Second element
>>> your example
your example result
3. Third element
现在的结果是:
(来源:)恐怕haddock根本不支持嵌套结构。我很想了解其他情况。我同意丹尼尔·菲舍尔的观点,文档似乎支持列表必须不间断,不能嵌套的概念。谢谢你们两位的回答,我认为在目前的情况下,这些回答是有效的-->应该把它们移到答案上来还是重要呢?我修正了问题#27。请参阅我的最新答案。