Github Pages

Github Pages是Github推出的一项网站服务，有关Pages的核心就一点：**创建一个名为username.github.io的仓库。Github会自动识别为一个网站，网站的url就是username.github.io **

操作起来也很简单，步骤如下：

  • 在Gtihub新建一个repository
  • 在第一栏，Owner要选自己，Repository name填username.github.io，username就是你Github的用户名
  • 可见性选Public，因为Pages free的账号只能public，有钱可以选Private，然后在新建之后的仓库Setting里，左侧栏选Pages，里边有升级成Pages Pro的选项，这样你的网站项目就可以隐藏，但每年要支付一定的费用
  • 勾选 Initialize this repository with a README
  • 点Create repository按钮新建仓库

此时你便拥有了自己的Pages个人主页，可以尝试输入网址打开看看，这个生成好的 Repository 就是用来存放博客内容的地方

绑定个人域名

如果你有一个个人域名，也可以在Repository-Settings-Pages里的Custom domain选项填上自己的个人域名，这样你的Pages就和你的个人域名绑定了，输入你的域名就会自动跳转到你个人的Pages

Hexo

生成 Repository之后，接下来就是要往这个Repository 里搭博客了

Hexo是一款本地博客框架，可以运行一个本地的静态博客网站，如果你只需要在自己电脑用，那就不用Pages了

Hexo使用起来很方便，只要在本地编辑好.md后缀的文章，然后重新部署就可以了，而且Hexo官网提供了大量的主题模板

1.搭建Node.js环境

  • 前往 https://nodejs.org/en/
  • 下载最新LTS版本
  • 安装
  • 打开Command Prompt，输入 node -v
  • 显示版本号
  • 成功

2.安装Hexo

  • 打开Command Prompt
  • 执行npm install -g hexo-cli
  • 输入 hexo -v查看版本即安装成功

3.Hexo的初始化

  • 创建blog文件夹，位置建议各盘根目录
  • 打开任一终端(PowerShell/Windows Terminal/Git Bash等均可)，进入刚才创建的blog路径下
  • 执行hexo init 将 blog 文件夹初始化
  • 执行 npm install 安装依赖包
  • 执行 hexo g 开始进行部署操作
  • 执行 hexo s 将生成的网页放在本地服务器
  • 打开浏览器，输入网址 http://localhost:4000/ 就可以看到本地的博客效果了
  • 效果没问题，返回终端按 Ctrl + C 中止服务运行

4.发布博客文章
发布博客文章也是较为简单的，需要在本地新建一个博客文档，打开本地进行编辑后，重新部署发布即可，操作如下：

  • 打开刚才的终端
  • 在blog路径下执行 hexo new "Test"
  • 生成的.md文件路径在 blog\source\_posts下

打开Test.md，会发现Hexo已经为我们生成了一个表头，表头的格式如下 

1
2
3
title: Test                       //文章标题
date: 2021-0X-XX XX:XX:XX         //生成日期
tags:                             //所属标签

然后，在其下随便写一些内容，保存
回到终端，执行hexo g部署，然后执行 hexo s发布，刷新 http://localhost:4000/ 查看结果

在 Github 上部署 Hexo

操作如下：

1
2
3
4
5
6
7
8
# Site
title: Santa的博客
subtitle: 'My personal blog'
description: '记录、分享、交流'
keywords:
author: 蒋胜达
language: en
timezone: ''
  • 查找**# URL**字段，修改如下： 
1
2
3
4
5
6
7
8
# URL
## Set your site url here. For example, if you use GitHub Page, set url as 'https://username.github.io/project'
url: https://santajiang.github.io/
permalink: :year/:month/:day/:title/
permalink_defaults:
pretty_urls:
  trailing_index: true # Set to false to remove trailing 'index.html' from permalinks
  trailing_html: true # Set to false to remove trailing '.html' from permalinks

注意url填写的是pages网址不是仓库地址

  • 查找deploy字段，修改如下： 
1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: git
repository: git@github.com:SantaJiang/santajiang.github.io.git
branch: main

这里要注意两点！

  1. Github后续更新了默认主分支的名称，已经不叫master了，改为了main，如果还是写master，并不会报错，但是会在main分支之外新建一个master分支
  2. repository一栏必须填ssh的地址，因为GitHub的密码验证于2021年8月13日不再支持，也就是不能再用密码方式去提交代码。要使用personal access token替代，当然这里我建议用SSH免密登陆，具体GitHub如何配置SSH免密登陆的步骤不在这里详述了，然后继续：
  • 回到终端，执行 npm install hexo-deployer-git --save 只需执行一次，后续无需再执行
  • 执行 hexo d 部署
  • 登录 santajiang.github.io.git 查看效果