说明
本教程将采用hexo+vercel+netify cms的方案进行部署 本方案的优势
- 完全免费
- 静态网页,无渲染时间
- 在线编辑,就像使用动态 CMS 一样简单,由 Netlify-CMS 支持
- 无需本地环境,您可以在任何设备上随时随地编辑您的页面
- 无需代码
- 使用Vercel CDN 使您的页面可以从世界任何地方(包括中国大陆)快速加载
- 轻松绑定到您的域,并启用 SSL 加密,Vercel 支持
- 对萌新友好
相关准备
账号
- 一个github账号
- 一个vercel账号(注册似乎需要科学上网)
本地环境
- 安装
Node.js
- 安装
Git
- 建议准备一个科学上网环境,不然一些资源可能下载极其缓慢。还可能会出现一些奇奇怪怪的报错。
汉化(非必须)
英语好的可以无视。
Git bash设置中文
打开Git bash后,命令窗口右键Options —>Window —>UI language,下拉选择 zh_CN
Git GUI安装中文
Git GUI汉化包
下载好后按照作者文档将zh_cn.msg
文件移动到指定位置
至此,准备工作结束。
在线部署
获取项目文件
访问项目地址
- 点击Use this template,然后进行你自己的设置,建议公开度设置为私有。
- 访问项目文件source/admin/config.yml,并修改其中的repo为你自己的路径。例如我的github用户名为123而fork后创建的库名字为abc-hexo,那么这个值就填123/abc-hexo。
- 修改base_url值为你博客的域名,注意需要带上https://
- 还有一点就是这2个值的冒号后面是需要留空格的。
创建一个oauth应用
- 上滑网页,然后点击GitHub右上角你的头像
- 点击设置(倒数第二个)
- 然后往下滑,在左边找到开发者设置
- 转到后点击第二个,点击右边创建应用
- 应用名称和描述随便,第二个输入框Homepage URL填入你在上面填的base_url值为你博客的域名,注意仍需要带上https://,第四个框Authorization callback URL填入你的域名(就是上面第二部设置的)/callback
- 完成后点击生成新的Client secrets,将值复制下来。
在vercel部署博客
- 选择你的博客
- 添加环境变量
OAUTH_GITHUB_CLIENT_ID
和OAUTH_GITHUB_CLIENT_SECRET
,这两个值都可以在上一步的应用里找到。 - 点击Deploy按钮,等待部署完成。
- 在项目的Settings > Domains中更改为你的域名(就是上面一直设置的值)
- 更改好了后,你的博客基本上就完成了。你可以在你的域名后面加上
/adinm/
登录你的GitHub账号访问后台。 - 接下来是一些高级操作,可以选择性观看。当然,都看到这里了,我猜没有人会拒绝继续看下去吧。
将你的博客克隆到本地
- 点击你右下角的开始菜单,在所有应用里找到Git GUI并启动
- 点击帮助>显示ssh密钥,然后生成一个密钥
- 复制密钥,然后转到GitHub设置下的ssh,将你复制的key粘贴上去,名称随意。
- 接下来设置本地账户
- 设置用户名
git config --global user.name "yourname"
- 设置用户邮箱
git config --global user.email "myemail@xx.com"
- 注意替换为你自己的内容。
- 打开Git GUI,选择克隆已有版本库。源位置在你的github项目代码可以看到。如
git@github.com:jhq223/hexo-netlify-cms-vercel.git
。目标位置你就选择一个想要存放的路径(该目录必须不存在,而且建议不要用中文) - 推荐使用VS COde来进行本地写作
- 按住win+R,输入cmd,在cmd里面安装hexo
如果安装失败,可能是没有权限,可以尝试头部加上 sudo 重新执行
在本地运行hexo
- 在你存博客文件的目录鼠标右键
- 选择Git Bash here
- 然后在弹出的终端输入
hexo s
本地运行 - 接着你可以在浏览器打开
http://localhost:4000
进行预览。 - 点击
Ctrl
+C可以停止。
这样做的一些好处
- 使用
npm install
默认安装所有package.json
文件中提到的包 - 用如
npm install hexo-render-pug hexo-renderer-stylus
直接安装某插件。 - 在进行一些修改时可以直接在本地预览。
- 直接使用
hexo new page xxx
或hexo new post xxx
新建页面和文章。
安装主题
- 在根目录新建
themes
文件夹,将主题下载到本地并解压到该目录,如\themes\yun 这个yun文件夹中就是下载的主题文件。 - 修改配置文件,启用主题。
将本地修改后的代码上传
- 启动Git GUI 打开项目
- 确保当前分支是
main
,如果不是就改一下本地分支名字 - 依次点击下面的扫描,缓存改动等,最后点击上传。
- 上传失败请尝试勾选强制覆盖已有的分支。