haskell - 如何链接到 Haddock 中的指定文档 block ？

Question

我可能遗漏了一些非常明显的东西(或者可能在盯着 Haddock 用户指南时暂时失明)，但我似乎找不到任何链接到 named chunk of documentation in Haddocks 的方法。

编辑:我正在尝试创建一个从文档的一部分到另一个命名的文档 block 的内部超链接。我尝试了以下方法:

-- You may want to take a look at 'findByPkHelpers' section for
-- variations of this function.
--
-- I even tried putting '$findByPkHelpers' but didn't work
--
-- ... snip ...

-- ** Some heading
-- 
-- $findByPkHelpers

Answer 1

您可以使用语法 #myanchor创建一个 anchor ，然后您可以使用 [my link text](#myanchor) 链接到它.例如，在我的导出 list 中，我有

    -- | #launchaprocess#

    -- * Launch a process
    , runProcess
    , readProcess

然后在文件的正文中，我有一个指向该 anchor 的链接

-- | Once you have a @ProcessConfig@ you can launch a process from it
-- using the functions in the section [Launch a process](#launchaprocess).

(注意，在导出列表中节标题旁边的 anchor 的情况下，它们之间必须有一个空白链接，否则 * 引入标题将被解释为 Haddock 注释项目符号列表!)
[感谢@sjakobi 指出此功能]