一、准备工作
1、注册一个github账号在官网。https://github.com/
2、下载mac版的github客户端。网址:https://desktop.github.com
3、之后会在出现安装。安装成功之后,会出现这个
4.登录github客户端并设置邮箱地址
5.注意:
a.在创建工程过程中,工程的名字一定不要有" "空格出现,不然就添加不进去了。因为文件的名字在创建过程中,自动改变了,我就是吃了这个亏了。
b.包含工程最外层的文件名字可以自己更改(也就是文件路径),但是内部的工程的名字不要随意更改,并且保持Name的名字与工程名字一致。否则添加代码也会失败。
二、开始上传
1、从本地选取需要上传的项目
2、填写相应的标题并Commit到本地存储的仓库中
3、点击Commit to master后出现的页面,填写完相应信息publish到仓库
4、进入Github查看刚才上传的项目
5、到此为止上传github完毕,登录githu即可看到刚才上传的工程,可根据需要添加README
5.1、添加gif或图片展示图,在其他用户查看demo时,可以先看下效果图在决定是否需要下载
1、 在本地工程共,添加展示图片截图或只做gif图片(mac gif只做可使用licecap软件制作)
2、将图片或gif添加到刚才的本地工程中
3、 将重复地4步,重新提交github
4、github图片链接格式:![image](http://github.com/github-account/your-repository/raw/master/images-folder/xxx.png)
github-account:gihub账号名称 your-repository:工程名称
images-folder:图片资源在工程中存放的文件夹路径
xxx.png:资源图片或gif文件
为省事可直接在github上查看刚发布的工程,确定github-account/your-repository:
5.2、将效果图链接添加github readme.md文件中:
注意:请使用https请求,至此添加完成,OK了。
三、删除github上相应工程文件
四、更新项目
五、撤销更新
撤销完毕后进入github查看撤销结果
六、遇到的问题
上传时出现:failed to add file / to index
可能是重复上传github,会在本地产生相应的.git文件,该文件为隐藏文件,需要删除所有.git目录,可在终端执行以下命令:
1、显示Mac隐藏文件的命令:defaults write com.apple.finder AppleShowAllFiles YES
2、隐藏Mac隐藏文件的命令:defaults write com.apple.finder AppleShowAllFiles NO
3、重启finder(command+option+esc,选中finder重启),找到相应工程删除所有文件夹下的.git文件,重新Create Repository(创建工程)即可。
删除完.git文件后重复执行上传的步骤