手把手教你學 GitHub
專案簡介
專案說明:緣起於 vivian(@slack) 2015/3/13 提到的 改善 g0v 入坑容易度 與 UX 相關資訊翻譯,因此想設計透過操作Pull Request參與協作翻譯的過程,幫助非資訊人了解 GitHub 。
發起人/拋磚人: noracami
目標與功能(什麼問題,要如何解決)
預定功能
學會 GitHub 的概念與基本操作。
翻譯文章,訓練外語和專業能力。
預定使用者
還沒嘗試使用過 GitHub 的人。
要解決的問題
現有類似專案
(現成的是否可以直接使用?或者有什麼不足之處?國外專案可參考?)
斧頭幫大挑戰 :測驗如何爬資料
Google Material Design 正體中文版 :多人協作翻譯 Google Material Design
相關專案
(衍生自某專案/衍生出某專案/API串接自某專案.)
授權方式
(程式碼部分如 MIT/BSD /文件部分,如 CC-BY)
使用資料
目前想先使用
- An introduction to user research techniques - GOV.UK Licence
- How to choose the right UX metrics for your product Licence
- ...
- 等有授權可供改作分享之文章來作為翻譯目標
專案目前狀態
(構想 / 規劃 / 雛形 / 實作)
想像中的流程:
- 專案介紹首頁
- 作者/參與者們 頁面
- 文章
- 其他
- 在參與者頁面處簽名
- go to project website
- fork
- clone (from your project)
- edit /source/contributors/index.md
- commit
- push
- back to your project website
- create pull request
- owner/administrator merge request
- auto publish by Travis CI
- see what you done
- 編輯、翻譯文章
- edit /source/_posts/{article}/index.md
- commit、push、pull request
- merge、publish
- see what you done
或是單純使用 Issue 進行協作
ex:
- 翻譯的書拆成一個小節一個 issue,譯文貼上,討論或 review 後再由其他人 commit。
- 收集其他你想翻譯的文章吧
- 用詞風格不一?開個 issue 討論吧

- go to project website

- New issue
- discuss
- work, work, work

開始吧
註冊 GitHub 帳號
如果你還沒有 GitHub 帳號,現在就去註冊一個吧。
安裝 Git/GitHub for Mac/GitHub for Windows
Fork 專案
An-introduction-to-user-research-techniques-translate

Clone

命令列指令(CLI):
- $ git clone <clone URL>
Clone in Desktop:
點下去就好了
修改
- .
- ├── _config.yml
- ├── package.json
- ├── scaffolds
- ├── scripts
- ├── source
- | ├── _drafts
- | ├── _posts
- | └── contributors
- | └── index.md :emoji_1f448:
- └── themes
Commit & Push
現在要將你所做的修改存檔(commit),然後推送(push)到 GitHub 上
命令列指令(CLI):
- $ git add .
- $ git commit -m "messages"
- $ git push
視窗模式:
Pull Request
Merged
看看你的成果吧
To be continued..