如何在 Haddock 文档中生成表格

Question

我正在用 Haddock 编写一些文档，我需要在其中放置一个包含一些值的多列表。我怎样才能用黑线鳕做到这一点？我找不到有关它的信息。嵌入一​​些 html 作为替代看起来也不可能。

Answer 1

与 GHC 8.4 或更高版本（Haddock 版本 >= 2.18.2）捆绑的 Haddock 支持表格。根据添加此内容的拉取请求，语法基于RST 网格表。

样品用途：

module Sample where

-- | A table:
--
-- +------------------------+------------+----------+----------+
-- | Header row, column 1   | Header 2   | Header 3 | Header 4 |
-- | (header rows optional) |            |          |          |
-- +========================+============+==========+==========+
-- | body row 1, column 1   | column 2   | column 3 | column 4 |
-- +------------------------+------------+----------+----------+
-- | body row 2             | Cells may span columns.          |
-- +------------------------+------------+---------------------+
-- | body row 3             | Cells may  | \[                  |
-- +------------------------+ span rows. | f(n) = \sum_{i=1}   |
-- | body row 4             |            | \]                  |
-- +------------------------+------------+---------------------+
sample :: ()
sample = ()

变成