从零开始，完全新手教程

[mengchaoheng]

首先为什么写这个，主要是看的很多使用本项目的同学并不习惯标准的git工作流程，即使他们都具备条件但是似乎不习惯。我简短总结一下希望能拉他们入坑。

##新手教程

1.首先注册一个GitHub账号，然后在你的系统上安装git。这部分内容在网上有很多资料，作为基础的基础这里不做展开。

2.找到我的项目地址，然后fork，然后用点击code，点击复制，长这样：

https://github.com/你的GitHub账号/SCUT_thesis.git

再到你想要进行编辑工作的文件夹下打开终端：win下右键找Git Bash Here，macOS下启动台找终端cd到你的目录。然后

git clone https://github.com/你的GitHub账号/SCUT_thesis.git

这里git clone后面的就是你点击code后复制那段地址。最好新增一个分支，以后我的模版有重大更新方便合并：

cd SCUT_thesis
git checkout -b  分支名称 # 新建你的分支
git  push -u origin 分支名称 # 将你的分支推送到远程

然后打开vocode或者texstudio进行编辑。有改动的话经常git status查看状态，简而言之：
先

git status # 看看你改了哪些文件，确认是不是你想要提交的
git add .  # 暂存所有文件

再写本次提交信息：

git commit -m "提交说明"

最后推到云端：

git push

这样周而复始，如果你顺利的话就一直循环这个过程直到毕业：修改->git add . ->git commit -m "提交说明“->git push。实在不放心的，适当的时候可以硬盘备份一下你的文件。但其实git备份更靠谱。

除非模版出现重大问题，或者你是git重度用户，高级玩家，否则不要往下看了。

##高级玩家
如果发现模版有什么问题，或者如果中途我有更新，而你想体验新版。先切换到master分支，设置新远程地址upstream，从upstream上fetch下来查看差异再合并。这时只是合并了master分支，你自己的论文在你的分支。通常是单独的章节文件，而我改master只有主文件和格式文件对你有影响，但也不能一概而论，会导致很复杂的合并问题。所以需要在vscode仔细查看再合并。注意#后的文字是注释，不用复制到终端执行。

1.设置一下上游分支，只设置一次：

git checkout master
git remote add upstream https://github.com/mengchaoheng/SCUT_thesis.git #只用添加一次
git fetch upstream
git merge upstream/master #通常以上这两步在进行过本步骤之后，才可以git pull直接进行，但太危险。
git branch --set-upstream-to=upstream/master master  #将 master 分支设置为从 upstream 远端抓取，这一步完成以后就可以直接在master分支下git pull了

这时终端运行

git remote -vv

可以查看当前远程库的情况，origin是你的地址，名为upstream的是我的上游仓库地址。

2.在写论文过程中，每次有需要更新模版的时候，执行：

git checkout master
git fetch upstream master # 只拉我的master分支下来
git status 

此时用git status ，可以在终端看到 :

On branch master
Your branch is behind 'upstream/master' by xxx commits, and can be fast-forwarded.
  (use "git pull" to update your local branch)

可以直接pull最好，老手的话切换完分支直接git pull。但有时小心为甚，先fetch再用merge。

合并新的master到你的本地master分支

git checkout master  # 一定确定你是在master分支上
git merge upstream/master

然后切换到你的分支，合并刚刚得到的本地最新的master。

git checkout 你的分支名
git merge master 

解决冲突后，如果论文编译成功没问题了再commit：

git add .
git commit -m "update"

最后，将本地你的分支推送到origin远程，同时默认origin为远程，以后就可以直接git push了，但这里完全是为了防止出错。

git push -u origin 你的分支名   # 设置过一次后直接git push就行

如果实在感觉困难，我建议用最笨的办法：新建一个文件夹，把我更新的文件放进去，在切换到你的分支，找到这些文件下你的改动，把你的论文内容放进去，再整个复制覆盖到你的论文目录，再按照上述流程提及。

[mengchaoheng]

至于发烧级玩家，可以推pr给我，非常乐意接受大家的建议。