Skip to content

Commit

Permalink
Several enhancements and bug fixes (krahets#981)
Browse files Browse the repository at this point in the history
* Update the installation section.

* Fix storage_pyramid.png

* Update the landing page.

* Update index.md

* Add download buttons to the landing page.

* Update the button style.

* Update .gitignore
  • Loading branch information
krahets authored Dec 6, 2023
1 parent 723af99 commit b10091c
Show file tree
Hide file tree
Showing 16 changed files with 215 additions and 120 deletions.
5 changes: 0 additions & 5 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,3 @@

# test script
test.sh

# overrides
overrides/partials/*
!overrides/partials/content.html
!overrides/partials/footer.html
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
42 changes: 25 additions & 17 deletions docs/chapter_appendix/installation.md
Original file line number Diff line number Diff line change
@@ -1,49 +1,57 @@
# 编程环境安装

### VSCode
## 安装 IDE

本书推荐使用开源、轻量的 VSCode 作为本地 IDE ,下载并安装 [VSCode](https://code.visualstudio.com/)
推荐使用开源、轻量的 VSCode 作为本地集成开发环境(IDE)。访问 [VSCode 官网](https://code.visualstudio.com/),根据操作系统选择相应版本的 VSCode 进行下载和安装

### Java 环境
![从官网下载 VSCode](installation.assets/vscode_installation.png)

1. 下载并安装 [OpenJDK](https://jdk.java.net/18/)(版本需满足 > JDK 9)。
2. 在 VSCode 的插件市场中搜索 `java` ,安装 Extension Pack for Java 。
VSCode 拥有强大的扩展包生态系统,支持大多数编程语言的运行和调试。以 Python 为例,安装“Python Extension Pack”扩展包之后,即可进行 Python 代码调试。安装步骤如下图所示。

### C/C++ 环境
![安装 VSCode 扩展包](installation.assets/vscode_extension_installation.png)

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) ,需要 Python 3.10 或更新版本。
2. 在 VSCode 的插件市场中搜索 `python` ,安装 Python Extension Pack 。
3. (可选)在命令行输入 `pip install black` ,安装代码格式化工具。

### Go 环境
### C/C++ 环境

1. 下载并安装 [go](https://go.dev/dl/)
2. 在 VSCode 的插件市场中搜索 `go` ,安装 Go
3. 按快捷键 `Ctrl + Shift + P` 呼出命令栏,输入 go ,选择 `Go: Install/Update Tools` ,全部勾选并安装即可
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 }`

### JavaScript 环境
### Java 环境

1. 下载并安装 [node.js](https://nodejs.org/en/)
2. 在 VSCode 的插件市场中搜索 `javascript` ,安装 JavaScript (ES6) code snippets 。
3. (可选)在 VSCode 的插件市场中搜索 `Prettier` ,安装代码格式化工具。
1. 下载并安装 [OpenJDK](https://jdk.java.net/18/)(版本需满足 > JDK 9)。
2. 在 VSCode 的插件市场中搜索 `java` ,安装 Extension Pack for Java 。

### C# 环境

1. 下载并安装 [.Net 8.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))。

### Go 环境

1. 下载并安装 [go](https://go.dev/dl/)
2. 在 VSCode 的插件市场中搜索 `go` ,安装 Go 。
3. 按快捷键 `Ctrl + Shift + P` 呼出命令栏,输入 go ,选择 `Go: Install/Update Tools` ,全部勾选并安装即可。

### 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)

### JavaScript 环境

1. 下载并安装 [node.js](https://nodejs.org/en/)
2. 在 VSCode 的插件市场中搜索 `javascript` ,安装 JavaScript (ES6) code snippets 。
3. (可选)在 VSCode 的插件市场中搜索 `Prettier` ,安装代码格式化工具。

### Dart 环境

1. 下载并安装 [Dart](https://dart.dev/get-dart)
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/index.assets/btn_download_pdf.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/index.assets/btn_download_pdf_dark.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/index.assets/btn_read_online.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit b10091c

Please sign in to comment.