Hexo 是一个高效的静态网站生成器,使用简洁的 Markdown(或其他模板引擎)编写内容,支持丰富的插件和主题,允许用户轻松定制网站。它通过将文本转换为静态HTML页面,使得网站加载速度快,易于部署,同时支持多平台发布,非常适合创建博客、文档或个人网站。本文将介绍如何使用Hexo搭建个人博客并且将博客文章免费放到github上。
1. 安装环境
本机是Windows 10 专业版,此教程适用于Windows10, Windows11各版本。
Hexo是基于Node.js的框架,同时我们要用到git进行部署。
软件需求:
软件安装教程
2. 本地搭建Hexo环境
官网地址:Hexo
2.1 新建blog文件夹
在电脑硬盘上任意位置新建存放blog文件的文件,例如d:\blog。本文将以d:\hexo_blog文件夹来演示如何搭建环境,同学可以根据你自己的情况建立文件夹。
2.2 使用Git Bash初始化环境
进入此文件夹,在任意空白处点击右键,在右键菜单中选择Open Git Bash here
,打开Git Bash
窗口。如果右键菜单中无此选项,请检查环境搭建是否成功。Git图文安装教程
打开之后输入以下命令修改npm的源为阿里的源:
npm config set registry https://registry.npmmirror.com
执行完成之后,输入以下命令一键安装hexo
npm install hexo-cli -g
完成之后再依次执行以下命令并回车,启动初始化并安装组件:
hexo init
npm install
命令执行完毕之后,文件夹里会增加类似以下的文件目录,安装完成。
可能遇到的问题:
输入
hexo init
后,可能卡在INFO Install dependencies
不动,此时需按下Ctrl+C停止此命令,继续输入npm install
即可。
2.3 启动Hexo服务
安装完成之后,在hexo博客目录下执行以下命令开启Hexo服务(默认情况下,访问网址为: http://localhost:4000/
):
hexo server
或者缩写方式
hexo s
见到如下图界面表名Hexo服务启动成功。打开浏览器输入http://localhost:4000/
即可看到博客预览界面。
启动过程中如果出现Windows安全中心警报
,需要点允许访问
。
恭喜,Hexo服务启动成功!!!其他详细设置,可参考官方文档继续完善。
3. 部署到GitHub Pages
3.1 创建GitHub仓库
登录GitHub账号之后新建一个仓库,仓库名为用户名.github.io
,这里的用户名替换为你自己GitHub上的用户名。
比如你的用户名是ABc123,新建的仓库名就是abc123.github.io
没有Github账号的同学可以参考教程注册。
创建时,选择Public
类型。勾选Add a README file
来创建默认的main
分支。 仓库名为用户名.github.io
。填写完毕之后点击Create repository
按钮完成创建。
3.2 为GitHub账号设置ssh
3.2.1 设置本地git账号
在刚才的Git Bash
窗口中输入以下命令并回车,将其中你的GitHub信息替换掉。
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"
3.2.2 本地创建ssh密钥文件
在Git Bash
窗口中输入以下命令并回车,注意替换其中的邮箱。接下来的3个输入的地方直接输入回车即可,不用设置密码。
ssh-keygen -t rsa -C "你的GitHub注册邮箱"
生成之后,去当前用户名的文件夹下的.ssh文件夹中找到id_rsa.pub
密钥文件,用文本编辑器打开并复制其内容。
当前用户名的文件一般是C:\Users\Administrator\.ssh
,如果当前系统用户不是Administrator,只需要把Administrator换成你的用户名即可。
3.2.3 在GitHub新建ssh key
回到浏览器,在github的页面中点击右上角的用户头像按钮,在弹出的菜单中选择Settings
功能。
在新页面中点击左侧菜单中的SSH and GPG keys
按钮进入SSH keys设置页面。
点击页面右侧的New SSH key
按钮,新增ssh key
在新页面中如下图填写并点击按钮保存。
在Git Bash中检测GitHub公钥设置是否成功,输入以下命令
ssh git@github.com
如上则说明成功。这里之所以设置GitHub密钥原因是,通过非对称加密的公钥与私钥来完成加密,公钥放置在GitHub上,私钥放置在自己的电脑里。GitHub要求每次推送代码都是合法用户,所以每次推送都需要输入账号密码验证推送用户是否是合法用户,为了省去每次输入密码的步骤,采用了ssh,当你推送的时候,git就会匹配你的私钥跟GitHub上面的公钥是否是配对的,若是匹配就认为你是合法用户,则允许推送。这样可以保证每次的推送都是正确合法的。
3.3 将博客部署到GitHub
在刚才的Git Bash
窗口中输入以下命令,安装hexo-deployer-git插件:
npm install hexo-deployer-git --save
打开博客文件夹中的_config.yml
文件,找到其中deploy
的部分并更改deploy的内容,用户名替换为自己的github用户名,修改完成之后保存并关闭该文件。
deploy:
type: 'git'
repo: git@github.com:用户名/用户名.github.io.git
branch: main
回到Git Bash
窗口,输入以下命令生成静态文件:
hexo g
上传到GitHub
hexo d
![image-20240720193321657](https://mvkersc.oss-cn-beijing.aliyuncs.com/image-20240720193321657.png
恭喜你已经成功配置好了ssh连接GitHub,并已经把生成的静态页面上传github成功了。
接下来可以在浏览器中打开**https://用户名.github.io**
查看你的博客效果,快去试一下吧。
4. 部署到Vercel加速访问
在国内访问 GitHub 时,有时可能需要科学上网才能访问,或者可能会遇到缓慢的加载时间,这可能会给您与朋友分享博客带来不便。为了避免这种尴尬,您可以利用 Vercel 提供的加速服务,确保您的朋友能流畅地访问和欣赏您的博客内容。
4.1 注册账号
打开Vercel官网登录页面: Vercel,点击右上角Sign Up
按钮开始注册。
我们是个人用户所以选择第一项Hobby,输入用户名,点击Continue
按钮继续。
在新页面中点击按钮Continue with GitHub
在弹出连接GitHub
的界面,点击按钮Authorize Vercel
按钮进行授权,等待进入下个界面。
在新的页面里面输入手机号进行绑定,收到验证码后输入验证码等待绑定完成。
4.2 添加新项目
点击Install
按钮进入仓库选择界面。
在选择仓库界面选择你GitHub中博客所在的仓库,点击Install
按钮导入。
输入GitHub密码,点击Confirm
按钮确认导入项目。
项目导入成功之后,在首页点击Import
按钮将项目导入到容器。
4.3 部署项目到容器
在部署确认页面点击Deploy
按钮确认部署。
部署成功。点击Continue to Dashboard
按钮跳转到首页。
点击上方的Setting
进入设置界面,可以更改项目名称。也可以不修改。
至此,Vercel设置已经完成。可以通过项目主页的Domain
来访问你的博客。
原文地址:原文地址