1

我正在尝试记录一系列 Polymer Web 组件。我过去使用过Polymer/core-docs-viewer，但发现它不像 YUIDocs 或其他类似 JSDocs 的那样完整和可扩展。YUIDocs 似乎是记录大型项目/前端和后端代码以创建单个可维护文档源的更好选择。

有没有办法让 YUIDocs 解析 HTML 注释块内或<script>自定义元素标签内的脚本块？

我试过了：

<!--
/**
* Description
*
*@class kiosk-pager
*@constructor
*/
-->

<polymer-element name="kiosk-pager" attributes="settings pagingRate pageDelay pollRate autoPaging "> //etc

还：

<polymer-element name="kiosk-pager" attributes="settings pagingRate pageDelay pollRate autoPaging ">
//template
<script>
    /**
    * Description
    *
    *@class kiosk-pager
    *@constructor
    */

到目前为止，YUIDocs 还没有在上面的评论中找到并添加我的类声明。

任何帮助表示赞赏。

4

2 回答 2

2

这是我如何将它与 Polymer 一起使用的示例

<script>
/**
    Description of element

        <myelement>I am a sweet custom element</myelement>

    @class myelement
**/
/**
    A description of a property

    @attribute property name
**/
</script>

<dom-module id="myelement">
    Put all of your element's code here
</dom-module>

<script src="./i_keep_the_js_seperate.js"></script>
于 2015-06-26T05:37:29.720 回答
1

有一个相关的问题。欢迎你的想法。

https://github.com/yui/yuidoc/issues/328

于 2015-07-05T08:22:56.087 回答