【教程】使用ＧＩＴＨＵＢ管理文本格式源码

Xelloss0618

火山新版本支持了文本格式源码，终于可以用 Git 做版本管理。
不过火山的文本编码是 UTF-16LE，使用 Git 还是有些坑的，这里以 ＧＩＴＨＵＢ 为例写个简单的教程。

注册 ＧＩＴＨＵＢ 账户这些就不说了，下载安装窗口版的 ＧＩＴＨＵＢ Desktop（当然你也可以用命令行版的 Git）。
https://desktop.ＧＩＴＨＵＢ.com/

一、登录 ＧＩＴＨＵＢ 账户，执行菜单 [File - Options]
图中是登录后的，未登录是 Sign in


二、创建仓库，执行菜单 [File - New repository]

这里注意一下，创建后的仓库路径是 [Local path\Name]，如图创建后是 C:\Users\Xelloss\Desktop\VolSample
可以选择现有的文件夹，如果文件夹不存在会自动创建。

如果你的项目需要设置忽略文件，这里可以随便选择一个 Git ignore 选项，它就会在仓库中生成一个 .gitignore 文件，否则你就需要以后自己创建这个文件。

三、创建仓库后，如果在 History 里有一个初始提交，建议对它右键，Undo commit，取消这个提交。
这里查看一下 .wsv 文件，发现 ＧＩＴＨＵＢ 将它识别为二进制文件，不能比较内容，
这是因为 Git 默认只支持 UTF-8 编码的文本，因此我们需要设置一下。


四、打开仓库文件夹，会发现里面有一个 .gitattributes 文件


编辑该文件，添加以下内容（注意尾部至少有一个空行）：

*.wsv text working-tree-encoding=UTF-16LE-BOM eol=CRLF diff
*.vgrp text working-tree-encoding=UTF-16LE-BOM eol=CRLF diff
*.vsln text working-tree-encoding=UTF-16LE-BOM eol=CRLF diff
*.vprj text working-tree-encoding=UTF-16LE-BOM eol=CRLF diff

五、如果你不想提交 .v 等二进制文件，如图编辑 .gitignore 文件，添加行 *.v


六、这个时候再看 ＧＩＴＨＵＢ Desktop，就会发现已经能识别和比较火山的文本格式。
按图中的顺序提交更改（建议可以写一些注释），和将更改上传到 ＧＩＴＨＵＢ。


七、首次上传会在 ＧＩＴＨＵＢ 上创建仓库

如果勾选了图中红框的选项，会设置成私密仓库，只有你自己能查看，如果想公开仓库就取消勾选，或者之后在 ＧＩＴＨＵＢ 网站上更改。

八、如果之后修改了源码，重复上面的提交更改和上传两步操作即可

本教程不涉及更复杂的 Git 操作，就到此为止了。

Xelloss0618

注意，新版本还没正式发布，这里先发篇教程而已

xqnh520

期待Gradle尽快上线

locoman

盛赞既有能力又有道义的贴主！！
有如此热情热心的队友，何愁火山不火！！

诗木

这文本没有阅读性

fengyishen

终于能复制了吖。挺好！

jzy

棒

zqiz

好期待新版本

zqiz

好期待新版本

zqiz

好期待新版本