noHome (#29)

course/.vitepress/config.mts

@@ -1,7 +1,5 @@
 import { defineConfig } from "vitepress";
-import sidebar from "./sidebar";
-import nav from "./nav";
-import socialLinks from "./socialLinks";
+import themeConfig from "./themeConfig";
 
 export default defineConfig({
   lang: "zh-CN",
@@ -12,35 +10,5 @@ export default defineConfig({
   },
   base: "/zig-course/",
   lastUpdated: true,
-  themeConfig: {
-    editLink: {
-      pattern: "https://github.com/zigcc/zig-course/tree/main/learn/:path",
-    },
-    search: {
-      provider: "local",
-      options: {
-        locales: {
-          root: {
-            translations: {
-              button: {
-                buttonText: "搜索文档",
-                buttonAriaLabel: "搜索文档",
-              },
-              modal: {
-                noResultsText: "无法找到相关结果",
-                resetButtonTitle: "清除查询条件",
-                footer: {
-                  selectText: "选择",
-                  navigateText: "切换",
-                },
-              },
-            },
-          },
-        },
-      },
-    },
-    nav: nav,
-    sidebar: sidebar,
-    socialLinks: socialLinks,
-  },
+  themeConfig: themeConfig,
 });

course/.vitepress/sidebar.ts

@@ -7,7 +7,7 @@ export default [
   },
   {
     text: "什么是 Zig ？",
-    link: "/what-is-zig",
+    link: "/",
   },
 
   {

course/.vitepress/themeConfig.ts

@@ -0,0 +1,38 @@
+import { DefaultTheme } from "vitepress";
+import sidebar from "./sidebar";
+import nav from "./nav";
+import socialLinks from "./socialLinks";
+
+const config: DefaultTheme.Config = {
+  editLink: {
+    pattern: "https://github.com/zigcc/zig-course/tree/main/learn/:path",
+  },
+  search: {
+    provider: "local",
+    options: {
+      locales: {
+        root: {
+          translations: {
+            button: {
+              buttonText: "搜索文档",
+              buttonAriaLabel: "搜索文档",
+            },
+            modal: {
+              noResultsText: "无法找到相关结果",
+              resetButtonTitle: "清除查询条件",
+              footer: {
+                selectText: "选择",
+                navigateText: "切换",
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+  nav: nav,
+  sidebar: sidebar,
+  socialLinks: socialLinks,
+};
+
+export default config;

course/environment/install-environment.md

@@ -148,9 +148,11 @@ Linux安装的话， 由于发行版的不同，安装的方式五花八门，
 
 1. 参考 [Getting Started](https://asdf-vm.com/guide/getting-started.html) 下载 asdf，一般而言，常见的系统管理器，如 brew、apt 均可直接安装
 2. 安装 asdf [Zig 插件](https://github.com/asdf-community/asdf-zig)
+
 ```bash
 asdf plugin-add zig https://github.com/asdf-community/asdf-zig.git
 ```
+
 3. 之后就可以用 asdf 管理 Zig 版本。这里列举一些 asdf 常用命令：
 
 ```bash

course/hello-world.md

@@ -16,6 +16,7 @@ outline: deep
 
 <!-- 引入代码片段 -->
 <!-- 具体说明见：https://vitepress.dev/zh/guide/markdown#import-code-snippets -->
+
 <<<@/examples/hello_world_1.zig
 
 _很简单，不是吗？_

course/home_page.md

@@ -0,0 +1,28 @@
+---
+layout: home
+
+hero:
+  name: "Zig 语言圣经"
+  text: "简单、快速地学习 Zig"
+  tagline: Zig 是一种通用的编程语言和工具链，用于维护健壮、最优和可重用的软件
+  actions:
+    - theme: brand
+      text: 📖 开始阅读
+      link: /what-is-zig
+    - theme: alt
+      text: 🌐 Zig官网
+      link: https://ziglang.org/
+
+features:
+  - icon: 📝
+    title: 语义简单
+    details: 专注于调试应用程序，而不是调试编程语言知识。无隐式控制流、无隐式内存分配、无预处理器和宏
+
+  - icon: 🚀
+    title: 编译期执行
+    details: 基于编译期代码执行和惰性求值的全新元编程方法,编译期调用任何函数、模拟目标架构，无运行时开销将类型作为值进行操作
+
+  - icon: 💡
+    title: 维护代码
+    details: 改善代码库，将 Zig 作为一个开箱即用的零依赖 C/C++ 编译器，通过 zig build 构建一致的编译环境，跨语言 LTO 默认启用
+---

course/index.md

@@ -1,28 +1,52 @@
----
-layout: home
-
-hero:
-  name: "Zig 语言圣经"
-  text: "简单、快速地学习 Zig"
-  tagline: Zig 是一种通用的编程语言和工具链，用于维护健壮、最优和可重用的软件
-  actions:
-    - theme: brand
-      text: 📖 开始阅读
-      link: /what-is-zig
-    - theme: alt
-      text: 🌐 Zig官网
-      link: https://ziglang.org/
-
-features:
-  - icon: 📝
-    title: 语义简单
-    details: 专注于调试应用程序，而不是调试编程语言知识。无隐式控制流、无隐式内存分配、无预处理器和宏
-
-  - icon: 🚀
-    title: 编译期执行
-    details: 基于编译期代码执行和惰性求值的全新元编程方法,编译期调用任何函数、模拟目标架构，无运行时开销将类型作为值进行操作
-
-  - icon: 💡
-    title: 维护代码
-    details: 改善代码库，将 Zig 作为一个开箱即用的零依赖 C/C++ 编译器，通过 zig build 构建一致的编译环境，跨语言 LTO 默认启用
----
+# 什么是 Zig
+
+根据其官网所述：
+
+> Zig 是一种通用的编程语言和工具链，用于维护健壮、最优和可重用的软件
+
+这样的概念解释可能比较模糊，我们来看看维基百科怎么说的：
+
+> Zig 是一种命令式、通用、静态类型、编译的系统编程语言，由 Andrew Kelley 设计。
+> 它旨在替代C编程语言，其目标是更小，编程更简单，同时还提供现代功能，新的优化和各种安全机制，
+> 同时不像其他语言那样对运行时安全性的要求。
+
+> 语言简单性的改进与流控制、函数调用、库导入、变量声明和 Unicode 支持有关。
+> 此外，该语言不使用宏或预处理器指令。从现代语言中采用的功能包括添加编译时泛型类型，
+> 允许函数处理各种数据，以及一小组新的编译器指令，以允许使用反射访问有关这些类型的信息。
+> Zig 还旨在提高代码的安全性，它不提供垃圾回收（GC），但是使用可选类型代替 `null` ，这避免了空指针的出现。
+
+## 为何使用 Zig
+
+从本质上看，Zig 是一门 `low level` 的高级语言，它和 C 很像，但改善旧问题并提供了完善的工具链，并且它可选支持 `libc`。
+
+一切都是强制显示声明式，这使得代码阅读很轻松！
+
+如果你是嵌入式开发，亦或者对速度有很高的要求，还不想使用心智负担太高的其他高级语言，或许 Zig 很适合你。
+
+## 特点
+
+- 类型是一等公民
+- 无隐式执行
+- 手动内存控制，精确的内存泄漏跟踪
+- 完善的堆栈跟踪（在裸机器上也可以）
+- 对交叉编译的一流支持
+- 标准库集成 libc ，但不依赖它
+- 类型作为一等公民
+- 可选类型代替 `null`，详见 [计算机科学中最严重的错误](https://www.lucidchart.com/techblog/2015/08/31/the-worst-mistake-of-computer-science/)
+- 编译期（可以简单看作在编译时执行的函数）执行实现泛型和反射
+- 无需 FFI/bindings 的 C 库集成
+- 非常强大的构建系统
+
+有几点是非常值得单独拿出来说明一下的：
+
+_Zig 会要求你显示传递和管理你的内存，并且编译时就会跟踪你的内存是否发生泄漏，
+高明的可选类型（这和 rust 的 option 有异曲同工之妙），强大的编译期运行，你可实现很多花哨的操作，而构建系统则被很多 C 项目拿去作为工具链使用_
+
+## 了解更多 ？
+
+查看[这里](appendix/well-known-lib.html)，列出了一些积极维护的 zig 库或者实现
+
+以下列出了，可以在线执行 zig 的平台：
+
+- [zig-playground](https://playground.zigtools.org/)
+- [zig-play](https://zig-play.dev/)