环境搭建流水

Github与gitbook互推

正常步骤

  • 在gitbook页面下，点开右上的头像去账户设置
  • 下拉页面在GitHub那部分link你的GitHub，然后选第二个
  • 创建一本书
  • 点开你的书（不是编辑的界面）
  • 点击右边的setting后，点击最下面的GitHub
    • 两种与你GitHub互推的方法
    • 第一种
      • 如果建立了与这本书对应的repository, 在第一栏直接填写, 保存。
      • 比如我为了测试在GitHub上建了一个叫testing的库，就添awlter/testing,
      • 点击下面的Addwebhook，保存。
    • 第二种
      • 没有的话，也需要填写第一栏，如上二，这时候你的testing就是随便你取了，比如omooc2py。
      • 点击Export to Github
        • 第一栏check Url，此时你后面的omooc2py还是可以随便改的
        • 第二栏自动生成omooc2py
        • 选Public,因为Private要收钱
        • Import
        • 回去刚刚的页面Add webhook

可能出现的问题

  • Import不成功，可能是由于你没有link你的Github
  • 如果想把book与某个已存在的repository互推，请使用上面的第一种方法。

本地与Git的push/pull

  • 确保已经安装git

目的

  • 是为了在离线的时候也能在本地库中的文件中编辑，在有网络状态的时候push上去

步骤（之一）

push

新建一个文件夹

  • 建议是比较好调取的，防止在编辑器中输入很长的路径，比如，cd desktop/gitbook/testing

clone repository

  • 在编辑器中输入路径,比如cd desktop/gitbook/testing
  • 然后输入 $ git clone [repository的URL], 比如, git clone https://github.com/Awlter/testing
  • 当你的文件夹里出现已你的repository命名的文件夹,克隆成功.

push

  • 通过编辑器进入repo的文件夹，cd [repo's name]
  • 输入 $ git init
  • 输入 $ git add *
  • 输入 $ git commit -m "whatever"
  • 输入 $ git push

pull

cd到需要的更改的repo路径下 git pull

注意

  • 如果已经入坑，建议全部删掉这些branch然后重新开始步骤
  • 每次push和pull都要保证cd到相应路径下
  • 每次push的时候都要重复以下
  • 输入 git add *
  • 输入 git commit -m "whatever"
  • 输入 git push

安装评论Plugin

  • 注册disqus

  • 设置与gitbook和github的关联

  • 新建book.json文件

    • 在需要加评论栏的库中，创建一个文件，命名为book.json，比如我直接在github的testing库中点击➕，创建文件夹
  • 编辑book.json
    • 输入
{
"plugins": ["disqus"],
"pluginsConfig": {
    "disqus": {
        "shortName": "omooc2py"
    }
}  
}
  • Commit之后等待gitbook同步更新