yapi/ydoc.json

{
    "name": "YApi",
    "dest": "static/doc",
    "examplePath": "./exampleCode",
    "defaultGrammar": "json",
    "instructionsInfoPath": "", //使用说明 内容路径 (需要配合JS-Component注释的@instructions使用)
    "instructionsUrlPath": "", //使用说明demo路径 (需要配合JS-Component注释的@instructions使用)
    "common": { // 通用默认配置，包括主页配置等
        "title": "YApi", //page title
        "footer": "&copy; 2016 <a href=\"https://github.com/ymfe/yapi\">YMFE</a> Team. Build by <a href=\"http://ued.qunar.com/ydoc/\">ydoc</a>", // 通用尾
        "home": "YMFE", // logo
        "homeUrl": "https://github.com/ymfe" // logourl
    },
    "options": {
        "foldcode": false,
        "markdown": { // 对于 markdown 编译器进行统一配置
            "menuLevel": 2 //选取第几级 head 作为目录，默认 -1 没有目录
        }
    },
    "pages": [{
        "name": "index",
        "title": "使用手册",
        "banner": {
            "title": "YApi",
            "description": "高效、易用、功能强大的api管理平台，旨在为开发、产品、测试人员提供更优雅的接口管理服务。"
        },
        "content": {
            "sidebar": true,
            "multi": true,
            "index": "./doc/page/usage/getfamiliar.md",
            "pages": [{
                "name": "认识 YApi",
                "index": "getfamiliar",
                "content": "./doc/page/usage/getfamiliar.md"
            },{
                "name": "创建第一个API",
                "index": "quickstart",
                "content": "./doc/page/usage/quickstart.md"
            },{
                "name": "管理分组与项目",
                "index": "manage",
                "content": "./doc/page/usage/manage.md"
            },{
                "name": "项目操作",
                "index": "project",
                "content": "./doc/page/usage/project.md"
            },{
                "name": "接口操作",
                "index": "interface",
                "content": "./doc/page/usage/api.md"
            },{
                "name": "普通 Mock",
                "index": "mock",
                "content": "./doc/page/usage/mock.md"
            },{
                "name": "高级 Mock",
                "index": "adv_mock",
                "content": "./doc/page/usage/adv_mock.md"
            },{
                "name": "使用测试集",
                "index": "case",
                "content": "./doc/page/usage/case.md"
            },{
                "name": "数据导入",
                "index": "data",
                "content": "./doc/page/usage/data.md"
            }
        ]
        }
    },
//   {
//       "name": "manage",
//       "title": "管理学院",
//       "banner": {
//           "title": "管理学院",
//           "description": "超级管理员、分组/项目组长的学院。"
//       },
//       "content": {
//           "sidebar": true,
//           "multi": true,
//           "index": "./doc/page/manage/intro.md",
//           "pages": [{
//               "name": "介绍",
//               "content": "./doc/page/manage/intro.md"
//           }, {
//               "name": "部署",
//               "content": "./doc/page/manage/build.md"
//           }, {
//               "name": "超管职责",
//               "content": "./doc/page/manage/admin.md"
//           }, {
//               "name": "版本升级",
//               "content": "./doc/page/manage/update.md"
//           }]
//       }
//   },
    {
    "name": "devops",
    "title": "内网部署",
    // "banner": {
    //     "title": "YApi",
    //     "description": "这里列举了 YApi 的历史版本、发布时间及变更记录，帮助你追溯到每个版本的演进过程。"
    // },
    "compile": "markdown",
    "menuLevel": 2,
    "content": "./doc/page/manage/build.md"
  },
    {
      "name": "plugin",
      "title": "插件Wiki",
      "banner": {
          "title": "插件",
          "description": "可根据业务需求，定制化功能"
      },
      "content": {
          "sidebar": true,
          "multi": true,
          "index": "./doc/page/plugin/index.md",
          "pages": [{
              "name": "插件管理",
              "index": "plugin-index",
              "content": "./doc/page/plugin/index.md"
          },{
            "name": "插件开发",
            "index": "plugin-dev",
            "content": "./doc/page/plugin/dev.md"
        },{
            "name": "钩子列表",
            "index": "plugin-hooks",
            "content": "./doc/page/plugin/hooks.md"
        },{
            "name": "插件列表",
            "index": "plugin-list",
            "content": "./doc/page/plugin/list.md"
        }
        ]
      }
  },
  {
    "name": "qa",
    "title": "常见问题",
    "compile": "markdown",
    "menuLevel": 2,
    "content": "./doc/page/usage/qa.md"
  },
  {
    "name": "releases",
    "title": "版本记录",
    "banner": {
        "title": "YApi",
        "description": "这里列举了 YApi 的历史版本、发布时间及变更记录，帮助你追溯到每个版本的演进过程。"
    },
    "compile": "markdown",
    "menuLevel": 2,
    "content": "./CHANGELOG.md"
  },{
    "name": "demo站点",
    "title": "demo站点",
    "url": "http://yapi.demo.qunar.com/"
  },
    {
        "name": "api",
        "title": "",
        "banner": {
            "title": "api",
            "description": "api文档"
        },
        "content": "./server/controllers/+(follow|base|group|interface|interfaceCol|log|project|user).js",
        "options": {
            "type": "interface",
            "source": true,
            "categories":["group","user","project", "interface","follow"]
        }
    }],
    "resources": {
        "images": "./doc/images",
        "styles": "./doc/styles"
    }
}