hexo-github搭建博客
Mtian
本文距离上次更新已过去 0 天,部分内容可能已经过时,请注意甄别。

环境搭建

Hexo 基于 Node.js,搭建过程中还需要使用 npm(Node.js 已带) 和 git,因此先搭建本地操作环境,安装 Node.js 和 Git。

下载 Node.js 和 Git 程序并安装,一路点 “下一步” 按默认配置完成安装。

安装完成后, Win+R 输入 cmd 并打开,依次输入 node -vnpm -vgit --version 并回车,如下图出现程序版本号即可。

image

连接 Github

使用邮箱注册 GitHub 账户,选择免费账户(Free),并完成邮件验证。

  • 打开 Git Bash,设置用户名和邮箱:

    1
    git config --global user.name "GitHub 用户名"
    1
    git config --global user.email "GitHub 邮箱"
  • 创建 SSH 密匙:

    1
    ssh-keygen -t rsa -C "GitHub 邮箱"

    然后一路回车。

  • 添加密匙:

    进入 [C:\Users\用户名.ssh] 目录(要勾选显示“隐藏的项目”),用记事本打开公钥 id_rsa.pub 文件并复制里面的内容。

  • 登陆 GitHub ,进入 Settings 页面,选择左边栏的 SSH and GPG keys,点击 New SSH key。

  • Title 随便取个名字,粘贴复制的 id_rsa.pub 内容到 Key 中,点击 Add SSH key 完成添加。

  • 验证连接:

    打开 Git Bash,输入 ssh -T git@github.com 出现 _Are you sure……_,输入 yes 回车确认。

    image
    显示 *Hi xxx! You've successfully……* 即连接成功。

创建 Github Pages 仓库

GitHub 主页右上角加号 -> New repository:

Repository name 中输入

1
用户名.github.io

Description 选填

勾选 Add a README file

填好后点击 Create repository 创建。

创建后默认自动启用 HTTPS,博客地址为: https://用户名.github.io

本地安装 Hexo 博客程序

新建一个文件夹用来存放 Hexo 的程序文件,如 Hexo-Blog。打开该文件夹,右键 -> Git Bash Here。

安装 Hexo

使用 npm 一键安装 Hexo 博客程序:

1
npm install -g hexo-cli

Mac 用户需要管理员权限(sudo),运行这条命令:

1
sudo npm install -g hexo-cli

安装时间有点久,界面也没任何反应,耐心等待

Hexo 初始化和本地预览

初始化并安装所需组件:

1
hexo init    # 初始化
1
npm install   # 安装组件

完成后依次输入下面命令,启动本地服务器进行预览:

1
hexo g    # 生成页面
1
hexo s    # 启动预览

访问 http://localhost:4000, 出现 Hexo 默认页面,本地博客安装成功!

image

Tips: 如果出现页面加载不出来,可能是端口被占用了。Ctrl+C 关闭服务器,运行 hexo server -p 5000 更改端口号后重试。

Hexo 博客文件夹目录结构如下:

image

部署 Hexo 到 GitHub Pages

本地博客测试成功后,就是上传到 GitHub 进行部署,使其能够在网络上访问。

  • 首先安装 hexo-deployer-git:
1
npm install hexo-deployer-git --save
  • 然后修改 _config.yml 文件末尾的 Deployment 部分,修改成如下:
1
2
3
4
deploy:
type: git
repository: git@github.com:用户名/用户名.github.io.git
branch: main
  • 完成后运行 hexo d 将网站上传部署到 GitHub Pages。

这时访问我们的 GitHub 域名 https://用户名.github.io 就可以看到 Hexo 网站了

绑定域名(可选)

博客搭建完成使用的是 GitHub 的子域名用户名.github.io,我们可以为 Hexo 博客绑定自己的域名替换 GitHub 域名,更加个性化和专业,也利于 SEO。

域名注册和解析

在 DNS 设置部分添加 CNAME 记录将 www 域名解析指向 用户名.github.io

绑定域名到 Hexo 博客

  • 进入本地博客文件夹的 source 目录,打开记事本,里面输入自己的域名,如 www.xxx.com,保存名称为 “CNAME”,格式为 “所有文件”(无 .txt 后缀)。
  • 清除缓存等文件并重新发布网站:
    1
    hexo clean    # 清除缓存文件等
    1
    hexo d    #重新部署 Hexo 到 GitHub Pages
    等待十分钟左右就可以使用自己的域名访问 Hexo 博客了。

开始使用

发布文章

进入博客所在目录,右键打开 Git Bash Here,创建博文:

1
hexo new "My New Post"

然后 source 文件夹中会出现一个 My New Post.md 文件,就可以使用 Markdown 编辑器在该文件中撰写文章了。

写完后运行下面代码将文章渲染并部署到 GitHub Pages 上完成发布。以后每次发布文章都是这两条命令。

1
hexo g    # 生成页面
1
hexo d    # 部署发布

也可以不使用命令自己创建 .md 文件,只需在文件开头手动加入如下格式 Front-matter 即可,写完后运行 hexo ghexo d 发布。

1
2
3
4
5
6
7
8
9
10
11
12
13
---
title: Hello World # 标题
date: 2019/3/26 hh:mm:ss # 时间
categories: # 分类
- Diary
tags: # 标签
- PS3
- Games
---

摘要
<!--more-->
正文

注意:冒号后要加一个空格!

网站设置

包括网站名称、描述、作者、链接样式等,全部在网站目录下的 _config.yml 文件中,参考 官方文档 按需要编辑。

更换主题

Themes | Hexo 选择一个喜欢的主题,比如 NexT,进入网站目录打开 Git Bash Here 下载主题:

1
git clone https://github.com/iissnan/hexo-theme-next themes/next

然后修改 _config.yml 中的 theme 为新主题名称 next,发布。(有的主题需要将 _config.yml 替换为主题自带的,参考主题说明。)

常用命令

1
2
3
4
5
6
7
8
hexo new "name"       # 新建文章
hexo new page "name" # 新建页面
hexo g # 生成页面
hexo d # 部署
hexo g -d # 生成页面并部署
hexo s # 本地预览
hexo clean # 清除缓存和已生成的静态文件
hexo help # 帮助

常见问题

  • 1.Hexo 设置显示文章摘要,首页不显示全文

    Hexo 主页文章列表默认会显示文章全文,浏览时很不方便,可以在文章中插入 <!--more--> 进行分段。

    该代码前面的内容会作为摘要显示,而后面的内容会替换为 Read More 隐藏起来。

  • 2.设置网站图标

    进入 themes/主题 文件夹,打开 _config.yml 配置文件,找到 favicon 修改,一般格式为:favicon: 图标地址。(不同主题可能略有差别)

  • 3.修改并部署后没有效果

    使用 hexo clean 清理后重新部署。

  • 4.开启 HTTPS 后访问网站显示连接不安全?

    证书还未部署生效,等待一会儿,清除浏览器缓存再试。

  • 5.Mac 安装 Hexo 报错无法安装

    Mac 用户需要管理员权限运行,使用 sudo npm install -g hexo-cli 命令安装。

  • 6.npm 下载速度慢,甚至完全没反应

    使用 npm 安装程序等待很久也没反应,或者下载速度很慢,可以更换 npm 源为国内 npm 镜像。

    临时更换方法:在 npm 安装命令后面加上:

    1
    --registry https://registry.npm.taobao.org

参考资料:知乎 @crystal
使用 Hexo+GitHub 搭建个人免费博客教程(小白向)

由 Hexo 驱动 & 主题 Keep
本站由 提供部署服务