gitbook中book.json文件详解

本文档详细介绍了如何配置GitBook的各种插件,包括评论、分享按钮、编辑链接等功能,并展示了如何通过配置文件来定制GitBook的外观和行为。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

JSON文件

{
  "title": "demo",//标题
  "description": "demo",//文档描述
  "language": "zh",//选择编辑的语言环境
  "plugins": [ //引入需要的插件,前面有-号的为uninstall相应的插件
    "disqus",
    "github",
    "editlink",
    "prism",
    "-highlight",
    "baidu",
    "splitter",
    "sitemap",
    "tbfed-pagefooter",
    "fontsettings",
    "simple-page-toc",
    "links"
  ],
  "styles": {
    "website": "styles/website.css" //引入css文件进行css样式的修改
  },
  "pluginsConfig": {
       "tbfed-pagefooter": {
            "copyright": "",
            "modify_label": "该文件修订时间:",
            "modify_format": "YYYY-MM-DD HH:mm:ss"
        },//显示文件的修改事件,包括一些版权声明
        "fontsettings": {
            "theme": "white",
            "family": "serif",
            "size": 12
        },//显示样式以及文字大小的主题
        "simple-page-toc": {
            "maxDepth": 3,
            "skipFirstH1": true
        },//<!-- toc -->中放置代码注释。生成GitBook以后,此评论会立即插入content
       //使用深度最多为maxdepth的标题。排除文件中的第一个h1级标题。
        "links": {
            "gitbook": false,
            "sharing": {
                "google": false,
                "facebook": false,
                "twitter": false,
                "all": false
        },//默认的一些分享的展示与隐藏,true为展示,false为隐藏
    "disqus": {
      "shortName": "webpack-handbook"//生成评论的插件
    },
    "github": {
      "url": "https://github.com/webChatContact/baas-v2-help"
    },
    "editlink": {
      "base": "https://github.com/webChatContact",
      "label": "编辑本页面"//内容顶部显示 编辑本页 链接。
    },
    "baidu": {
        "token": "a9787f0ab45d5e237bab522431d0a7ec"//使用百度统计。
    },
    "sitemap": {
        "hostname": "http://baidu.com/"//生成站点地图
    }
  }
}
### 如何在 GitBook 的 `book.json` 文件中正确配置和使用下载插件 为了实现 GitBook 中的下载功能,通常会借助第三方插件来完成。以下是关于如何在 `book.json` 文件中配置并启用下载插件的具体方法。 #### 插件的选择 目前常用的 GitBook 下载插件有 `gitbook-plugin-download-pdf` 和 `gitbook-plugin-export-pdf` 等[^1]。这些插件能够帮助用户生成 PDF 或 ePub 格式的电子书供读者下载。 #### 配置步骤 在 `book.json` 文件中添加所需的插件及其参数: ```json { "plugins": ["download-pdf"], // 添加 download-pdf 插件 "pluginsConfig": { "download-pdf": { "includes": [ "README.md", "**/*.md" ], "excludes": [], "outputName": "my-book.pdf", // 设置输出文件名 "format": "A4" // 设置页面格式 } } } ``` 上述代码片段展示了如何通过 `book.json` 文件中的 `plugins` 字段引入 `download-pdf` 插件,并通过 `pluginsConfig` 对其行为进行进一步定制[^4]。 #### 构建与发布 当配置完成后,运行以下命令以构建项目并生成可供下载的内容: ```bash gitbook install gitbook build ``` 这一步骤将确保所选插件被正确加载到环境中,并按照指定规则生成最终产物[^3]。 如果希望在线提供该资源,则需额外考虑部署方式,比如上传至 GitHub Pages 并配合 Travis CI 自动化流程处理更新过程[^5]。 #### 注意事项 需要注意的是,在实际操作过程中可能会遇到一些挑战,例如网络上的某些教程可能已经过时或者不完全适用当前版本的情况[^2];另外也要确认本地开发环境已满足必要条件(如 Node.js 版本),以及是否成功安装了对应依赖项。 ---
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值