PyTorch教程23.6之为本书做贡献

23.6.1。提交小改动

最常见的贡献是编辑一个句子或修正拼写错误。我们建议您在GitHub 存储库中找到源文件并直接编辑该文件。例如，您可以通过查找文件按钮（图 23.6.1）搜索文件以找到源文件（markdown 文件）。然后单击右上角的“编辑此文件”按钮以在降价文件中进行更改。

图 23.6.1在 Github 上编辑文件。

完成后，在页面底部的“建议文件更改”面板中填写您的更改说明，然后单击“建议文件更改”按钮。它会将您重定向到一个新页面以查看您的更改（图 23.6.7）。如果一切顺利，您可以通过单击“创建拉取请求”按钮来提交拉取请求。

23.6.2。提出重大改变

如果你计划更新大部分文本或代码，那么你需要更多地了解本书使用的格式。源文件基于markdown 格式，通过d2lbook包提供了一组扩展 ，例如引用方程式、图像、章节和引用。您可以使用任何降价编辑器打开这些文件并进行更改。

如果您想更改代码，我们建议您使用 Jupyter Notebook 打开这些 markdown 文件，如第 23.1 节所述。这样您就可以运行并测试您的更改。请记住在提交更改之前清除所有输出，我们的 CI 系统将执行您更新的部分以生成输出。

某些部分可能支持多个框架实现。如果你添加一个新的代码块，请%%tab在开始行使用 来标记这个块。例如，对于 PyTorch 代码块， 对于 TensorFlow 代码块，或者所有实现的共享代码块。您可以参考 < 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为本书投稿。

我们将引导您详细完成这些步骤。如果您已经熟悉 Git，则可以跳过本节。为了具体起见，我们假设贡献者的用户名为“astonzhang”。

23.6.3.2。登录 GitHub

在浏览器中输入本书代码库的地址。点击图23.6.3Fork右上角红框内的按钮，复制本书的资源库。现在这是您的副本，您可以随意更改它。

图 23.6.3代码库页面。

现在，本书的代码库将被分叉（即复制）到您的用户名，如图23.6.4astonzhang/d2l-en左上角所示 。

图 23.6.4分叉代码库。

23.6.3.3。克隆存储库

要克隆存储库（即制作本地副本），我们需要获取其存储库地址。图 23.6.5中的绿色按钮 显示了这一点。如果您决定将此分叉保留更长时间，请确保您的本地副本与主存储库保持同步。现在只需按照安装中的说明开始。主要区别在于您现在正在下载自己的存储库分支。

图 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