- html - 出于某种原因,IE8 对我的 Sass 文件中继承的 html5 CSS 不友好?
- JMeter 在响应断言中使用 span 标签的问题
- html - 在 :hover and :active? 上具有不同效果的 CSS 动画
- html - 相对于居中的 html 内容固定的 CSS 重复背景?
我知道已提出问题 1731,要求在 Google 脚本编辑器中预览 jsdoc。 http://code.google.com/p/google-apps-script-issues/issues/detail?id=1731
在我们等待实现时,预览我添加到已发布库中的 jsdoc 注释而不需要创建新版本的最佳方式是什么?
最佳答案
2014 年更新:Google Apps 脚本编辑器的自动完成功能现在支持库,因此可以立即获得有关库的某些 jsdoc 注释的反馈。
<小时/>这个解决方案并不理想 - 它不提供与已发布的谷歌脚本库相同的外观 - 但至少我可以通过我的 jsdoc 注释来很好地了解它们的外观,而无需不断创建新的我的库的版本没有功能增强。 如果有人可以详细说明获得我们从发布中看到的确切输出的额外步骤,请分享!
这是我在 Windows 7 PC 上所做的。类似的步骤可能适用于其他平台,ymmv。
通过将存储库下载为 zipfile 来获取 jsdoc3 .
解压缩到方便的位置。我用过C:\jsdoc
。这还会安装 jsdoc3 所需的 Rhino jvm。
接下来,您需要将 google 脚本放入可以由 jsdoc3 解析的本地文件中。 再说一遍,如果有人知道更好的方法,我洗耳恭听!
为您的 Google 脚本项目设置本地目录。 C:\myscript
,说。
转到 Google 文档/驱动器/其他位置中的脚本,然后将整个内容复制到系统剪贴板。
<ctrl-A> <ctrl-C>
使用您喜欢的文本编辑器粘贴剪贴板内容
<ctrl-V>
将结果保存在 JavaScript 文件中。 C:\myscript\testing.js
,说。
好吧,从这里开始,我们需要解析文件、审核输出并编辑 jsdoc 注释,直到您满意为止。
jsdoc3 的输出将进入“out”目录。
在 C:\myscript
中打开命令窗口.
解析您的 JavaScript 文件。
\jsdoc\jsdoc testing.js
在默认浏览器中打开输出。
out\index.html
冲洗并重复,直到获得所需的结果。
将编辑后的脚本复制并粘贴回 Google 空间,验证您的代码没有损坏,然后创建一个新版本来为您发布的库生成文档。
输出的格式与您在已发布的 Google 脚本库中看到的不同,但内容基本相同。请记住,Google 仅支持 jsdoc 标签的子集(仅 @param 和 @returns) - 您可以将其他标签放入代码中,但它们将被忽略。
HTML 表格可以包含在您的 jsdoc 注释中,但自定义选项有限。
<tbody></tbody>
中标签; <thead>
内的行被忽视。 <th>
被忽视。要使第一行突出,请使用 <b></b>
标签。align
等将被忽略。以下是在 jsdoc 和 googlescript doc 中呈现的一些元素的示例:
/**
* Demonstrate jsdoc with a table. Otherwise, meaningless gibberish.
*
* <table>
* <tbody>
* <tr><td style="width: 75%"><b>Student Name</b></td><td style="width: 25%"><b>Idiocy Factor</b></td></tr>
* <tr><td> John Smith </td><td align=right> 18 </td></tr>
* <tr><td> Sally Doe </td><td align=right> 53 </td></tr>
* <tr><td> Carmen Sandiego </td><td align=right> 90 </td></tr>
* <tr><td> Tam O'Shanter </td><td align=right> 180 </td></tr>
* </tbody>
* </table>
*
* Continuation of function description down here. Why not have an example?
* <pre>
* =myFunc($A8, $DV8 )
* </pre>
*
* @param {String} your mother's name, e.g. <code>"Anne Murray"</code>
* @param {String} date of birth, <code>DD/MM/YYYY</code>
* @returns {Date} estimated date of demise
* @returns {String} "Please try again." if error in input
*/
并不完美,并且具有相当高的 PITA 值。尽管如此,jsdoc 将确保您获得任何不受支持的标签的语法正确,这非常有利于可移植性。
关于google-apps-script - 如何在 Google 文档脚本中预览 jsdoc 注释,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/12461752/
我需要将文本放在 中在一个 Div 中,在另一个 Div 中,在另一个 Div 中。所以这是它的样子: #document Change PIN
奇怪的事情发生了。 我有一个基本的 html 代码。 html,头部, body 。(因为我收到了一些反对票,这里是完整的代码) 这是我的CSS: html { backgroun
我正在尝试将 Assets 中的一组图像加载到 UICollectionview 中存在的 ImageView 中,但每当我运行应用程序时它都会显示错误。而且也没有显示图像。 我在ViewDidLoa
我需要根据带参数的 perl 脚本的输出更改一些环境变量。在 tcsh 中,我可以使用别名命令来评估 perl 脚本的输出。 tcsh: alias setsdk 'eval `/localhome/
我使用 Windows 身份验证创建了一个新的 Blazor(服务器端)应用程序,并使用 IIS Express 运行它。它将显示一条消息“Hello Domain\User!”来自右上方的以下 Ra
这是我的方法 void login(Event event);我想知道 Kotlin 中应该如何 最佳答案 在 Kotlin 中通配符运算符是 * 。它指示编译器它是未知的,但一旦知道,就不会有其他类
看下面的代码 for story in book if story.title.length < 140 - var story
我正在尝试用 C 语言学习字符串处理。我写了一个程序,它存储了一些音乐轨道,并帮助用户检查他/她想到的歌曲是否存在于存储的轨道中。这是通过要求用户输入一串字符来完成的。然后程序使用 strstr()
我正在学习 sscanf 并遇到如下格式字符串: sscanf("%[^:]:%[^*=]%*[*=]%n",a,b,&c); 我理解 %[^:] 部分意味着扫描直到遇到 ':' 并将其分配给 a。:
def char_check(x,y): if (str(x) in y or x.find(y) > -1) or (str(y) in x or y.find(x) > -1):
我有一种情况,我想将文本文件中的现有行包含到一个新 block 中。 line 1 line 2 line in block line 3 line 4 应该变成 line 1 line 2 line
我有一个新项目,我正在尝试设置 Django 调试工具栏。首先,我尝试了快速设置,它只涉及将 'debug_toolbar' 添加到我的已安装应用程序列表中。有了这个,当我转到我的根 URL 时,调试
在 Matlab 中,如果我有一个函数 f,例如签名是 f(a,b,c),我可以创建一个只有一个变量 b 的函数,它将使用固定的 a=a1 和 c=c1 调用 f: g = @(b) f(a1, b,
我不明白为什么 ForEach 中的元素之间有多余的垂直间距在 VStack 里面在 ScrollView 里面使用 GeometryReader 时渲染自定义水平分隔线。 Scrol
我想知道,是否有关于何时使用 session 和 cookie 的指南或最佳实践? 什么应该和什么不应该存储在其中?谢谢! 最佳答案 这些文档很好地了解了 session cookie 的安全问题以及
我在 scipy/numpy 中有一个 Nx3 矩阵,我想用它制作一个 3 维条形图,其中 X 轴和 Y 轴由矩阵的第一列和第二列的值、高度确定每个条形的 是矩阵中的第三列,条形的数量由 N 确定。
假设我用两种不同的方式初始化信号量 sem_init(&randomsem,0,1) sem_init(&randomsem,0,0) 现在, sem_wait(&randomsem) 在这两种情况下
我怀疑该值如何存储在“WORD”中,因为 PStr 包含实际输出。? 既然Pstr中存储的是小写到大写的字母,那么在printf中如何将其给出为“WORD”。有人可以吗?解释一下? #include
我有一个 3x3 数组: var my_array = [[0,1,2], [3,4,5], [6,7,8]]; 并想获得它的第一个 2
我意识到您可以使用如下方式轻松检查焦点: var hasFocus = true; $(window).blur(function(){ hasFocus = false; }); $(win
我是一名优秀的程序员,十分优秀!