chore: use idoc build website.

Author: jaywcjlove

.gitignore

@@ -1,3 +1,7 @@
+dist
+node_modules
+package-lock.json
+
 # Prerequisites
 *.d
 

README.md

@@ -1,156 +1,55 @@
-Beginning C
----
-
-C 语言是一种功能强大、简洁的计算机语言，通过它可以编写程序，指挥计算机完成指定任务。
-
-目录
+C Tutorial
 ===
 
-- [创建第一个程序](#创建第一个程序)
-- [编译源码](#编译源码)
-- [添加注释](#添加注释)
-- [使用变量](#使用变量)
-- [使用多个变量](#使用多个变量)
-- [简单的计算](#简单的计算)
-- [计算吃饼干](#计算吃饼干)
-- [有浮点值的除法](#有浮点值的除法)
-
-## 创建第一个程序
-
-```c
-int main(void)
-{
-  printf("Hello world!");
-  return 0;
-}
-```
-
-将上面代码保存为 [`hello.c`](example/hello.c)
-
-## 编译源码
-
-```bash
-$ gcc -o hello hello.c
-$ ./hello
-Hello World
-```
-
-## 添加注释
-
-```c
-/**
- * Written byu Kenny Wong
- * Copyright 2019
-*/
-
-#include <stdio.h>
-
-// 每个程序总是从 main 这个函数开始执行
-int main()
-{
-  printf("Hello world!"); // 这里是单行注释输出日志
-  return 0;               // main 函数 返回了个 0，表示正常终止程序，非 0 表示异常
-}
-```
-
-## [使用变量](example/using_a_variable.c)
-
-```c
-#include <stdio.h>
-
-int main(void)
-{
-  int salary;     // 声明一个名为 salary 的变量
-  salary = 10000; // 将 10000 存储在 salary 中
-  printf("My salary is %d.\n", salary);
-  return 0;
-}
-```
-
-## [使用多个变量](example/using_more_variables.c)
-
-```c
-#include <stdio.h>
-
-int main(void)
-{
-  int brothers; // 声明一个名为 brothers 的变量
-  int brides;   // 和一个叫做 brides 的变量
-
-  brothers = 7; // 将 7 存储在变量 brothers 中
-  brides = 7;   // 将 7 存储在变量 brides 中
-
-  // 输出变量内容
-  printf("%d brides for %d brothers\n", brides, brothers);
-  return 0;
-}
-```
-
-## [简单的计算](example/simple_calculations.c)
-
-```c
-#include <stdio.h>
-
-int main(void)
-{
-  int total_pets;
-  int cats;
-  int dogs;
-  int ponies;
-  int others;
+C 语言是一种功能强大、简洁的计算机语言，通过它可以编写程序，指挥计算机完成指定任务。
 
-  // 设置每种宠物的数量
-  cats = 2;
-  dogs = 1;
-  ponies = 1;
-  others = 46;
+## 什么是C？
 
-  // 计算宠物总数
-  total_pets = cats + dogs + ponies + others;
+C 是 Dennis Ritchie (丹尼斯·里奇) 和 Brian Kernighan (布莱恩·柯林汉) 于 1972 年在贝尔实验室创建的通用编程语言。
 
-  printf("我们共有 %d 只宠物!\n", total_pets); // 输出结果
-  return 0;
-}
-```
+这是一种非常流行的语言，尽管它很古老。
 
-## [计算吃饼干](example/calculations_with_cookies.c)
+C 与 UNIX 密切相关，因为它是为编写 UNIX 操作系统而开发的。
 
-```c
-#include <stdio.h>
+## 为什么要学习 C？
 
-int main(void)
-{
-  int cookies = 5;           // 饼干总数
-  int cookie_calories = 125; // 每卡路里需要的饼干
-  int total_eaten = 0;       // 吃饼干总数
+- 它是世界上最流行的编程语言之一
+- 如果你懂 C，那么你学习其他流行的编程语言，如 Java、Python、C++、C# 等也没有问题，因为语法相似
+- 与其他编程语言（如 Java 和 Python）相比，C 非常快
+- C是非常通用的； 它可以用于应用程序和技术
 
-  int eaten = 2;             // 要吃的数量
-  cookies = cookies - eaten; // 减去吃掉饼干，获取剩下的饼干
-  total_eaten = total_eaten + eaten;
-  printf("\n我吃了 %d 个饼干。 剩下 %d 个饼干。", eaten, cookies);
+## C 和 C++ 之间的区别
 
-  eaten = 3;                 // 吃掉饼干的新值，重新赋值
-  cookies = cookies - eaten; // 减去吃掉饼干，获取剩下的饼干
-  total_eaten = total_eaten + eaten;
-  printf("\n我又吃了 %d 个。 现在剩下 %d 个饼干。\n", eaten, cookies);
-  printf("\n消耗的总能量为 %d 卡路里。\n", total_eaten * cookie_calories);
-  return 0;
-}
-```
+C++ 是作为 C 的扩展开发的，两种语言的语法几乎相同
+C 和 C++ 的主要区别在于 C++ 支持类和对象，而 C 不支持
 
-## [有浮点值的除法](example/division_with_float_values.c)
+<!--idoc:ignore:start-->
 
-```c
-#include <stdio.h>
+## 学习目录
 
-int main(void)
-{
-  float plank_length = 10.0f; // 长度
-  float piece_count = 4.0f;   // 多少块
-  float piece_length = 0.0f;  // 每块的长度
+- [C 开始 Get Started](docs/c_getstarted.md)
+- [C 语法 Syntax](docs/c_syntax.md)
+- [C 输出（打印文本）Output](docs/c_output.md)
+- [C 注释 Comments](docs/c_comments.md)
+- [C 变量 Variables](docs/c_variables.md)
+- [C Data Types](docs/c_data_types.md)
+- [C Constants](docs/c_constants.md)
+- [C Operators](docs/c_operators.md)
+- [C If...Else](docs/c_conditions.md)
+- [C Switch](docs/c_switch.md)
+- [C While Loop](docs/c_while_loop.md)
+- [C For Loop](docs/c_for_loop.md)
+- [C Break/Continue](docs/c_break_continue.md)
+- [C Arrays](docs/c_arrays.md)
+- [C Strings](docs/c_strings.md)
+- [C 用户输入 User Input](docs/c_user_input.md)
+- [C Memory Address](docs/c_memory_address.md)
+- [C Pointers](docs/c_pointers.md)
+- [C Functions](docs/c_functions.md)
+- [C Function Parameters](docs/c_functions_parameters.md)
+- [C Function Declaration](docs/c_functions_decl.md)
+- [C Recursion](docs/c_functions_recursion.md)
+- [C Math Functions](docs/c_math.md)
+- [C Structures](docs/c_structs.md)
 
-  piece_length = plank_length / piece_count;
-  printf("一块 %f 英尺长的木板可以切成 %f 块 %f 英尺长。\n", plank_length, piece_count, piece_length);
-  return 0;
-}
-```
+<!--idoc:ignore:end-->

assets/editer-01.png

@@ -0,0 +1,44 @@
+C 注释 Comments
+===
+
+注释可用于解释代码，并使其更具可读性。它还可用于在测试替代代码时阻止执行。
+
+注释可以是单行或多行的。
+
+## 单行注释
+
+单行注释以两个正斜杠 (`//`) 开头。
+
+`//` 和行尾之间的任何文本都会被编译器忽略（不会被执行）。
+
+此示例在一行代码之前使用单行注释：
+
+```c
+// 这是一个注释
+printf("Hello World!");
+```
+
+此示例在代码行末尾使用单行注释：
+
+```c
+printf("Hello World!"); // 这是一个注释
+```
+
+## 多行注释
+
+多行注释以 `/*` 开头，以 `*/` 结尾。
+
+`/*` 和 `*/` 之间的任何文本都将被编译器忽略：
+
+
+```c
+/* 下面的代码将打印出 Hello World!
+到屏幕上，真是太棒了 */
+printf("Hello World!");
+```
+
+## 单行注释还是多行注释？
+
+您要使用哪个取决于您。 通常，我们使用 `//` 表示简短的注释，使用 `/*` `*/` 表示较长的注释。
+
+很高兴知道：在 C99 版本（1999 年发布）之前，您只能在 `C` 中使用多行注释。

assets/editer-runcode.png

@@ -0,0 +1,120 @@
+开始使用 C
+===
+
+要开始使用 C，您需要做两件事：
+
+- 用于编写 C 代码的文本编辑器，如记事本
+- 编译器，如 GCC，将 C 代码翻译成计算机可以理解的语言
+
+有许多文本编辑器和编译器可供选择。 我们介绍几种编辑器和编译环境（见下文）。
+
+注意 ⚠️ ：Linux 和 Mac 系统可以直接安装 GCC，Windows 系统可以安装 MinGW。
+
+## 编辑器
+
+### Visual Studio Code
+
+[![VSCode 下载安装地址](../assets/editer-01.png)](https://code.visualstudio.com)
+
+VSCode 下载安装地址：https://code.visualstudio.com
+
+下载安装好 [VSCode](https://code.visualstudio.com) 后，我们需要安装下面两个插件更方便的支持 C 语言环境。
+
+- [C/C++ Extension Pack](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools-extension-pack)
+- [Code Runner](https://marketplace.visualstudio.com/items?itemName=formulahendry.code-runner)
+
+### Sublime Text 3
+
+[![Sublime Text 下载安装地址](../assets/sublime-01.png)](https://www.sublimetext.com)
+
+Sublime Text 下载安装地址：https://www.sublimetext.com
+
+## C 快速入门
+
+如果您不理解下面的代码，请不要担心 —— 我们将在后面的章节中详细讨论。 现在，专注于如何运行代码。
+
+### 创建第一个程序
+
+让我们创建我们的第一个 C 文件。
+
+打开编辑器选择菜单 `File` > `New File` 创建一个空的文本文件。
+
+编写以下 C 代码并将文件另存为 `hello.c`（`File` > `Save As`）：
+
+```c
+#include <stdio.h>
+
+int main() {
+  printf("Hello World!");
+  return 0;
+}
+```
+
+### 编辑器编译运行
+
+在 [Visual Studio Code](https://code.visualstudio.com) 中，它应该如下所示：
+
+![](../assets/editer-runcode.png)
+
+然后，点击 `Run Code` 以运行（执行）程序。 结果看起来像这样：
+
+```bash
+[Running] cd "/Users/c-tutorial/example/" && gcc hello.c -o hello && "/Users/c-tutorial/example/"hello
+Hello world!
+[Done] exited with code=0 in 4.016 seconds
+```
+
+在 Sublime Text 3 中，运行比较简单，打开 `hello.c` 文件，`Tool` > `Build` 选择 `C Single File - Run`，它应该如下所示：
+
+[![Sublime Text 下载安装地址](../assets/sublime-02.png)](https://www.sublimetext.com)
+
+### 命令行编译运行
+
+通过命令行进入 `hello.c` 所在目录
+
+```bash
+cd /Users/c-tutorial/example
+```
+
+使用 `gcc` 编译 `hello.c` 文件，
+
+```bash
+$ gcc -o hello hello.c
+```
+
+运行成功之后会在当前目录下看到 hello 文件，直接在命令后输入 `./hello` 命令，您将得到如下输出结果：
+
+```bash
+Hello World
+```
+
+### Docker 运行环境
+
+可以简单用 Docker 来安装编译环境，这样在 Windows、MacOS、Linux 下都可以拥有完全相同的编译环境。
+
+镜像基于 Alpine Linux 镜像，只有 5MB 镜像，并且包含 C/C++ 编译器（gcc/g++ 包）
+
+1) 安装 Docker
+2) 使用 docker pull 命令
+    ```bash
+    docker pull frolvlad/alpine-gxx
+    ```
+3) 创建 Dockerfile 文件
+    ```docker
+    FROM alpine:3.14
+    RUN apk add --no-cache gcc musl-dev
+    RUN apk add --no-cache g++
+    ```
+4) 生成本地镜像
+    ```bash
+    docker build -t myalpine .
+    ```
+5) 运行映像，把当前路径（$PWD）映射至容器的 /test 目录，用 gcc 编译程序，exit返回：
+    ```shell
+    docker run -it -v$PWD:/test myalpine
+    root@b1a38bd7107a:/# cd test
+    root@b1a38bd7107a:/test# gcc -o hello hello.c
+    Hello World
+    root@b1a38bd7107a:/test# exit
+    exit
+    ```