# [Github](https://www.github.com)入門教學

## 想像一種情況

你有70個人，必須要協作一份重要的文件。

每個人都有不同的想法，但是都想要文件變好。

你要如何讓70個人良好討論呢？

當然，你可以把他們分成許多組。70個人就分成七組，每組10個人。

然後，每個小組再發下一些便利貼、布告版、或者是圖釘等等，讓大家集思廣益。

問題來了，最後要整合所有小組意見的時候，你就會發現，每一個小組可能都有優點和缺點，沒有辦法完全整合起來。

如果你的團隊是在使用Google doc為主，你會常常發現單一串流的版本控制是完全不夠用的。

如果只有兩三個人的話，也有可能夠用，把所有不同意見保留，整合至新版本。

Github 這個社群媒體，提供一種更強大的協作平台，由Git 版本控制系統當作它的基底。

## [Github](https://www.github.com)能解決什麼問題？

[Github](https://www.github.com) 這個社群媒體，提供的是一種更強大的協作平台，由Git版本控制系統當作它的基底。

## 如何上手[Github](https://www.github.com)？

### 先從簡單的地方著手

[Github](https://www.github.com)的學習路徑比較陡峭難爬， 因此，我們不要太著急，先想想看有沒有比他更簡單一點點的協作平台呢？

有的，那就是no-code 網站設計中，非常好用的[hackMD](https://hackmd.io)。

我們從比較簡單的[hackMD](https://hackmd.io)，走階梯走到[Github](https://www.github.com)，會比較容易

您可以先去[hackMD](https://hackmd.io)註冊一個帳號嗎？

註冊帳號的方式非常簡單，您可以只要用Google Login就好了。

註冊好了，[hackMD](https://hackmd.io)之後，請把帳號email給你想合作的對象，例如[Bestian](https://hack.bestian.tw)，謝謝。

### 接下來我們再去申請一個[Github](https://www.github.com)帳號

<img width="890" alt="GitHub__Let’s_build_from_here_·_GitHub" src="https://github.com/3dw/github-tutorial/assets/109048/299156e4-71dc-4552-aa6a-8c468592f39c">

( 未完待續 .... )

## 如何克隆(Clone)一個專案

以下是使用 GitHub Desktop 克隆 GitHub 專案的步驟：

安裝 GitHub Desktop: 如果您尚未安裝 GitHub Desktop，請先從[官方網站](https://desktop.github.com)下載並安裝。

開啟 GitHub Desktop: 安裝完成後，開啟 GitHub Desktop 應用程式。

登入帳戶: 如果您還沒有登入 GitHub 帳戶，您會需要先登入。

前往 GitHub 專案頁面: 打開瀏覽器，然後前往您想要克隆的 GitHub 專案頁面。

複製專案的 URL: 在 GitHub 專案頁面的右上角，找到 "Code" -> "Clone" ，點擊複製專案的 URL。

回到 GitHub Desktop: 在 GitHub Desktop 的選單中，選擇 "File" > "Clone Repository"。

輸入或貼上 URL: 在彈出的對話框中，切換到 "URL" 分頁，然後在 Repository URL or GitHub username and repository 輸入或貼上您之前複製的 GitHub 專案 URL。

選擇儲存位置: 您可以選擇將專案克隆到電腦上的哪個目錄。

點擊 "Clone": 確認所有訊息後，點擊 "Clone" 按鈕。

這樣，GitHub Desktop 就會開始克隆專案到您指定的目錄中。克隆完成後，您可以在 GitHub Desktop 的介面中看到專案，並可以進行進一步的操作，例如提交更改(Commit changes)或推送(Pull Request)到遠端。

希望這個解釋能幫助您了解如何使用 GitHub Desktop 來克隆(Clone) GitHub 專案！

## 如何創建專案內部分支branch
如何從 master 建立一個主題分支
fetch
merge
( 未完待續 .... )

## 如何使用分叉fork與整合Pull-request專案：創建個人版本的分岔支線版本，修改之後，提出 Pull Request 到原本的專案。我們對自己目前還沒有權限編輯的專案，要改良通常都是用這種方法。

創建分叉： 前往 GitHub 專案頁面，打開瀏覽器，然後前往您想要創建分叉(Fork) 的 GitHub 專案頁面，點擊右上角的 "Fork"。

編輯分叉：

整合更改(Commit changes)分叉的所有分支branches： "Commit changes" > Merge

Pull Request 到原本專案 ： "Contribute"
( 未完待續 .... )

## 如果協作專案是要在近端/本機寫程式，建議近端/本機安裝Visual Studio Code，並將 GitHub Desktop 預設編輯器設為Visual Studio Code。

安裝 Visual Studio Code: 如果您尚未安裝 Visual Studio Code，請先從[官方網站](https://code.visualstudio.com)下載並安裝。

在 GitHub Desktop 將 Visual Studio Code 設成預設編輯器：

(Windows)在 GitHub Desktop 的選單中，選擇 "File" > "Options" > “Integrations" > External Editor 選擇Visual Studio Code > "Save"

(Mac)在 GitHub Desktop 的選單中，選擇 "粗體GitHub Desktop" > "Settings" > “Integrations" > External Editor 選擇Visual Studio Code > "Save"

## 如何在Visual Studio Code 安裝Git ->再連結Github
( 未完待續 .... )

# Markdown 語法範例：

[Danger! 按此可跳關到完整的Markdown說明文件](https://hackmd.io/@eMP9zQQ0Qt6I8Uqp2Vqy6w/SyiOheL5N/%2FBVqowKshRH246Q7UDyodFA?type=book)

人生設計的四個順序：(清單)

1. 健康：養成良好的飲食和運動習慣。
3. 遊戲(喜樂)：
4. 愛：
5. 工作(對文明有所貢獻)：

## 健康

養成良好的習慣：

1. 飲食：在有限的時間和金錢當中，選擇對自己最健康的飲食，是很重要的。
2. 運動：如果你沒空山學瑜伽或是登山，至少要能夠在走路的過程當中，專心的走。
3. 睡眠：如果你無法好好的睡眠，至少要能夠冥想和回氣。

### 飲食

*  健康優先，護生和信仰次之。
*  雖然素食有它的優點，但是必要的時候也可以葷素不拘。

### 運動

- [ ] 我每週至少有3次，每次有30分鐘的有氧運動
- [ ] 我每天都有做深呼吸。
- [ ] 我每天至少做健走或是單車等和緩運動半小時

## 遊戲

* 尋找令您快樂的活動和愛好。
* 人們常說孩子要「會學也會玩」。
* 玩中有學，學也可以是玩。

## 愛

* 與家人和朋友建立穩固的關係。
* 愛鄰如己。要先愛自己。

## 工作

* 選擇一個您熱愛並能對社會有貢獻的職業。
* 比賺錢更重要的是，是在我們離開這世界之時，可以留給下一代更好的世界。
* 工欲善其事，必先利其器。善用工具，例如[hackMD](https://hackmd.io) and/or [Github](https://www.github.com)， 可以讓你的團隊工作效率提高10倍以上。