如何搭建自己免费的技术博客-工具盒子

你好，我是猿java。

技术博客，可以作为自己技术输出的一种方式，相对使用第三方的技术论坛，自己的技术博客更有自主性和归属感，更重要的是你可以写已所想，不用被第三方平台各种审核不通过(国家法律法规限制的就除外哦)，看过很多搭建技术博客的帖子，网上也用过很多开源的框架，个人觉得比较理想的是GitHub Pages+Jekyll，因此今天就分享一下如何用这两个组合搭建自己免费的技术博客。

GitHub Pages {#GitHub-Pages}

GitHub Pages是大名鼎鼎的代码托管平台Github的一个功能，它是面向用户、组织和项目开放的公共静态页面搭建托管服务，详情可以参考官网，使用 Github Pages的优缺点如下：

GitHub Pages官网地址：https://pages.github.com/

优点

页面节约不简陋，整体风格看起来很清爽
完全免费，其中服务器、域名什么的都管，完全零费用搭建一个技术博客
写博客就是提交代码，让写作和编程的体验保持一致
支持绑定自己的域名
提供流行的网页主题模板

缺点

不支持动态内容，博客必须都是静态网页，一般会使用Jekyll来构建内容
博客不能被百度索引，具体原因可以google一下
仓库空间有限，一般不大于1G
每个月的流量有限，一般不超过100G
每小时更新频率有限，一般不超过10次

Jekyll {#Jekyll}

Jekyll是和GitHub Pages搭建静态网站的黄金搭档，它是一个简单的博客形态的静态站点生产机器，如果你是做java开发的，可以把Jekyll类比与Tomcat，Jetty之类的服务。它可以把标准的Markdown格式文档渲染器转化成一个完整的可发布的静态网站，可以发布在nginx等服务器上，也可以运行在 GitHub Page上。

Jekyll github地址：https://github.com/DONGChuan/Yummy-Jekyll

Jekyll主题比较多，你可以选择自己喜欢的风格，详情参见：http://jekyllthemes.org/

如何快速搭建GitHub 上免费的网站 {#如何快速搭建GitHub-上免费的网站}

你需要注册一个github账号，然后进入链接 https://github.com/yuanjavar/yuanjava.github.io，将项目fork到你自己的github仓库，这样你就有了一个现成的静态模板。

删除CNAME文件(若无此文件，忽略该操作)

删除项目根目录中的CNAME文件，CNAME是定制域名的时候使用的内容，如果不使用定制域名会存在冲突。

重新命名仓库名称

如下图操作，修改fork出的仓库名称，名称修改成自己需要的

设置Github Pages

如下图操作，点击Settings按钮进入，左边找到Pages，然后设置分支等信息，点击保存后会出现一条提示

访问步骤4中生成的地址

浏览器地址栏中输入：https://yuanjavar.github.io/yuanjava.github.io/ ，如下图，样式有问题，是因为页面中的地址是http开头，当前访问地址是https的，做前端的小伙伴应该知道https不能访问http，大家只要修改成相对地址就好了。

修改仓库根目录下的_config.xml
repository: yuanjavar/yuanjava.github.io
github_url: https://github.com/yuanjavar
url: https://www.yuanjava.cn
将三面三个内容修改成你的对应信息
编写博文

如下文，将仓库 clone到你的本地机器上，然后在idea中编写符合Markdown格式的技术博客，然后push到master就OK了

到此，一个技术博客就部署好了，是不是很easy？

如何自定义域名 {#如何自定义域名}

在上述过程中我们的域名是https://yuanjavar.github.io/yuanjava.github.io/ ，如果大家想绑定自己的域名也是OK的，首先你需要有一个已经备案的域名，然后在你的域名服务商去做域名解析，然后将域名填入github中

没有备案域名的，可以参考博文注册和备案域名 https://www.yuanjava.cn/common/2022/03/21/domain.html
github 绑定域名参考：https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site

OK，到此，我们就介绍了如何快速用GitHub Pages+Jekyll黄金组合搭建一个免费的网站以及如何绑定自定义域名，有兴趣的小伙伴可以去实操一遍，有任何疑问，欢迎在留言区留言。