利用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即可。