创建GitHub技术博客全攻略

最新推荐文章于 2025-08-31 09:43:28 发布

转载最新推荐文章于 2025-08-31 09:43:28 发布 · 119 阅读

本文指导你如何使用GitHub账号创建个人技术博客，包括注册、验证邮箱、创建页面仓库、设置页面、生成用户页面及查看效果的全过程。

说明: 首先,你须要注冊一个 github 账号,最好取一个有意义的名字,比方姓名全拼,昵称全拼,假设被占用,能够加上有意义的数字.
本文中假设username为 tiemaocsdn

1. 注冊账号:
地址: https://github.com/
输入账号、邮箱、password,然后点击注冊button.

图1 第1步

2. 初始设置
注冊完毕后,选择 Free免费账号完毕设置。

图2 第2步

2.1 验证邮箱
请打开你的邮箱，查看发送给你的确认邮件，你须要验证邮箱后,后面生成的个人主页才会被接受和公布.

3. 创建页面仓库
地址: https://github.com/new
这个仓库的名字须要和你的账号相应，如 tiemaocsdn.github.io
输入基本信息,然后点击创建仓库.

图3 第3步

4. 进入项目设置页面
由于这个项目就是专门的放页面的,所以 master分支就可以. 假设是你的某个仓库的页面,你须要设置到 gh-pages 分支中,关于这些,请參考本文末尾提到的參考资料.

图4 第4步

5. 进入自己主动页面生成器
在设置页面,下拉究竟部, 默认分支(master)不用管.

图5 第5步

6.1 创建用户页面(即技术博客站点)
输入一些内容,能够自己编辑,也能够从readme载入：

图6-1 第6-1步

6.2 继续,选择主题

图6-2 第6-2步

7. 选择主题,然后公布
例如以下图所看到的,事实上这些以后你都能够自己改动替换,这仅仅是生成一些css,html,img到你的仓库里面.

图7 第7步

8. 查看效果
如今,你能够訪问自己的GitHub.io 上的主页了，比如：
http://tiemaocsdn.github.io/
页面效果例如以下图所看到的:

图8 第8步

注意事项:

假设报404，或者其它错误,请稍等,或者检查你的邮箱，看看构建失败的提示信息.
比方我的,由于最初没有验证邮箱,结果收到了好几次公布失败的通知(如以下的邮件提示)。
以后每次你提交(或在线改动后提交)文件到这个仓库,GitHub 都会自己主动为你构建,并公布。
所以,有问题,请改动并提交某个文件，又一次试试吧！

The page build failed with the following error:


You need a verified email address in your GitHub account to publish Pages.
You can verify your email addresses from your Settings panel:


    https://github.com/settings/emails


If you have any questions please contact us at https://github.com/contact.

以下是參考的一部分:

您能够通过GitHub的页面自己主动生成器高速为项目,用户(User,比方你的账号),或组织(Organization, 比方 alibaba) 创建一个站点(事实上就是技术博客啦)。

生成用户/组织的网页

要生成用户/组织的站点页面,你须要创建一个仓库(repository,代码库),名为: username.github.io 或 orgname.github.io ； username或组织名必须是你自己的账号, 否则GitHub Pages 站点不会帮你生成(build,构建,编译,)。 GitHub的页面自己主动生成器能够通过仓库的设置页面(Settings page)看到。您能够阅读很多其它关于用户和组织页面的内容。

警告: GitHub页面站点在互联网上是公开,即使其仓库是私有的。假设你有敏感数据在页面仓库中,您可能须要在公布之前删除他们。

參考地址:

假设你看到这里,假设你已登录, 假设认为对你有帮助,请点击以下的 “顶” button.

假设有问题,有建议,请留言。

赶快试试吧！

GitHub.io技术博客的优点: 写博客,你能够自定义JS，CSS，图片,嵌入iframe 显示代码演示样例,什么你都能够自定义,什么标签都同意,而在其它的技术博客站点,由于安全限制,非常多是不同意的。