doc-for-hexo

需要准备

Vercel 账号、Github 账号、本地 Git 环境

Vercel 为开发者提供免费的一键式托管服务,可以通过导入主流的代码托管平台的项目来进行静态网站托管。选择 Vercel 的原因不仅是因为其完全免费,而且在国内环境下,其部署的网站访问速度也算是一流。

本文主要是Hexo+NexT搭建博客并且进行主题的配置以及页面的样式优化

本篇文档参考了许多大佬的文章以及配置文件,在此感谢大佬们。

本文参考的文章都会直接给出原文链接或者以注脚的形式标记出处,如有遗漏,欢迎指出。

本文内容会在后续的优化中慢慢补充完整~~

Hexo 博客配合next主题的安装和配置

推荐直接使用我搭好的脚手架,节省时间:
YJ2CS/hexo-archetype-vercel-next

下面将给出配置文档,你可以点击预览成品效果:demo站点

创建Github上的博客仓库

来到骨架的项目首页:YJ2CS/hexo-archetype-vercel-next (github.com)

点击 use this template
xuL7FVCq3gHEpBs.png

创建您自己的博客仓库,名称随便,查看权限建议选择private
Jz645YTSKajhNHE.png

之后点击复制您的git地址,
NDjGXiwUFW1EMnB.png

本地配置本地git环境

这里需要您事先安装好本地git环境,以便于使用git clone命令

关于如何配置本地 Git 环境,可以百度搜教程,有很多。

git clone到本地

在本地使用git克隆

1
git clone https://github.com/YJ2CS/blog-test.git blog

MSCmUKt3vGyW5lr.png

开始写下您博客的第一篇文章

至此,您已经完成了本项目的9成的任务,您可以使用 Hexo 博客框架进行自由的写作,发布自己的想法了!开始自己的创作吧!

见:如何写下您的第一篇文章

上传到GitHub服务器

如果您在本地更新了文章想要发布,或者是对 Hexo 更换了主题,或者是修改了 Hexo 的配置、添加了插件等,

可以使用 git 命令添加文件夹上传至 Github,然后等待几分钟后,Vercel 便会自动将 Github 仓库里的最新提交进行解析部署,

然后成功后会发一封邮件至绑定邮件提醒博客已经更新(可关闭),然后去自己的博客网站就可以看见自己做的修改或者最新的文章已经能看见了。

使用git 命令添加文件夹上传至 Github

1
2
3
git add --all
git commit -m 'new commit 2021-02-01-10-48'
git push

git push过程中出现了问题-单次提交文件体积过大

当您尝试git push到远程仓库,发现单次提交文件体积过大,提交失败,可以尝试以下解决方案

1
2
3
4
# 关闭ssl的安全验证
git config http.sslVerify "false"
# 增大缓冲池 `Buffer`
git config --global http.postBuffer 524288000

524288000代表B,524288000B也就是500MB。这个值得大小,可以根据项目酌情设置。

部署到vercel

本项目附带一篇默认文章,所以您可以直接开始部署您的在线博客

查看文档:hexo-使用vercel托管网站

如果不想部署到vercel还可以选择其他替代方案,比如

hexo-使用netlify托管网站

hexo-使用-github-pages-托管博客

至此,您所有必须的配置都已经完成,下面给出一些项目特性介绍和完整环境配置的链接

本地环境配置–nodejs

本地安装node.js环境

如果您需要使用完整的hexo功能,比如进行更多的自定义配置,您还需要安装nodejs的相关环境

具体安装见:hexo-nodejs环境配置

项目特性

在我的博客里,我简单介绍了一些插件,和它们带来的特性,您可以选择查看,

hexo-next-blog-lamirs脚手架项目特性集成

事实上,它们大部分已经集成到了您的博客中,您不必过分关注

next主题自定义配置

hexo-next主题自定义配置

如何更好的写出文章

hexo-记录常用插件和脚本的配置过程

SEO推广

hexo-seo推广

常用的维护命令

您可能对Hexo的常用维护命令感兴趣

使用下列命令在本地生成网页

1
hexo g

您也可以加上-force后缀来强制重新生成网页

1
hexo g -f

感谢

参考:
Hexo官方文档
NexT使用文档
Windows下部署安装Hexo
创建Hexo项目
Hexo博客上传至Github
使用NexT主题优化Hexo博客