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
创建您自己的博客仓库,名称随便,查看权限建议选择private
之后点击复制您的git地址,
本地配置本地git环境
这里需要您事先安装好本地git
环境,以便于使用git clone
命令
关于如何配置本地 Git
环境,可以百度搜教程,有很多。
git clone到本地
在本地使用git克隆
git clone https://github.com/YJ2CS/blog-test.git blog
开始写下您博客的第一篇文章
至此,您已经完成了本项目的9成的任务,您可以使用 Hexo 博客框架进行自由的写作,发布自己的想法了!开始自己的创作吧!
上传到GitHub服务器
如果您在本地更新了文章想要发布,或者是对 Hexo 更换了主题,或者是修改了 Hexo 的配置、添加了插件等,
可以使用 git 命令添加文件夹上传至 Github,然后等待几分钟后,Vercel 便会自动将 Github 仓库里的最新提交进行解析部署,
然后成功后会发一封邮件至绑定邮件提醒博客已经更新(可关闭),然后去自己的博客网站就可以看见自己做的修改或者最新的文章已经能看见了。
使用git 命令添加文件夹上传至 Github
git add --all
git commit -m 'new commit 2021-02-01-10-48'
git push
git push过程中出现了问题-单次提交文件体积过大
当您尝试git push到远程仓库,发现单次提交文件体积过大,提交失败,可以尝试以下解决方案
# 关闭ssl的安全验证
git config http.sslVerify "false"
# 增大缓冲池 `Buffer`
git config --global http.postBuffer 524288000
524288000代表B,524288000B也就是500MB。这个值得大小,可以根据项目酌情设置。
部署到vercel
本项目附带一篇默认文章,所以您可以直接开始部署您的在线博客
查看文档:hexo-使用vercel托管网站
如果不想部署到vercel还可以选择其他替代方案,比如
至此,您所有必须的配置都已经完成,下面给出一些项目特性介绍和完整环境配置的链接
本地环境配置--nodejs
本地安装node.js环境
如果您需要使用完整的hexo功能,比如进行更多的自定义配置,您还需要安装nodejs的相关环境
具体安装见:hexo-nodejs环境配置
项目特性
在我的博客里,我简单介绍了一些插件,和它们带来的特性,您可以选择查看,
hexo-next-blog-lamirs脚手架项目特性集成
事实上,它们大部分已经集成到了您的博客中,您不必过分关注
next主题自定义配置
如何更好的写出文章
SEO推广
常用的维护命令
您可能对Hexo的常用维护命令感兴趣
使用下列命令在本地生成网页
hexo g
您也可以加上-force后缀来强制重新生成网页
hexo g -f
感谢
参考:Hexo官方文档NexT使用文档Windows下部署安装Hexo创建Hexo项目Hexo博客上传至Github使用NexT主题优化Hexo博客