如何链接到Haddock中的命名文档块？

Question

我可能会遗漏一些非常明显的东西(或者可能已经开始暂时失明,盯着Haddock用户指南),但我似乎无法找到任何方式链接到Haddocks中的一大块文档

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

-- 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创建锚点，然后可以使用 链接到它[my link text](#myanchor)。例如，在我的导出列表中

    -- | #launchaprocess#

    -- * Launch a process
    , runProcess
    , readProcess

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

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

（注意，对于导出列表中节标题旁边的锚点，它们之间必须有一个空白链接，否则*引入标题将被解释为 Haddock 注释项目符号列表！）

[感谢@sjakobi 指出此功能]