💬Generate LLM translations (#1945)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: z <[email protected]>

Author: github-actions[bot]

docs/cn/developer/20-community/00-contributor/00-building-from-source.md

@@ -0,0 +1,128 @@
+---
+title: 构建 Databend
+sidebar_label: 构建 Databend
+description: 从源代码获取和构建 Databend
+---
+
+作为一个开源平台，Databend 为用户提供了根据其特定需求修改、分发和增强软件的灵活性。此外，用户可以自由地从源代码构建 Databend，从而能够充分了解软件的工作原理并有可能为其开发做出贡献。
+
+:::tip
+Databend 提供了一个 Docker 镜像，其中包含开发所需的所有工具，但目前仅适用于 amd64 架构。要使用它，请确保已安装并运行 Docker，然后运行 `INTERACTIVE=true scripts/setup/run_build_tool.sh`。这将启动一个用于构建和测试的环境，`INTERACTIVE=true` 标志启用交互模式。
+:::
+
+## 前提条件
+
+在构建 Databend 之前，请确保已满足以下要求：
+
+- 从源代码构建 Databend 至少需要 16 GB 的 RAM。
+- 您已安装以下必需工具：
+  - Git
+  - cmake
+  - [rustup](https://rustup.rs/)
+
+## 构建 Databend
+
+按照以下步骤构建 Databend：
+
+1. 下载源代码。
+
+```shell
+git clone https://github.com/databendlabs/databend.git
+```
+
+2. 安装依赖项并编译源代码。
+
+```shell
+cd databend
+make setup -d
+export PATH=$PATH:~/.cargo/bin
+```
+
+3. 构建 Databend。
+
+- 要构建包含调试信息的 Databend 以进行调试，请运行 `make build`。生成的文件将位于 "target/debug/" 目录中。
+
+```shell
+make build
+```
+
+- 要构建用于生产环境的 Databend，针对您的本地 CPU 进行了优化，请运行 `make build-release`。生成的文件将位于 "target/release/" 目录中。
+
+```shell
+make build-release
+```
+
+## 启动 Databend 进行调试
+
+```shell
+# 1. 首先启动 databend-meta：
+nohup target/debug/databend-meta --single --log-level=ERROR &
+
+# 2. 启动 databend-query 并将其连接到 databend-meta：
+nohup target/debug/databend-query -c scripts/ci/deploy/config/databend-query-node-1.toml &
+```
+
+:::tip
+要停止 databend-meta 和 databend-query，请运行以下命令：
+
+```shell
+killall -9 databend-meta
+killall -9 databend-query
+```
+
+:::
+
+## 常见错误
+
+1. 在 osx 中构建：
+
+- 最好使用官方 clang 而不是 apple clang：
+
+  ```bash
+  brew install llvm
+  ```
+
+  并设置编译器环境，例如：
+
+  ```bash
+  export CMAKE_CC_COMPILER=/opt/homebrew/opt/llvm/bin/clang
+  export CMAKE_CXX_COMPILER=/opt/homebrew/opt/llvm/bin/clang++
+  ```
+
+- 使用自定义 jemalloc env 配置：
+  ```bash
+  export JEMALLOC_SYS_WITH_LG_PAGE=14
+  export JEMALLOC_SYS_WITH_MALLOC_CONF="oversize_threshold:0,dirty_decay_ms:5000,muzzy_decay_ms:5000"
+  ```
+
+2. protoc failed: Unknown flag: --experimental_allow_proto3_optional\n
+
+```bash
+  --- stderr
+  Error: Custom { kind: Other, error: "protoc failed: Unknown flag: --experimental_allow_proto3_optional\n" }
+warning: build failed, waiting for other jobs to finish...
+All done...
+# Reduce binary size by compressing binaries.
+objcopy --compress-debug-sections=zlib-gnu /home/aucker/mldb/databend/target/release/databend-query
+objcopy: '/home/aucker/mldb/databend/target/release/databend-query': No such file
+make: *** [Makefile:51: build-release] Error 1
+```
+
+错误消息表明，由于 protoc 使用了一个未知的标志（--experimental_allow_proto3_optional），导致构建 Databend 时出现问题。protoc 是一个协议缓冲区编译器。此标志仅在 protoc 3.12 或更高版本中可用，而当前使用的版本不支持它。
+
+建议的解决方案是升级到支持该标志的 protoc 版本。您可以通过从官方发布页面 (https://github.com/protocolbuffers/protobuf/releases) 下载最新版本的 protoc 并将其安装在您的系统上来实现。
+
+```bash
+PB_REL="https://github.com/protocolbuffers/protobuf/releases"
+curl -LO $PB_REL/download/v3.15.8/protoc-3.15.8-linux-x86_64.zip
+unzip protoc-3.15.8-linux-x86_64.zip
+$sudo cp bin/protoc /usr/bin/
+$protoc --version
+libprotoc 3.15.6
+```
+
+3. 无法连接到派生的 Databend 项目中的 databend-meta。
+
+此问题可能是由 Databend-meta 中实施的版本检查未被派生项目满足所致。
+
+一种可能的解决方案是使用命令 `git fetch https://github.com/databendlabs/databend.git --tags` 从官方 Databend 存储库中获取最新的标签。这应确保项目使用最新版本的 Databend-meta 并将通过版本检查。

docs/cn/developer/20-community/00-contributor/01-good-pr.md

@@ -0,0 +1,151 @@
+---
+title: 你的第一个 Databend PR
+sidebar_label: 第一个 Pull Request
+description: 你的第一个好的 Databend pull request
+---
+
+[Databend](https://github.com/databendlabs/databend) 是一个开源项目，每个人都可以贡献他们的代码，并将他们的创意变为现实。本主题帮助新的贡献者了解如何在 GitHub 上为 Databend 创建 pull request，并为代码贡献提供有用的注意事项。
+
+:::tip
+**你知道吗？** 为了表示感谢，您的 GitHub 用户名将在您的代码成功合并后添加到 `system.contributors` 表中。
+
+查看它：
+
+`SELECT * FROM system.contributors`
+:::
+
+## 前提条件
+
+Databend 是用 Rust 编写的，要从头开始构建 Databend，您需要安装以下工具：
+
+- **Git**
+- **Rust** 使用 [rustup](https://rustup.rs/) 安装
+
+## 编码规范
+
+### 代码格式和分析
+
+```shell
+$ make lint
+```
+
+### 代码文档
+
+任何公共字段、函数和方法都应该使用 [Rustdoc](https://doc.rust-lang.org/book/ch14-02-publishing-to-crates-io.html#making-useful-documentation-comments) 进行文档化。
+
+请遵循下面详细介绍的 `modules`、`structs`、`enums` 和 `functions` 的约定。当导航 Rustdoc 时，_单行_ 用作预览。例如，请参阅 [collections](https://doc.rust-lang.org/std/collections/index.html) Rustdoc 中的“Structs”和“Enums”部分。
+
+```rust
+/// [Single line] One line summary description
+///
+/// [Longer description] Multiple lines, inline code
+/// examples, invariants, purpose, usage, etc.
+[Attributes] If attributes exist, add after Rustdoc
+```
+
+以下示例：
+
+```rust
+/// Represents (x, y) of a 2-dimensional grid
+///
+/// A line is defined by 2 instances.
+/// A plane is defined by 3 instances.
+#[repr(C)]
+struct Point {
+    x: i32,
+    y: i32,
+}
+```
+
+## 贡献文档
+
+我们欢迎您在编写代码的同时，为 Databend 文档做出贡献！Databend 文档由 markdown 文件组成，这使得编写和维护变得容易。为了确保高质量的文档，我们建议使用 [Visual Studio Code](https://code.visualstudio.com/) 作为您的 markdown 编辑器。此外，安装 [Code Spell Checker](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker) 扩展程序将帮助您发现任何拼写错误。
+
+当提交新命令或函数的文档时，必须遵守提供的模板和指南，以保持一致性并确保 Databend 文档的清晰度。这些模板旨在包含所有必要的信息和格式约定，使用户更容易理解和使用命令或函数。
+
+- [command-template](https://github.com/databendlabs/databend/blob/d3a40d91b8a8ebaf878344e024164f36b6db5615/docs/public/templates/command-template.md?plain=1)
+- [function-template](https://github.com/databendlabs/databend/blob/d3a40d91b8a8ebaf878344e024164f36b6db5615/docs/public/templates/function-template.md?plain=1)
+
+除了遵循模板之外，请注意其中包含的代码。代码的目的是明确指出新命令或函数是否仅适用于 Databend Enterprise，并提供有关何时引入命令或函数的信息。此上下文信息对于用户至关重要，因为它允许他们准确评估功能的范围和限制。它还使用户能够识别支持该功能的 Databend 的特定版本，从而使他们能够有效地规划其使用。
+
+## Pull Requests
+
+### 提交 PR
+
+1. Fork `databend` 仓库，并从 `main` 创建您的分支。
+2. 打开一个常规 [issue](https://github.com/databendlabs/databend/issues/new/choose) 以绑定 pull request。
+3. 提交一个 [Draft Pull Requests](https://github.blog/2019-02-14-introducing-draft-pull-requests/)，标记您正在进行的工作。
+4. 如果您添加了应该测试的代码，请添加单元测试。
+5. 验证并确保测试套件通过，`make test`。
+6. 确保您的代码通过了两个 linters，`make lint`。
+7. 将状态更改为“Ready for review”。
+8. 注意来自 `@mergify` 的回复，她将是您的指导。
+
+### PR 标题
+
+格式：`<type>(<scope>): <subject>`
+
+`<scope>` 是可选的
+
+```
+fix(query): fix group by string bug
+^--^  ^------------^
+|     |
+|     +-> Summary in present tense.
+|
++-------> Type: rfc, feat, fix, refactor, ci, docs, chore
+```
+
+更多类型：
+
+- `rfc`: 此 PR 提出了一个新的 RFC
+- `feat`: 此 PR 向代码库引入了一个新功能
+- `fix`: 此 PR 修复了代码库中的一个错误
+- `refactor`: 此 PR 更改了代码库，但没有新功能或错误修复
+- `ci`: 此 PR 更改了构建/ci 步骤
+- `docs`: 此 PR 更改了文档或网站
+- `chore`: 此 PR 只有小的更改，不需要记录，例如编码风格。
+
+### PR 模板
+
+Databend 有一个 [Pull Request Template](https://github.com/databendlabs/databend/blob/main/.github/PULL_REQUEST_TEMPLATE.md):
+
+```shell
+I hereby agree to the terms of the CLA available at: https://docs.databend.com/dev/policies/cla
+
+## Summary
+
+Summary about this PR
+
+Fixes #issue
+```
+
+您不应该更改 PR 模板上下文，但需要完成：
+
+- `Summary` - 描述构成 Pull Request 的内容以及您对代码所做的更改。例如，修复哪个 issue。
+
+## 测试
+
+_单元测试_
+
+```shell
+$ make unit-test
+```
+
+_无状态测试_
+
+```shell
+$ make stateless-test
+```
+
+## Issues
+
+Databend 使用 [GitHub issues](https://github.com/databendlabs/databend/issues) 来跟踪错误。请包括必要的信息和说明来重现您的问题。
+
+## 文档
+
+所有开发者文档都发布在 Databend 开发者网站 [databend.com](/guides) 上。
+
+## 行为准则
+
+请参阅 [行为准则](/dev/policies/code-of-conduct)，其中描述了社区内互动的期望。