gitbook 入門

安裝 gitbook 插件

npm install gitbook-cli -g  或者  yarn global add gitbook-cli

初使化目錄

gitbook init

會發現目錄下面多了2個文件，README.md和SUMMARY.md

README.md 和 SUMMARY.md 是兩個必須文件

README.md 是對書籍的簡單介紹

SUMMARY.md 是書籍的目錄結構

生成

gitbook build   //生成在當前目錄的默認文件夾 _book里面

gitbook build  ./out      //生成在當前目錄的默認文件夾 指定的out 里面


gitbook build  ./md  ./out   //當前md外  生成out  

本地預覽

gitbook serve

http://localhost:4000

配置文件（不是必需的）

{
	"title": "前端規范",
	"description": "前端規范 簡介",
	"language": "zh-hans",
	"plugins": [

	],
	"pluginsConfig": {

	},
	"links": {
		"gitbook": false,
		"sharing": {
			"google": false,
			"facebook": false,
			"twitter": false,
			"all": false
		}
	}
}

設置語言、去掉分享功能

重要說明：gitbook 如果要安裝插件 要安插件的路徑為 win C:\Users\admin.gitbook\versions\3.2.2 其他系統不知道
eg:

本人的配置文件

{
	"title": "前端規范",
	"description": "前端規范 簡介",
	"language": "zh-hans",
	"plugins": [
		"-lunr", 
		"-search", 
		"search-plus",       //支持中文搜索  上面 search 是默認的   “-”  是去掉的意思
		"splitter",               // 這個側邊可以拉伸
		"tbfed-pagefooter",    //這個是底部加 信息  下面可以看到具體的配置
		"expandable-chapters-small"     //使左側的章節目錄可以折疊
	],
	"pluginsConfig": {
        "theme-default": {
	        "showLevel": true
	    },
	    "tbfed-pagefooter": {
	        "copyright":"Copyright &copy xxxxx",
	        "modify_label": "該文件修訂時間：",
	        "modify_format": "YYYY-MM-DD HH:mm:ss"
	    }
	},
	"links": {
		"gitbook": false,
		"sharing": {
			"google": false,
			"facebook": false,
			"twitter": false,
			"all": false
		}
	}
}

可以參考：http://gitbook.zhangjikai.com/plugins.html