23.6.1。提交小改動

最常見的貢獻是編輯一個句子或修正拼寫錯誤。我們建議您在GitHub 存儲庫中找到源文件并直接編輯該文件。例如，您可以通過查找文件按鈕（圖 23.6.1）搜索文件以找到源文件（markdown 文件）。然后單擊右上角的“編輯此文件”按鈕以在降價文件中進行更改。

圖 23.6.1在 Github 上編輯文件。

完成后，在頁面底部的“建議文件更改”面板中填寫您的更改說明，然后單擊“建議文件更改”按鈕。它會將您重定向到一個新頁面以查看您的更改（圖 23.6.7）。如果一切順利，您可以通過單擊“創(chuàng)建拉取請求”按鈕來提交拉取請求。

23.6.2。提出重大改變

如果你計劃更新大部分文本或代碼，那么你需要更多地了解本書使用的格式。源文件基于markdown 格式，通過d2lbook包提供了一組擴展 ，例如引用方程式、圖像、章節(jié)和引用。您可以使用任何降價編輯器打開這些文件并進行更改。

如果您想更改代碼，我們建議您使用 Jupyter Notebook 打開這些 markdown 文件，如第 23.1 節(jié)所述。這樣您就可以運行并測試您的更改。請記住在提交更改之前清除所有輸出，我們的 CI 系統(tǒng)將執(zhí)行您更新的部分以生成輸出。

某些部分可能支持多個框架實現(xiàn)。如果你添加一個新的代碼塊，請%%tab在開始行使用 來標記這個塊。例如，對于 PyTorch 代碼塊， 對于 TensorFlow 代碼塊，或者所有實現(xiàn)的共享代碼塊。您可以參考 < http://book.d2l.ai/user/code_tabs.html >`__ 包了解更多信息。%%tab pytorch%%tab tensorflow%%tab all`d2lbook

23.6.3。提交重大變更

我們建議您使用標準 Git 流程來提交重大更改。簡而言之，該過程的工作原理如圖 23.6.2所示。

圖 23.6.2為本書投稿。

我們將引導您詳細完成這些步驟。如果您已經(jīng)熟悉 Git，則可以跳過本節(jié)。為了具體起見，我們假設貢獻者的用戶名為“astonzhang”。

23.6.3.2。登錄 GitHub

在瀏覽器中輸入本書代碼庫的地址。點擊圖23.6.3Fork右上角紅框內的按鈕，復制本書的資源庫。現(xiàn)在這是您的副本，您可以隨意更改它。

圖 23.6.3代碼庫頁面。

現(xiàn)在，本書的代碼庫將被分叉（即復制）到您的用戶名，如圖23.6.4astonzhang/d2l-en左上角所示 。

圖 23.6.4分叉代碼庫。

23.6.3.3。克隆存儲庫

要克隆存儲庫（即制作本地副本），我們需要獲取其存儲庫地址。圖 23.6.5中的綠色按鈕 顯示了這一點。如果您決定將此分叉保留更長時間，請確保您的本地副本與主存儲庫保持同步。現(xiàn)在只需按照安裝中的說明開始。主要區(qū)別在于您現(xiàn)在正在下載自己的存儲庫分支。

圖 23.6.5克隆存儲庫。

# Replace your_github_username with your GitHub username
git clone https://github.com/your_github_username/d2l-en.git

mylaptop:d2l-en me$ git status
On branch master
Your branch is up-to-date with 'origin/master'.

Changes not staged for commit:
 (use "git add ..." to update what will be committed)
 (use "git checkout -- ..." to discard changes in working directory)

  modified:  chapter_appendix-tools-for-deep-learning/contributing.md

git add chapter_appendix-tools-for-deep-learning/contributing.md
git commit -m 'Fix a typo in git documentation'
git push