From 2547ca8137fb42318e70e0f84b92c2e207c4bda5 Mon Sep 17 00:00:00 2001 From: JackBoosY <47264268+JackBoosY@users.noreply.github.com> Date: Tue, 8 Oct 2019 01:40:57 +0800 Subject: [PATCH] Add Chinese readme. (#8476) * add chinese readme. * fix format. --- README_zh_CN.md | 72 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 README_zh_CN.md diff --git a/README_zh_CN.md b/README_zh_CN.md new file mode 100644 index 000000000..ab53d7180 --- /dev/null +++ b/README_zh_CN.md @@ -0,0 +1,72 @@ +# Vcpkg + +## 概要 +Vcpkg 可帮助您在 Windows、Linux 和 MacOS 上管理 C 和 C++ 库。这个工具和生态系统正在不断发展,您的参与对它的成功至关重要! + +如需获取有关可用命令的简短描述, 请执行 `vcpkg help`。 + +## 快速开始 +需求: +- Windows 10、8.1、7、Linux、或 MacOS +- Visual Studio 2015 Update 3 或更新的版本 (Windows 中) +- Git +- *可选:* CMake 3.12.4 + +如何开始: +``` +> git clone https://github.com/Microsoft/vcpkg.git +> cd vcpkg + +PS> .\bootstrap-vcpkg.bat +Linux:~/$ ./bootstrap-vcpkg.sh +``` + +然后,[集成](docs/users/integration.md)至本机环境中,执行 (注意: 首次启动需要管理员权限) +``` +PS> .\vcpkg integrate install +Linux:~/$ ./vcpkg integrate install +``` + +使用以下命令安装任意包 +``` +PS> .\vcpkg install sdl2 curl +Linux:~/$ ./vcpkg install sdl2 curl +``` + +与CMake一起使用已安装库的最佳方法是通过工具链文件 `scripts\buildsystems\vcpkg.cmake`。要使用此文件,您只需将 `-DCMAKE_TOOLCHAIN_FILE=[vcpkg root]\scripts\buildsystems\vcpkg.cmake` 作为参数添加到CMake命令行中。 + +在Visual Studio中,您可以创建一个新项目(或打开一个已有项目)。所有已安装的库都可以使用 `#include` 在您的项目中使用,而无需进行其他配置。 + +若需获取更多信息,请查看[使用一个包](docs/examples/installing-and-using-packages.md)具体示例。 若您需要使用的库不在vcpkg中,请[在GitHub上创建一个issue](https://github.com/microsoft/vcpkg/issues) ,开发团队和贡献者会看到它,并有可能为此库创建端口文件。 + +有关 macOS 和 Linux 支持的其他说明,请参见[官方公告](https://blogs.msdn.microsoft.com/vcblog/2018/04/24/announcing-a-single-c-library-manager-for-linux-macos-and-windows-vcpkg/)。 + +## Tab补全/自动补全 +`vcpkg`支持在 Powershell 和 bash 中自动补全命令、程序包名称、选项等。如需启用自动补全功能,请使用以下命令: +``` +PS> .\vcpkg integrate powershell +Linux:~/$ ./vcpkg integrate bash +``` +并重启您的控制台。 + + +## 示例 +请查看[文档](docs/index.md)获取具体示例,其包含[安装并使用包](docs/examples/installing-and-using-packages.md),[使用压缩文件添加包](docs/examples/packaging-zipfiles.md),和[从GitHub源中添加一个包](docs/examples/packaging-github-repos.md)。 + +我们的文档现在也可以从[ReadTheDocs](https://vcpkg.readthedocs.io/)在线获取。 + +观看4分钟[demo视频](https://www.youtube.com/watch?v=y41WFKbQFTw)。 + +## 贡献者 +Vcpkg通过您的贡献不断发展。下面是一些您可以贡献的方式: + +* 创建一个关于vcpkg或已支持包的[新issue](https://github.com/Microsoft/vcpkg/issues) +* [创建修复PR和创建新包](https://github.com/Microsoft/vcpkg/pulls) + +请参阅我们的[贡献准则](CONTRIBUTING.md)了解更多详细信息。 + +该项目采用了[Microsoft开源行为准则](https://opensource.microsoft.com/codeofconduct/)。获取更多信息请查看 [行为准则FAQ](https://opensource.microsoft.com/codeofconduct/faq/)或联系[opencode@microsoft.com](mailto:opencode@microsoft.com)提出其他问题或意见。 + +## License + +使用的代码 License 为[MIT License](LICENSE.txt)。