Github 基本使用学习笔记

发布于:2024-11-29 ⋅ 阅读:(23) ⋅ 点赞:(0)

1. 基本概念

1.1 一些名词

  • Repository(仓库)
    用来存放代码,每个项目都有一个独立的仓库。

  • Star(收藏)
    收藏你喜欢的项目,方便以后查看。

  • Fork(克隆复制项目)
    复制别人的仓库(项目)。Fork后的项目是独立存在的,可以自由修改。

  • Pull Request(发送请求)
    将你在自己仓库中的更新提交给原仓库的创建者,请求将你的更改合并到原仓库。等待仓库创建者的查看和合并。

  • Watch(关注)
    关注一个项目,项目更新时会接收到通知。

  • Issue(事物卡片)
    当发现代码有问题但尚无解决方案时,使用Issue进行讨论,类似于做笔记。

1.2 一些页面

  • GitHub主页
    显示动态、关注的项目、个人信息等内容。

  • 仓库主页
    展示仓库和项目的相关信息,包括创建仓库和个人主页的说明。

  • 个人主页
    显示你关注的人、项目,自己关注的Git库,自己的开源项目及贡献等信息。


2. 创建仓库(Create a New Repository)

2.1 README 文件

README 文件用于详细描述项目内容和功能。
注:此文件将允许你立即将仓库克隆到你的计算机上,如果你导入的是已有的仓库,则可以跳过此步骤。

2.2 新建文件

每次新建文件时,确保文件名有相应的后缀名。

2.3 提交修改(Commit)

每次修改文件后,都需要提交修改并说明修改的原因。

2.4 删除文件

可以在仓库中删除文件,删除操作会记录在提交日志中。

2.5 GitHub Issues

GitHub Issues用于代码的讨论与问题交流。当问题解决后,仓库管理员会关闭相应的Issue。


3. 开源项目贡献流程

3.1 新建Issue

你可以通过创建Issue提交使用问题、建议或想法,促进项目讨论与优化。

3.2 Pull Request

贡献代码的流程:

  1. Fork 项目:复制你想贡献的项目到自己的GitHub仓库。
  2. 修改仓库代码:在你自己的仓库中进行代码修改。
  3. 发起Pull Request:将你修改后的代码提交给原项目的仓库进行审核。
  4. 等待审核:原仓库的维护者审核你的修改,若合适会将其合并到原项目中。

4. Git 的作用

目的:使用 Git 来管理和托管代码,并将代码上传至 GitHub 进行共享和协作。


5. 搭建 GitHub 页面

5.1 访问个人站点

个人站点的 URL 格式为 https://用户名.github.io

5.2 搭建步骤

  1. 创建个人站点
    新建一个仓库,仓库名必须为 [用户名].github.io

  2. 在仓库中创建 index.html 文件
    创建一个简单的 HTML 文件作为网站的首页。

注:GitHub Pages 仅支持静态网页,仓库里只能包含 HTML 文件。

5.3 项目站点设置

在仓库的 Settings 页面中,选择 GitHub Pages 来发布你的个人或项目站点。