当链接到一个 URL 时,可以提供一个标签来指定读者将看到什么;例如,<http://www.haskell.org haskell>
链接文本将具有“haskell”。不幸的是,该文档没有提供一种明显的方式来标记指向锚点的链接;链接“Data.FooBar#foo”的链接文本将包含“Data.FooBar”,因此读者看不到此链接将指向锚点。
所以我的问题是:在黑线鳕中标记指向锚点的链接是否有技巧,或者这是不可能的?
现在是https://github.com/haskell/haddock/issues/262(由 OP 提交)。
在我写这篇文章时,它是开放的,没有被评论过。
目前,当您使用“MyModule#anchor”之类的内容链接到黑线鳕中的锚点时,生成页面上的链接只会显示“MyModule”。这非常令人困惑,因为看起来链接正在将一个链接带到模块页面,而实际上它会转到该页面上的特定锚点。如果可以将锚名称添加到链接的标签中以明确链接的去向,或者如果有一种方法可以手动指定链接的标签——比如说,借用URL 使用空格指定标签的语法,例如“MyModule#anchor label goes here”。
尽管他们的文档似乎就解决方案提供了建议,但他们似乎没有提供直接的方法。