跳至内容

如何在 GitHub 中创建新文档

当您准备好提交您的原创书面文档以供批准时，请按照以下简单步骤操作

使用 GitHub GUI

您可以从 GitHub 上的 Web GUI 完成几乎所有任务。以下是将您在本地计算机上创建的文件添加到 Rocky Linux 文档 GitHub 存储库的示例。

  1. 登录您的 GitHub 帐户。
  2. 导航到 Rocky Linux 文档存储库：https://github.com/rocky-linux/documentation。
  3. 您应该在“Main”分支上，因此请检查中间区域下方的下拉标签以确保您在。您的文档可能最终不会出现在“Main”分支上，但管理员稍后会将其移动到逻辑位置。
  4. 在页面右侧，点击 Fork 按钮，这将创建您的文档副本。
  5. 在 fork 副本页面的中间，位于绿色“Code”下拉菜单的左侧，有一个 Add file 按钮。单击此按钮并选择“Upload files”选项。
  6. 这将允许您将文件拖放到此处，或从您的计算机中浏览它们。继续使用您偏好的方法。
  7. 文件上传后，您需要做的下一件事是创建一个 Pull Request。此请求让上游管理员知道您有一个新文件（或文件），您希望他们将其合并到主分支。
  8. 点击屏幕左上角的 Pull Request。
  9. 在“Write”部分写一条简短的消息，告知管理员您已完成的操作。（新文档、修订、建议的更改等），然后提交您的更改。

从 Git 命令行

如果您更喜欢在本地计算机上运行 Git，您可以克隆 Rocky Linux Documentation 存储库，进行更改，然后提交更改。为简单起见，使用上面的**使用 GitHub GUI** 方法执行步骤 1-3，然后

  1. Git 克隆存储库

    git clone https://github.com/your_fork_name/documentation.git

  2. 现在，在您的计算机上，将文件添加到目录。示例

    mv /home/myname/help.md /home/myname/documentation/

  3. 接下来，为该文件名运行 Git add。示例

    git add help.md

  4. 现在，运行 git commit 来提交您所做的更改。示例

    git commit -m "Added the help.md file"

  5. 接下来，将您的更改推送到您的 forked 存储库

    git push https://github.com/your_fork_name/documentation main

  6. 接下来，重复上面的步骤 6 和 7：创建一个 Pull Request。此请求让上游管理员知道您有一个新文件（或文件），您希望他们将其合并到主分支。点击屏幕左上角的 Pull Request。

关注 PR 中的评论，以获取请求的修订和澄清。

作者：Ezequiel Bruni

贡献者：Grammaresque, Ganna Zhyrnova