Github 基本使用学习笔记

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 来发布你的个人或项目站点。