update git and github

Author: Administrator

About.md

@@ -0,0 +1,65 @@
+# Git 如何设置上游分支 upstream？
+
+## 1. 背景
+当您想要克隆一个新的存储库或使用各种功能分支时，您需要知道如何使用上游分支以及如何设置它们。本文将告诉您如何设置上游分支，它还会告诉您哪个 git 本地分支正在跟踪哪个上游远程分支。
+
+## 2. 准备
+- 在本地计算机上安装并配置 Git。
+- 本地存在克隆的 Git 存储库或您自己的 Git 项目
+
+## 3. 什么是 Git 上游分支（upstream）？
+当您想从远程存储库（如 GitHub 或 Bitbucket）检出 git 中的分支时，“上游分支”是托管在 Github 或 Bitbucket 上的远程分支。每当您发出基本上没有参数的普通 `git fetch/git pull` 时，它就是您从中获取/拉出的分支。
+
+
+## 4. 如何在 Git 中设置上游分支
+对上游分支使用带有“-u”选项的 Git Push 命令。
+
+## 5. 使用 Git Push 命令设置上游分支
+创建一个名为“的新分支并使用`-b`选项切换到当前分支
+创建一个名为“的新分支并使用-b选项切换到当前分支
+
+```bash
+git checkout -b <分支名称>
+```
+
+切换分支确认出现如下：
+![](https://img-blog.csdnimg.cn/44f0addd70c344249986a06647a715ca.png)
+当当前分支（'new_branch'）没有设置上游分支时，我们尝试运行命令“Git push”。在cmd中运行以下命令后：
+
+![](https://img-blog.csdnimg.cn/7e501d36bee8471fa9089515dd4c5122.png)
+现在，您需要使用带有 `-u` 选项的 Git push 命令来设置上游分支。将 `<branch name>` 替换为您的分支名称。
+
+```bash
+git push -u origin <分支名>
+```
+
+ 或者，您也可以使用“`–set-upstream`”命令来设置上游分支
+
+```bash
+git push --set-upstream origin <分支名称>
+```
+![](https://img-blog.csdnimg.cn/eb49e97d4a394129850a53563c207d4f.png)
+
+## 6. 如何在 Git 中更改上游分支
+现在，您需要跟踪一个新的上游分支而不是刚刚设置运行的分支：
+
+```bash
+git branch -u <远程/分支名称>
+```
+
+```bash
+git branch main -u <origin/new_branch>
+git branch main -u <源/主>
+```
+
+终端打印出确认消息：
+![](https://img-blog.csdnimg.cn/dd0a8ecc5d8a4f65868e4d8f21a1442a.png)
+![](https://img-blog.csdnimg.cn/bd3eb484881942038b88db110919c234.png)
+## 7. 如何检查哪些 Git 分支正在跟踪哪些上游分支
+现在，您可以使用带有 -vv 选项的“Git 分支”列出所有跟踪上游分支的分支：
+![](https://img-blog.csdnimg.cn/45857cda4bac4925839bac58cb293fe8.png)
+主分支有一个 `[origin/main]` 的跟踪分支。测试分支有一个跟踪分支`[origin/test]`。`new_branch` 分支有一个跟踪分支`[origin/new_branch]`。
+
+
+参考：
+- [How to Set Upstream Branch on Git?](https://www.geeksforgeeks.org/how-to-set-upstream-branch-on-git/)

Git/12-Git_Set_upstream_branch.md

@@ -0,0 +1,61 @@
+#  Git Fetch 和 Git Pull 的区别
+
+
+## 1. 介绍
+`Git Fetch` 是一个命令，它告诉本地存储库远程存储库中有可用的更改，而不会将更改带入本地存储库。另一方面，`Git Pull` 将远 程目录更改的副本带入本地存储库。让我们借助示例分别查看 Git Fetch 和 Git Pull。
+
+```bash
+git pull = git fetch + git merge
+```
+
+## 2. Git Fetch
+让我们创建一个名为demo.txt的文件，其中包含“ Hello Geeks”内容，将目录初始化为 git 存储库，并将更改推送到远程存储库。
+
+```bash
+git init
+git add <Filename>
+git commit -m <Commit Message>
+git remote add origin <Link to your remote repository>
+git push origin <branch name>
+```
+![](https://img-blog.csdnimg.cn/ef6236fd893648ccac0865a5c6b2218f.png)
+
+现在，我们在远程存储库中 有了我的`demo.txt` 。
+![](https://img-blog.csdnimg.cn/d6887c0bfd66444d9364c5e78985fad7.png)
+本地和远程存储库现在是同步的，并且在两个地方具有相同的内容。现在让我们更新远程存储库中的 demo.txt 。![](https://img-blog.csdnimg.cn/ad8ebd71e4c742d19fa2655ea5086acb.png)
+现在，由于我们已经远程更新了demo.txt，让我们将更改带到我们的本地存储库。我们的本地存储库只有 1 次提交，而远程存储库现在 有 2 次提交（观察从`4c4fcb8`开始的第二次提交）。让我们使用`git fetch`命令在本地存储库中查看远程存储库中是否有更改。在此 之前，让我们使用`git log`命令查看我们之前的提交。
+![](https://img-blog.csdnimg.cn/e2f883a65ba44c91be01fbad8d21984b.png)
+我们可以看到，在使用`git fetch`之后，我们得到了在远程存储库中完成了一些提交的信息。（注意`4c4fcb8`是我们在远程存储库中第二次提交的首字母）。要将这些更改合并到我们的本地存储库中，我们需要使用`git merge origin/<branch name>`命令。
+![](https://img-blog.csdnimg.cn/f68211fc5dde4251a2c2db814d4ca0c3.png)
+让我们使用`git log` 命令查看我们在本地存储库中的提交。
+![](https://img-blog.csdnimg.cn/c5109e817ed441519ccf28bc256c17d4.png)
+我们在本地存储库中提交了远程存储库。这就是 `git fetch` 的工作原理。现在让我们看一下`git pull`命令。
+
+## 3. Git Pull
+让我们对远程存储库中的 demo.txt 文件进行更多更改。
+![](https://img-blog.csdnimg.cn/7a0f8a5b668046bcb16cd71e484cb16c.png)
+现在，我们在远程存储库中有 3 个提交，而在我们的本地存储库中有 2 个提交。（注意以09d828f开头的第三次提交）。现在让我们使 用`git pull origin <branch name>`命令将此更改带到我们的本地存储库。
+
+![](https://img-blog.csdnimg.cn/aa922456e3594f388487d8a89a94ac26.png)
+我们可以看到，在git pull命令的帮助下，我们直接获取远程存储库并将其与本地存储库合并。
+
+
+## 4. 结论
+
+
+```bash
+git pull = git fetch + git merge
+```
+现在我们的远程和本地存储库再次相互同步。因此，从以上例子中，我们可以得出结论：
+|Git fetch |Git pull|
+|--|--|
+|在不合并到当前分支的情况下提供来自远程存储库的新更改的信息|    从远程存储库中获取所有更改的副本并将它们合并到当前分支中|
+|存储库数据在 .git 目录中更新|  直接更新本地仓库|
+|可以审查提交和更改     |立即将更改更新到本地存储库。|
+|没有合并冲突的可能性。 |如果远程和本地存储库在同一位置进行了更改，则可能会发生合并冲突。|
+|Git fetch 的命令是 git fetch<remote>   |Git Pull 的命令是 git pull<remote><branch>|
+|Git fetch 基本上将提交导入到本地分支，以便及时了解每个人正在处理的内容。|      Git Pull 基本上使本地分支与远程副本一起 更新，远程副本也将更新其他远程跟踪分支。|
+
+
+参考：
+- [Git – Difference Between Git Fetch and Git Pull](https://www.geeksforgeeks.org/git-difference-between-git-fetch-and-git-pull/?ref=rp)

Git/13_Git_fetch_and_pull_difference.md

@@ -0,0 +1,59 @@
+# Git remote prune、Git prune 和 Git fetch –prune 的区别
+
+
+## 1. 背景
+Git 的一大优点是它*在删除数据时非常小心*。这使得 Git 中的提交或其他有价值的数据很难丢失！这样做的一个小缺点是您有时可能 会看到实际上不再需要的陈旧数据。最好的例子之一是对已删除的远程分支的引用：假设您的一位队友删除了共享远程存储库中的一个分支；该分支仍会为您显示，除非您明确指示 Git 进行清理。
+
+
+## 2. 方法
+在远程存储库上使用“prune”：
+“prune”可作为 `git fetch` 和 `git remote` 命令的选项使用。（`git prune` 命令——在垃圾收集期间使用。）。使用 prune 的最简 单方法是在获取时将其作为选项提供：
+
+```bash
+git fetch --prune origin
+```
+如果您只想`*`执行prune而不`*`获取远程数据，您可以将它与 `git remote` 一起使用：
+
+```bash
+git remote prune origin
+```
+两种情况下的结果是相同的：对指定远程存储库中不再存在的远程分支的陈旧引用将被删除。顺便说一句：你永远不必担心你当地的分支机构，因为修剪永远不会影响那些。
+
+克隆同一个 repo 两次，以便您正确理解 `git prune` 的工作原理。
+
+```bash
+git clone repolink
+```
+![](https://img-blog.csdnimg.cn/69207dae53ea4315b5c30dce420b52bf.png)
+- 在一个回购上创建一个分支并在其副本上获取它
+- 从一个回购中删除该分支
+- 当您在另一个仓库中列出分支时，它不会得到更新。
+
+```bash
+git branch
+git push origin HEAD
+git branch -r
+```
+![](https://img-blog.csdnimg.cn/3f336eb1ebb446f88d13cb18a8294edb.png)
+使用 `git fetch –prune`：
+
+如果我们使用 prune 命令删除，该分支将在 2nd repo 中自动更新
+
+```bash
+git fetch --prune
+```
+![](https://img-blog.csdnimg.cn/7b5af25b6f1f42c09a6f74e0bd6b1c69.png)
+假设在某些情况下您希望`*`只*执行prune并且不获取远程数据
+
+```bash
+git remote prune origin
+```
+如果你想自动prune自己
+
+```bash
+git config —global fetch.prune true
+```
+
+参考：
+- [Difference Between Git remote prune, Git prune and Git fetch –prune](https://www.geeksforgeeks.org/difference-between-git-remote-prune-git-prune-and-git-fetch-prune/?ref=rp)
+

Git/14_Git_fetch_prune.md

@@ -0,0 +1,130 @@
+#  gitbook 插件：音乐
+
+@[toc]
+
+##  1. gitbook-plugin-zymplayer 插件
+
+[gitbook-plugin-zymplayer](https://github.com/T-miracle/gitbook-plugin-zymplayer) 插件 可以播放音乐。
+
+###  1.1 配置
+
+```bash
+"plugins": [ "zymplayer" ]
+
+"pluginsConfig": {
+   "zymplayer": {
+     "element": "body", 
+     "width": "350px", 
+     "mode": "random", 
+     "show": "all", 
+     "list": {
+         "path": "assets/music/musicList.json",
+         "height": 180, 
+         "expand": true 
+     },
+     "position": {
+         "pos": "fixed", 
+         "right": "0px",
+         "bottom": "0px" 
+         }
+   }
+}
+```
+音乐列表存放`musicList.json`、音乐mp3在目录`song`、音乐图片在目录`img`
+
+```bash
+$ ls assets/music/
+img  musicList.json  song
+
+$ ls assets/music/img/
+Angel_Lover-Prendre_sa_main.png  dylanf_卡农.jpg                                Peter_Jeremias-Dusk.jpg  张宇桦_大自然的空气_钢琴曲.jpg  陈光荣_Tanning_In_Your_Sunray.jpg
+Denean-Vow_to_Virtue.jpg         Jocelyn_Pook_Russian_Red-Loving_Strangers.jpg  Vexento_Anesthesia.jpg   群星_森林之歌.jpg
+
+$ ls assets/music/song/
+Angel_Lover-Prendre_sa_main.mp3  dylanf_卡农.mp3                                Peter_Jeremias-Dusk.mp3  张宇桦_大自然的空气_钢琴曲.mp3  陈光荣_Tanning_In_Your_Sunray.mp3
+Denean-Vow_to_Virtue.mp3         Jocelyn_Pook_Russian_Red-Loving_Strangers.mp3  Vexento_Anesthesia.mp3   群星_森林之歌.mp3
+```
+`musicList.json`内容如下：
+
+```bash
+cat  assets/music/musicList.json 
+[
+    {
+        "name": "Tanning In Your Sunray",
+        "artist": "陈光荣",
+        "url": "assets/music/song/陈光荣_Tanning_In_Your_Sunray.mp3",
+        "cover_art_url": "assets/music/img/陈光荣_Tanning_In_Your_Sunray.jpg",
+        "duration": "03:38"
+    },
+    {
+        "name": "Prendre sa main",
+        "artist": "Angel Lover",
+        "url": "assets/music/song/Angel_Lover-Prendre_sa_main.mp3",
+        "cover_art_url": "assets/music/img/Angel_Lover-Prendre_sa_main.jpg",
+        "duration": "03:31"
+    },
+    {
+        "name": "Vow to Virtue",
+        "artist": "Denean",
+        "url": "assets/music/song/Denean-Vow_to_Virtue.mp3",
+        "cover_art_url": "assets/music/img/Denean-Vow_to_Virtue.jpg",
+        "duration": "03:43"
+    },
+
+    {
+        "name": "Loving Strangers",
+        "artist": "Jocelyn Pook Russian Red",
+        "url": "assets/music/song/Jocelyn_Pook_Russian_Red-Loving_Strangers.mp3",
+        "cover_art_url": "assets/music/img/Jocelyn_Pook_Russian_Red-Loving_Strangers.jpg",
+        "duration": "03:43"
+    },
+    {
+        "name": "Dusk",
+        "artist": "Peter Jeremias",
+        "url": "assets/music/song/Peter_Jeremias-Dusk.mp3",
+        "cover_art_url": "assets/music/img/Peter_Jeremias-Dusk.jpg",
+        "duration": "02:05"
+    },
+    {
+        "name": "Anesthesia",
+        "artist": "Vexento",
+        "url": "assets/music/song/Vexento_Anesthesia.mp3",
+        "cover_art_url": "assets/music/img/Vexento_Anesthesia.jpg",
+        "duration": "03:41"
+    },
+    {
+        "name": "森林之歌",
+        "artist": "群星",
+        "url": "assets/music/song/群星_森林之歌.mp3",
+        "cover_art_url": "assets/music/img/群星_森林之歌.jpg",
+        "duration": "02:04"
+    },
+
+    {
+        "name": "张宇桦_大自然的空气_钢琴曲",
+        "artist": "张宇桦_大自然的空气_钢琴曲",
+        "url": "assets/music/song/张宇桦_大自然的空气_钢琴曲.mp3",
+        "cover_art_url": "assets/music/img/张宇桦_大自然的空气_钢琴曲.jpg",
+        "duration": "02:22"
+    },
+    {
+        "name": "卡农",
+        "artist": "dylanf",
+        "url": "assets/music/song/dylanf_卡农.mp3",
+        "cover_art_url": "assets/music/img/dylanf_卡农.jpg",
+        "duration": "05:00"
+    }
+]
+
+```
+
+###  1.2 安装
+
+```bash
+gitbook install 
+```
+###  1.3 效果
+![在这里插入图片描述](https://img-blog.csdnimg.cn/f5d6bc57a2c648979b72ec8f97ff697e.gif#pic_center)
+###  1.4 评论
+插件效果很好，但存在bug，影响logo暂时，子目录下拉显示等等。
+综合指数：:star::star::star:

Gitbook/Plugins/30_Gitbook_Plugin_music.md

@@ -0,0 +1,9 @@
+
+
+  
+xx zz zz zz
+   XX xx
+
+
+
+