mirror of
https://github.com/krahets/hello-algo.git
synced 2025-07-05 13:15:30 +08:00
Move docs/* to docs/zh/*
This commit is contained in:
Binary file not shown.
Before Width: | Height: | Size: 215 KiB |
@ -1,47 +0,0 @@
|
||||
# 一起参与创作
|
||||
|
||||
由于作者能力有限,书中难免存在一些遗漏和错误,请您谅解。如果您发现了笔误、失效链接、内容缺失、文字歧义、解释不清晰或行文结构不合理等问题,请协助我们进行修正,以给读者提供更优质的学习资源。
|
||||
|
||||
所有[撰稿人](https://github.com/krahets/hello-algo/graphs/contributors)的 GitHub ID 将被展示在本书的仓库主页上,以感谢他们对开源社区的无私奉献。
|
||||
|
||||
!!! success "开源的魅力"
|
||||
|
||||
纸质书籍的两次印刷的间隔时间往往需要数年,内容更新非常不方便。
|
||||
|
||||
然而在本开源书中,内容更迭的时间被缩短至数日甚至几个小时。
|
||||
|
||||
### 内容微调
|
||||
|
||||
如下图所示,每个页面的右上角都有“编辑图标”。您可以按照以下步骤修改文本或代码。
|
||||
|
||||
1. 点击“编辑图标”,如果遇到“需要 Fork 此仓库”的提示,请同意该操作。
|
||||
2. 修改 Markdown 源文件内容,检查内容的正确性,并尽量保持排版格式的统一。
|
||||
3. 在页面底部填写修改说明,然后点击“Propose file change”按钮。页面跳转后,点击“Create pull request”按钮即可发起拉取请求。
|
||||
|
||||

|
||||
|
||||
图片无法直接修改,需要通过新建 [Issue](https://github.com/krahets/hello-algo/issues) 或评论留言来描述问题,我们会尽快重新绘制并替换图片。
|
||||
|
||||
### 内容创作
|
||||
|
||||
如果您有兴趣参与此开源项目,包括将代码翻译成其他编程语言、扩展文章内容等,那么需要实施以下 Pull Request 工作流程。
|
||||
|
||||
1. 登录 GitHub ,将[本仓库](https://github.com/krahets/hello-algo) Fork 到个人账号下。
|
||||
2. 进入您的 Fork 仓库网页,使用 `git clone` 命令将仓库克隆至本地。
|
||||
3. 在本地进行内容创作,并进行完整测试,验证代码的正确性。
|
||||
4. 将本地所做更改 Commit ,然后 Push 至远程仓库。
|
||||
5. 刷新仓库网页,点击“Create pull request”按钮即可发起拉取请求。
|
||||
|
||||
### Docker 部署
|
||||
|
||||
在 `hello-algo` 根目录下,执行以下 Docker 脚本,即可在 `http://localhost:8000` 访问本项目。
|
||||
|
||||
```shell
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
使用以下命令即可删除部署。
|
||||
|
||||
```shell
|
||||
docker-compose down
|
||||
```
|
@ -1,7 +0,0 @@
|
||||
# 附录
|
||||
|
||||
<div class="center-table" markdown>
|
||||
|
||||
{ width="600" }
|
||||
|
||||
</div>
|
@ -1,55 +0,0 @@
|
||||
# 编程环境安装
|
||||
|
||||
### VSCode
|
||||
|
||||
本书推荐使用开源轻量的 VSCode 作为本地 IDE ,下载并安装 [VSCode](https://code.visualstudio.com/) 。
|
||||
|
||||
### Java 环境
|
||||
|
||||
1. 下载并安装 [OpenJDK](https://jdk.java.net/18/)(版本需满足 > JDK 9)。
|
||||
2. 在 VSCode 的插件市场中搜索 `java` ,安装 Extension Pack for Java 。
|
||||
|
||||
### C/C++ 环境
|
||||
|
||||
1. Windows 系统需要安装 [MinGW](https://sourceforge.net/projects/mingw-w64/files/)([配置教程](https://blog.csdn.net/qq_33698226/article/details/129031241)),MacOS 自带 Clang 无须安装。
|
||||
2. 在 VSCode 的插件市场中搜索 `c++` ,安装 C/C++ Extension Pack 。
|
||||
3. (可选)打开 Settings 页面,搜索 `Clang_format_fallback Style` 代码格式化选项,设置为 `{ BasedOnStyle: Microsoft, BreakBeforeBraces: Attach }` 。
|
||||
|
||||
### Python 环境
|
||||
|
||||
1. 下载并安装 [Miniconda3](https://docs.conda.io/en/latest/miniconda.html) 。
|
||||
2. 在 VSCode 的插件市场中搜索 `python` ,安装 Python Extension Pack 。
|
||||
3. (可选)在命令行输入 `pip install black` ,安装代码格式化工具。
|
||||
|
||||
### Go 环境
|
||||
|
||||
1. 下载并安装 [go](https://go.dev/dl/) 。
|
||||
2. 在 VSCode 的插件市场中搜索 `go` ,安装 Go 。
|
||||
3. 快捷键 `Ctrl + Shift + P` 呼出命令栏,输入 go ,选择 `Go: Install/Update Tools` ,全部勾选并安装即可。
|
||||
|
||||
### JavaScript 环境
|
||||
|
||||
1. 下载并安装 [node.js](https://nodejs.org/en/) 。
|
||||
2. 在 VSCode 的插件市场中搜索 `javascript` ,安装 JavaScript (ES6) code snippets 。
|
||||
3. (可选)在 VSCode 的插件市场中搜索 `Prettier` ,安装代码格式化工具。
|
||||
|
||||
### C# 环境
|
||||
|
||||
1. 下载并安装 [.Net 6.0](https://dotnet.microsoft.com/en-us/download) 。
|
||||
2. 在 VSCode 的插件市场中搜索 `C# Dev Kit` ,安装 C# Dev Kit ([配置教程](https://code.visualstudio.com/docs/csharp/get-started))。
|
||||
3. 也可使用 Visual Studio([安装教程](https://learn.microsoft.com/zh-cn/visualstudio/install/install-visual-studio?view=vs-2022))。
|
||||
|
||||
### Swift 环境
|
||||
|
||||
1. 下载并安装 [Swift](https://www.swift.org/download/) 。
|
||||
2. 在 VSCode 的插件市场中搜索 `swift` ,安装 [Swift for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=sswg.swift-lang) 。
|
||||
|
||||
### Dart 环境
|
||||
|
||||
1. 下载并安装 [Dart](https://dart.dev/get-dart) 。
|
||||
2. 在 VSCode 的插件市场中搜索 `dart` ,安装 [Dart](https://marketplace.visualstudio.com/items?itemName=Dart-Code.dart-code) 。
|
||||
|
||||
### Rust 环境
|
||||
|
||||
1. 下载并安装 [Rust](https://www.rust-lang.org/tools/install) 。
|
||||
2. 在 VSCode 的插件市场中搜索 `rust` ,安装 [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer) 。
|
Reference in New Issue
Block a user