如果你熟悉git原理并在gitee上提交过代码,那么你基本可以忽略本章节内容,但是有两点务必注意:
关于git的历史和原理,笔者找了一个介绍比较好的文章,大家可以参考:https://zhuanlan.zhihu.com/p/66506485
对于初学者而言,个人觉得使用下面的图来理解更合适。
几个问题:
WINDOWS环境下建议大家使用命令行的工具,如果你是MACOS或者Linux,我相信你使用起来会更简单,此处不表,本文仅仅以WINDOWS环境介绍。 可以从git bash下载地址下载git bash工具并安装。 安装完毕之后,在你的工作目录下右键点击即可出现git bash。
点击启动git bash之后会进入一个linux终端的界面,这就是我们后续将修改内容从本地上传到
Gitee上的个人仓库的主要战场了。
一些linux的基本命令(cd:切换目录;cat:参看文件等)都可以在这个界面使用,使用help + 命令可以查看具体的命令的使用方法。请记住,你可以输入命令的前几个字符然后使用tab键补全,毕竟大家的记忆都不是很好。
使用SSH公钥可以让你在你的电脑和 Gitee 通讯的时候使用安全连接。 那么怎么获取到我们PC的SSH公钥呢?在桌面右键打开git bash
输入ssh-keygen.exe 并回车,再次回车,然后输入y,继续回车两次,这样即可生成个人的SSH公钥保持文件。
git无法直接ctrl+c/v实现复制粘贴,但可以鼠标选中ssh公钥保持文件(即Your public key has been saved in 后面的内容)然后右键Copy复制,Paste粘贴实现这个功能。
使用cat命令查看生成的id_rsa.pub文件,输入cat (右键Paste粘贴ssh公钥保持文件)回车即可查看具体信息。
从ssh-rsa开始,整段选中然后复制,打开gitee官网在设置里面找到ssh公钥,粘贴确定即可将公钥添加到我们的gitee账号中。
我们向gitee个人仓库提交修改内容,需要告知大家这些修改内容是谁发起提交的,不然大家怎么知道是哪位英雄好汉为开源社区出了力。所以为了避免每次都重复输入一些提交信息(个人账号信息),我们需要使用git bash统一配置一下提交信息。
首先,先记住自己的个人空间地址,在个人主页的网页链接上可看到。
打开git bash,依次输入以下命令并回车,前两个命令没有反应就证明配置成功。
git config --global user.name "xxxx" (配置用户名,xxxx为账号用户名,即个人空间地址)
git config --global user.email "xxxxxx@xxx"
git config --list (查看配置情况)
恭喜你,到这里就顺利完成向开源社区做贡献的准备动作了!
如果你没有个人熟悉的工具,个人推荐使用OpenHarmony南向设备端IDE DevEcoTool作为我们的C/C++/Markdown文档的编辑工具,不然很多MD文档(程序员最爱)你都打不开。
IDE下载地址:
下载对应的版本之后按照安装引导进行安装。
这是一款给予Visual Studio Code的IDE,可以安装很多VS插件,比方我们修改文档常用的Markdown.打开该IDE工具,在扩展插件中搜索Markdown,安装Markdown All in one/Markdown preview enchance/Markdown PDF几个插件。
目标:知识体系联合运营小组、基础设施组的同学举办了一个知识赋能课程直播,直播活动有个课后打卡的环节,我们就来提个PR做个打卡的动作吧。
把官方仓库内容同步到自己的个人仓库
fork之后,在我们的gitee账号就可以看到这个仓库啦。
打开到个人账号下面的这个仓库,进入到clone界面,复制clone的链接地址。
在gitbash工具下面使用git clone命令完成clone动作。--depth=1意思是只clone当前仓库最新版本,避免仓库历史记录过于庞大花费太多clone时间。
git clone https://gitee.com/Cruise2022/online_event.git --depth=1
clone完毕之后,即可在本地目录下看到这个clone的仓库。补充说明一下,本地目录所在位置是根据git bash的位置决定的,比如你在桌面启动git bash,则clone的仓库会出现在桌面。
在本地目录打开六期成长打卡作业,新建一个打卡作业文件夹(推荐使用自己的gitee个人空间地址来命名自己的打卡作业文件夹,避免冲突),把readme.md文档复制到自己的打卡作业文件夹内,可以使用刚才安装的IDE编辑md文件,也可以使用其他的markdown工具编辑这个md文件(例如Typora)
readme.md修改完成注意保存后,然后开始使用git命令查看并提交。此时需要在本地仓库位置进行git bash,不然git找不到我们修改后的内容。提交的主要步骤如下:
git status
2. 将修改变更后的文件添加到暂存区,输入以下命令操作
git add *
3. 提交修改变更后的文件到本地仓库并签名,输入以下操作命令。
-s是签名表明这次提交者是你,-m是对此次提交行为进行备注,向大家说明你提交修改了什么。
git commit -s -m "add:知识体系赋能课程签到"
4. 最后我们再用git status查看一下,可看到已没有修改变更的东西存在了。
git log
2. 现在我们需要将本地仓库的修改内容推送到gitee上的个人仓库,使用git push命令来完成这个动作。
git push origin master
3. 进入我们的账号下面,我们查看这个仓库,发现已经发生了变化。
进入个人账号的该仓库下,点击增加PR即可开始提交PR。
提交之后就可以看到我们提交的PR了。
此时已经结束了吗?
No.我们需要在该PR下增加一个评论,门禁才开始检查(门禁指管理员设置的一系列合规性检查,检测代码是否合规,质量是否合格,是否签署DCO协议)。
然后我们就可以看到CI的各种合规检查开始进行了,泡杯咖啡,坐等检查通过,然后仓库的管理员来进行合并(PS:有些提交会因为各种原因被管理员拒绝,注意留意管理员回复及时修改重新提交)
至此,恭喜你成功向OpenHarmony开源社区发出了第一声属于自己的呐喊!
虽然这只是一小步,但我们相信这会是社区进步的一大步,期待你加入我们,一起开源贡献!
我以前注册过gitee,本次使用新账号,但是push的时候失败
现象如下:
具体原因是我们的windows的SSH凭据可能还是保持的以前的设置,需要我们手动进行更改凭据条git:https://gitee.com。
visual studio code 安装完markdown相关的插件之后,没有预览功能
查看visual studio code是否处于Restricted Mode模式,看IDE界面的左下角,如果是,则点击关闭即可。在markdown界面右键即可出现预览功能。
完成知识体系相关仓库社区交流(watch/fork/star)
结合自己的视角,提出问题(ISSUE)并力所能及的修正问题(PR)可以检视下述仓库
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。