博客建立教程及命令备忘

Front-matter设置 & 默认值

设置 描述 默认值
layout 布局 config.default_layout
title 标题 文章的文件名
date 建立日期 文件建立日期
updated 更新日期 文件更新日期
comments 开启文章的评论功能 true
tags 标签(不适用于分页)
categories 分类(不适用于分页)
permalink 覆盖文章的永久链接. 永久链接应该以 / 或 .html 结尾 null
excerpt 纯文本的页面摘要。 使用 该插件 来格式化文本
disableNunjucks 启用时禁用 Nunjucks 标签 {{ }}/{% %} 和 标签插件 的渲染功能 false
lang 设置语言以覆盖 自动检测 继承自 _config.yml
published 文章是否发布 对于 _posts 下的文章为 true,对于 _draft 下的文章为 false

前天起计划搭建个人博客,花了一点时间就大概搞出来了,现在分享下我的流程,帮大家快速建立个人博客,以下操作需要电脑。

摆烂了,根据第一个参考链接从概述开始就可以了,官方文档下面还有上传github的办法

用power shell执行hexo指令时需要打全成hexo.cmd(tab键也可以补全)

其他玩法

内嵌网易云音乐外链,并且根据屏幕宽度选择是否隐藏 内嵌B站播放器

使用 hexo-backlink 插件实现 hexo 对 obsidian wiki 链接的自动转换

命令:

  • 生成博客:hexo g
  • 预览博客:hexo s 浏览器打开命令输入后出来的网址
  • 上传博客:hexo d github page在上传成功后需要过一会才会变化,只要最近commit的id对的上就证明没错
  • hexo d -m “评论示例” 上传并附上commit评论
  • hexo clean 不知道有什么用


如果hexo d 出错先检查下网络,然后看看根目录(不是themes下主题的)_config.yml的 “deploy:” 那里有没有打上git仓库信息。


分支也不要搞错,例如自己项目里分支是 main 的话不要按照教程打成 master 不知道这会不会有问题。

参考链接:

1.Hexo官方文档

2.不需懂代码,10分钟在Github搭建免费且已成型的个人博客网站 - 知乎

3.在Github/Gitee上搭建免费个人博客网站(进阶篇) - 知乎


博客建立教程及命令备忘
https://blog.zhaosn.top/2022/blog_tutorial/
作者
Zhao SN
发布于
2022年1月12日
更新于
2025年12月24日
许可协议