文章目录
这里接前面一片文章Git的安装与使用-1,如果不清楚的话可以参考前面的章节去做。
注册Gitlab账号
注册Gitlab
账号的过程比较简单,如下图所示:
由于Gitlab是公司所搭建的私服,因而其注册邮箱并不会去校验,换言之,随便写一个邮箱账号都行,不过既然是公司的私服,推荐还是写上自己的真实邮箱比较好。
在填写注册密码时,我们这里应该留意图示中的标注。其规定了,密码的最小长度为8个字节。
当我们填写完以上信息时,点击Register
完成注册操作。
当账号被注册成功后,其直接就跳转到登录成功后的主页面,其主页面如下:
Gitlab托管Git秘钥
要想成功的在Gitlab
中拉取与提交项目文件,其首先要做的就是将自己的秘钥注册到Gitlab
中,其秘钥的设置方式如下:
点击上图中的账号
->Settings
。
之后就会出现下面的设置页面:
由于我们的秘钥属于ssh
所生成的,因而我们这里选择SSH Keys
选项,之后我们会看到下面的页面
在这里,我们将秘钥粘贴在Key
文本域中,而Title
可以随意填写,之后点击Add key
按钮完成秘钥的添加操作。
在上面的操作中,我们在Key
文本域中是需要粘贴上我们Git
所生成的公钥的,其生成的公钥地址,在之前的文章介绍中就已经被写明,如下:
其公钥的地址就在图中的这段信息内:
Your public key has been saved in /c/Users/Administrator/.ssh/id_rsa.pub
Gitlab项目的拉取与提交
Gitlab的项目地址
由于我们这里主要是介绍的Gitlab
项目的拉取与提交,因而至于项目的创建等操作,我这里就直接跳过了。
在Gitlab
中,由于其为了适应多模块项目开发的需要,因而其在创建项目时有一个项目分组的概念,也就是说,正常情况下,我们是先创建项目分组(Group
),然后再创建项目(Project
),在这里,我们直接使用现有的项目,因而我们会在Groups
->Explore groups
中搜索到我们所需要的检出的项目,如下图所示:
在这里,我们为了做演示,因而直接访问下图中的TestGroup
项目分组。点击TestGroup
项目分组,进入项目分组界面。
在项目分组界面,点击图中的TestProject
项目,进入详细的项目界面。
在项目界面中,我们要想拉取项目,直接点击图示中的Clone
,拷贝Clone with SSH
中的地址,该地址就是我们所要拉取的项目地址。
检出Gitlab项目
我们检出项目时,使用的是WebStorm
这款IDE
软件,其欢迎界面如下:
点击图示中的Git
,在弹出的窗口中,粘贴我们的项目地址(URL
),粘贴完成后,点击克隆(Clone
)完成项目的检出操作。
在弹出的确认连接窗口,选择Yes
在确认打开窗口,我们继续Yes
其打开后的页面如下所示:
至此,我们的项目已经检出成功。
下载MarkDown插件
在上面的截图中,我们其实是打开了testproject
项目中的test.md
文件,而其后缀.md
意思就是该文件时MarkDown
格式的文件。而现在主流的文档编写格式,都是基于MarkDown
来实现的,比如说全球最大的开源社区GitHub
,国内最大的开源社区码云,比如说公司的私服Gitlab
,比如说国内最大的IT社区CSDN
等等都已经全面的支持了MarkDown
格式的文章编写,而在JetBrains
的IDE
工具中,很多最新版均已经集成了MarkDown
编辑器插件,因而无需再次安装。而我的版本属于18.1
版本,该版本并没有默认集成该插件,因而需要我们手动去安装。
选择File
->Settings
->Plugins
,弹出如下窗口:
点击上图中的Browse Repositories
按钮,弹出如下所示界面。
在上面的界面中,在搜索框中输入Mark
即可看到相应的搜索结果,在这里一共搜索出了两款MarkDown
插件,无论安装哪款都是可以的,不过由于Markdown Navigator
属于付费插件,虽然可以免费体验,不过还是建议使用上面那款Markdown
插件。选中它,点击Install
执行安装操作。
安装完成后,其会出现重启的提示,如下所示:
点击重启按钮Restart WebStorm
,之后我们就能够看到该Markdown
软件的展示效果了。
在上图中,我们可以看到,软件的主窗口中出现了分栏,在左边仍然显示原来的Markdown
可编辑文本界面,而在其右侧,其显示的就是页面的预览效果。
至此,我们的Markdown
插件已经安装成功。
Gitlab项目的提交
在进行了前面的操作步骤后,最后剩下的提交操作反倒是最简单的操作。
如下图所示,我在Markdown
页面中插入了一张本地图片,其在右侧立即就展示出了预览效果。
添加图片的格式如下:
![avatar](图片相对路径)
在下图中,点击Version Control
弹出Git
提交面板,在该面板中Default
展示的是有变动,但未提交的文件,在这里,我们可以看到我们刚才添加图片的test.md
以及图片cake.jpg
文件。点击最左侧的箭头指示图标,执行代码提交操作。
在下图所示的文本框中,填写提交的注释信息,然后点击Commit
按钮,提交文件。
在点击提交是,此时有一个小的注意点,那就是这里的提交一般选择Commit and Push
,其意思是先将文件提交到本地Git
仓库,然后再将该提交操作推送到远程Gitlab
仓库。
在下图中的确认推送界面,我们直接点击Push
当我们看到页面右下角的提示信息时,这说明我们的本次文件修改已经提交成功。
在Gitlab中预览提交的结果
我们将文件提交到远程的Gitlab
私服中后,我们就可以通过Gitlab
所提供的页面直接浏览该提交信息。比如说,刚才的提交信息内容如下:
至此,Git
的安装与使用已经演示完毕。