zoukankan      html  css  js  c++  java
  • YUIDoc example代码高亮错误、生成API文档目录不按源文件注释顺序

    1.如果发现yuidoc命令用不了,那就重装nodejs吧

       昨天不知道是清扫电脑的原因,yuidoc命令用不了(命令不存在),也没有找到好的解决方法,怒重装YUIDoc也不行。最后想了想,怒重装了nodejs,再装回YUIDoc,发现又可以了,原因还没找到。

    2.YUIDoc的theme中的simple模板,sidebar.handlebar有写错。

       里面属性遍历的properties被写成了events

    3.YUIDoc example代码高亮错误的解决方法

      使用过YUIDoc的人有可能会发现,写在example下的示例代码在文档生成之后可能出现代码不高亮、代码高亮错误等问题。

      这里提一个小技巧,先把example下所有的示例代码顶左,再使用Tab进行缩进,才不是出现高亮错误。

    4.YUIDoc生成的API文档目录不按源文件注释顺序

       YUIDoc默认将所有的class、method、properties、events等按字母进行排序。-_-!!!

       而且这个是在生成文档时进行排序的,所以如果除去按字母进行排序这种默认行为。

       就必须修改YUIDoc的工具文件。修改C:UsersAdministratorAppDataRoaming pm ode_modulesyuidocjslib 下的 builder.js 文件

       第1313-1316行,就是这几句罪魁祸首,注释掉后就可以按源文件注释顺序,当然你也可以自己弄其他排序方法。

  • 相关阅读:
    spring-boot4
    spring-boot3代码
    spring-boot3
    spring-boot2代码
    spring-boot2
    Java Socket编程
    eclipse项目中.classpath文件详解
    spring-boot1
    ASCII 在线转换器
    如何在Android开发中让你的代码更有效率
  • 原文地址:https://www.cnblogs.com/lovesong/p/3341453.html
Copyright © 2011-2022 走看看