Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New Crowdin updates #1916

Merged
merged 7 commits into from
Mar 10, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
99 changes: 99 additions & 0 deletions docs/guides/contribute/beginners.zh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
---
title: 初学者贡献指南
author: Krista Burdine
contributors: Ezequiel Bruni, Steven Spencer, Ganna Zhyrnova
tags:
- contributing
- documentation
- beginners
- howto
---

# 首次贡献指南

_凡事都有个开头。 如果这是您第一次在 GitHub 上为开源文档做出贡献,恭喜您迈出了这一步。 我们迫不及待地想听听你要说什么!_

## Git 和 GitHub

我们所有的贡献者使用说明都预先假定您有一个 GitHub 账户。 如果你从来没有做过,现在是时候了。 如果你有12分钟的时间,可以从 [ Git 和 GitHub 入门指南](https://www.udacity.com/blog/2015/06/a-beginners-git-github-tutorial.html) 中学习 GitHub 的基本知识。

你可能一开始并没有为 Rocky Linux 创建和管理存储库,但这个 [Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) 教程会引导你创建 GitHub 账户,学习术语并了解存储库的工作原理。 重点学习如何对现有文档进行更新和提交(Commit),以及如何创建拉取请求(Pr)。

## Markdown

Markdown 是一种简单的语言,允许您在同一文件中包含格式、代码和纯文本。 首次更新文档时,请遵循现有代码。 用不了多久,您就可以开始探索其他功能了。 当时机成熟时,以下就是基础。

* [基础 Markdown](https://www.markdownguide.org/basic-syntax#code)
* [扩展 Markdown](https://www.markdownguide.org/extended-syntax/#fenced-code-blocks)
* 在存储库中,我们还使用了一些更[高级的格式选项](https://docs.rockylinux.org/guides/contribute/rockydocs_formatting/)

## 本地存储库编辑器

要创建本地存储库,首先找到并安装一个适用于您的计算机和操作系统的 Markdown 编辑器。 这里有一些选择,但还有其他选择。 使用你所知道的就可以了。

* [ReText](https://github.com/retext-project/retext) - 免费、跨平台、开源
* [Zettlr](https://www.zettlr.com/) - 免费、跨平台、开源
* [MarkText](https://github.com/marktext/marktext) - 免费、跨平台、开源
* [Remarkable](https://remarkableapp.github.io/) - 适用于 Linux 和 Windows,开源
* 用于 vi/vim 用户和 nvim客户端的 [NvChad](https://nvchad.com/)。 有很多插件可以增强 Markdown 编辑器。 请参阅 [本文档](https://docs.rockylinux.org/books/nvchad/) 以获取一套很好的安装说明。
* [VS Code](https://code.visualstudio.com/) - 部分开源,由微软提供。 VS Code 是一个轻量级且功能强大的编辑器,可用于 Windows、Linux 和 MacOS 。 要为这个文档项目做出贡献,您应该获取以下扩展程序:Git Graph、HTML Preview、HTML Snippets、Markdown All in One、Markdown Preview Enhanced、Markdown Preview Mermaid Support 以及任何您喜欢的扩展程序。

## 创建本地存储库

安装好 Markdown 编辑器后,按照说明将其连接到您的 GitHub 帐户,并将您的存储库下载到本地计算机。 每次准备更新文档时,请按照以下步骤将本地和在线分支与 main 分支同步,以确保您使用的是最新版本:

1. 在 GitHub 中,将文档存储库的分支与 main 分支同步。
2. 按照你 Markdown 编辑器的说明,将你当前的 fork 与本地机器同步。
3. 在您的 Markdown 编辑器中,打开您要修改的文档。
4. 修改文档。
5. 保存。
6. 在您的编辑器中提交(Commit)您的更改,这应该会将您的本地存储库与您的在线分支同步。
7. 在 GitHub 中,在你的 fork 中找到更新的文档,并创建一个 Pull Request,将其与主文档合并。

## 提交更新

_添加遗漏的单词、更正错误或澄清令人困惑的文本。_

1. 从要更新的页面开始。

点击您要更新的文档右上角的 "Edit" 铅笔。 您将被引领到 GitHub 上的原始文档。

当您第一次向 RL 仓库贡献代码时,您将看到一个绿色按钮,提示您 "**Fork** this **repository** and propose changes."。 这将创建 RL 存储库的副本,您可以在其中进行建议的编辑。 只需点击绿色按钮并继续。

2. 进行更改

遵循 Markdown 格式。 例如,也许有一个单词遗漏了,或者第 21 行的链接需要修复。 做出必要的改变。

3. 提出更改建议

在页面底部,在标题为 "**Propose changes"** 的区块标题中写一行描述。 参考文档顶部的文件名是有帮助的,但不是必需的。

因此,如果你更新了 Markdown 文本第 21 行中的链接,你会说 "Update README.md with correct links."。

**注意:用现在时态描述你的操作。**

然后单击 "Propose changes",这将把您的更改 **Commit** 到您 fork 的存储库的完整文档中去。

4. 审核更改

现在你可以逐行查看你所做的工作。 你是否遗漏了一些东西? 返回上一页并再次更正(你必须重新开始),然后再次单击 "Propose Changes"。

文档变成您想要的样子后,单击绿色按钮 "Create Pull Request"。 这又提供了一次机会来再次检查您的更改并确认文档已准备好。

5. 创建 PR

到目前为止,您的所有工作都是在您自己的存储库中完成的,没有机会破坏 RL main 存储库。 接下来,您将其提交给文档团队,以将您的版本合并到文档的 main 版本中。

点击 "Create Pull Request" 的大绿色按钮。 好消息是,你还没有破坏任何东西,因为现在它要交给 RL 文档团队进行审查。

6. 等待

RL 团队收到您的请求后,他们将以三种方式之一作出回应。

* 接受并合并您的 PR
* 提出反馈意见并要求更改
* 拒绝你的 PR 并解释原因

最后一个回应不大可能出现。 我们真的很想在这里包括你的观点! 如果你必须进行更改,你会突然明白为什么需要本地存储库。 团队可以 [告诉您](https://chat.rockylinux.org/rocky-linux/channels/documentation) 下一步该怎么做。 好消息是,它仍然是可以解决的。 请关注该请求的评论部分,以了解需要进一步提供哪些信息。

否则,您的请求将被接受并合并。 欢迎加入团队,您现在正式成为了贡献者! 过几天,你的名字就会出现在《贡献者指南》底部的 all-contributors 名单上。
48 changes: 48 additions & 0 deletions docs/guides/contribute/createnew.zh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
title: 在 GitHub 上创建新文档
author: Ezequiel Bruni
contributors: Grammaresque, Ganna Zhyrnova
tags:
- contributing
- documentation
---

# 如何在 GitHub 中创建新文档

_当您准备好提交原始书面文档以供审批时,请执行以下简单步骤:_


## 使用 GitHub GUI

您几乎可以在 GitHub 上的 Web 图形用户界面中完成所有任务。 下面是将您在本地计算机上创建的文件添加到 Rocky Linux Documentation GitHub 存储库的示例。



1. 登录您的 GitHub 账户。
2. 导航到 Rocky Linux Documentation 存储库地址 [https://github.com/rocky-linux/documentation](https://github.com/rocky-linux/documentation)。
3. 您应该在 "Main" 分支上,所以请检查中间部分的下拉标签,以确保您是这样做的。 您的文档最终可能不会出现在 "Main" 分支中,但管理员稍后会将其移动到逻辑上的适合位置。
4. 在页面右侧,单击 "Fork" 按钮,这将创建属于您的文档副本。
5. 在 fork 副本的页面中间,绿色 "Code" 下拉列表的左侧,是一个 "Add file" 按钮。 点击此按钮,选择 "Upload files" 选项。
6. 这将允许您将文件拖放到此处或在您的计算机上浏览到它们。 继续使用你喜欢的方法。
7. 上传文件后,接下来需要做的就是创建 PR 。 此请求会让上游管理员知道您有一个(或多个)希望与 main 分支合并的新文件。
8. 点击屏幕左上角的 "Pull Request"。
9. 在 "Write" 部分写一条简短的消息,让管理员知道您做了什么。 比如新文档、修改、建议更改等。然后提交您的变更。


## 使用 Git 命令行

如果您更喜欢在本地计算机上运行 Git,则可以克隆 [Rocky Linux Documentation](https://github.com/rocky-linux/documentation) 存储库,进行更改并提交更改。 为了简单起见,使用上述 **使用 GitHub GUI** 方法执行步骤 1-3 ,然后:



1. 使用 Git 命令克隆存储库:git clone https://github.com/your_fork_name/documentation.git
2. 现在,在您的计算机上,将新文件添加到该目录中。
3. 例如这样的命令:mv /home/myname/help.md /home/myname/documentation/
4. 接下来,为该文件名运行 git add 命令。
5. 示例:git added help.md
6. 现在,运行 git commit 命令以提交您所做的更改。
7. 例如:git commit -m "Added the help.md file"
8. 接下来,将您的更改推送到您的分支存储库:git push https://github.com/your_fork_name/documentation main
9. 接下来重复上述步骤 6 和 7:创建 PR 。 此请求会让上游管理员知道您有一个(或多个)希望与 main 分支合并的新文件。 点击屏幕左上角的 "Pull Request"。

请注意 PR 中的评论,以获取请求的修改和解释。
2 changes: 1 addition & 1 deletion docs/guides/contribute/localdocs/index.fr.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
Title: Introduction
author: Steven Spencer
contributors: null
contributors: Ganna Zhyrnova
tags:
- local docs
- docs as code
Expand Down
Loading
Loading