23.6.1。提交小改動(dòng)

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

圖 23.6.1在 Github 上編輯文件。

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

23.6.2。提出重大改變

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

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

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

23.6.3。提交重大變更

我們建議您使用標(biāo)準(zhǔn) Git 流程來(lái)提交重大更改。簡(jiǎn)而言之，該過(guò)程的工作原理如圖 23.6.2所示。

圖 23.6.2為本書投稿。

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

23.6.3.2。登錄 GitHub

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

圖 23.6.3代碼庫(kù)頁(yè)面。

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

圖 23.6.4分叉代碼庫(kù)。

23.6.3.3。克隆存儲(chǔ)庫(kù)

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

圖 23.6.5克隆存儲(chǔ)庫(kù)。

# 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