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