Google Apps Script auto-generated documentation see and prettyprint
为 Google 应用程序脚本库使用自动生成的文档时,是否可以将 Google
但似乎在一代人中被剥离了。
是否还有一种方法可以使用@see 命令来引用代码文档中的函数或外部资源?
google-apps-script 支持的 gsdoc 标签有很多限制,您只描述了其中的两个 - 不支持 html 元素属性,以及有限的 doc 标签。我在如何在 google doc 脚本中预览 jsdoc 评论中描述了一些其他问题。
还有未解决的问题:
- 从脚本编辑器中预览 jsDoc 文档
- 通过在库中支持 @example 使显示示例更容易
- 使用库文档支持面向对象的接口
您可以针对您的特定问题添加一个新问题。
一种选择是在另一个平台或托管服务上构建和托管您的文档。这是为一些著名的库所做的,例如 2D 阵列库。然后,您可以使用 jsdoc 生成您的文档,并利用整个标签集的丰富性。