From 59fb717da0b6b07858aeda02d803c2c2092f0c54 Mon Sep 17 00:00:00 2001 From: esonhugh Date: Thu, 14 Oct 2021 14:01:48 +0800 Subject: [PATCH 1/4] github.md - add github edu, github lab; git.md - add git commit branch lab, git in goland, commit rules --- git/git.md | 35 ++++++++++++++++++++++++++++++++++- git/github.md | 28 +++++++++++++++++++++++++++- 2 files changed, 61 insertions(+), 2 deletions(-) diff --git a/git/git.md b/git/git.md index dba9608..b674d81 100644 --- a/git/git.md +++ b/git/git.md @@ -1 +1,34 @@ -# Git 教程 \ No newline at end of file +# Git 教程 + +## Commit & Branch 等基础使用 + +https://learngitbranching.js.org/?locale=zh_CN (这是中文版的) + +上述教学网站可以提供输入 shell 指令的空间,通过简单的交互和小任务(游戏)的形式使得使用者快速入门 git 命令行操作. + +## 客户端选择 + +- 普普通通 cli git +- 可视化的 fork (https://git-fork.com/) on windows mac +- ... and so on + +## Goland Git + +https://www.jetbrains.com/help/go/using-git-integration.html + +goland jetbrains 官方对于 内置 Git 功能的说明与使用 + + +## Unimportant Misc + +### git commit 规范问题 + +AngularJS 的 git 规范 是使用较为广泛的规范 + +具体的规范需要遵从具体的项目下说明文档 + +文章: https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#heading=h.uyo6cb12dt6w + + + + diff --git a/git/github.md b/git/github.md index c7964e5..3903aea 100644 --- a/git/github.md +++ b/git/github.md @@ -1 +1,27 @@ -# Github 教程 \ No newline at end of file +# Github 教程 + +## 官方 Lab + +https://lab.github.com/ + +官方 lab 是基础的引入 其中涵盖了大大小小的模块课程 + +包括 : +- github 的介绍 +- github action 的基础介绍 +- github pages 的 blog 搭建 +- ... + +## 教育优惠 + +http://education.github.com/ + +requirements: edu 邮箱 [, 学生个人信息或学信网] + +首页上可以进行 Github Student Pack 跟随指示 进行一步步操作 + +目前 本校邮箱可以免验证学信网帐号以及学籍信息 + +可提供的优惠包括但不限于 jetbrains 学生优惠, Github Pro 帐号, ssh 终端管理器 Termius + + From a6f4f81db5a9f055c92d56b65ad7b430629e78ec Mon Sep 17 00:00:00 2001 From: esonhugh Date: Thu, 14 Oct 2021 14:01:48 +0800 Subject: [PATCH 2/4] git.md - add more verbose and command operation --- git/git.md | 155 +++++++++++++++++++++++++++++++++++++++++++++++++- git/github.md | 28 ++++++++- 2 files changed, 181 insertions(+), 2 deletions(-) diff --git a/git/git.md b/git/git.md index dba9608..692f5f9 100644 --- a/git/git.md +++ b/git/git.md @@ -1 +1,154 @@ -# Git 教程 \ No newline at end of file +# Git 教程 + +## 导入 + +Git 是一个分布式版本控制软件 最初由林纳斯·托瓦兹创作 于2005年以GPL发布 最初目的是为更好地管理Linux内核开发而设计 + +git 会记录其文件变化 对代码进行跟踪和定位 其最大的优势是 **合并跟踪** 这对于大型项目合作开发非常有用 + +同时 git 的操作更加类似与 文件系统 尽管其具体原理有些晦涩难懂 但是基本的操作又都是~~非常友好~~的 指令 + +git 的内部实现方式类似与 拷贝文件 但却是进行特殊二进制格式的对象存储 以及压缩 其具体实施过程会由 git 自动负责, 作为程序员本身不需要过多的操心。所以往往其整个 git 项目的文件夹的大小大约等于两倍的源码文件的大小 + +## 基础指令 + +### git clone + +这个指令就可以用四个大字概括 **拿来吧你** + +一般可以有 三种下载方案 + +HTTPS / SSH / 类 Git App + +> 注意 ssh 处可能需要配置对应的账户 SSH 公私钥 +> +> 具体操作可以在 [官方文档](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) 找到 +> 目前 ssh 是使用较多的操作 + +### git add + +当代码编辑完毕之后使用 + +增加指令 可以将代码增添到 **临时的存储区域** 并且对存储对象进行预备操作 + +> 一般在 jetbrains 系列内置的 git 中 只是勾选文件就可以进行简单的 add 操作 + +cli 下指令如下 + +. 是指 当前文件夹 git 会递归当前文件夹下的源代码文件 并且对变化的源代码文件进行增加 + +-v 只是增加了 verbose 以观察具体的 文件增加过程 以防错误地将敏感文件增加进入 git 历史之中 + +> 例如 您的 password, 小程序的 key 等等 + +``` bash +git add [-v] . +``` + +也可以替换为 其他的具体文件名称 例如 git.md + +``` bash +git add git.md +``` + +帮助 以及 更多 add 的特殊操作 + +``` bash +git add -h +``` + +在 add 进行完毕后 我们可以通过指令 来输出具体的添加和临时存储的信息 + +``` bash +git status +``` + +### git commit + +commit 便是进行提交和本地归档的操作 所以 commit 操作较为核心 + +其同时也具有更多的 子选项和子指令 + +git 会对 add 操作之后的 **临时存储区域** 进行存储操作 将指定的变动文件进行 + +现在是基础款的 信息添加 +``` bash +git commit -m "提交消息1" +``` + +帮助 以及 更多 commit 的特殊操作 + +``` bash +git commit -h +``` + +这里的操作更多更为复杂 暂时不宜进行展开 可以在遇到了具体问题之后 进行搜索 + +> 同时 由于本组织使用 jetbrains 系列作为基础的开发 +> +> jetbrains IDE 掩盖了大多数的指令操作 具有的 git 模块会较为具体的展现出各个选项 对新人非常友好 + +### git push + +push 指令是作为 上传指令出现的 + +其原理是将本地的 .git 文件夹重命名后 上传至服务器中 + +一般是 项目名称.git + +``` bash +git push +``` + +一旦你开了一个 pr 之后 再进行编辑时非常容易 push 失败 + +这时我们需要使用 来进行强制上传提交 +``` bash +git push --force +``` + +帮助 以及更多 push 操作 + +``` bash +git push -h +``` + +## Commit & Branch 基础使用的小游戏 + +https://learngitbranching.js.org/?locale=zh_CN (这是中文版的) + +上述教学网站可以提供输入 shell 指令的空间 通过简单的交互和小任务(游戏)的形式使得使用者快速入门 git 命令行操作 + +### 关于 branch fork 与 commit + +- commit 基础款的提交操作 可以用来进行详细的说明与操作 +- branch 更像一个对 commit 的引用操作 +- fork 几乎可以是完全分离 有一些分家的意味 但也可以用来 提 pull Request 为项目提交改变 + + +## 客户端选择 + +- 普普通通 cli git +- 可视化的 fork (https://git-fork.com/) on windows mac +- ... and so on + +## Goland Git + +https://www.jetbrains.com/help/go/using-git-integration.html + +goland jetbrains 官方对于 内置 Git 功能的说明与使用 + + +## Unimportant Misc + +### git commit 规范问题 + +AngularJS 的 git 规范 是使用较为广泛的规范 + +具体的规范需要遵从具体的项目下说明文档 + +文章: https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#heading=h.uyo6cb12dt6w + + + + diff --git a/git/github.md b/git/github.md index c7964e5..3903aea 100644 --- a/git/github.md +++ b/git/github.md @@ -1 +1,27 @@ -# Github 教程 \ No newline at end of file +# Github 教程 + +## 官方 Lab + +https://lab.github.com/ + +官方 lab 是基础的引入 其中涵盖了大大小小的模块课程 + +包括 : +- github 的介绍 +- github action 的基础介绍 +- github pages 的 blog 搭建 +- ... + +## 教育优惠 + +http://education.github.com/ + +requirements: edu 邮箱 [, 学生个人信息或学信网] + +首页上可以进行 Github Student Pack 跟随指示 进行一步步操作 + +目前 本校邮箱可以免验证学信网帐号以及学籍信息 + +可提供的优惠包括但不限于 jetbrains 学生优惠, Github Pro 帐号, ssh 终端管理器 Termius + + From ef4410be32ea8fc0bd21b0774cf8d497d0190908 Mon Sep 17 00:00:00 2001 From: esonhugh Date: Thu, 14 Oct 2021 15:39:19 +0800 Subject: [PATCH 3/4] git.md - add more verbose and command operation --- git/git.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/git/git.md b/git/git.md index 843fbf9..a31f64c 100644 --- a/git/git.md +++ b/git/git.md @@ -1,6 +1,5 @@ # Git 教程 -<<<<<<< HEAD ## 导入 Git 是一个分布式版本控制软件 最初由林纳斯·托瓦兹创作 于2005年以GPL发布 最初目的是为更好地管理Linux内核开发而设计 @@ -132,7 +131,6 @@ https://learngitbranching.js.org/?locale=zh_CN (这是中文版的) https://learngitbranching.js.org/?locale=zh_CN (这是中文版的) 上述教学网站可以提供输入 shell 指令的空间,通过简单的交互和小任务(游戏)的形式使得使用者快速入门 git 命令行操作. ->>>>>>> 59fb717da0b6b07858aeda02d803c2c2092f0c54 ## 客户端选择 From 34db11b907cd1d6fd35e67a356e614e10a93cc96 Mon Sep 17 00:00:00 2001 From: esonhugh Date: Thu, 14 Oct 2021 15:41:24 +0800 Subject: [PATCH 4/4] feature.md - add language for code block --- golang/feature.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/golang/feature.md b/golang/feature.md index 653cb0a..0828ec1 100644 --- a/golang/feature.md +++ b/golang/feature.md @@ -12,7 +12,7 @@ ### 关于指针与切片 以下代码的两个 `change` 函数造成的改动，都能成功生效吗？ 如果不能，分别是因为什么原因？怎么写才是对的？ -``` +``` go type personInfos struct { Filename string Persons []Person @@ -41,4 +41,4 @@ func (p *personInfos)ChangeSomeThingV2() { } } -``` \ No newline at end of file +```