美文网首页iOS学习上海恩美路演学无止境
四步搞定mac github客户端 & readme.m

四步搞定mac github客户端 & readme.m

作者: 凉风起君子意如何 | 来源:发表于2017-03-28 17:24 被阅读385次

    github到底是干嘛的,有什么作用,我想只要是看到这个标题进来的你,应该都知道一二,也许你只是一时兴起误闯的,也没关系,google或百度github,你就会懂的,这里就不做赘述了。GitHub Desktop官方下载链接

    其实,网上关于mac github桌面客户端使用还是有些资料的,只是自己亲身去实践一遍,发现还是有些要补充的,就写下这么个总结,方便自己以后查阅,也希望能帮到遇到同样问题的你。

    简单四步搞定:

    • 创建github账号
    • 提交本地项目到github上,并更新同步提交代码
    • clone github服务器上的项目到本地
    • 创建项目分支,并将改动合并到主支

    一,创建github账号

    要想让github帮我们托管项目,首先肯定是要有一个github账号的,点击注册github账号

    点击sign up根据提示一步一步填写注册即可

    二,提交本地项目到github上,并更新同步提交代码

    • 下载安装完了GitHub Desktop之后,界面大概是这样的,自带的指导手册已被删,但是界面差不多。
    • 把本地项目加入到github本地仓库,并提交到github上。(注意图片下的说明)
    这里你也可以选Create,好了之后把需要上传的项目拷贝到该路径下就行 点击Create&Add Repository之后如此图
    • 至此,你已成功将本地项目上传到了github上,是不是很简单😁。提交更新也是一样的,细心的你应该也发现了本地项目有任何改动的话,在github desktop里面都会相应的提示,之后你要提交哪个文件就选中哪个文件,记得写上简要和详细注释,之后commit就ok了。

    三,Clone github服务器上的项目到本地

    对程序员来说,估计没有人不喜欢github的,因为github上实在是有太多的很好的开源库和实用的demo,比如说AFNetworking,MJExtension等。这时候你就会用到clone,当然你可以下载下来,只是假如有更新的话,你又要重新下载,好麻烦。如果选择clone的话,只需要同步下就行。

    • clone github服务器上别人的项目
    • clone github上自己的项目

    四,创建项目分支,并将改动合并到主支

    • 创建分支
    • 把代码提交到分支上
    • Pull Request,合并

    问题小结:

    • 上传本地项目到github上的时候,出现如下错误

    解决方法:删掉github服务器上的资源库,先不要把内容commit,只是publish空资源库,之后再commit 同步,就行了。 如果还是不行可能是你提交的内容太多,网速有不好导致的,可以分批次commit。(我就遇到过,因为提交了个gif文件,一起提交就报这个错误,分批次提交就好了)

    README.md插入png图片

    • 将图片上传到github上
    1 上传成功,刷新浏览器,能查看到图片文件夹
    • 获取图片相对路径
    2 点击copy path拿到图片相对路径
    • 在README.md中输入图片绝对路径

    特别注意: 正确:https://github.com/用户名/资源库名称/raw/master/screenshots/screenshot1.png 而不是:https://github.com/用户名/刚才copy的相对路径 网上有的说是这样,其实这样图片是显示不出来的

    3 README.md文件插入图片语法,类似markdown语法

    README.md插入gif图片

    github上好多demo都配有gif动态图,对短时间了解demo非常有帮助且比较清晰,果断就网上搜了下。最后,发现其实跟上面插入图片用法是一样的。只是这个动态图的格式要注意,不能是MP4,要为gif才行。
    Tip:最新qq自带录屏功能(control+cmd+a,默认是截屏,选择录屏),得到gif动态图(结束录屏之后不要选择绿色的勾,而是要选择旁边的另存为,里面有保存格式选择,记得选gif),并上传到github上(操作同之前插入图片)


    设置sshkey

    • 拷贝公匙
      1、得到公匙,打开终端输入如下命令,
      ssh-keygen -t rsa -C "caohuoxiasoft@163.com"
      会让你输入文件存放位置和密码,也可以忽略直接enter。
      2、复制id_rsa.pub文件内容
      下面两种方法都可以
      方法一:用cat命令打开pub文件,之后选中显示的内容复制(直接双击系统是打不开该文件的,注意pub文件路径,我的是在/Users/admin/.ssh/下面的,具体的可以自己查找下)
      cat /Users/admin/.ssh/id_rsa.pub
      方法二:执行如下命令之后,直接黏贴到github服务器上,保存就好
      pbcopy < ~/.ssh/id_rsa.pub
    • github上,cmd+v黏贴公匙
    • 激活公匙
      ssh -T git@github.com
      新添加到github上的秘钥左边的点一开始是灰色的,终端执行这个命令后,刷新网页会看到灰色点变成了绿色.

    简书上的这篇文章写的也很详细

    git常用命令这个网页已总结的很好,直接拿来用,就不写了

    相关文章

      网友评论

        本文标题:四步搞定mac github客户端 & readme.m

        本文链接:https://www.haomeiwen.com/subject/xbpjottx.html