1

我正在尝试创建一个自定义 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 更改。

4

2 回答 2

4

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

  1. 将 "theme": "./customtheme" 添加到您的 book.json 文件中。
  2. 使用 Gitbook 存储库中的文件在根目录中创建您的 customtheme 文件
  3. 从那里编辑

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

于 2015-06-05T02:13:10.483 回答
2

模板“布局”和“标题”不存在。您只能更改:

  • site : 网站模板
  • 词汇表:词汇表的模板
  • langs : 语言选择模板
  • page : 电子书的模板

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

于 2014-09-26T07:48:32.650 回答