gitbook 入门教程之网站域名备案 icp 插件

欢迎访问 gitbook-plugin-icp 官网 👋

用于在首页页脚区域添加 icp 网站备案信息的 Gitbook 插件

🏠 主页

• Github : https://snowdreams1006.github.io/gitbook-plugin-icp/
• GitLab: https://snowdreams1006.gitlab.io/gitbook-plugin-icp/
• Gitee : https://snowdreams1006.gitee.io/gitbook-plugin-icp/

屏幕截图

• 多语言版本

• 单语言版本

用法

步骤＃1-更新book.json文件

1. 在您的 gitbook 的 book.json 文件中，将 icp 添加到 plugins 列表中。
2. 在 pluginsConfig ,将 number 值设置为您本身的 icp 网站备案编号.
3. 在 pluginsConfig ,label 或 link 值是可选的,默认状况下,连接地址为 http://www.beian.miit.gov.cn/ .

这是最简单的示例：

{
    "plugins": ["icp"],
    "pluginsConfig": {
        "icp": {
            "number": "浙ICP备18042346号"
        }
    }
}

此外，受支持的配置选项以下：

"label": {
  "type": "string",
  "title": "icp label",
  "required": false
},
"number": {
  "type": "string",
  "title": "icp number",
  "required": true
},
"link": {
  "type": "string",
  "title": "link url",
  "required": false,
  "default": "http://www.beian.miit.gov.cn/"
}

步骤＃2-gitbook命令

1. 运行gitbook install .它将自动为您的 gitbook 安装 icp 插件.

该步骤仅须要容许一次便可.

gitbook install

或者您能够运行 npm install gitbook-plugin-icp 命令本地安装 gitbook-plugin-icp 插件.

npm install gitbook-plugin-icp

1. 像往常同样构建您的书（ gitbook build ）或服务（ gitbook serve ）.

gitbook serve

示例

• 官方文档配置文件

https://github.com/snowdreams1006/gitbook-plugin-icp/blob/master/docs/book.json

{
    "plugins": ["icp"],
    "pluginsConfig": {
        "icp": {
            "number": "浙ICP备18042346号"
        }
    }
}

• 官方示例配置文件

https://github.com/snowdreams1006/gitbook-plugin-icp/blob/master/example/book.json

{
    "plugins": ["icp"],
    "pluginsConfig": {
        "icp": {
            "number": "浙ICP备18042346号"
        }
    }
}

• 示例book.json文件

{
    "plugins": ["icp"],
    "pluginsConfig": {
        "icp": {
            "label": "YOUR OWN ICP LABEL",
            "number": "YOUR OWN ICP NUMBER",
            "link":"YOUR OWN ICP LINK"
        }
    }
}

或者，您能够添加 label 以自定义标签：

{
    "plugins": ["icp"],
    "pluginsConfig": {
        "icp": {
            "label": "YOUR OWN ICP LABEL",
            "number": "YOUR OWN ICP NUMBER",
            "link":"YOUR OWN ICP LINK"
        }
    }
}

或者您能够添加 link 以自定义连接：

{
    "plugins": ["icp"],
    "pluginsConfig": {
        "icp": {
            "label": "YOUR OWN ICP LABEL",
            "number": "YOUR OWN ICP NUMBER",
            "link":"YOUR OWN ICP LINK"
        }
    }
}

注意 ：若是您的书尚未建立,以上代码段能够用做完整的book.json文件.

做者

👤 snowdreams1006

• 网站 : snowdreams1006.tech
• GitHub : @snowdreams1006
• 电子邮件 : snowdreams1006@163.com

贡献

欢迎提供文稿，问题和功能请求！
随时检查问题页面 。

表示支持

若是这个项目对您有帮助，请给个星星 ！

版权

版权全部©2019 snowdreams1006 。

该项目是MIT许可的。

若是本文对你有所帮助,不用赞扬,也没必要转发,直接点赞留言告诉鼓励一下就能够啦!