为 Google 应用程序脚本库使用自动生成的文档时,是否可以将 Googleprettyprint
类用于代码示例?我试过将它包含在pre
标签中:
<pre class="prettyprint">
但似乎在一代人中被剥离了。
还有没有办法使用@see 命令来引用代码文档中的函数或外部资源?
为 Google 应用程序脚本库使用自动生成的文档时,是否可以将 Googleprettyprint
类用于代码示例?我试过将它包含在pre
标签中:
<pre class="prettyprint">
但似乎在一代人中被剥离了。
还有没有办法使用@see 命令来引用代码文档中的函数或外部资源?
google-apps-script 支持的 gsdoc 标签有许多限制,您只描述了其中两个 - 不支持 html 元素属性和有限的 doc 标签。我在How to preview jsdoc comments in google doc scripts中描述了一些其他问题。
还有一些未解决的问题:
您可以针对您的特别关注添加一个新问题。该@see
标签特别奇怪,因为它出现在 Base Services 文档中,因此该标签要么仅适用于 Google,要么用 html 代替。
一种选择是在另一个平台或托管服务上构建和托管您的文档。这就是为一些著名的库所做的,例如2D Array Library。然后,您可以使用 jsdoc 生成文档,并利用整个标签集的丰富性。