Google Apps Script 自动生成的文档查看和打印

Google Apps Script auto-generated documentation see and prettyprint

为 Google 应用程序脚本库使用自动生成的文档时,是否可以将 Google prettyprint 类用于代码示例?我已经尝试将它包含在 pre 标签中:
<pre1>

但似乎在一代人中被剥离了。

是否还有一种方法可以使用@see 命令来引用代码文档中的函数或外部资源?


google-apps-script 支持的 gsdoc 标签有很多限制,您只描述了其中的两个 - 不支持 html 元素属性,以及有限的 doc 标签。我在如何在 google doc 脚本中预览 jsdoc 评论中描述了一些其他问题。

还有未解决的问题:

  • 从脚本编辑器中预览 jsDoc 文档
  • 通过在库中支持 @example 使显示示例更容易
  • 使用库文档支持面向对象的接口

您可以针对您的特定问题添加一个新问题。 @see 标签特别奇怪,因为它出现在 Base Services 文档中,所以该标签要么只适用于 Google,要么用 html 代替它。

一种选择是在另一个平台或托管服务上构建和托管您的文档。这是为一些著名的库所做的,例如 2D 阵列库。然后,您可以使用 jsdoc 生成您的文档,并利用整个标签集的丰富性。