rainie-doc

前端文档网站生成工具

rainie-doc工具根据注释自动生成文档静态网站。

特点

• 借助jsdoc解析注释生成json数据
• 根据json数据自动生成静态网站
• 可添加markdown文档
• 预留使用说明和特点介绍说明到生成页面指定位置

文档

• 使用指导

介绍

安装

使用 npm:

$ npm install rainie-doc -g

选项

-c / --config <file>

说明：配置文件路径

默认值： rainie-doc.json

rainieDoc -c rainie-doc.json

配置文件

配置文件rainie-doc.json模板：

{
  "github_url": "https://github.com/lanjingling0510/rainie-doc",
  "name": "文档web自动生成工具",
  "title": "",
  "description": "根据代码注释自动生成说明网站",
  "logo_icon": "",
  "entry_path": "./src/*.js",
  "categories": [
      "介绍",
      "API"
  ],
    "staticDocs": [
        {
                "type": "markdown",
                "urlId": "readme",
                "category": "介绍",
                "title": "readme",
                "description": "",
                "path": "README.md"
        }
    ],
  "feature": "Feature.md",
  "usage": "./docs/usage.js"
}

具体内容请看配置文件说明

How to Contribute

Anyone and everyone is welcome to contribute to this project. The best way to start is by checking our open issues, submit a new issues or feature request, participate in discussions, upvote or downvote the issues you like or dislike.

0.0.4 2016-12-16 16:03:11

• dce05f4 📚 [document] 文档修改
• cb2f533 📚 [document] 在docs中添加changelog

0.0.3 2016-12-15 18:00:03

• 1c4cbea 🐛 [bug]修改changelog

0.0.2 2016-12-15 17:42:25

• 21e5a5e 🔧 [config] 完善changelog生成功能
• b5cc6f8 ✨ [feature] 添加changelog配置

0.0.1 2016-12-15 17:42:25

• d7bcd1e chore(package.json): updaten version to 0.0.1 by cqGit
• 92e1fc3 🔧 [config] 调整命令配置
• f78fd02 🔧 [config] 修改命令脚本代码
• 325b995 ✨ [feature] 添加发布流程
• 5bdbe30 📚 [document] 修改 reademe.md 配置说明链接
• 298f76f ✨ [feature] markdown支持html标签
• 532e130 first commit