利用GitHub搭建个人博客页面,目前共有以下几种技术路线:
序号 | 技术路线 | 编程语言 |
---|---|---|
1 | GitHub Pages+ Jekyll | Ruby |
2 | GitHub Pages+ Hexo | JavaScript |
3 | GitHub Pages+ Hugo | Go |
4 | GitHub Pages+ Pelican | Python语言 |
其本质的思路都是在GitHub
上创建一个特定仓库,配置其仓库属性
,使其成为存放静态网页文件
的展示仓库,然后使用特定域名进行访问。
本站点目前采用的搭建博客的方式是使用 GitHub Pages + jekyll 的方式,其中GitHub Pages是GitHub官方推出的适用于中小型博客或项目主页的建站服务工具,
Jekyll 是GitHub官方推荐的基于Ruby的静态网页生成系统。因为该方式较为简单,所以目前暂且选择了该路线,网上大部分是GitHub Pages+ Hexo的技术路线。
一、GitHub创建特定仓库
在GitHub上创建一个具有公共权限的新仓库,命名为username.GitHub.io的格式:
二、选择一个GitHub Pages的主题
然后在仓库的设置页面找到Pages/Choose a theme选项并点击:
选择一个模板并提交:
这样就可以通过访问username.github.io访问该站点。
但是这样子生成的网站页面只能展示一些简单的页面,如果想要展示功能更丰富的网站功能,需要借助静态网页生成系统。
三、导入并配置静态网站模板
网上有多种基于jekyll的静态网站模板,我们可以下载一个然后替换掉该仓库的文件,例如:
本博客使用网站模板链接:BY Blog
该网站模板不需要下载额外的插件,当然功能也很有限。
四、配置个性化的静态网站
假设我们使用的网站模板链接是:BY Blog
1、修改_config.yml文件
在该文件中我们可以方便地修改如下属性:
网站主标题(title)、主标题下简介(description)、网址栏简介(SEOTitle)、首页背景图片路径(header-img)、个人邮箱(email)、个人关键词(keyword)等
2、修改导航栏入口
网站首页的导航栏(首页概况、项目背景、文章博客等)可以自定义
其中首页概况
是默认的导航地址,需要在_includes/nav.html
中修改其名称。
而项目背景
、文章博客
等是由当前项目中的根目录下的配置属性为layout:page
的.html文件决定的
,如该网站的1-projects.html。这类文件名称可以自定义,但是其中内容属性必须为layout:page
,且必须在根目录,
3、发表自己的博客
所有的博客必须以.md的形式放在_posts
文件夹下,且命名必须以2021-08-18-
的时间格式开头;
.md博客的开头必须有
layout: post title: 博客标题 subtitle: 博客子标题 date: 2021-09-26 author: 作者 header-img: img/the-first.png catalog: True tags:
- 技术笔记
作者一般用Typora文件写.md文件,然后用GitHub Desktop软件同步到GitHub网站,缺点是引用图片时比较繁琐。
作者将博客的图片统一放在img-post
文件夹下,然后在.md内以![](/img-post/XXX.png)
的格式进行引用
4、修改网站的小图标
使用一些免费的.ico图片在线制作网站()制作一个32*32的.ico文件,替换掉img
文件夹中的favicon.ico
即可。