gitbook初体验

前言

在早些天看sec-wiki的时候，看到有同学做了一个ctf-wiki来介绍CTF，让CTF新手能够快速入门，做成了电子书的样子，放在github上面。页面精美、简洁，让人爱不惜手。

想着自己也能够做一下总结之类的，弄成一本小册子也是不错的，然后从中了解到了gitbook。之前玩过githubpage，自然也是明白gitbook的原理，markdown与静态页面的完美结合，不得不说markdown的出现确实大大提升了作者的写文效率，让人不用再关心样式的问题，专注于写作上面。

那么下面就记录一下自己对gitbook的一些使用与感触，与及从中遇到的坑。

安装并使用gitbook

gitbook的使用其实很简单，因为有很多大佬前辈都已经写过了相关的教程，我在参考了GitBook 简明教程和官方文档，也算是对于gitbook有了大致的了解。

因为《GitBook简明教程》这篇教程似乎有了一定的年份，与现在的状况有一些出入。这里就说说变化了的地方，请注意本文的发表日期与当前的时间，有可能某些状况也已经发生了变化。

1, 私有书籍的变化。现在免费账户已经不能享受拥有一本私有电子书的优惠了

2, 插件的安装不需要全局安装，而是由gitbook统一管理

貌似是在早些时候的版本中，在本地预览gitbook的时候，需要用到哪个插件就要npm install 一下，现在不需要了，只需要在book.json中配置plugins里面填写好你需要的插件名称即可。在执行gitbook serve命令时，gitbook会自动检查当前环境是否包含有插件列表的插件，没有就会安装，方便了许多。至于插件在那里可以找到呢？gitbook有一个插件官网,你可以在上面搜索你想要的插件。

又或者到这里看看Gitbook 使用教程,扩展方面写的很好

3, 国内下载gitbook editor极慢，怎么解？

这无解啊！麻蛋，就六十多兆的东西，下了大半天都下载不下来，最后还是让我同学用某灯专业版下载下来的。我买了影梭的vpn根本没卵用，这里吐槽一下影梭的vpn是真的水，真的。如果要使用gitbook editor，那么请一定要最新的版本，低版本的gitbook editor会出现book.json load error的情况。这里提供windows最新版本7.0.12，有需要的同学可以下载

4, 关于book.json的一些问题

windows使用gitbook editor时，因为gitbook editor在本地并没有book.json文件，如果需要配置插件，需要手动创建book.json，并git上去。book.json的撰写应该是这样子的。

{

   {

"author": "水泡泡",

"description": "水泡泡的testbook",

"extension": null,

"generator": "site",

"language": "zh-hans",

"isbn": "",

"links": {

"sharing": {

"all": null,

"facebook": null,

"google": null,

"twitter": null,

"weibo": null

},

"sidebar": {

"水泡泡的博客": "http://www.cnblogs.com/r00tuser/"

}

},

"output": null,

"pdf": {

"fontSize": 12,

"footerTemplate": null,

"headerTemplate": null,

"margin": {

"bottom": 36,

"left": 62,

"right": 62,

"top": 36

},

"pageNumbers": false,

"paperSize": "a4"

},

"plugins": [

"-lunr",

"-search",

"-highlight",

"prism",

"search-plus",

"theme-comscore",

"toggle-chapters",

"codeblock-filename",

"splitter",

"tbfed-pagefooter",

"anchor-navigation-ex",

"expandable-chapters-small",

"sectionx",

"disqus"

],

"pluginsConfig": {

"prism": {

"css": [

"prism-themes/themes/prism-base16-ateliersulphurpool.light.css"

]

},

"tbfed-pagefooter": {

"copyright":"Copyright &copy r00tuser 2017",

"modify_label": "该文件修订时间：",

"modify_format": "YYYY-MM-DD HH:mm:ss"

},

"anchor-navigation-ex": {

"isRewritePageTitle": true,

"isShowTocTitleIcon": true,

"tocLevel1Icon": "fa fa-hand-o-right",

"tocLevel2Icon": "fa fa-hand-o-right",

"tocLevel3Icon": "fa fa-hand-o-right"

},

"sectionx": {

"tag": "b"

},

"disqus": {

"shortName": "yourshorName"

}

},

"title": "test book",

"variables": {},

"theme-default": {

"showLevel": true

}

}

}

因为language默认是en，如果需要用到中文的话，要这样设置"language": "zh-hans"。

关于book.json的介绍与及插件可以查看这篇文章Gitbook 实用配置及插件介绍

后话

果然，逼自己去写文章总结，就会遇到很多问题。又学到了不少东西。

参考资料

1,Gitbook editor

2,Gitbook 实用配置及插件介绍

3,Gitbook 使用教程

4,GitBook 简明教程

5,GitBook官方文档