Hexo+Github Pages+yilia搭建博客

Hexo+PigGo

Posted by Mayday on January 6, 2020

Hexo+Github Pages+yilia搭建博客

一、什么是Github Pages

请自行查询,总之是github支持的首页展示仓库,适合用来做博客首页,每个帐号只能有一个仓库来存放个人主页,而且仓库的名字必须是username/username.github.io

二、环境准备

1.安装node.js 2.安装npm 3.安装git,如果前面要commit、push,那之前就应该安装 4.github账户配置和github pages仓库配置

三、Hexo安装

利用 npm 命令即可安装。在桌面任意位置点击鼠标右键,选择Git Base/Git Base Here

输入命令:

npm install -g hexo

注意:-g是指全局安装hexo。

在任意位置创建一个hexo文件夹。进去文件夹 鼠标右键 选择Git Base/Git Base Here

完成命令操作如下:

$ cd d:/hexo                    # 此处以d盘新建hexo文件夹为例
$ npm install hexo-cli -g       # 全局安装hexo


$ hexo init blog                # hexo初始化,初始化文件夹命名为blog
$ cd blog                       # 进入blog文件夹
$ npm install                   # 执行


$ hexo generate                        # 或者hexo generate
$ hexo server # 或者hexo s,可以在http://localhost:4000/ 查看(hexo s -p 8023端口被占用时)

注意:执行hexo命令必须在hexo当前文件夹目录,否则提示命令不正确。

四、Hexo主题切换

Hexo默认主题是landscape,大家可以切换成为next或者yilia的风格

步骤1. 安装主题

$ hexo clean
$ git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

步骤2. 启用主题

修改Hexo目录下的_config.yml配置文件中的theme属性,将其设置为yilia。

$ vim _config.yml

步骤3. 更新主题

所谓的更新主题,其实就是步骤2更新主题配置文件后,重新启动hexo即可

$ cd themes/yilia   ## 可以选择不执行更新
$ git pull          ## 可以不执行

## 以下命令退回到hexo文件夹路径执行,否则提示命令错误
$ hexo generate # 生成
$ hexo server # 启动本地web服务器

步骤4. 本地访问

打开http://localhost:8023/ ,会看到一个全新的界面。

步骤5. 部署Hexo到Github Pages

以上步骤都完成后,写好博客后,如何部署到Github Pages呢

1.部署Hexo到Github Pages上的原理

a.第一步中我们在Github上创建了一个特殊的repo(gladysgong.github.io)一个最大的特点就是master中的html静态文件,可以通过链接http://gladysgong.github.io来直接访问。

b.Hexo -g 会生成一个静态网站(第一次会生成一个public目录),这个静态文件可以直接访问。

c.将hexo生成的静态网站,提交(git commit)到github上。

2.使用hexo deploy部署到github

3.安装扩展(不安装会出错)

五、MarkDown编写神器

推荐使用Typore软件编写,软件很小,功能齐全。比如本文编写界面如下:

支持标题、代码块、引用、粗体等各种基本功能,不熟悉markdown的同学使用起来特别方便。

六、图片上传神器PigGO

写markdown文章,难以避免的会需要添加图片。

参考文章 图床工具的使用—PicGo 即可。

6.1 入门教程如下:

1、 [PigGo快速上手] (https://picgo.github.io/PicGo-Doc/zh/guide/getting-started.html)

6.2 实操步骤如下

1、下载piggo

  • PigGo官网地址 https://github.com/Molunerfinn/PicGo

  • PigGo版本发布地址 https://github.com/Molunerfinn/PicGo/releases

2、生成github token

获取git个人token如下,用于步骤三种设置github图床权限:

git token生成

3、piggo配置截图如下

如果不想每次重命名,配置时间戳命名即可。此处只需要使用Github图传,只勾选Github图床即可。

配置1

配置Github图传仓库、分支名、Token,以及子路径等

配置2

图片上传方式支持拖拽、剪切板。剪切板方式不需要保存图片,配合智能截图工具Snipaste,那感觉顿时感觉markdown上传图片从此不再是难题。

图上传区

4、引用图片

在相册文件中复制markdown格式的链接到markdown中即可,是不是很简单。

七、其他说明

7.1 hexo仓库区分博客源代码和博客生成代码

使用Hexo搭建博客需要区分【博客源代码】和【博客生成代码】

『博客源代码』:Hexo的源码,包括themes目录(博客模板),source目录(使用MarkDown写的博客)等

『博客生成代码』:执行hexo generate或者hexo server命令生成的代码,是Hexo自动生成的,在public目录里面。

『博客源代码』需要使用Git做版本管理,而『博客生成代码』需要使用Git部署。因此容易混淆。

使用2个不同的Git仓库分别管理『博客源代码』和『博客生成代码』

附 参考文章

  1. Hexo+Github Pages+yilia搭建博客
  2. 图床工具的使用—PicGo