增加git内容以及图标

Author: liuhao

docs/.vuepress/config.ts

@@ -9,6 +9,8 @@
  * 特别的，请不要在两个配置文件中重复配置相同的项，当前文件的配置项会被覆盖
  */
 
+// 统一图标库：https://icon-sets.iconify.design/vscode-icons/
+
 import { viteBundler } from '@vuepress/bundler-vite'
 import { defineUserConfig } from 'vuepress'
 import { plumeTheme } from 'vuepress-theme-plume'
@@ -125,7 +127,7 @@ export default defineUserConfig({
       // youtube: true,      // 启用嵌入 youtube视频 语法 @[youtube](video_id)
       // artPlayer: true,    // 启用嵌入 artPlayer 本地视频 语法 @[artPlayer](url)
       // audioReader: true,  // 启用嵌入音频朗读功能 语法 @[audioReader](url)
-      icon: { provider: 'iconify' },        // 启用内置图标语法  ::icon-name::
+      icon: { provider: 'iconify' },        // 启用内置图标语法  ::icon-name::  https://icon-sets.iconify.design/
       // table: true,        // 启用表格增强容器语法 ::: table
       // codepen: true,      // 启用嵌入 codepen 语法 @[codepen](user/slash)
       // replit: true,       // 启用嵌入 replit 语法 @[replit](user/repl-name)

docs/.vuepress/navbar.ts

@@ -7,26 +7,37 @@
 import { defineNavbarConfig } from 'vuepress-theme-plume'
 
 export default defineNavbarConfig([
-  { text: '首页', link: '/' },
+  { text: '首页', link: '/', icon: 'streamline-plump-color:home-1-flat'},
   {
     text: '编程语言',
     items: [
-      { text: 'Go', link: '/notes/go/README.md' },
-      { text: 'mongoDB', link: '/notes/mongoDB/README.md' },
-    ]
+      { text: 'Go', icon:'vscode-icons:file-type-go', link: '/notes/go/README.md' },
+    ],
+    icon: 'streamline-color:file-code-1'
   },
   {
     text: '中间件',
     items: [
-      { text: 'docker', link: '/notes/docker/README.md' },
-    ]
+      { text: 'mongoDB', icon:'devicon:mongodb', link: '/notes/mongoDB/README.md' },
+      { text: 'docker', icon: 'devicon:docker' , link: '/notes/docker/README.md' },
+    ],
+    icon: 'streamline-plump-color:database-flat'
+  },
+  {
+    text: '开发常用',
+    items: [
+      { text: 'git', icon:'material-icon-theme:git', link: '/notes/git/README.md' },
+    ],
+    icon: 'streamline-sharp-color:tool-box-flat'
   },
   {
     text: '开源项目',
     items: [
       { text: 'go-utils', link: '/notes/utils/README.md' },
-    ]
+    ],
+    icon: 'mingcute:github-fill'
   },
+  
   { text: '标签', link: '/blog/tags/' },
   { text: '归档', link: '/blog/archives/' },
   { text: '博客', link: '/blog/' },

docs/.vuepress/notes.ts

@@ -69,6 +69,18 @@ const utilsNote = defineNoteConfig({
     // sidebar: 'auto',
 })
 
+const gitNote = defineNoteConfig({
+    dir: 'git',
+    // `dir` 所指向的目录中的所有 markdown 文件，其 permalink 需要以 `link` 配置作为前缀
+    // 如果 前缀不一致，则无法生成侧边栏。
+    // 所以请确保  markdown 文件的 permalink 都以 `link` 开头
+    link: '/git',
+    // 手动配置侧边栏结构
+    sidebar: 'auto',
+    // 根据文件结构自动生成侧边栏
+    // sidebar: 'auto',
+})
+
 
 /**
  * 导出所有的 note
@@ -78,5 +90,11 @@ const utilsNote = defineNoteConfig({
 export default defineNotesConfig({
   dir: 'notes',
   link: '/',
-  notes: [goNote, mongoDBNote, dockerNote, utilsNote],
+  notes: [
+    goNote, 
+    mongoDBNote, 
+    dockerNote, 
+    utilsNote,
+    gitNote
+  ],
 })

docs/notes/git/1.git介绍.md

@@ -0,0 +1,21 @@
+---
+title: git介绍
+createTime: 2025/09/08 23:47:31
+permalink: /git/881498zj/
+icon: material-icon-theme:git
+---
+
+Git 是由 Linux 的创始人 Linus 发明的。Git 是目前世界上最先进的分布式版本控制系统。
+
+首先需要了解什么是集中式，什么是分布式。
+
+集中式版本控制系统，版本库是集中存放在中央服务器的，每次需要从中央服务器获取最新版本，然后将自己干完的活推送回中央服务器。也就是说，整个项目的最新版代码都集中于中央服务器中。
+
+而且集中式版本控制系统最大的毛病就是必须联网才能工作，如果网络不好，那么就可能出现提交文件时间提交很久，很浪费时间。
+
+分布式版本控制系统他和他的名字一样，是分布式的，也就是说没有中央服务器这一个概念，每一个人的电脑上都有一个完整的版本库。
+
+那么这样如何多人协作呢？
+> 比方说你在自己电脑上改了文件 A，你的同事也在他的电脑上改了文件 A，这时，你们俩之间只需把各自的修改推送给对方，就可以互相看到对方的修改了。
+
+在实际使用分布式版本控制系统的时候，其实很少在两人之间的电脑上推送版本库的修改，因为可能你们俩不在一个局域网内，两台电脑互相访问不了，也可能今天你的同事病了，他的电脑压根没有开机。因此，分布式版本控制系统通常也有一台充当“中央服务器”的电脑，但这个服务器的作用仅仅是用来方便“交换”大家的修改，没有它大家也一样干活，只是交换修改不方便而已。

docs/notes/git/2.了解项目状态.md

@@ -0,0 +1,71 @@
+---
+title: 了解项目状态
+createTime: 2025/09/08 23:48:53
+permalink: /git/3f1386qi/
+icon: material-icon-theme:git
+---
+
+## git status
+
+当你忘记某个文件是否已经修改，是否提交到仓库的时候，就可以使用 `git status` 命令来查看。
+
+它帮助我们了解当前工作目录中文件的更改情况，包括哪些文件被修改、新增或删除，以及这些更改是否已提交到版本库。
+
+直接在命令行中输入；
+```bash
+git status
+```
+
+此命令会返回当前工作目录的状态，包括未跟踪的文件、修改后的文件以及新创建的文件。同时，它还会显示当前 branch 的状态信息，如分支名称、最后一次提交的 commit 信息等。
+
+如果你想查看特定文件的状态，可以使用 `git status -a` 命令，它会显示所有文件的状态，**包括那些在 Git 仓库中但已经删除的文件**。
+
+`git status` 的优点在于它能够快速展示当前目录的状态，让我们时刻把握项目的进展。然而，它也有一些局限性。例如，**它只能显示当前目录的状态**，无法跨多个子目录分析代码状态。为了解决这个问题，我们可以使用 `git status -u` 命令，它会显示所有子目录的状态。
+
+**例如修改了一个 `readme.txt` 文件，使用命令后**：
+```bash
+On branch master
+Changes not staged for commit:
+  (use "git add <file>..." to update what will be committed)
+  (use "git checkout -- <file>..." to discard changes in working directory)
+
+	modified:   readme.txt
+
+no changes added to commit (use "git add" and/or "git commit -a")
+```
+`On branch master` 表示我们当前所在的分支是 master 分支。
+
+下面的 `Changes not staged for commit:` 告诉我们工作目录中有一些更改尚未提交。Git 将要被提交的更改称为 "staged"。在这种情况下，Git 提醒你需要使用 `git add` 来 "添加" 更改，以便它们被包含在下一次提交中。
+
+`modified: readme.txt` 表示 "readme.txt" 文件已经被修改。修改意味着我们对这个文件进行了修改，但是这些修改尚未被 "添加" 到暂存区。
+
+`no changes added to commit (use "git add" and/or "git commit -a")` 是提示我们还没有把修改添加到下一次提交中。如果我们想把这些修改包含在下次提交中，我们需要使用 `git add` 命令。如果我们想忽略这些未添加的更改，我们可以使用 `git checkout -- readme.txt` 来丢弃工作目录中的更改。
+
+
+## git diff
+
+只是用 `git status` 只能看文件是否有改动，但是不能看到文件具体改动了哪些，一旦你忘记了修改了什么地方，也就不敢随便乱动，这个时候就可以使用 `git diff` 命令**查看当前工作目录中所有未提交的更改**。
+
+如果我们需要查看特定文件的变化，可以使用 `git diff <文件名>`。
+
+`git diff --cached` 命令则显示已暂存但对尚未提交到版本库的更改。
+
+例如修改了一个 `example.txt` 文件后，使用 `git diff` 命令来查看：
+```bash
+diff --git a/example.txt b/example.txt index 843a555..45aff21 100644 
+--- a/example.txt 
++++ b/example.txt 
+@@ -1,3 +1,4 @@ 
+Line 1: The same as the original version. Line 2: Added a new line. 
+Line 3: This line has been modified. 
++Line 4: Another new line.
+```
+`diff --git a/example.txt b/example.txt`：这行告诉我们在 a/example.txt 和 b/example.txt 之间进行了比较。
+
+`index 843a555..45aff21 100644`：这行展示了索引信息，它描述了文件在 Git 版本库中的状态。在这个例子中，843a555 和 45aff21 是文件的两个不同的版本标识，100644 是文件的权限模式。
+
+`--- a/example.txt` 和 `+++ b/example.txt`：这两行分别表示被比较的两个文件。在这个例子中，a/example.txt 是原始文件，b/example.txt 是修改后的文件。
+
+`@@ -1,3 +1,4 @@`：这行表示差异比较的行范围。在这个例子中，原始文件的前3行与修改后的文件的前3行是相同的，而修改后的文件新增了一行。
+
+最后面列出了文件的每一行及其状态。"+" 表示新增的行，"%" 表示没有改变的行，"-" 表示被删除的行。

docs/notes/git/3.仓库的创建.md

@@ -0,0 +1,36 @@
+---
+title: 仓库的创建
+createTime: 2025/09/08 23:50:07
+permalink: /git/1blzkos1/
+icon: material-icon-theme:git
+---
+
+仓库又名版本库，英文名字为 Repository，这个仓库里面的所有文件都可以被 Git 管理起来，每个文件的修改、删除，Git 都能跟踪，以便任何时刻都可以追踪历史，或者在将来某个时刻可以“还原”。
+
+## 创建仓库
+
+创建仓库的命令很简单，打开终端，进入某个你想创建仓库的文件夹路径，使用命令：
+```bash
+git init
+``` 
+即可创建成功，创建完成之后是一个空的仓库，而且当前文件夹下面会多一个 `.git` 的目录，这个目录是 Git 来跟踪管理版本库的。
+
+## 将文件放入 Git 仓库
+
+随便在文件夹中创建一个文件 `a.txt`，首先是**将其放入暂存区**：
+```bash
+git add a.txt
+```
+像这样如果没有报任何错误就代表成功将内容添加到暂存区。
+
+下一步就是将**文件提交到仓库**：
+```bash
+git commit -m "this is a file"
+```
+`-m` 后面加上双引号写的内容代表的是本次提交的说明。执行了这条命令后，Git **会将暂存区的修改内容提交到版本库，并将附加的描述信息一并记录下来。** 这样，你就可以在历史记录中查看这个提交的详细信息。
+
+我们可以一次性 add 许多个文件，然会一次性 commit 将其提交到仓库：
+```bash
+git add file2.txt file3.txt
+git commit -m "add 3 files."
+```

docs/notes/git/4.版本回退.md

@@ -0,0 +1,26 @@
+---
+title: 版本回退
+createTime: 2025/09/08 23:50:50
+permalink: /git/j9t15o2u/
+icon: material-icon-theme:git
+---
+
+在了解了如何提交和修改文件之后，我们来看如何实现版本回退，这样就可以放心地对文件进行修改了，哪怕修改后不满意也可以回退到原来的版本。
+
+我们可以使用 `gti log` 追踪我们的版本控制历史，它对于了解项目的历史和追踪变更至关重要。
+
+`git log` 命令：
+```bash
+git log
+```
+这会显示从初始提交到最新提交的所有提交记录。每个提交都有一个唯一的哈希值，表示该提交的唯一标识符。
+
+我们还可以使用一些选项来过滤和定制我们想要查看的提交记录。例如，我们可以使用 `--short` 选项来只显示每个提交的简短信息，而不是整个提交记录。
+```bash
+git log --short
+```
+
+我们还可以使用`--graph`选项来显示提交历史的图形化表示，这可以帮助我们更好地理解分支和合并操作。
+```bash
+git log --graph
+```

docs/notes/git/README.md

@@ -0,0 +1,9 @@
+---
+title: git
+createTime: 2025/09/08 23:46:44
+permalink: /git/
+icon: material-icon-theme:git
+---
+
+
+git

docs/notes/utils/README.md

@@ -1,5 +1,5 @@
 ---
-title: utils
+title: go-utils
 createTime: 2025/09/08 10:16:26
 permalink: /utils/
 ---