Merge pull request #33 from shipengqi/feat/new-theme

feat(theme): use hextra theme

Author: shipengqi

.github/workflows/gh-pages.yaml

@@ -23,15 +23,15 @@ jobs:
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v3
         with:
-          hugo-version: '0.119.0'
+          hugo-version: '0.139.0'
           extended: true
 
       - name: Build
-        run: hugo -t book --minify
+        run: hugo --minify
 
       - name: Deploy
         uses: peaceiris/actions-gh-pages@v4
         if: github.ref == 'refs/heads/master'
         with:
           github_token: ${{ secrets.PAT }}
-          publish_dir: ./public
+          publish_dir: ./public

.gitmodules

@@ -4,22 +4,27 @@ Go language learning ...
 
 ## Usage
 
-Development:
+Initialize project as a Hugo Module using the `hugo mod init` command:
 
 ```sh
-# init submodule, set the URLs and paths of the submodules based on the information in the .gitmodules file, 
-# but will not download the submodule's content
-# after cloning a repository containing submodules, run this command to initialize the submodules.
-git submodule init
+hugo mod init github.com/shipengqi/golang-learn
+```
+
+Adding the [Hextra](https://github.com/imfing/hextra) theme:
+
+```yaml
+baseURL: "https://shipengqi.github.io/golang-learn"
+title: "Golang Learning"
 
-# Update the submodule's content to the latest commit in the branch specified in the .gitmodules file
-# Run this command after initializing a submodule, or when you need to update the contents of a submodule.
-git submodule update
+module:
+  imports:
+    - path: github.com/imfing/hextra
+```
 
-# git submodule add [email protected]:alex-shpak/hugo-book.git themes/book
+Start server:
 
-# start server
-hugo server --minify --theme book
+```sh
+hugo server -D
 ```
 
 Manually deploy:
@@ -30,7 +35,16 @@ Manually deploy:
 
 > Any changes in the `content` directory will automatically trigger a deployment.
 
-## Menu
+## Update Theme
+
+To update all Hugo modules in your project to their latest versions, run the following command:
 
-By default, the [hugo-book](https://github.com/alex-shpak/hugo-book) theme will render pages from the `content/docs` section as a menu in a tree structure.
-You can set `title` and `weight` in the front matter of pages to adjust the order and titles in the menu.
+```
+hugo mod get -u
+```
+
+To update Hextra to the latest released version, run the following command:
+
+```
+hugo mod get -u github.com/imfing/hextra
+```

README.md

@@ -1,39 +1,16 @@
 ---
-title: 主要内容
+title: Go Learning
 ---
 
-# Go Learning
-
 ## 主要内容
 
-{{< columns >}}
-
-### 🍚 Go 语言基础
-
-Go 的基本数据类型，关键字的使用和原理。
-
-<--->
-
-### ⚡ Go 并发编程
-
-Go 常见的并发原语的使用和原理。
-
-{{< /columns >}}
-
-
-{{< columns >}}
-
-### 🛠️ Go 实践
-
-记录了编译优化，性能优化，测试， debug，性能分析，工程实践等。
-
-<--->
-
-### 🔍 Go 底层原理
-
-Go 底层内存管理，GC，调度器的实现原理。
+{{< cards cols="2" >}}
+{{< card link="/golang-learn/docs/basic" title="Go 语言基础" icon="code" subtitle="Go 的基本数据类型，关键字的使用和原理。" >}}
+{{< card link="/golang-learn/docs/concurrency" title="Go 并发编程" icon="color-swatch" subtitle="Go 常见的并发原语的使用和原理。" >}}
+{{< card link="/golang-learn/docs/practice" title="Go 实践" icon="cube" subtitle="记录了编译优化，性能优化，测试， debug，性能分析，工程实践等。" >}}
+{{< card link="/golang-learn/docs/advance" title="Go 底层原理" icon="beaker" subtitle="Go 底层内存管理，GC，调度器的实现原理。" >}}
+{{< /cards >}}
 
-{{< /columns >}}
 
 ## 互动与勘误
 
@@ -48,4 +25,4 @@ Go 底层内存管理，GC，调度器的实现原理。
 - [Go 语言设计与实现](https://draveness.me/golang/)
 - [Go 程序员面试笔试宝典](https://golang.design/go-questions/)
 - [Go 语言必知必会](https://golang.dbwu.tech/)
-- [Go 语言高性能编程](https://geektutu.com/post/high-performance-go.html)
+- [Go 语言高性能编程](https://geektutu.com/post/high-performance-go.html)

config.yaml

@@ -3,8 +3,6 @@ title: 数组
 weight: 2
 ---
 
-# 数组
-
 数组是一个由**固定长度**，**相同类型的元素**组成的数据结构。计算机会为数组分配一块**连续的内存**来保存其中的元素，并且可以利用**索引**快速访问数组中的元素。
 
 ## 初始化
@@ -21,4 +19,4 @@ arr2 := [...]int{1, 2, 3} // `...` 省略号，表示数组的长度是根据初
 根据数组大小：
 
 - 当元素数量小于或者等于 4 个时，会直接将数组中的元素放置在栈上。
-- 当元素数量大于 4 个时，会将数组中的元素放置到静态区，并在运行时取出。
+- 当元素数量大于 4 个时，会将数组中的元素放置到静态区，并在运行时取出。

content/_index.md

@@ -3,8 +3,6 @@ title: 切片
 weight: 3
 ---
 
-# 切片
-
 切片 (slice) 在使用上和数组差不多，区别是切片是**可变长**的，定义的时候不需要指定 size。
 
 切片可以看做是对数组的一层简单的封装，切片的底层数据结构中，包含了一个数组。

content/docs/basic/02_array.md

@@ -3,8 +3,6 @@ title: 哈希表
 weight: 4
 ---
 
-# 哈希表
-
 `map` 是一个无序的 `key/value` 对的集合，同一个 key 只会出现一次。
 
 ## 哈希表的设计原理

content/docs/basic/03_slice.md

@@ -3,8 +3,6 @@ title: 函数
 weight: 5
 ---
 
-# 函数
-
 ## 参数传递
 
 函数的参数传递有两种方式：

content/docs/basic/04_map.md

@@ -4,8 +4,6 @@ weight: 6
 draft: true
 ---
 
-# 接口
-
 Go 支持接口数据类型，接口是一组方法的集合，任何其他类型只要实现了这些方法就是实现了这个接口，无须显示声明。
 
 **接口只有当有两个或两个以上的具体类型必须以相同的方式进行处理时才需要**。比如写单元测试，需要 mock 一个类型时，就可以使用接口，mock 的类型和被测试的类型都实现同一个接口即可。
@@ -132,4 +130,4 @@ func main() {
 }
 ```
 
-匿名接口的优点，**匿名接口的方式不依赖具体实现，可以对任意实现了该接口的类型进行重写**。
+匿名接口的优点，**匿名接口的方式不依赖具体实现，可以对任意实现了该接口的类型进行重写**。

content/docs/basic/05_function.md

@@ -4,8 +4,6 @@ weight: 7
 draft: true
 ---
 
-# 反射
-
 **反射机制，能够在运行时更新变量和检查它们的值、调用它们的方法和它们支持的内在操作，而不需要在编译时就知道
 这些变量的具体类型**。弥补了静态语言在动态行为上的一些不足。
 
@@ -91,4 +89,4 @@ func TestSumAll(t *testing.T) {
     }
 }
 ```
-尝试比较 `slice` 和 `string`。这显然是不合理的，但是却通过了测试。所以使用 `reflect.DeepEqual` 比较简洁但是在使用时需多加小心。
+尝试比较 `slice` 和 `string`。这显然是不合理的，但是却通过了测试。所以使用 `reflect.DeepEqual` 比较简洁但是在使用时需多加小心。

content/docs/basic/06_interface.md

@@ -4,6 +4,4 @@ weight: 8
 draft: true
 ---
 
-# 泛型
-
-Coming soon ...
+Coming soon ...

content/docs/basic/07_reflect.md

@@ -3,8 +3,6 @@ title: 指针
 weight: 9
 ---
 
-# 指针
-
 **指针和内存地址不能混为一谈**。内存地址是内存中每个字节单元的唯一编号，而指针是一个实体。指针也会分配内存空间，相当于一个保存内存地址的整形变量。
 
 ## 指针的限制
@@ -93,4 +91,4 @@ func main() {
 	fmt.Println(reflect.TypeOf(p)) // *unit
 	fmt.Println(*p)                // 11
 }
-```
+```

content/docs/basic/08_generic.md

@@ -4,8 +4,6 @@ weight: 10
 draft: true
 ---
 
-# range
-
 带有 `range` 子句的 `for` 语句会先把被遍历的字符串值拆成一个**字节序列**（注意是字节序列），然后再试图找出这个字节序列中
 包含的每一个 UTF-8 编码值，或者说每一个 Unicode 字符。
 

content/docs/basic/09_pointer.md

@@ -4,8 +4,6 @@ weight: 11
 draft: true
 ---
 
-# select
-
 `select` 类似于用于通信的 `switch` 语句。每个 `case` 必须是一个通信操作，要么是发送要么是接收。
 
 当条件满足时，`select` 会去通信并执行 `case` 之后的语句，这时候其它通信是不会执行的。
@@ -181,4 +179,4 @@ select {
 ```
 
 上面的代码 `select` 语句只有一个候选分支，我在其中利用接收表达式的第二个结果值对 `intChan` 通道是否已关闭做了判断，并在
-得到肯定结果后，通过 `break` 语句立即结束当前 `select` 语句的执行。
+得到肯定结果后，通过 `break` 语句立即结束当前 `select` 语句的执行。

content/docs/basic/10_range.md

@@ -4,8 +4,6 @@ weight: 12
 draft: true
 ---
 
-# defer
-
 #### 堆上分配
 
 编译器不仅将 defer 关键字都转换成 runtime.deferproc 函数，它还会通过以下三个步骤为所有调用 defer 的函数末尾插入 runtime.deferreturn 的函数调用
@@ -296,4 +294,4 @@ func main() {
 这个队列与该 `defer` 语句所属的函数是对应的，并且，它是先进后出（FILO）的，相当于一个栈。
 
 在需要执行某个函数中的 `defer` 函数调用的时候，Go 语言会先拿到对应的队列，然后从该队列中一个一个地取出 `defer` 函数及
-其参数值，并逐个执行调用。
+其参数值，并逐个执行调用。