[0wd5]dpush - Githubissues

~ 是什么以及为什么

现象

gitbook 双推技巧
解决

~ 本质上由于 gitbook NoZuoNoDie 的行径,导致以往的自然流程失效:

注册 github , 开辟仓库
注册 gitbook , 创建图书, 绑定 github 仓库
从 github clone 图书仓库
在本地编辑图书
push github
- github 自动通知 gitbook
- gitbook 自动去 github 同步文本
- gitbook 自动编译发布图书
  宏观上

已知:

gitbook 的图书仓库和 github 源内容仓库无法自动同步
gitbook 有可接触的 git 仓库
gitbook 的图书仓库,没有 github 仓库那些丰富的管理/分享/传播功能

目标:

希望原先图书管理流程不变
github 仓库专注图书的管理/编辑/协同...
gitbook 专注图书的编译/发布

所以:

人工解决 github 和 gitbook 仓库不同步问题
同时/接连将图书内容 push 到两个仓库就好!
技术上

github

使用 ssh 认证, 不用口令
通过 git/ssh 协议高速交互

gitbook

只能使用 https 协调交互
只能使用明文帐号+口令认证
如果,图书发布 URI 是:
- https://www.gitbook.com/book/[帐号]/[图书名]/details
- 则对应的仓库应该是:
- https://git.gitbook.com/[帐号]/[图书名].git

技巧:

和 svn/hg 等等版本管理仓库类似
git 仓库也支持在配置中明文保存口令,以免反复输入
形如:
- url = https://用户名:口令@git.gitbook.com/帐号/[图书名].git
  操作上
已经创建好 github 图书仓库, gitbook 图书实例
并将 github 仓库 clone 到本地: /path/2/[图书名]
则应该可以看到 /path/2/[图书名]/.git/config 有以下配置声明

[remote "origin"]
    url = git@github.com:OpenMindClub/[图书名].git
    fetch = +refs/heads/*:refs/remotes/origin/*

那么就可以手工增订为:

[remote "book"]
    url = https://git.gitbook.com/[帐号]/[图书名].git
    fetch = +refs/heads/*:refs/remotes/origin/*
[remote "hub"]
    url = git@github.com:OpenMindClub/[图书名].git
    fetch = +refs/heads/*:refs/remotes/origin/*
[remote "origin"]
    url = git@github.com:OpenMindClub/[图书名].git
    fetch = +refs/heads/*:refs/remotes/origin/*

$ git remote -v
book    https://git.gitbook.com/[帐号]/[图书名].git (push)
book    https://git.gitbook.com/[帐号]/[图书名].git (fetch)
hub git@github.com:OpenMindClub/[图书名].git (push)
hub git@github.com:OpenMindClub/[图书名].git (fetch)
origin  git@github.com:OpenMindClub/[图书名].git (push)

配置明文口令,以便不用输入

[remote "book"]
    url = https://[用户名]:[口令]@git.gitbook.com/[帐号]/[图书名].git
    fetch = +refs/heads/*:refs/remotes/origin/*

注意: 隐藏约定 ~ 口令中不能包含 @ ,否则,你懂的...
手工双推

那么,俺就可以用两次 git 操作,完成两个仓库的内容发送了:

$ git pu hub
Counting objects: 18, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (15/15), done.
Writing objects: 100% (16/16), 3.29 KiB | 0 bytes/s, done.
Total 16 (delta 3), reused 0 (delta 0)
To git@github.com:OpenMindClub/[图书名].git
   8c3c8b6..f27428a  master -> master

$ git pu book
Counting objects: 20, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (15/15), done.
Writing objects: 100% (16/16), 3.29 KiB | 0 bytes/s, done.
Total 16 (delta 3), reused 0 (delta 0)
To https://[用户名]:[口令]@git.gitbook.com/[帐号]/[图书名].git
   8c3c8b6..f27428a  master -> master

自动双推

经过文档研究,发现,其实, git 可以任性的识别仓库配置中,多个 uri 的,那么增强配置为

...
[remote "origin"]
    url = https://[用户名]:[口令]@git.gitbook.com/[帐号]/[图书名].git
    url = git@github.com:OpenMindClub/[图书名].git
    fetch = +refs/heads/*:refs/remotes/origin/*

再进行默认推送, 就发现,自动完成了两个仓库的分别 push:

$ git pu
Counting objects: 8, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (4/4), 2.00 KiB | 0 bytes/s, done.
Total 4 (delta 2), reused 0 (delta 0)
To https://[用户名]:[口令]@git.gitbook.com/[帐号]/[图书名].git
   f27428a..0d06615  master -> master
Counting objects: 7, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (4/4), 2.00 KiB | 0 bytes/s, done.
Total 4 (delta 2), reused 0 (delta 0)
To git@github.com:OpenMindClub/[图书名].git
   f27428a..0d06615  master -> master

(￣▽￣)

150927nn2322 相对一期,二期同学就没有这么简单的了
- 是也乎,(￣▽￣)

综上可得:

git 太任性,怎么来都可以
多人协同更加任性, 得要约定好统一的原则
- 在当前情景中
- 就需要所有参与编辑同一图书的小伙伴,在本地配置中完全一致
- 以免引发冲突
当然,也可以不那么任性:
- 使用 github 推荐的 P-R 协同方式
- github+gitbook 双仓库操作,只交给一位主持人进行
- 其它小伙伴,都通过 fork 图书的 github 仓库到私人空间,进行增补
- 感觉可以合并时
- 向主持人提交一个 pull-request
- 由主持人判定,合并提交
- 再双推到 gitbook 平台
- 可是,问题来了,,,, pull-request 的礼节,不是那么简单的
- 参考: Github 發 Pull Request & 貢獻流程速查
- 即,任何时候使用 -f 都是一种野蛮行为,必须遭到所有人的 BS !

ZoomQuiet / OMOOC2py

[0wd5]dpush #1

现象

解决

宏观上

技术上

操作上

手工双推

自动双推

(￣▽￣)