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
贡献代码的流程:
- Fork 项目:复制你想贡献的项目到自己的GitHub仓库。
- 修改仓库代码:在你自己的仓库中进行代码修改。
- 发起Pull Request:将你修改后的代码提交给原项目的仓库进行审核。
- 等待审核:原仓库的维护者审核你的修改,若合适会将其合并到原项目中。
4. Git 的作用
目的:使用 Git 来管理和托管代码,并将代码上传至 GitHub 进行共享和协作。
5. 搭建 GitHub 页面
5.1 访问个人站点
个人站点的 URL 格式为 https://用户名.github.io
。
5.2 搭建步骤
创建个人站点
新建一个仓库,仓库名必须为[用户名].github.io
。在仓库中创建
index.html
文件
创建一个简单的 HTML 文件作为网站的首页。
注:GitHub Pages 仅支持静态网页,仓库里只能包含 HTML 文件。
5.3 项目站点设置
在仓库的 Settings 页面中,选择 GitHub Pages 来发布你的个人或项目站点。