版本 e2757d75f9b2cff471321d17ef395df4ddeab208
Changes from e2757d75f9b2cff471321d17ef395df4ddeab208 to 11a8c55861303ad28c50705206cde8e73c1d8084
---
title: GitHub 設定指引
toc: no
...
(以下內容由 `許元杰<https://github.com/Jayjack0116>`_ 貢獻)
建立 GitHub 帳號
------------------------
* Github 是個 Git 的托管網站，可讓開發者將自己的專案儲存到網路上，與全世界分享，我們可方便的使用 Git 在本機進行專案管理。
* GitHub 同時提供付費帳號和為了開放原始碼程式提供的免費帳號。根據 2009 年的 Git 使用者調查，GitHub 是最熱門的 Git 分享網站。它提供了如 feeds、followers 和顯示開發者們如何在他們版本庫上的版本工作的圖表。 GitHub 也提供類似剪貼簿的功能，issue tracker 和網頁使用 Wiki，通過一個 git repository 即可對這些頁面進行編輯。
.. image:: /use-git-01.png
建立新 repository
------------------------
在和本機的 repository 連動之前，先給自己的專案取個名字吧，這會是你專案之後的名字，也會是其他人搜尋你專案的時候的關鍵字，好的專案一定有一個好的名字。
.. image:: /use-git-02.png
上圖是筆者新增一個叫做 "Embedded-System-Class" 的 repository，以及 Fork 課程所用的 `embedded2015/arm-lecture<https://github.com/embedded2015/arm-lecture/>`_ 這個 repository。
綁訂機器的 SSH key
---------------------------
因為要讓 Github 知道是我們這台電腦上傳的專案，所以我們要和 Github 之間建立一種默契，這個默契就是使用 ssh 協定時的 `public key<http://en.wikipedia.org/wiki/Public-key_cryptography>`_，我們給 Github 我們本機的 ssh public key ，告訴 Github 拿著這個 key 的電腦才是這個帳號的使用者， 如此一來就只能由這台電腦進行管理，才不會造成其他人來我們的帳號亂上傳東西的窘境。
首先，點選右上角的工具按鈕，進入帳號設定頁面，在頁面的左下角點選 "SSH keys"
.. image:: /use-git-03.png
SSH key 產生的方法
---------------------------
(``$`` 開頭的表示法，就是說明在 Linux 終端機輸入指令)
1. 輸入指令
.. code-block:: prettyprint
$ ssh-keygen -t rsa -C "your_email@example.com"
2. 後面那是自己申請 Github 所使用的信箱。之後 ssh 程式會要求輸入 passphrase：
後面那是自己申請 Github 所使用的信箱。之後 ssh 程式會要求輸入 passphrase：
.. image:: /use-git-04.png
3. 直接按下 Enter 鍵即可。
2. 直接按下 Enter 鍵即可。
.. image:: /use-git-05.png
4. 輸入一個passphrase，如不想輸入直接按下 Enter 鍵即可。
3. 輸入一個passphrase，如不想輸入直接按下 Enter 鍵即可。
.. image:: /use-git-06.jpg
5. 此時顯示的是你SSH Key的fingerprint
4. 此時顯示的是你SSH Key的fingerprint
.. image:: /use-git-07.jpg
5-1. 將剛剛產生的key加入ssh-agent中
5. 將剛剛產生的key加入ssh-agent中
如果你已經安裝了 `Windows版的Github<https://windows.github.com/>`_ ，你可以在不使用SSH Key的狀況下執行clone等操作。windows版本同時支援許多Git Bash tool，可運行眾多的Git指令。
如果你已安裝了 `Windows版的Github<https://windows.github.com/>`_ ，你可以在不使用SSH Key的狀況下執行clone等操作。windows版本同時支援許多Git Bash tool，可運行眾多的Git指令。
5-1. 如果你已安裝Git Bash，輸入以下指令以啟動ssh-agent
.. image:: /use-git-08.jpg
