原创文章首发微信公众号「后端技术学堂」转载请先与我联系,点文末链接「了解更多」
你是否想有一个自己的博客,这里详细记录和分享我的博客搭建经验,让你轻轻松松拥有自己的博客网站。 傻瓜式一站式教你用github pages 来搭建博客,详细记录全过程。
开始
先看下博客整体效果。在线预览我的博客https://lemonchann.github.io/
支持特性
- 简约风格博客
- Powered By Jekyll
- 博客文章搜索
- 自定义社交链接
- 网站访客统计
- Google Analytics 网站分析
- Gitalk评论功能
- 自定义关于about页面
- 支持中文布局
- 支持归档与标签
建立博客Git仓库
首先你要在github上有自己博客仓库,用来生成和存放博客文章。你可以直接fork我的博客仓库。这样你马上有了自己的博客仓库。
点这里我的博客地址进去fork,之后在你自己的仓库下会看到刚复制的仓库。以后的操作都在你自己的仓库进行。
版权声明:fork之后_posts文件夹内容是我的博客文章,版权归我所有。你可以选择删除里面的文章替换上自己的或者转载附上链接注明出处。
修改博客仓库名称
进到你自己的博客仓库,修改博客仓库名称成你自己的用户名。github page解析的时候找的是这个 username.github.io的仓库名。
此时,不出意外的话,打开域名https://username.github.io 就能看到你刚搭建的博客了。注意替换username成你自己的github用户名。
博客配置
上面点开域名看到的还是我的博客配置,显示的博客名字也是我的。还需要更改配置才是你的博客。
博客的配置文件是仓库根目录下的_config.yml文件,直接点开它编辑。
你还需要更改以下配置:
博客名称和描述
分别是博客名称和描述,自己任意写点啥。
博客社交链接
这里配置社交链接按钮,没配的不显示,我现在配了知乎、邮箱、github账号三个。其他你想加自己加上就可以。
配置gitalk
这个是评论功能的配置。评论功能基于gitalk,在配置文件中找到gitalk配置项目:
修改规则如下:
gitalk:
clientID:<你的clientID>
clientSecret:<你的clientSecret>
repo:<你的repository名称>
owner:<你的GitHub用户名>
原理是利用github的issues评论文章。其中clientID和clientSecret需要点击这里创建
点绿色按钮创建,成功之后会得到以上两个id,修改配置即可。
Google站长统计
首先你要去注册一个谷歌分析账号,它可以统计你博客网站的访问人数,访问来源等非常丰富的网站数据。如果你不在乎可以不用跳过这节。不过要把配置中我的google_analytics: UA-XXXXXXX-X删除,否则统计到我的去了。
# Enter your Google Analytics web tracking code (e.g. UA-2110908-2) to activate tracking
google_analytics: UA-XXXXXXX-X
下面是我的网站实时分析页面展示:
由于不可描述的原因,国内注册账号可能会遇到问题,所有不配置也没关系。
博客网址配置
# Your website URL (e.g. http://barryclark.github.io or http://www.barryclark.co)
# Used for Sitemap.xml and your RSS feed
url: https://yourname.github.io
这里配置你自己的博客地址。
配置提交
对_config.ymld的修改需要提交才能生效,点下图中绿色按钮提交。
done! 现在输入上面提到的博客地址,回车,你拥有了自己的博客。
如何写博客
好了,博客有了。如何更新文章呢?
文章用markdown语法,写好统一放在_post文件夹下上传,git page会自动从你的git仓库拉去解析成网页,立刻就能在你的博客网页浏览。
关于文章的命名格式:博客文章必须按照统一的命名格式 yyyy-mm-dd-blogName.md 比如我这篇博客的名字是2019-11-22-create_blog_with_github_pages.md
好了,现在你已经拥有了自己的博客。
如果你还有兴趣了解一些博客DIY定制的过程,可以在我的公众号「后端技术学堂」查看原文了解更多。
致谢
感谢Jekyll提供的技术支持才能有这个博客。
感谢LOFFER: https://fromendworld.github.io/LOFFER/document/ 提供的原始模板,我在其上进行的二次开发。
创作不易,点赞关注支持一下吧
我会持续分享软件编程和程序员那些事,欢迎关注。若你对编程感兴趣,我整理了这些年学习编程大约3G的资源汇总,关注公众号「后端技术学堂」后发送「资料」免费获取。
查看原文,点下方「了解更多」链接。
,