无法在 gitbook 主题中添加自定义模板文件答案

【问题标题】：not able to add custom template files in gitbook themes无法在 gitbook 主题中添加自定义模板文件
【发布时间】：2014-11-18 03:06:08
【问题描述】：

我正在尝试创建一个自定义 gitbook 主题，并且我还想更改布局，以便我使用该主题创建的书具有我想要的布局。我在自定义主题的assets 目录中复制了默认模板目录，然后根据需要修改了 layout.html 和 header.html 文件。然后为了包含修改后的模板文件，我在 index.js 文件中添加了以下属性

module.exports = {
    book: {
        assets: "./assests",
        templates: {
            "layout":"templates/layout.html",
            "header":"templates/includes/book/header.html",
        },
......
......

但是，使用此配置，生成的书不会选择模板文件更改。但是我确实看到了我所做的 css/js 更改。

【问题讨论】：

标签： templates themes gitbook

【解决方案1】：

作为记录，如果您采用以下“不建议”（强调这种不建议的性质）路线，则确实存在布局和标题模板文件：

将 "theme": "./customtheme" 添加到您的 book.json 文件中。
使用来自Gitbook repo 的文件在根目录中创建您的customtheme 文件夹
从那里编辑

到目前为止，这是我发现编辑您的网站图标、侧边栏、标题和布局文件的唯一方法。不建议这样做，因为您不再使用 repo 中的文件，因此更新可能会破坏它，但是有些事情要么不容易，要么不可能在不做像这样的混乱和 hacky 的情况下进行更改。希望将来可以使更新网站图标、标题或侧边栏等简单的事情变得更容易。我只是在很多很多谷歌搜索和插件比较之后才找到这个解决方案，所以也许有人有更好的解决方案，我还没有找到。

【讨论】：

【解决方案2】：

模板“布局”和“标题”不存在。你只能改变：

网站：网站模板
词汇表：词汇表模板
langs：语言选择模板
页面：电子书模板

确实不建议更改模板，您应该使用插件来仅扩展 html、css、js 使用：https://github.com/GitbookIO/plugin/blob/master/index.js#L2

【讨论】：

感谢@samy-pesse 的回复。这可能有点矫枉过正，但我的计划是将多个 gitbook 输出组合为离线 Firefox OS 应用程序的子部分。 this link 中的每个链接都将是使用 gitbook 生成的一本书的输出。因此，我希望这些书也看起来与主页的外观非常相似。由于我们所拥有的只是一个模板，因此应该有其他方法可以使用我想要使用的其他模板，而不是默认模板。