如何在 Apple DocC 上添加字符串扩展

Question

我正在 Xcode 13 beta 上查看新的 Apple 文档。我可以 build documentation 使用 DocC。

但我看不到为字符串扩展、日期扩展等扩展创建的任何文档。

根据以下案例的示例，它不会添加任何文档。

extension String {

    /// Description for DocC
    func myMethod() {
       
    }
}

考虑一下，如果我为任何结构或 class 创建了扩展，那么它会添加如下代码的文档

public struct MyStruct {

}


extension MyStruct {

  /// Description
  func myMethod() {
 
  }
}

这是苹果的默认行为还是我遗漏了什么？

Answer 1

目前不支持。 DocC 只能为单个模块的类型生成文档。不处理模块外部类型的扩展。（它也不允许您 link 使用 ``...`` 引用在模块外键入。）

How to add String Extension on Apple DocC