gitbook 入门教程之自定义不同的多语言首页插件

自定义多语言主页

中文 | English

🏠 主页

• Github : snowdreams1006.github.io/gitbook-plu…
• GitLab : snowdreams1006.gitlab.io/gitbook-plu…
• Gitee : snowdreams1006.gitee.io/gitbook-plu…

屏幕截图

用法

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

1. 在您的gitbook的 book.json 文件中，将 multilingual-index 添加到 plugins 列表中。
2. 在 pluginsConfig ，将 enableSuper 设置为 false 可禁用默认主页，并添加 index值以自定义多语言主页。仅支持相对路径。

这是最简单的示例：

{
    "plugins": ["multilingual-index"],
    "pluginsConfig": {
        "multilingual-index": {
            "enableSuper": false,
            "index":"index.html"
        }
    }
}
复制代码

有关更多详细信息，请参考如下配置项：

"enableSuper": {
  "type": "boolean",
  "title": "inherit from super",
  "required": false,
  "default": true
},
"index": {
  "type": "string",
  "title": "default index path",
  "required": false
}
复制代码

步骤＃2 - gitbook命令

1. 运行 gitbook install 。它将自动为您的 Gitbook 安装 multilingual-index gitbook 插件。仅须要一次。

gitbook install
复制代码

或者您能够运行 npm install gitbook-plugin-multilingual-index 来本地安装。

npm install gitbook-plugin-multilingual-index
复制代码

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

gitbook serve
复制代码

示例

• 官方文档配置文件

github.com/snowdreams1…

{
    "plugins": ["multilingual-index"],
    "pluginsConfig": {
        "multilingual-index": {
            "enableSuper": false,
            "index":"index.html"
        }
    }
}
复制代码

• 官方示例配置文件

github.com/snowdreams1…

{
    "plugins": ["multilingual-index"],
    "pluginsConfig": {
        "multilingual-index": {
            "enableSuper": true,
            "index":"index.html"
        }
    }
}
复制代码

继承默认主页的示例 book.json 文件

{
   "plugins": ["multilingual-index"],
    "pluginsConfig": {
        "multilingual-index": {
            "enableSuper": true,
            "index":"index.html"
        }
    }
}
复制代码

不继承默认主页的示例 book.json 文件

{
    "plugins": ["multilingual-index"],
    "pluginsConfig": {
        "multilingual-index": {
            "enableSuper": false,
            "index":"index.html"
        }
    }
}
复制代码

做者

👤 snowdreams1006

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

贡献

欢迎提供文稿，问题和功能请求！

随时检查问题页面 。

表示支持

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

版权

版权全部©2019 snowdreams1006 。

该项目是MIT许可的。

若是你以为本文对你有所帮助,欢迎点赞留言告诉我,你的鼓励是我继续创做的动力,不妨顺便关注下我的公众号「雪之梦技术驿站」,按期更新优质文章哟!