translate: tools/index.md + tools/editor/*

docs/tools/editor/geany.md

@@ -2,93 +2,93 @@ author: xingjiapeng, MingqiHuang
 
 # Geany
 
-Geany 是一个轻量、便捷的编辑器，对于 Linux 环境下的初学者较为友好。
+Geany is a lightweight, easy-to-use text editor. It is friendly for beginners in Linux environment.
 
-与 Dev-C++ 一样，它可以编译运行单个文件。
+Like Dev-C++, it supports single file compilation.
 
-不过，它可以在 Linux/Windows/macOS 下运行。
+However, it is compatible in Linux, Windows and macOS.
 
-其官网为：<https://geany.org/>
+The homepage of Geany is <https://geany.org/>
 
-## 优缺点
+## Pros & Cons
 
-### 优点
+### Pros
 
-1. 轻量；
-2. 可以编译运行单个文件；
-3. 不需要太多配置；
-4. 跨平台。
+1. Lightweight;
+2. Support for single file compilation;
+3. No much need to configure;
+4. Cross-platform.
 
-### 缺点
+### Cons
 
-1. 没有太多人使用；
-2. 在 macOS Catalina 下有一些权限问题[^1]；
-3. 新建文件时，默认不会有语法高亮，需要手动切换文件类型。
+1. Not many users;
+2. An access control issue was reported in macOS Catalina [^1].
+3. No syntax highlighting by default when creating a new document. You may need to manually set filetype.
 
-## 安装
+## Installation
 
 ### Windows/macOS
 
-在官网上下载安装包安装
+It is simple - just download installer from its official site and install it.
 
 ### Linux
 
-#### 方法一
+#### Using Package Manager
 
-使用包管理器进行安装，如在 Ubuntu 或 NOI Linux 中，运行
+Linux users can install Geany via package managers. For example, in debian-based distributions like Ubuntu or NOI Linux, run the following command and it will be automatically installed:
 
 ```bash
 sudo apt install geany
 ```
 
-#### 方法二
+#### Build from Source
 
-1. 从官网下载源码
-2. 终端下运行：
+1. Obtain sources from its repository or homesite
+2. Run the following commands in terminal:
 
 ```bash
 ./configure
 make
 sudo make install
 ```
 
-如遇到 `No package 'gtk+-2.0' found` 可能需要安装 `libgtk2.0-dev`。
+Note: you may need install a dependency `libgtk2.0-dev` if it reports `No package 'gtk+-2.0' found`.
 
-## 使用技巧
+## Skills
 
-### 切换文件类型
+### Switch filetype
 
-在*文档 -> 设置文件类型*中进行切换。
+Click `Document -> Set Filetype` to switch filetype.
 
-如 C++ 语言，点击*文档 -> 设置文件类型 -> 编程语言 -> C++ 源文件*，即可看到文件已被转换为 C++ 语言的语法高亮了。
+For example, click `Document -> Set Filetype -> Programming Source -> C++ Source`, and you will see its syntax highlighting has been converted to C++.
 
-### 设置文件模板
+### Set File Template
 
-在配置文件目录下建立 templates/files 文件夹，建立在其中的文件即为模板文件，再次打开 Geany，就可以在*文件 -> 从模板新建*中找到它了。
+Create a new folder `templates/files` under configuration directory, where files inside are template files. Restart Geany, and you will find `File -> New (With Template)` in menubar.
 
-配置文件目录可以通过*帮助 -> 调试信息*的第二、三行找出。
+The current configuration file path can be found in the second and third line of `Help -> Debug Message`.
 
-这里给出 macOS 和 Linux 下的默认模板配置文件目录：
+The following is default configuration file path of templates for macOS and Linux:
 
-- 系统目录：`/usr/share/geany/templates/files/`
-- 用户目录：`~/.config/geany/templates/files/`[^2]
+- System-wide directory: `/usr/share/geany/templates/files/`
+- User directory: `~/.config/geany/templates/files/`[^2]
 
-## 常见问题
+## Troubleshoot
 
-### 兼容深度终端
+### Compatibility with Deepin Terminal
 
-在*首选项 -> 工具 -> 虚拟终端*，修改终端的命令为：
+In `Edit -> Preferences -> Tools -> Terminal`, replace it with the following command:
 
 ```bash
 deepin-terminal -x "/bin/sh" %c
 ```
 
-点击“应用”按钮即可。[^3]
+And click `Apply` to apply changes.
 
-## 参考资料与注释
+## References & Footnotes
 
-[^1]: 详见：<https://github.com/geany/geany/issues/2344>
+[^1]: <https://github.com/geany/geany/issues/2344>
 
-[^2]: 来源：<https://wiki.geany.org/config/templates>
+[^2]: <https://wiki.geany.org/config/templates>
 
-[^3]: 来源：Deepin Wiki <https://wiki.deepin.org/>
+[^3]: Deepin Wiki <https://wiki.deepin.org/>

docs/tools/editor/vscode.md

@@ -1,79 +1,129 @@
-author: NachtgeistW, Ir1d, ouuan, Enter-tainer, Xeonacid, ChungZH, keepthethink, abc1763613206, partychicken, Chrogeek, xkww3n
+author: NachtgeistW, Ir1d, ouuan, Enter-tainer, Xeonacid, ChungZH, keepthethink, abc1763613206, partychicken, Chrogeek, xkww3n, 
 
-## 简介
+Last translated on September 16th, 2021, with commit [353b1f6](https://github.com/OI-wiki/OI-wiki/commit/353b1f64c8a2c756695bb5e99f036d1e80819dbe)
 
-Visual Studio Code（以下简称 VS Code) 是一个由微软开发，同时支持 Windows、Linux 和 macOS 等操作系统且开放源代码的代码编辑器。它是用 TypeScript 编写的，并且采用 Electron 架构。它带有对 JavaScript、TypeScript 和 Node.js 的内置支持，并为其他语言（如 C、C++、Java、Python、PHP、Go）提供了丰富的扩展生态系统。
+## Introduction
 
-官网：[Visual Studio Code - Code Editing. Redefined](https://code.visualstudio.com/)
+Visual Studio Code, or VS Code, is an open-source code editor developed by Microsoft, supporting Windows, Linux and macOS. VS Code is written in TypeScript, and based on Electron framework. It bundled with built-in support for JavaScript, TypeScript and Node.js, and provides a rich ecosystem of extensions for other language like C, C++, Java, Python, PHP and Go.
 
-## 使用 Code Runner 插件运行代码
+Official site: [Visual Studio Code - Code Editing. Redefined](https://code.visualstudio.com/)
 
-VS Code 安装并配置插件后可实现对 C/C++ 的支持，但配置过程比较复杂。一个简单的编译与运行 C++ 程序的方案是安装 Code Runner 插件。
+## Execute Code Using Code Runner
 
-Code Runner 是一个可以一键运行代码的插件，在工程上一般用来验证代码片段，支持 Node.js、Python、C、C++、Java、PHP、Perl、Ruby、Go 等 40 多种语言。
+After installing and configuring extensions, VS Code will have support for C/C++. However the process is complicated. A simple solution to compile and run C++ programs is to install Code Runner extension.
 
-安装的方式是在插件商店搜索 Code Runner 并点击 Install；或者前往 [Marketplace](https://marketplace.visualstudio.com/items?itemName=formulahendry.code-runner) 并点击 Install，浏览器会自动打开 VS Code 并进行安装。
+Code Runner is an extension that allows one to run code in one click. In projects it is often used to verify code _____. It supports over 40 programming languages including Node.js, Python, C, C++, Java, PHP, Perl, Ruby and Go.
+
+On installing method is to search Code Runner in extension marketplace and click Install; Another is go to [Marketplace](https://marketplace.visualstudio.com/items?itemName=formulahendry.code-runner) and click Install, then the browser will call VS Code automatically and start installation.
 
 ![](./images/vscode-1.jpg)
 
-安装完成后，打开需要运行的文件，点击右上角的小三角图标即可运行代码；按下快捷键<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>N</kbd>（在 macOS 下是<kbd>Control</kbd>+<kbd>Option</kbd>+<kbd>N</kbd>）也可以得到同样的效果。
+After finishing installation, open file that need to be run, click the upper-right little triangle icon to run code. Pressing shortcut key <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>N</kbd>(or, for macOS, <kbd>Control</kbd>+<kbd>Option</kbd>+<kbd>N</kbd>) will do the same
 
 ???+ warning
-    如果安装了 VS Code 与 Code Runner 后，代码仍然无法运行，很有可能是因为系统尚未安装 C/C++ 的运行环境，参考 [Hello, World! 页面](../../lang/helloworld.md) 以安装。
-    
-    记得勾选设置中的 Run In Terminal 选项，如图：![](./images/vscode-7.png)
+    If code is still unable to run after install VS Code and Code Runner, it it probably because of the lack of C/C++ running environment in the operating system. For installation of environment please refer to Hello, World!](../../lang/helloworld.md).
+
+    Remember to toggle on Run In Terminal in preferences as the following image: ![](./images/vscode-7.png)
 
-## 使用 C/C++ 插件编译并调试
+## Compile and Debug using C/C++ extensions
 
-### 安装插件
+### Installation
 
-在 VS Code 中打开插件商店，在搜索栏中输入 `C++` 或者 `@category:"programming languages"`，然后找到 C/C++，点击 Install 安装插件。
+Open extension store in VS Code, type `C++` or `@category:"programming languages"`, and find C/C++, and press Install to install it.
 
 ![](./images/vscode-2.png)
 
 ???+ warning
-    在配置前，请确保系统已经安装了 G++ 或 Clang，并已添加到了 `PATH` 中。请使用 CMD 或者 PowerShell，而不是 Git Bash 作为集成终端。
+    Before continue to config, please make sure the that system has installed a C++ or Clang, and has added them to `$PATH`. Please use CMD or Powershell instead of Git Bash.
 
-### 配置编译
+### Configuring Compilation
 
-首先用 VS Code 打开一个文件夹，然后按下<kbd>F1</kbd>，输入 `C/C++: Edit configurations (UI)`，进入 C/C++ 插件的设置界面。
+First, open a folder in VS Code, and then press <kbd>F1</kbd>, type `C/C++: Edit configurations (UI)` and enter the configuration page of C/C++ extension.
 
 ![vscode-3](images/vscode-3.png)
 
-在“编译器路径”中选择 G++ 或 Clang 的所在路径。如果没有可选项，请检查编译器所在路径是否添加到了操作系统的 `PATH` 变量中。
+Choose the path where G++ or Clang located in Compiler Path. re-check whether the path of compiler has been added to `PATH` environment variable of operating system if there is nothing to choose.
 
-### 配置 IntelliSense
+### Configuring IntelliSense
 
-用于调整 VS Code 的智能补全。
+This section is talking about adjusting smart auto-completion of VS Code.
 
-如果你使用 Clang 编译器，在“IntelliSense 模式”中选择 `clang-x64` 而非默认的 `msvc-x64`；如果你使用 G++ 编译器，选择 `gcc-x64` 以使用自动补全等功能。否则会得到“IntelliSense 模式 msvc-x64 与编译器路径不兼容。”的错误。
+If you are using Clang as compiler, remember to choose `clang-x64` instead of default `msvc-x64`, or for G++ compiler users, choose `gcc-x64`, to enable features like auto-completion. Otherwise you will encounter an error "Intellisense mode msvc-x64 is incompatible with compiler path".
 
 ![](images/vscode-4.png)
 
-### 配置 GDB/LLDB 调试器
+### Configure GDB/LLDB Debuggers
 
-在 VS Code 中新建一份 C++ 代码文件，按照 C++ 语法写入一些内容（如 `int main(){}`），保存并按下<kbd>F5</kbd>，进入调试模式。
-如果出现了“选择环境”的提示，选择“C++ (GDB/LLDB)”。在“选择配置”中，G++ 用户选择 `g++.exe - 生成和调试活动文件`；Clang 用户选择 `clang++ - 生成和调试活动文件`。
+To enter debugging mode, create a new C++ file in VS Code and write something in C++ grammar, press <kbd>F5</kbd> after saving file. If a **choose environment** dialog pops up, select **C++ (GDB/LLDB)** and choose **g++ - Build and debug active file** for G++ users, or **clang++ - Build and debug active file** for Clang users.
 
 ???+ warning
-    配置名称并非固定，而是可以自定义的。不同的操作系统可能具有不同的配置名称。
+    The configuration name is customizable. It may differ in different operating systems.
 
-完成后，VS Code 将自动完成初始化操作并弹出一个 `launch.json` 配置文件。关闭它。
+Then, VS Code will finish initialization automatically and open a `launch.json` configuration file. Ignore and close it.
 
-至此，所有的配置流程已经完毕。再次按下<kbd>F5</kbd>即可看到软件下方的调试信息。
+At this point, all configuration processes have been completed. Press <kbd>F5</kbd> again and you will see debugging informations.
 
-若要在以后使用 VS Code 编译并调试代码，所有的源代码都需要保存至这个文件夹内。若要编译并调试其他文件夹中存放的代码，需要重新执行上述步骤（或将旧文件夹内的 `.vscode` 子文件夹复制到新文件夹内）。
+All files needed to be compiled and debugged are required to be saved in this folder in the future. If you need to compile and debug codes in other folders, you need to perform above steps again, or copy `.vscode` sub-folder in original folder to new folder.
 
-### 开始调试代码
+### Debugging Code
 
-使用 VS Code 打开一份代码，将鼠标悬停在行数左侧的空白区域，并单击出现的红点即可为该行代码设置断点。再次单击可取消设置断点。
+To set a breakpoint on a certain row, open a code in VS Code, hover the cursor over the blank space to the left of the row number, and click the appeared red point. Re-click it will cancel the breakpoint.
 
-![](images/vscode-5.gif)
+![](images/vscode-5.apng)
 
-按下<kbd>F5</kbd>进入调试模式，编辑器上方会出现一个调试工具栏，四个蓝色按钮从左至右分别代表 GDB 中的 `continue`,`next`,`step` 和 `until`：
+Press <kbd>F5</kbd> to enter debug mode, where a debug toolbar will appear on the upper of editor. The four blue buttons represent `continue`, `next`, `step` and `until` in GDB from left to right.
 
 ![](images/vscode-6.png)
 
-如果编辑器未自动跳转，点击左侧工具栏中的“调试”图标进入调试窗口，即可在左侧看到变量的值。
+In case that the editor doesn't redirect automatically, you can enter debugging window by clicking `Run and Debug` in the left toolbar. Then values of variables will appear.
+
+
+In debugging mode, the code editor will 
+display codes that will be executed next in yellow background.
+
+## Configure clangd
+
+???+ warning
+    Because of conflict, IntelliSense from C/C++ extension will be automatically disabled. (Some features like debugging still use C/C++.)  If encountering problems of clangd's features, you may want to check whether IntelliSense from C/C++ is disabled.
+
+### Introduction
+
+From LLVM official site
+
+> Clangd is an implementation of the Language Server Protocol leveraging Clang. Clangd’s goal is to provide language“smartness”features like code completion, find references, etc. for clients such as C/C++ Editors.
+
+Briefly talking, clangd provides some smart features like project-wide indexing, cross-references, variables renaming, faster auto-completion, errors and warnings and formatting. Though is is officially described as an implementation of LSP protocol, its functions are more similar to a language server than a protocol itself.
+
+VS Code's C/C++ extension also has features like auto-completion. However, comparing with clangd, it is inferior in accuracy of the legibility of the prompt information, etc. Therefore, we may sometimes use clangd instead of the C/C++ plugin to implement features such as code auto-completion.
+
+### Installation
+
+Linux users can use package manager to install clangd. Detailed operations are similar.
+
+```bash
+# Ubuntu/Debian
+sudo apt install clangd 
+```
+
+For some distribution, it only requires clang as it is included.
+
+```bash
+# Arch/Manjaro
+sudo pacman -S clang
+```
+
+MacOS users are required to install LLVM via Homebrew, as LLVM from built-in XcodeCommandLineTools doesn't include clangd. 
+
+```bash
+brew install llvm
+```
+
+Windows users can obtain binary installer from [LLVM Download Page](https://releases.llvm.org/download.html).
+
+### VS Code Extension
+
+Open VS Code extension market, type `clang` in search bar and install it.
+
+![](images/vscode-8.png)
 
-在调试模式中，编辑器将以黄色底色显示下一步将要执行的代码。
+Now, enjoy coding with features like auto-completion from clangd!