Merge branch 'dev'

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "cSpell.words": [
+        "gitmodules"
+    ]
+}

archetypes/post.md

@@ -1,9 +1,9 @@
 ---
-title: '{{ replace .File.ContentBaseName "-" " " | title }}'
+title: {{ replace .File.ContentBaseName "-" " " | title }}
 date: {{ .Date }}
 draft: true
 author: JackyLee
-tags: ["未分类"]
-categories: ["未分类"]
+tags: [未分类]
+categories: [未分类]
 comments: true
 ---

content/posts/git-scenario/index.md

@@ -1,30 +1,85 @@
 ---
-title: 'Git 使用场景'
+title: Git 一些比较复杂的使用场景
 date: 2024-04-03T13:53:54+08:00
-draft: false
+draft: true
 author: JackyLee
-tags: ["git"]
-categories: ["场景"]
+tags: [git]
+categories: [场景]
 comments: true
 ---
 
-在使用 Github 的时候，由于对远程分支和本地分支理解不够深刻，难免会出现各种问题
+## 前言
 
-现在记录一下遇到的各种场景
+平常使用 `git add .` 或者 `git push|pull|clone` 等命令，已经无法满足各种奇怪的需求了，
 
-## 场景 1
+在使用 Github 的时候，由于对【本地分支】和【远程分支】理解不够深刻，难免会出现各种问题
 
-远程分支已删除，本地仍然保留远程分支
+所以本文章持续记录使用 Git 时遇到的各种复杂场景
 
-### 如何解决
+## 1 本地分支相关
 
-因为本地缓存了远程分支的信息，要删除本地缓存的已删除远程分支，可以使用以下 `git` 命令
+### 1.1 签出会覆盖本地修改
+
+场景描述：
+
+通常我会在 `dev` 分支上操作，然后细粒度地提交 commit，上传到 github 上形成一个 pull-request，然后 `main` 再接受 pr，合并成一个
+
+但是有时候会忘记切换分支（比如现在就是），直接在 main 上更改
+
+在 vscode 的状态栏就会出现 `*`，此时想换到 `dev` 分支
+
+直接切换会出现
+
+![签出会覆盖本地修改](assets/override-local-change.png)
+
+该提示下的三个选项分别是什么意思呢？
+
+1. 储藏并签出：希望【暂存区】仍然在当前分支，然后切换到另一个分支
+2. 迁移更改：希望将【暂存区】的内容切换到另一个分支，可能要处理冲突问题
+3. 强制签出：（不推荐）直接放弃当前分支（比如 `main`）未提交的 `commmit`，然后切换为分支 `dev`
+
+所以该场景我们需要的是【迁移更改】
+
+### 1.2 暂存 apply 和 pop
+
+什么时候需要【储藏并签出】呢？
+
+比如当自己在 `a-branch` 上写代码，突然有紧急的 bug 需要在 `b-branch` 维修，但是 `a-branch` 还没到达可以提交的阶段，此时就可以使用【储藏并签出】的功能
+
+在修改完以后，回到原先的分支，可以看到 stash 的小图标
+
+![stash-graph](assets/stash-graph.png)
+
+此时右键单击该小图标，会弹出如下对话框
+
+![stash-apply-pop](assets/stash-apply-pop.png)
+
+那么两个选项有什么区别呢？
+
+- `apply-stash`：合并到当前分支，可以对多个分支使用，删除用 `drop stash`
+- `pop-stash`：合并到当前分支并删除，即只能使用一次
+
+Warning: 使用完 stash 后，并没有形成一个提交
+
+该场景下用 `pop-stash` 即可
+
+### 1.2 变基
+
+## 2 远程分支相关
+
+### 2.1 删除远程分支
+
+远程分支已删除，本地仍然保留远程分支，如何清理过期的分支
+
+原因就是本地缓存了远程分支的信息，要删除本地缓存的已删除远程分支，可以使用以下 `git` 命令
 
 ```shell
 git remote prune origin
 ```
 
-## 场景 2
+### 2.2 gitmodules 相关
+
+gitmodule 是第一次遇到，有点抽象的，不过不用管，先酱
 
 删除 `gitmodules`
 

content/posts/hugo-tutorial/index.md

@@ -1,10 +1,10 @@
 ---
-title: 'Hugo 简易教程'
+title: Hugo 简易教程
 date: 2024-04-03T11:00:30+08:00
-draft: false
+draft: true
 author: JackyLee
-tags: ["go"]
-categories: ["教程"]
+tags: [go, hugo]
+categories: [教程]
 comments: true
 ---
 
@@ -24,7 +24,7 @@ comments: true
 
 参考如下文章
 
-[Hugo框架中文文档 标签分类 - Andbible](https://www.andbible.com/post/hugo-content-management-taxonomies/#default-taxonomies)
+[Hugo 框架中文文档 标签分类 - Andbible](https://www.andbible.com/post/hugo-content-management-taxonomies/#default-taxonomies)
 
 ```yaml
 taxonomies:

content/posts/hugo-workflow/index.md

@@ -0,0 +1,32 @@
+---
+title: Hugo 工作流
+date: 2024-04-03T17:20:20+08:00
+draft: true
+author: JackyLee
+tags: [hugo, go]
+categories: [工作流]
+comments: true
+---
+
+## Huge 发布工作流
+
+### 第一步：生成文章模板
+
+```shell
+hugo new --kind <archetypes> <path/to/post>/index.md
+# 例如
+hugo new --kind post path/to/post/index.md
+```
+
+### 第二步：修改 tags 和 categories
+
+```yaml
+tags: []
+categories: []
+```
+
+### 第三步：创作
+
+写文章
+
+### 第四步：提交

content/posts/my-first-post.md

@@ -6,4 +6,4 @@ author: JackyLee
 comments: true
 ---
 
-非常欢迎来到我的博客
+欢迎来到我的博客

hugo.yml

@@ -4,7 +4,7 @@ paginate: 5
 theme: PaperMod
 
 enableRobotsTXT: true
-buildDrafts: false
+buildDrafts: true
 buildFuture: false
 buildExpired: false