×

2.第一周的折腾:Github与Gitbook的使用与绑定

96
韶山南风
2015.10.17 00:31* 字数 726

GitHub个人仓的建立

首先,需要一个GitHub的账号,并点击绿色的“New repository”按钮。在建立个人仓库的时候,一定要点击Initialize this repository with a README 否则在后续与GitBook的互相绑定中就会出现提示这个个人仓库为empty的情况。

GitBook的设置

GitBook也要注册一个账户,账户注册好后建立一本新的书籍“creat a new book”。在设置好书籍的相关信息后保存,在my book中点击这本书的title(不是编辑页面!),打开setting界面,在右下方的选项里选择github,将新建的github repository地址复制到里面,点击添加webook后保存即可。

由于GitBook原生并没有评论功能,这需要我们自己自行添加disqus模块。关于这个模块,网上的教程很丰富 可以参考:Hard way to Python 要注意的是代码的标点均为英文符号。

自己在这个地方花了大量时间,主要问题出在对这个评论模块的不理解上。disqus是一个第三方的评论模块,要想在gitbook中使用,那么他必然要在gitbook中设置许可,更要在disqus中添加信任的网站信息。自己就是疏忽了disqus本身网站的设置中疏忽了,导致浪费了许多时间。

在这里,一定要提醒下,github。gitbook的web段设置一定要用chrome浏览器!!!! 一定要用chrome浏览器!!!! 一定要用chrome浏览器!!!! 我一开始使用的360浏览器在gitbook的载入页面里卡了好久好久。。。。。

我后来在disqus设置中,当设置好了shortname后却一直没找到setting的位置,导致一直在这个坑里爬不出来。后来发现一个小方法,在个人主页的地址的末尾加一个/setting 则顺利跳转页面,问题得以解决。

最后,由于在gitbook本地端的安装上花了许多无用的时间,导致效率偏低。不过也发现了一个解决问题的小方法:在微博上搜索。 我们遇到的问题肯定不是孤例,世界这么大,肯定有不少人也遇到过。当这个问题解决时,大多数人都会很开心,继而发条微博以表庆贺。利用微博搜索找到最近遇到这个问题的哥们,用诚恳的语气和他交流,他人不经意的一句话,往往就成了解决问题的关键。

最后,Python当歌,人生几何!

Python技术
Web note ad 1