在本機設定供文件使用的 Git 存放庫
本文以參與 Adobe 文件編寫為目的,說明在本機電腦上設定 Git 存放庫的步驟。貢獻者可使用複製到本機的存放庫來新增文章、對現有文章做出重大編輯或變更插圖。
概述
若要參與 Adobe 文件編寫,您可以取用合適的存放庫並將其複製到自己的 GitHub 帳戶,如此便能擁有讀取/編寫權限。接著,複製對應的文件存放庫,就能在本機建立及編輯 Markdown 檔案。接下來,您可使用提取請求,將變更合併 (提交) 至唯讀的集中式共用存放庫。
- 確定合適的存放庫
- 取用存放庫並複製到您的 GitHub 帳戶
- 選擇本機資料夾以存放複製的檔案
- 將存放庫複製到本機電腦
- 設定上游遠端的值
確定存放庫
取用合適的存放庫並複製到您自己的 GitHub 帳戶,這樣您就擁有讀取/編寫權限,可儲存您要做的變更。Adobe Experience Cloud檔案位於github.com的多個不同的存放庫。
- 若不確定要使用哪個存放庫,可使用網頁瀏覽器查看文章。選取文章右上角的 編輯 連結 (鉛筆圖示) (如果沒有顯示編輯連結,表示還無法在 GitHub 使用該內容)。
若要對 Adobe 文件做出貢獻,請複製對應的文件存放庫,這樣就能在本機上建立及編輯 Markdown 檔案。接下來,您可使用提取請求,將變更合併至唯讀的集中式共用存放庫。
建立存放庫複本
找到合適的存放庫後,請使用 GitHub 網站,在您自己的 GitHub 帳戶中建立存放庫複本。
由於所有主要文件存放庫僅提供唯讀權限,表示您不能直接在存放庫中修改內容,因此需要自行建立複本。若要變更內容,您必須向主要存放庫提交複本提取請求 (PR)。為方便此流程進行,首先需建立一個您可以擁有編寫權限的存放庫複本。GitHub 取用 功能即為此目的而生。
-
前往主要存放庫的 GitHub 頁面,然後按一下右上角的 Fork (分叉) 按鈕。
-
一旦系統顯示提示,請選取您的 GitHub 帳戶,作為建立複本的目的地。此提示會在您的 GitHub 帳戶中建立存放庫複本 (即所謂的分叉)。
-
選擇方便記憶與輸入的資料夾名稱。
有些存放庫可能規模龐大。請選擇磁碟空間充足的儲存位置。
note note NOTE 避免選擇其他 Git 存放庫資料夾位置下的巢狀本機資料夾路徑。雖然 Git 複製資料夾可以並列存放,巢狀的 Git 資料夾會造成檔案追蹤上的錯誤。
在本機建立存放庫複本
複製您要使用的存放庫,會將檔案的複本下載到您的電腦上。準備就緒後,您可從本機磁碟將編輯項目推送到伺服器上您所取用的存放庫。接著,您可以提交提取請求,將編輯項目合併到上游的主存放庫。
這些步驟只適用於 GitHub Desktop。若是使用其他用戶端,請適度調整作法。
-
按一下 Clone or download (複製或下載),然後選擇 Open in Desktop (在 Desktop 中開啟),將存放庫複本 (亦即您建立的分叉) 提取到您電腦的目錄。
-
使用 GitHub Desktop 可保持本機檔案與取用的存放庫保持同步。
詳情請參閱 GitHub Desktop 文件。