使用Hexo搭建属于静态博客

阿呆2024-11-132025-01-21

配置环境

下载 Git，Node

安装hexo并初始化

首先创建一个文件夹，进入并右键选择Open Git Bash here 输入

#安装hexo
sudo npm install -g hexo-cli
#初始化hexo
hexo init blog
#安装npm
npm install

创建Github page

打开GitHub，并创建账号。
登陆之后点击Create a new repository

Repository name 输入GitHub名称.github.io点击Create repository

例如GIthub名称 adaiblog ， Repository name：adaiblog.github.io

Hexo关联Github

在Git Bash 中输入

#安装deploy-git
npm install hexo-deployer-git --save
#GithubName: Github用户名
git config --global user.name "GithubName"
#GithubEmail：Github绑定的邮箱
git config --global user.email "GithubEmail"

创建SSH keys

1	ssh-keygen -t rsa -C "GithubEmail"

输入之后一路回车，在C:\Users\adai.ssh找到id_rsa.pub 并复制其中的内容

\adai为windoss用户名，根据自身名称查找

点击Github个人头像找到setting ->SSH and GPG keys ->New SSH keyb ,将id_rsa.pub 内容复制到Key中

打开博客文件中的_config.yml 拉到最下面输入

deploy:
  - type: 'git'
    repo: git@github.com:GithubName/GithubName.github.io.git
    branch: master

保存之后在Git Bash 输入

#生成静态文件
hexo g
#部署上传到github
hexo d

# 其他hexo操作
# 创建文章
hexo new "Name"
#本地服务预览
hexo s 
# 清除缓存文件
hexo clean

GithubName换成自己的名称

更换主题

打开Hexo主题，下载主题文件，将文件复制到blog文件夹下面的themes中，并打开_config.yml找到theme：landscape,将landscape改成下载主题文件夹名称

绑定域名开启HTTPS

进入到域名管理页面，点击域名解析创建两条记录
记录类型 CNAME
主机记录 www
记录值：博客地址

记录类型 CNAME
主机记录 @
记录值：博客地址

在blog目录中进入source，并创建一个名为CNAME，内容输入域名保存
打开Github，点击创建的GIthub用户名.github.io仓，进入点击上方Settings，选择Pages在Custom domain中输入域名并勾选Enforce HTTPS

搭建部分错误

提示Please make sure you have the correct access rights and the repository exists.

可能是git绑定名称邮箱不对，或者密钥错误，这里我们查看并重新生成密钥

git config --list    //查看user.name,user.eamil是否正确，不正确重新设置
git config --global user.name "GithubName"     //GithubName: Github用户名
git config --global user.email "GithubEmail"   //#GithubEmail：Github绑定的邮箱
ssh-keygen -t rsa -C "GithubEmail"             //生成密钥

网络原因，查看是否开启github加速器等软件，关闭尝试看是否成功。
如还是不行,检查是否能连接github.com

1	ssh -T git@github.com

如提示：ssh: connect to host github.com port 22: Connection refused,22端口不行就改成443端口
在C:\Users\用户名.ssh（也就是密钥文件地方）创建一个config并输入以下内容保存

Host github.com
User git
Hostname ssh.github.com
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_rsa
Port 443
 
Host gitlab.com
Hostname altssh.gitlab.com
User git
Port 443
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_rsa

博客短链接地址

打开_config.yml,找到permalink并修改

1	permalink: posts/:id.html

在文章上面加入ID：xxxx作为文章地址

生成站点xml

安装站点地图生成插件

1
2

npm install hexo-generator-sitemap --save         //谷歌
npm install hexo-generator-baidu-sitemap --save   //百度，申请门坎：30天内，日均点击量大于1w，快速收录需要加入VIP俱乐部

打开根目录_config.yml添加

sitemap:
  path: sitemap.xml
  template: ./sitemap_template.xml
  template_txt: ./sitemap_template.txt
  rel: false
  tags: true
  categories: true
baidusitemap:
  path: baidusitemap.xml

在跟目录source文件夹中创建robots.txt并输入

User-agent: *
Allow: /

Sitemap: https://博客域名/sitemap.xml

屏蔽某个文章在其Front-matter中添加

1	sitemap: false

添加RSS订阅

安装插件

1	npm install hexo-generator-feed --save