使用GitBook快速搭建自己的博客平台

简单demo

1. 需要nodejs环境，自行到nodejs官网下载安装，安装成功后如下

   $ node -v
   v12.16.1
   

   $ npm -v
   6.13.4
   

2. 安装gitbook-cli

   npm install -g gitbook-cli
   

3. 进入建立gitbook的文件夹，执行下面的命令

   gitbook init
   

4. 将会生成两个文件

   • README.md —— 书籍的介绍写在这个文件里
   • SUMMARY.md —— 书籍的目录结构在这里配置

5. 加入自己书写的内容，目录结构如下，自己可以根据需要修改

   │  README.md
   │  SUMMARY.md
   ├─第一章
   │      content.md
   │      README.md
   │      
   ├─第三章
   │      content.md
   │      README.md
   │      
   └─第二章
           content.md
           README.md
   

6. 配置SUMMARY.md

   # Your Book Title
   
   - [第一章](第一章/README.md)
       * [Content](第一章/content.md)
   - [第三章](第三章/README.md)
       * [Content](第三章/content.md)
   - [第二章](第二章/README.md)
       * [Content](第二章/content.md)
   

7. 如果不想手动写SUMMARY.md，也可以使用命令自动生成（也可以使用book.json文件指定插件）

   npm install -g gitbook-summary
   book sm
   

8. 写好book内容，配置好SUMMARY.md之后就可以在本地预览gitbook了

   gitbook serve
   

   

进阶

1. 根据自己的需要添加插件进行配置，在主目录下添加book.json文件进行配置，详细的博客：https://www.cnblogs.com/mingyue5826/p/10307051.html

   {
       "title": "demo",//标题
       "description": "demo",//文档描述
       "language": "zh",//选择编辑的语言环境
       "plugins": [ //引入需要的插件，前面有-号的为uninstall相应的插件
           "disqus",
           "github",
           "editlink",
           "prism",
           "-highlight",
           "baidu",
           "splitter",
           "sitemap",
           "tbfed-pagefooter",
           "fontsettings",
           "simple-page-toc",
           "links"
       ],
       "styles": {
           "website": "styles/website.css" //引入css文件进行css样式的修改
       },
       "pluginsConfig": {
           "tbfed-pagefooter": {
                   "copyright": "",
                   "modify_label": "该文件修订时间：",
                   "modify_format": "YYYY-MM-DD HH:mm:ss"
               },//显示文件的修改事件，包括一些版权声明
               "fontsettings": {
                   "theme": "white",
                   "family": "serif",
                   "size": 12
               },//显示样式以及文字大小的主题
               "simple-page-toc": {
                   "maxDepth": 3,
                   "skipFirstH1": true
               },//<!-- toc -->中放置代码注释。生成GitBook以后，此评论会立即插入content
           //使用深度最多为maxdepth的标题。排除文件中的第一个h1级标题。
               "links": {
                   "gitbook": false,
                   "sharing": {
                       "google": false,
                       "facebook": false,
                       "twitter": false,
                       "all": false
               },//默认的一些分享的展示与隐藏，true为展示，false为隐藏
           "disqus": {
           "shortName": "webpack-handbook"//生成评论的插件
           },
           "github": {
           "url": "https://github.com/webChatContact/baas-v2-help"
           },
           "editlink": {
           "base": "https://github.com/webChatContact",
           "label": "编辑本页面"//内容顶部显示 编辑本页 链接。
           },
           "baidu": {
               "token": "a9787f0ab45d5e237bab522431d0a7ec"//使用百度统计。
           },
           "sitemap": {
               "hostname": "http://baidu.com/"//生成站点地图
           }
       }
   }
   
   

gitbook和github同步

1. 在你的github上创建仓库
2. 将你的gitbook推送到github远端
3. 登录gitbook，进入dashboard，创建对应的space
   
4. 创建好后和指定的github仓库分支link，后面只要github代码更新，都会实时更新到gitbook
5. 现在就可以通过浏览器访问到了，例如我的blog