docs: make Chinese README the default

2026-07-13 10:28:01 +00:00
parent 5aae728e64
commit 18c0895c34
1 changed files with 23 additions and 17 deletions
@@ -1,6 +1,12 @@
+<!-- WEHUB_ZH_README -->
+> [!NOTE]
+> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
+> [English](./README.en.md) · [原始项目](https://github.com/TheAlgorithms/C-Plus-Plus) · [上游 README](https://github.com/TheAlgorithms/C-Plus-Plus/blob/HEAD/README.md)  
+> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
+
 # The Algorithms - C++ # {#mainpage}

-<!-- the suffix in the above line is required for doxygen to consider this as the index page of the generated documentation site -->
+<!-- 上述行中的后缀是 doxygen 将本页视为所生成文档站点索引页所必需的 -->

 [![Gitpod Ready-to-Code](https://img.shields.io/badge/Gitpod-Ready--to--Code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/TheAlgorithms/C-Plus-Plus)
 [![CodeQL CI](https://github.com/TheAlgorithms/C-Plus-Plus/actions/workflows/codeql.yml/badge.svg)](https://github.com/TheAlgorithms/C-Plus-Plus/actions/workflows/codeql.yml)
@@ -13,28 +19,28 @@
 [![Discord chat](https://img.shields.io/discord/808045925556682782.svg?logo=discord&colorB=5865F2)](https://the-algorithms.com/discord/)
 [![Donate](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/TheAlgorithms/donate)

-## Overview
+## 概述

-This repository is a collection of open-source implementation of a variety of algorithms implemented in C++ and licensed under [MIT License](https://github.com/TheAlgorithms/C-Plus-Plus/blob/master/LICENSE). These algorithms span a variety of topics from computer science, mathematics and statistics, data science, machine learning, engineering, etc.. The implementations and the associated documentation are meant to provide a learning resource for educators and students. Hence, one may find more than one implementation for the same objective but using a different algorithm strategies and optimizations.
+本仓库汇集了多种算法的开源实现，使用 C++ 编写，并采用 [MIT License](https://github.com/TheAlgorithms/C-Plus-Plus/blob/master/LICENSE). 许可。这些算法涵盖计算机科学、数学与统计学、数据科学、机器学习、工程等多个主题。实现代码及相关文档旨在为教育工作者和学生提供学习资源。因此，针对同一目标，你可能会发现不止一种实现，它们采用不同的算法策略与优化方式。

-## Features
+## 特性

- The repository provides implementations of various algorithms in one of the most fundamental general purpose languages - [C++](https://en.wikipedia.org/wiki/C%2B%2B).
- Well documented source code with detailed explanations provide a valuable resource for educators and students alike.
- Each source code is atomic using [STL classes](https://en.wikipedia.org/wiki/Standard_Template_Library) and _no external libraries_ are required for their compilation and execution. Thus, the fundamentals of the algorithms can be studied in much depth.
- Source codes are [compiled and tested](https://github.com/TheAlgorithms/C-Plus-Plus/actions?query=workflow%3A%22Awesome+CI+Workflow%22) for every commit on the latest versions of three major operating systems viz., Windows, MacOS, and Ubuntu (Linux) using MSVC 19 2022, AppleClang 15.0.15, and GNU 13.3.0 respectively.
- Strict adherence to [C++17](https://en.wikipedia.org/wiki/C%2B%2B17) standard ensures portability of code to embedded systems as well like [ESP32](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/cplusplus.html#c-language-standard), [ARM Cortex](https://developer.arm.com/documentation/101458/2404/Standards-support/Supported-C-C---standards-in-Arm-C-C---Compiler), etc. with little to no changes.
- Self-checks within programs ensure correct implementations with confidence.
- Modular implementations and OpenSource licensing enable the functions to be utilized conveniently in other applications.
+- 本仓库在最为基础之一的通用编程语言 [C++](https://en.wikipedia.org/wiki/C%2B%2B). 中提供了多种算法的实现。
+- 文档完善的源代码配有详细说明，为教育工作者和学生提供宝贵资源。
+- 每份源代码都是原子化的，使用 [STL classes](https://en.wikipedia.org/wiki/Standard_Template_Library)，编译与运行_无需外部库_。因此可以更深入地研究算法的基本原理。
+- 源代码在每次提交时都会针对三大主流操作系统的最新版本进行[编译与测试](https://github.com/TheAlgorithms/C-Plus-Plus/actions?query=workflow%3A%22Awesome+CI+Workflow%22)，即 Windows、MacOS 和 Ubuntu（Linux），分别使用 MSVC 19 2022、AppleClang 15.0.15 和 GNU 13.3.0。
+- 严格遵循 [C++17](https://en.wikipedia.org/wiki/C%2B%2B17) 标准，确保代码可移植到嵌入式系统等平台，例如 [ESP32](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/cplusplus.html#c-language-standard), [ARM Cortex](https://developer.arm.com/documentation/101458/2404/Standards-support/Supported-C-C---standards-in-Arm-C-C---Compiler), 等，几乎无需修改。
+- 程序内置自检机制，可确保实现正确、结果可信。
+- 模块化实现与开源许可使这些函数能够便捷地用于其他应用。

-## Documentation
+## 文档

-[Online Documentation](https://TheAlgorithms.github.io/C-Plus-Plus) is generated from the repository source codes directly. The documentation contains all resources including source code snippets, details on execution of the programs, diagrammatic representation of program flow, and links to external resources where necessary. The documentation also introduces interactive source code with links to documentation for C++ STL library functions used.
-Click on [Files menu](https://TheAlgorithms.github.io/C-Plus-Plus/files.html) to see the list of all the files documented with the code.
+[Online Documentation](https://TheAlgorithms.github.io/C-Plus-Plus) 直接根据仓库源代码生成。文档包含全部资源，包括源代码片段、程序运行说明、程序流程图示，以及必要时的外部资源链接。文档还提供交互式源代码，并附有所用 C++ STL 库函数的文档链接。
+点击 [Files menu](https://TheAlgorithms.github.io/C-Plus-Plus/files.html) 可查看所有已记录代码的文件列表。

-[Documentation of Algorithms in C++](https://thealgorithms.github.io/C-Plus-Plus) by [The Algorithms Contributors](https://github.com/TheAlgorithms/C-Plus-Plus/graphs/contributors) is licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)<br/>
+[Documentation of Algorithms in C++](https://thealgorithms.github.io/C-Plus-Plus) 由 [The Algorithms Contributors](https://github.com/TheAlgorithms/C-Plus-Plus/graphs/contributors) 编写，采用 [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)<br/>
 <a href="https://creativecommons.org/licenses/by-sa/4.0"><img alt="Creative Commons License" style="height:22px!important;margin-left: 3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/cc.svg" /><img  alt="Credit must be given to the creator" style="height:22px!important;margin-left: 3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/by.svg" /><img alt="Adaptations must be shared under the same terms" style="height:22px!important;margin-left: 3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/sa.svg" /></a>

-## Contributions
+## 贡献

-As a community developed and maintained repository, we welcome new un-plagiarized quality contributions. Please read our [Contribution Guidelines](https://github.com/TheAlgorithms/C-Plus-Plus/blob/master/CONTRIBUTING.md).
+作为由社区开发并维护的仓库，我们欢迎新的、未抄袭的优质贡献。请阅读我们的 [Contribution Guidelines](https://github.com/TheAlgorithms/C-Plus-Plus/blob/master/CONTRIBUTING.md).