本文使用 Zhihu On VSCode 创作并发布

本文是供一些非软件开发者使用Git&vscode的文章,这部分人大多不需要使用这类工具作为日常工作的一部分,但是因为发现了tsharp_docs的问题希望提供帮助或者其他原因想要使用的,我们致力与在本文中为其提供帮助

软件安装:(Git)

Windows平台:

请访问https://gitforwindows.org/来下载最新版本的Git for Windows

或者直接访问https://git-scm.com/download/win,都一样,不会对下面的操作有影响

安装过程都按照默认选项就可以了

安装完成之后我们按下Windows key +S,输入cmd,按下回车

这时候我们应该看到一个黑乎乎的东西,长这样




gitblit仓库找不到_git


cmd.png

内容为:


Microsoft Windows [Version 10.0.19041.508]
(c) 2020 Microsoft Corporation. All rights reserved.

C:Usersxxxx>


输入git,按下回车,如果这个窗口变成了这样,说明安装正确


gitblit仓库找不到_git_02

git.png


这就是我们所说的命令行工具,因为大家不需要太多的操作,我们只需要学会一些简单的命令

macOS平台:

macOS上面一般是默认安装了Git的,用下面的办法来检查

macOS和Windows上cmd类似,也存在着终端这个软件,打开LaunchPad,输入terminal(如果你的Spotlight搜索默认打开了,那你可以按下Command+Space(空格)来打开Spotlight,然后输入terminal

现在你应该能看到如下画面:

输入git,如果出现以下画面你可以直接跳过下面步骤

如果没有,那么首先将如下命令复制到命令行里面:

安装Homebrew:


/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"


安装Git:(Homebrew 自带)


brew install git


Linux平台:

Linux平台自带git,无需安装

软件安装:(vscode篇)

请到官网:https://code.visualstudio.com/上下载所需的软件,并安装以下插件:


Gitlens
LaTex workshop
markdownlint
Markdown All in One


使用git和vscode编辑文档

现在,先访问本项目主页:https://gitee.com/tsharptop/tsharp_docs

在刚才的命令行中,输入git clone https://gitee.com/tsharptop/tsharp_docs.git,等待一会,出现这样的画面时说明完成:


gitblit仓库找不到_git desktop发布到gitee_03


注意:不可以使用Ctrl+C/V来复制粘贴,在Windows下面使用右键来操作,在macOS上面使用Command+C/V来操作

这样,我们就把这个项目(下面简称repo)复制了一个一模一样的到你的电脑上(下面简称clone

进入当前目录,使用命令cd tsharp_docs来进入tsharp_docs目录

使用命令code .来开启一个在当前目录的vscode

提交到远程仓库

为了向我们的repo做出贡献,你首先要注册一个gitee账户,访问这里:https://gitee.com/signup

然后访问我们项目的官网:https://gitee.com/tsharptop/tsharp_docs,点击右上角的Fork,这样你就创建了自己的分支

在本地项目进行编辑(或者直接使用Gitee上面的编辑器),使用如下命令将本地文件同步到Gitee(你Fork的仓库)上:


git remote add origin <远程仓库地址(你自己的)>
git push --set-upstream origin master


现在你每一次的操作都可以被push到远程仓库上面去,比如,当你在vscode上做出了更改以后,返回项目的根目录,使用以下命令来提交更改:

首先同步项目(从远程同步):


git pull


然后添加更改到工作区:


git add .


提交更改(到本地):(-m后面加上的参数是提交的信息)


git commit -m "Update"


如果你已经学习过vim的用法,或者想更好的更改提交信息,使用以下命令


git commit


然后按下i,进入编辑模式,这时候你可以任意编辑

等到编辑结束,按下esc推出编辑模式,输入wq保存文件

然后,也是最后一步,使用git push命令提交到远程仓库(你的仓库)

接下来,访问项目的地址:https://gitee.com/tsharptop/tsharp_docs

点击上面的Pull request,选择需要同步的版本,点击确认

接下来,我们会审核您提交的内容,如果对社区有益,我们会合并操作,您提交的内容就会成为社区文档的一部分