新手建站、搭建个人博客指南 - 知乎 (zhihu.com)
使用hexo上传博客至Github(新的方向新的开始!)-CSDN博客
github page+hexo 绑定域名后页面显示404-CSDN博客
1 | . |
Hexo博客新建&发布文章
创建新文章
在网站根目录下打开命令行Git Bash Here,使用如下命令创建新文章:
1 | hexo new <title> |
执行该命令,Hexo会在/source/_posts目录下创建一篇新的文章。
Front-matter
打开 Hexo 创建的文章可以看到,文章开头有这样一段:
这个使用—包括起来的内容称之为Front-matter,即前置信息,用于给 Hexo 渲染该 md 文档,除了这三项,还有很多的配置项可以自己添加:
配置项 | 意义 |
|---|---|
title | 网页文章标题 |
date | 文章创建如期 |
comments | 文章评论功能是否启动 |
tags | 文章标签 |
categories | 文章分类 |
keywords | 文章关键字 |
生成文章
文章写好之后,首先清除掉旧的数据:
1 | hexo clean |
这个命令会清除掉之前生成的网页,即站点根目录下的public文件夹
然后使用如下命令生成新的页面:
1 | hexo g |
这个命令会将source文件夹下所有的md文件进行渲染,生成HTML页面,存放在public文件夹下
Hexo博客 部署
部署
Hexo 提供了快速方便的一键部署功能,让您只需一条命令就能将网站部署到服务器上。
1 | $ hexo deploy |
Hexo博客 文章分类
Hexo+Github博客教程:03添加分类
打开命令行,进入博客所在文件夹。执行命令
1 | $ hexo new page categories |
Hexo博客删除文章
普通删除方式
Hexo正常删除文章的流程是先删除本地文件。
以原始文件:helloworld.md为例:
首先进入到source / _post 文件夹中,找到helloworld.md文件,在本地直接执行删除。
然后依次执行命令:
1 | hexo clean |
1 | hexo g |
1 | hexo d |
这样就删除成功了
已发布文章删除
如果你已经将文章git发布了,此时会在本地创建一个名为 .deploy_git的文件夹,并将生成的文件复制到该文件夹。
你需要删除本地的文章后,再删除 .deploy_git文件夹。
最后依次执行正常删除的命令。
修改主题设置
总体设置:修改Blog/themes/diaspora/_config.yml
修改背景音乐:将 Blog/source/_posts 中对应文件的文件头mp3指向 Blog/themes/diaspora/audio/xxx.mp3 。
修改封面:将 Blog/source/_posts 中对应文件的文件头cover指向 Blog/themes/diaspora/img/xxx.png 。
域名解析
个人博客第6篇——解析域名 - 知乎 (zhihu.com)
报错信息排查
Nunjucks Error
泄露(Escape)内容
Hexo 使用 Nunjucks 来解析文章(旧版本使用 Swig,两者语法类似),内容若包含 {{ }} 或 {% %} 可能导致解析错误,您可以用 raw 标签包裹,single backtick {{ }} 或 triple backtick 来避免潜在问题发生。
02_Hexo-出错排查-Nunjucks Error | 陈鹏的个人主页 (gitee.io)
参考链接
The world’s fastest framework for building websites | Hugo (gohugo.io)