基于Hexo和Github搭建博客

时间:2022-05-24 14:16:26

搭建自己的个人博客。

准备工作

确保电脑需要已下载安装node和npm。查看安装是否成功,windows只需在命令行输入以下两条命令即可。

1
2
$ node -v
$ npm -v

安装hexo

安装hexo

1
$ npm install -g hexo

检测hexo版本来确保hexo是否成功安装

1
$ hexo v

基于Hexo和Github搭建博客

注:可能报错,可以试试执行

1
npm install hexo --no-optional

进入本地工程目录,初始化hexo

1
2
$ cd blog
$ hexo init

npm安装package.json中的依赖包

1
$ npm install

生成博客文件

1
$ hexo g

启动本地博客

1
$ hexo s

基于Hexo和Github搭建博客
此时在浏览器输入http://localhost:4000即可访问默认主题的hexo博客
基于Hexo和Github搭建博客

查看hexo帮助

1
$ hexo help

修改全局配置文件

对本地blog目录下的_congig.yml进行修改配置即可。

网站

参数 描述
title 网站标题
subtitle 网站副标题
description 网站描述
author 您的名字
language 网站使用的语言
timezone 网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说:America/New_York,Japan, 和 UTC 。

网址

参数 描述 默认值
url 网址  
root 网站根目录  
permalink 文章的 永久链接 格式 :year/:month/:day/:title/
permalink_default 永久链接中各部分的默认值

目录

参数 描述 默认值
source_dir 资源文件夹,这个文件夹用来存放内容。 source
public_dir 公共文件夹,这个文件夹用于存放生成的站点文件。 public
tag_dir 标签文件夹 tags
archive_dir 归档文件夹 archives
category_dir 分类文件夹 categories
code_dir Include code 文件夹 `downloads/code
i18n_dir 国际化(i18n)文件夹 :lang
skip_render 跳过指定文件的渲染,您可使用 glob 表达式来匹配路径。

文章

参数 描述 默认值
new_post_name 新文章的文件名称 :title.md
default_layout 预设布局 post
auto_spacing 在中文和英文之间加入空格 false
titlecase 把标题转换为 title case false
external_link 在新标签中打开链接 true
filename_case 把文件名称转换为 (1) 小写或 (2) 大写 0
render_drafts 显示草稿 false
post_asset_folder 启动 Asset 文件夹 false
relative_link 把链接改为与根目录的相对位址 false
future 显示未来的文章 true
highlight 代码块的设置

分类 & 标签

参数 描述 默认值
default_category 默认分类 uncategorized
category_map 分类别名  
tag_map 标签别名

日期 / 时间格式

Hexo 使用 Moment.js 来解析和显示时间。

参数 描述 默认值
date_format 日期格式 MMM D YYYY
time_format 时间格式 H:mm:ss

分页

参数 描述 默认值
per_page 每页显示的文章量 (0 = 关闭分页功能) 10
pagination_dir 分页目录 page

扩展

参数 描述
theme 当前主题名称。值为false时禁用主题
deploy 部署部分的设置

配置github

新建仓库

  1. 登录github,点击右上角加号,点击new respository

基于Hexo和Github搭建博客

  1. 在跳转界面填写信息

基于Hexo和Github搭建博客

生成测试页面

进入新建的仓库,点击右上角的settings,在跳转页面点击 launch automatic page generator,在跳转页面点击continue to layouts,接着选择主题,生成页面,约15min后,访问https://syd1992.github.io,即可显示生成测试页面

基于Hexo和Github搭建博客

基于Hexo和Github搭建博客

创建ssh keys

  1. 检测ssh keys是否已存在,即id_rsa,id_resa.pub是否存在
1
$ ls -al ~/.ssh

基于Hexo和Github搭建博客

  1. 生成ssh keys(若ssh keys不存在)
1
$ ssh-keygen -t rsa -C "847909475@qq.com"

输入命令后,会提示输入ssh keys保存位置,一般无需改,直接回车即可;接着提示输入密码,并确认再次输入密码,这个密码后面会有使用,一定要记住!

  1. 查看生成的ssh keys中的公钥
1
$ cat ~/.ssh/id_rsa.pub

基于Hexo和Github搭建博客

给github仓库添加ssh keys

  1. 点击创建的仓库右上侧的settings,在跳转页面左下侧点击deploy keys

基于Hexo和Github搭建博客

  1. 在跳转页面点击add deploy keys,title随意填,在key部分将创建ssh keys步骤中的id_rsa.pub内容粘贴在该部分

基于Hexo和Github搭建博客

测试连接

执行命令,输入命令后,问yes/no,输入yes即可,提示输入密码,则输入生成ssh keys时设置的密码

1
$ ssh -T git@github.com

最后提示如下内容,表示成功

1
Hi, 用户名/用户名.github.io! You've successfully authenticated, but GitHub does notprovide shell access.

配置根目录下的_config.yml文件并发布

  1. 安装hexo-deployer-git
1
$ npm install hexo-deployer-git --save
  1. 修改_config.yml的deploy内容,如下图

基于Hexo和Github搭建博客

  1. 生成博客文件,每次修改本地文件后,都要执行该命令
1
$ hexo g
  1. 发布
1
$ hexo d

此时,访问https://syd192.github.io.git即可看到自己的辛勤劳动成果咯!!

切换主题

默认主题是landscape,如果不太喜欢,可以访问这里获取更多的主题。本人选择主题是TKL,具体切换方法如下:

  1. 下载TKL主题
1
$ git clone https://github.com/SuperKieran/TKL.git theme/TKL
  1. 配置根目录下的_config.yml文件

基于Hexo和Github搭建博客

然后,hexo g,再hexo d,即可正常访问。

注:图片url填写,图片文件夹img应放在source文件目录下,url直接写为/img/图片.png即可。

写一篇博客

  1. 新建博客
1
$ hexo new "newBlog"
  1. 在根目录下source文件夹下找到对应的newBlog.md文件,按照markdown规则,编写博客。

    在该newBlog.md文件的头部,可以对该博客进行配置,如博客标题title,博客创建时间date,所属分类categories,标签tags

然后,hexo g,再hexo d,即可正常访问。

最后来张成果图,继续加油咯~~~~

基于Hexo和Github搭建博客

参考链接

    1. 史上最详细的Hexo博客搭建图文教程
    2. 使用hexo搭建github.io博客(一)
    3. 基于 Hexo 和 GitHub Pages 搭建博客