记录.Hexo 的一些小要求

本文最后更新于:2021年8月21日 下午

文章跳转

{% post_link 文章文件名(不要后缀) 文章标题(可选) %}
例:记录.Hexo 的一些小要求

部署时,不渲染某些文件

不渲染 .html

可在文件的最上面加上以下代码

1
2
3
---
layout: false
---

不渲染 .md

使用了上面代码虽然不会渲染 .md ,但会转换成为 html 文件。
如果想保留 md 原文件,需要在 _config.yml 中找到 skip_render 参数
skip_render 匹配的位置一般为 source_dir ,默认是在 source 文件夹下

1
2
3
4
skip_render:
- "mypage/*" #单文件夹的全部文件
- "mypage/*.md" #单文件夹的指定类型文件
- "mypage/**" #单文件夹的全部文件以及子目录

文章模板配置

修改 Hexo 项目文件夹中的 scaffolds
文章:post.md
草稿:draft.md

对应的是 hexo new [layout] <title> 中的 layout ,默认是 post,
如果在模板中,标题需要空格,需要用引号包起来。

draft 是 Hexo 中的一种特殊布局,在建立时会保存到 source/_drafts ,默认不会显示在页面中,
但可以在执行时加上 --dart 参数,或者把 _config.ymlrender_drafts 参数设置为:true
用于预览

1
2
3
4
5
6
7
8
9
10
---
title: {{ title }}
tags:
categories:
description:
date: {{ date }}
---

点击阅读前文前, 首页能看到的文章的简短描述

部署在网站的子目录

在博客配置文件(_config.yml)中修改:url 和 root
例:xxx.github.io/blog
则需设置

1
2
url: http://example.com/blog
root: /blog/

Hello