Draft for my own tutorials

Quick notes before the tutorials are finalized.

GitBook "Double Push" issue

Background

在GitHube repository https://github.com/janice-lu-zeng/OMOOC2py（下面简称为GitHub repo OMOOC2py）已存在的前提下，注册了GitBook，新建book https://janice-lu-zeng.gitbooks.io/omooc2py-the-book/ （下面简称omooc2py the book），并设定为由GitHub repo OMOOC2py直接导入，omooc2py the book新建成功。

后来为了调试Disqus插件编辑book.json文件，编辑了GitHub repo OMOOC2py中的book.json文件并使用$ git push origin master，结果是GitHub repo OMOOC2py与omooc2py the book中的book.json文件都更新了，且Disqus插件也可以正常使用了（并没有马上==），所以当时得出的结论是omooc2py the book 与 GitHub repo OMOOC2py联动成功。

直到10月18日想要在ommoc2py the book中添加新的章节，在Github repo OMOOC2py的本地clone中新建了相关md文件并更新了SUMMARY.md文件，并git pus origin master，在gitbook.com上新建的md文件无法正常显示（目录根据SUMARRY.md的更新有所更新，但是新建的章节标题在目录中显示为灰色，点击无法显示内容。）在omooc2py the book对应的git https://git.gitbook.com/janice-lu-zeng/omooc2py-the-book.git的本地clone中直接做相同的编辑动作并git push origin master, 编辑在gitbook.com上生效。由此判断omooc2py the book未与GitHub repo OMOOC2py完全联动。

所以还是需要弄清楚“Double Push”这件事。

How I did it

完全按照这张芝麻星卡片背面的步骤来操作的。

  • 现有：GitHub repo OMOOC2py https://github.com/janice-lu-zeng/OMOOC2py.git,omooc2py the book https://git.gitbook.com/janice-lu-zeng/omooc2py-the-book.git
  • 并已将GitHub repo OMOOC2py clone 至本地，路径为/Users/apple/Documents/gitHub/OMOOC2py

  • 在terminal中输入

    ~ apple$ cd /Users/apple/Documents/gitHub/OMOOC2py 
OMOOC2py apple$ git remote -v

    terminal中返回

    origin    https://github.com/janice-lu-zeng/OMOOC2py.git (fetch)
origin    https://github.com/janice-lu-zeng/OMOOC2py.git (push)

    查看/Users/apple/Documents/gitHub/OMOOC2py/.git/config，在terminal中输入

    OMOOC2py apple$ cat .git/config

    terminal中返回

    [core]
  repositoryformatversion = 0
  filemode = true
  bare = false
  logallrefupdates = true
  ignorecase = true
  precomposeunicode = false
[remote "origin"]
  url = https://github.com/janice-lu-zeng/OMOOC2py.git
  fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
  remote = origin
  merge = refs/heads/master

    使用nano编辑此.git/config文件，在terminal中输入OMOOC2py apple$ nano .git/config,并将文件更新如下：

    [core]
  repositoryformatversion = 0
  filemode = true
  bare = false
  logallrefupdates = true
  ignorecase = true
  precomposeunicode = false
[remote "origin"]
  url = https://github.com/janice-lu-zeng/OMOOC2py.git
  fetch = +refs/heads/*:refs/remotes/origin/*
[remote "book"]
  url = https://git.gitbook.com/janice-lu-zeng/omooc2py-the-book.git
  fetch = +refs/head/*:refs/remotes/origin/*
[remote "hub"]
  url = https://github.com/janice-lu-zeng/OMOOC2py.git
  fetch = +refs/head/*:refs/remotes/origin/*
[branch "master"]
  remote = origin
  merge = refs/heads/master

    其中[remote "book"]与[remote "hub"]为新增。此时再在terminal中输入OMOOC2py apple$ git remote -v，得到

    book    https://git.gitbook.com/janice-lu-zeng/omooc2py-the-book.git (fetch)
book    https://git.gitbook.com/janice-lu-zeng/omooc2py-the-book.git (push)
hub    https://github.com/janice-lu-zeng/OMOOC2py.git (fetch)
hub    https://github.com/janice-lu-zeng/OMOOC2py.git (push)
origin    https://github.com/janice-lu-zeng/OMOOC2py.git (fetch)
origin    https://github.com/janice-lu-zeng/OMOOC2py.git (push)

    至此就可实现将GitHub repo OMOOC2py本地clone中的变动分别push至GitHub repo OMOOC2py 和omooc2py the book了。

    在本地clone/Users/apple/Documents/gitHub/OMOOC2py中进行各种修改后，在terminal中依次输入

    OMOOC2py apple$ git add *
OMOOC2py apple$ git commit -m "notes on changes just made"
OMOOC2py apple$ git push hub
OMOOC2py apple$ git push book

    最后两步需输入github.com与git.gitbook.com的用户名与密码。

    Voila~