个性化配置

除了修改书籍的主题外，还可以通过配置book.json文件来修改 gitbook 在编译书籍时的行为，例如：修改书籍的名称，显示效果等等。

一：在线配置

在线编辑可以打开settings可以配置Title，description，topic等信息。勾选E-book选项可以在线导出pdf，mobi，epub。

二：book.json配置

gitbook 在编译书籍的时候会读取书籍源码顶层目录中的book.js或者book.json，这里以book.json为例，参考gitbook 文档可以知道。

三：插件

gitbook的默认插件：

* highlight

* search

* sharing

* font-settings

* livereload

配置插件：

在技术文档的编辑中用到gitbook-plugin-image-captions插件，抓取内容中图片的alt或title属性，在图片下面显示标题。

添加

"plugins": [
    "image-captions"
]

配置

"image-captions": {
          "caption": "Figure _PAGE_LEVEL_ - _PAGE_IMAGE_NUMBER_  _CAPTION_"
      }

  • \_CAPTION\_：img的title或者alt值

  • \_PAGE\_LEVEL\_：章节

  • \_PAGE\_IMAGE\_NUMBER\_：图片在章节的序列

  • \_BOOK\_IMAGE\_NUMBER\_：图片在书籍中的序列

results matching ""

    No results matching ""