git及GitHub学习收获与使用总结

一、git及GitHub学习收获

1、git的安装与配置（参考菜鸟教程：http://www.runoob.com/git/git-install-setup.html）

2、Github的使用：

（1）.首先注册GitHub账号（这个根据注册账号指引即可）
（2）.在本地创建ssh key，使用命令：ssh-keygen -t rsa -C “你注册GitThb时的邮箱”

( a ).创建ssh key命令
( b ).ssh key保存路径
( c ).输入GitHub登陆密码
( d ).生成的key

（3）.进入Account Settings(账户配置)，进行配置。


（4）.创建Github的存储仓库（点击1的start a project后跳转）

（5）.验证是否配置成功，输入命令：ssh -T git@github.com
（6）.创建git用户角色，并创建版本库，上传本地项目至Github存储仓库。操作命令步骤：

            cd 本地项目位置
            git init
            git config user.name "用户名"
            git config user.email "邮箱"
            git add * 
            git commit -m "备注"
            git remote add origin https://github.com/GitHub用户名/仓库名.git
            git push -u origin master

二、GitHub使用总结

1、链接显示问题

在完成项目的过程中，发现index.md文档中存在着一个无关紧要却让人看起来很难受的问题：

• （1）About
• （2）[Team profile](report/documents/02-team profile.md—(注：为了显示效
  果，未打右括号)

   如上所示，同样是链接的表示，一个可以正常显示，一个则不可以，不过在网页中都是正常显示
   链接的，不影响正常使用访问，所以实质影响并不大。但在GitHub文档中看起来却显得格外不
   舒服，并且也影响文档的访问查看。于是查找了很多博客希望可以得到解决方法都没有成功，后
   来去到往届作品的文档里面仔细观察往届师兄们的写法，寻找不同，最后猜测是因为有空格的
   缘故(02-team profile.md之间的空格）才导致不能正常显示，于是进行实践（将02-team 
   profile.md改为02-team_profile.md)，发现顺利解决感官上的问题。如下：

• （2）Team profile

  注意：需记得同时修改原文档命名；
  思考：以后需要认真系统学习GitHub及其他工具、平台的各种标准规则准确的使用方法，不可囫
  囵吞枣，要练扎实“基本功”。

2、图片显示问题

• （1）发现：在完成作业的过程中，github中一些图片无法正常显示。
• （2）问题：在一些文档中上传的图片用 "![](UML/pictures/脑图.png”—(注：为了显示效果，
  未打右括号)不能正常显示，如下;

• （3）思考：刚开始以为图片无法正常显示是网络和GitHub延迟的问题，没仔细注意，后来发现每次点进去总是显示失败，并且刷新也没有效果，于是找了很多方法，换了很多图片所在位置的定位输入方式，均未能正常显示。但其他一些文档同样的输入方式却可以完全正常地显示，仔细 对比发现也未能发现区别，就在要打算放弃的时候，觉得有必要换个思路，把文档地位输入方式直接换为图片的网址链接，终于解决了问题。如下；

    "![脑图](https://github.com/uml163/UML/blob/master/pictures/
    %E8%84%91%E5%9B%BE.png?raw=true"---(注：为了显示效果，未打右括号)
   
    猜测：无法显示问题可能是上传的图片位置不好写进去，所以找到图片位置也还是显示不了；
    也可能是图片大小及格式原因的影响；或者GitHub缓存器问题。直接用图片网址链接则可以
    直接避免这些问题。如下；

• （4）备注：需在GitHub repository 的文件地址后面加"?raw=true"。

      插入 Github 上面的图片时其链接一定要注意，请在原 img 上右键复制该图片的实际
      存放的路径而不是在github 上的网页路径。否则 gitpages 会渲染不出来。

      对于同一张图片，有下面示例。
      错误示例 
      https://github.com/uml163/UML/blob/master/pictures/%E8%84%91%E5%9B%BE.png

      正确示例
      https://i-blog.csdnimg.cn/blog_migrate/aeb6baa864c53a59af24e02e9f93038e.png

3、GitHub访问受限问题

github偶尔会出现无法访问的问题，有时候等段时间就可以了，而有时候等一天也还是无法访问，昨天我就遇到了这样的
问题。这势必会为完成项目带来不必要的麻烦和浪费时间，因此去CSDN上学习了很多解决的办法，终于找到了一种有效解
决方案，下面是关于我的学习收获。

• （1）找到hosts文件在里面做些修改。定位路径：C：\Windows\System32\drivers\etc（这里以windows10系统为例）
• （2）找到hosts文件，“右键-属性-安全-编辑”，选中当前电脑登录的用户，给自己最高权限，确认。
  
• （3）然后用记事本打开，在最后一行加：

         192.30.253.113 github.com
         192.30.252.131 github.com
         185.31.16.185 github.global.ssl.fastly.net
         74.125.237.1 dl-ssl.google.com
         173.194.127.200 groups.google.com
         192.30.252.131 github.com
         185.31.16.185 github.global.ssl.fastly.net
         74.125.128.95 ajax.googleapis.com

• （4）再访问github：

访问成功，问题解决。

4、GitHub中文档访问路径出错的问题

在GitHub中不同文件夹间文档链接路径可能存在访问出错问题。如：

• [About](report/documents/01-about.md—(注：为了显示效果，
  未打右括号)不能正常访问：
  About

解决方法：

• [About](/report/documents/01-about.md—(注：为了显示效果，
  未打右括号)访问正常：
  About