hexo博客搭建

-
2024-06-16

介绍:

Hexo 是一款基于Node.js 的快速、简洁且高效的静态博客框架。 Hexo 使用Markdown(或其他渲染引擎)解析文章,安装十分方便,配置简单,自定义功能强大,在几秒内,即可利用靓丽的主题生成静态网页。


也就是说,是一个把md转换为博客样式的网页的工具

部署

前置需求

安装环境node.js和npm

https://nodejs.org/en/

#Debian/Ubuntu
sudo apt-get update
sudo apt-get install -y nodejs npm

#CentOS/RHEL
curl -sL https://rpm.nodesource.com/setup_16.x | sudo bash -
sudo yum install -y nodejs

#Alpine Linux(容器推荐)
sudo apk update
sudo apk add nodejs npm

安装git bash

如果说要托管到github pages需要安装git命令

部署

(Windows:在 git bash 中输入以下命令启用 Hexo镜像)

设置源:
npm config set registry https://registry.npmjs.org/

在 git bash 中输入以下命令开始全局安装 Hexo

npm install -g hexo-cli

在 git bash 中输入

hexo init [自定义博客名]

在 git bash 中输入hexo g ,编译静态文件到public文件夹,这是根目录会自动生成public文件夹

hexo g 

在 git bash 中输入hexo s,启动本地预览,关闭gitbash后,就无法预览

hexo s

输入 http://localhost:4000 ,能正常访问,则启动成功

主题

https://hexo.io/themes/

在这个网站可以看到好多大神的博客主题,都非常牛逼

创建分类和标签(标签和分类创建方法是一样的,关键是给博文的属性)

hexo new page [分类/标签]
#博文属性
categories: [分类名]
tages: [标签名]

安装渲染器

npm install hexo-renderer-pug hexo-renderer-stylus --save

关联github

注册github.com账号

新建一个github仓库,仓库名必须是你的GitHub用户名.github.io,

比如1jia1.github.io

目的是为了搭载 GitHub Pages 服务,如果导入到vercel,可以自定义其它用户名


生成SSH密钥

在 git bash 中输入如下命令

 git config --global user.name “你的GitHub用户名”
 git config --global user.email "你注册github的邮箱"
 ##生成密匙命令
 ssh-keygen -t rsa -C "你注册github的邮箱"

在本地电脑中找到新生成的公匙,复制id_rsa.pub中的内容

找到github个人图像

设置-SSH and GPG keys-New SSH Key-粘贴公钥


验证是否成功

输入命令

ssh -T [email protected]

打开 _config.yml,找到文件最后一行的 deploy

替换以下代码

deploy:
  type: git
  repo: https://github.com/你的github用户名/你的github用户名.github.io.git,main 

 

安装推送命令

npm install hexo-deployer-git --save

清理缓存,重新生成静态文件,推送到github的命令

hexo clean && hexo g && hexo de

推送成功后

访问网址:你的GitHub用户名.github.io


 


目录