大四学生一枚,javascript初学者,目前在实习,公司的有一套自己的框架,只需要javascript就可以实现前台和后台,但是关于这个框架的文档是很久以前手写的,跟真正的框架源码甩了好几条街
我希望能够开发一个针对本公司的js文档生成器,源码如下
ui.require('Button');
ui.version.Table = '2.0';
ui.comp.Table = ui.extend('', {
    constructor: function(param) {
    ui.comp.Table.superclass.constructor.apply(this, arguments);
    this.width = 'auto';
    this.height = 'auto';
    },
    focusPreScrollTop:function(focused,num){
        var container =  this.domObj_listContainer.find('.kui-table-content');
        var item = container.find('.kui-table-row-focus');
        if(item.size()>0){
            var itemTop = item.offset().top;
            var toolTop = this.domObj_header.offset().top;
            var height = this.domObj_header.outerHeight(true);
            if(itemTop < (toolTop+height)){
                var temp = itemTop - (toolTop+height);
                container.scrollTop(this._getScrollTop(temp,focused,item,num));
            }
        }
    }
});
已有的文档内容如下
<tr>
<th>属性名</th>
<th>简介</th>
</tr>
<tr>
<td>id</td>
<td>默认值无(AUTO_INCREMENT). 允许格式:字符串。<br/>此属性用于设置组件的id。如不指定,框架会使用一个页面唯一的内部id,命名格式为<i>kui-n</i>,n为一个自增长数字。为组件指定id后,可通过ui.getObjectById( id )方法快速获取组件对象。</td>
</tr>
<tr>
<td>container</td>
<td>默认值"body". 允许格式:jquery 选择器或jquery DOM 对象。<br/>此属性用于设置组件的上级容器。默认body 即表示绘制在页面body元素下。可指定一个jquery 选择器或DOM 对象,如 container : '#myDiv' 或 container : $('#myDiv')</td>
</tr>
<tr>
<td>width</td>
<td>默认值'auto'. 允许格式:数字(单位像素)或字符串(百分比或auto)。<br/>此属性用于设置Block的宽度。默认auto,将撑满水平宽度。</td>
</tr>
除了tr, td中的内容其它不需要改变,我的初步想法是将jsDoc的源码拿来改,但是又不知道如何下手,看不太懂jsDoc的源码
但是如果自己从头开始写一个文本分析工具一样的文档生成器,是不是重复造轮子?
还希望各位大神给我一点建议,感激不尽

解决方案 »

  1.   

    其实我是看不懂楼主想要搞什么。。文档生成这种不是js弄的。。设计io操作管理员美女这个问题就交给你啦
      

  2.   

    ,
    问题描述可以再清楚,详细一点。目前并不是太清楚你到底是要做什么,要生成什么。如果是要根据JS的注释生成API的文档,那么JSDoc是可以用的。
      

  3.   

    nodejs不是可以吗
      

  4.   

    nodejs不是可以吗
    嗯,孤陋寡闻了,一直只是听说nodejs,没有稍微了解过哦。本人还停留在传统技术层面,多学习哈
      

  5.   

    生成API文档的工具有很多
    比如:JSDoc Toolkit和YUIDoc
    需要按照这两种API生成文档的要求,给代码加注释,个人觉得已经很好了
      

  6.   

    文档都是down写吧,用什么生成器。github、npm这些程序员主流社区的文档全部都是down,已经是事实上的规范了
      

  7.   

    js 干这种活应该蛮容易的吧,  前几天刚用 js 写了个 LALR(1)  parser, 用来解析解析简单的文件啊, 写个简单的语言类似 C 的啊啥的编译器/解释器啥的都特别方便 ....
      

  8.   

    没太懂撸主表达的意思这一句
    公司的有一套自己的框架,只需要javascript就可以实现前台和后台
    让我眼前一亮