Hexo写作支持Markdown。
不懂就查文档
下面是一些区别于常规Markdown的点。

即时预览

由于 Hexo 博客不全是使用Markdown语法,常规Markdown编辑器无法提供效果完全相同的预览。但是 Hexo 提供了本地网页即时预览博客的功能。

在命令行中输入Hexo server(简写hexo s),即可在127.0.0.1:4000即时预览博客。
Microsoft Edge似乎只能在localhost:4040中预览。

blog_preview
blog_preview

文章信息

文章放在\source\_post的目录里面,md文件随便放。

下面是开头的格式front-matter

1
2
3
4
5
6
7
8
9
10
---
title: Test Post
date: 2019-06-23 16:33:03
tags:
- ACM
- 图论
category:
- C++
top: false
---

一些其他参数:

参数 描述 默认值
layout 布局
date 创建日期
updated 更新日期 文件更新日期
comments 开启文章的评论功能 true
permalink 覆盖文章网址

这些文本使用 hexo new [draft] xxx 会自动按照 /Scaffold/post.md (或 /Scaffold/draft.md)的模板生成。下面是我的 post.md

1
2
3
4
---
title: {{ title }}
date: {{ date }}
---

由于 hexo 在 wsl 上有十秒的延迟,加上每次新建博客会顺便创建文件夹,不是很喜欢,我在 VS Code 上使用的是一个叫 psioniq File Header 的插件,安装插件以后,编辑新文件前,按 Ctrl+Alt+H 两次即可按照 Visual Studio Code 的配置文件 settings.json 模板就可以创建开头。我的 settings.json 的相关部分长这个样子:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
  "psi-header.templates": [
{
"language": "*",
"template": [
"---",
"title: <<filename>>",
"date: <<dateformat('YYYY-MM-DD H:mm:ss')>>",
"tags:",
"- 杂谈",
"category:",
"- C++",
"mathjax: true",
"---"
]
}
],

插入图片

对于 Hexo 这类网站,插入图片一直是个痛点,不能像印象笔记、WordPress、CSDN 等直接将图片拖动到窗口,就可以自动上传。

但是可以使用一种叫图床的插件。对于 Visual Studio Code,我推荐的 Coding 图床插件,绑定 Coding.net 账号以后,可以在 VS Code 编辑 Markdown 的页面一键粘贴图片(将图片传到 Coding 的指定仓库,然后粘贴图片链接)。

HTML间的相对路径

HTML间的常规引用:

上一级文件夹的某文件:../index/
上两级文件夹的某文件:../../index/

Hexo 中,文章间的引用使用常规方法好像容易炸,因为 Hexo 创建文章是按日期创建的,如https://lyh543.github.io:4000/2019/06/26/Testblog/,不同日期的文件夹就会炸。
Google 了一下,据说 Hexo 3.0 可以使用

post_link hexo-writing hexo-writing %}```
1
2
3
4
5
6
7
8

的形式引用,但测了一下还是不行。
于是是用另一种方式,通过修改`站点配置文件`,修改文章的命名方式,改为只由`title`命名。

```yml
root: /
permalink: :title/
permalink_defaults:

然后就可以按HTML的常规引用了。
同文件夹文章的相互引用:../hexo-building-blog/(最后的/是可选的)
链接到某个标题../hexo-writing#文章信息#文章信息
链接到标题的更详细的语法可以看Markdown 语法:锚点

_posts上一级的文件就写绝对路径吧,如 /img/test.jpg
注意从根目录开始引用博客不加 _posts,如 /cpp/Blog/hexo-writing

引入LaTeX 公式—— Mathjax

为此单写了一篇博客。详见那一篇博客。

重定向博文

由于我把博客当做学习笔记,经常会查博客记录的 Linux 命令、MATLAB 笔记。

虽然有搜索功能,但是对于最常用的,还是希望能够直接跳转,如在首页后添加 linux 并回车,就能跳转到 Linux 的博文。换句话说,我希望能将 https://blog.lyh543.cn/linux 重定向到 https://blog.lyh543.cn/Linux/linux-daily-command/

如果博客是架在自己的服务器上,并且用 Nginx 作为网站服务器,一行 location = /linux {return 301;} 就能解决问题;

其实 Hexo 也有解决方法。

由于 HTML(利用 JS)支持跳转功能,我们写一个 linux.html 文件,放在 _posts 目录。由于直接这样会导致我们写的这个 HTML 会出现在首页和搜索结果下面,我们还需要进行隐藏。

在本地安装插件:

1
npm install hexo-hide-posts --save

然后编写以下文件,另存为 /source/_posts/linux.html

1
2
3
4
5
6
7
8
---
hidden: true
---
<html><head><title>正在跳转</title></head>
<body>
<script language='javascript'>document.location = '/Linux/linux-daily-command/'</script>
</body>
</html>

然后上传就可以了。这是测试链接