haskell - 如何在 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 = ()

变成

Answer 2

Haddock“标记”目前不支持表格，另请参阅Haddock 用户指南 - 第 3 章文档和标记。添加对简单表的支持存在一个未解决的问题。