0x001 Hexo 渲染

  在Hexo部署时会默认渲染source下的所有html页面,但有时候想在Hexo博客上单独自定义html页面或README.md时,却不希望被Hexo渲染。因此对某个文件或者目录进行排除渲染是非常必要的。

0x002 方法一:font matter

Hexo新建网站页面,然后将你的代码直接写入 index.md

Front matter 中添加 layout: false,此方法适用于单一的纯HTML
CSS 页面。

1
2
3
4
5
6
---
title: tools
date: 2020-04-28 00:00:00
type: "tools"
layout: false
---

0x003 方法二:skip render

在博客根目录下的 _config.yml,找到 skip_render,大概在32行左右,写入你想要的跳过渲染的路径,注意缩进和空格。

1
2
3
4
# 指定目录跳过hexo渲染
skip_render:
- 'tools/*'
- 'tools/**'

注释:tools/* 表示在目录 source/fireworks 下的文件全部跳过渲染,tools/** 表示在博客根目录 source/tools/ 文件夹下的文件全部跳过渲染(例如页面的 js、css 在另一个文件夹中)。

0x004 案例:webstack 导航

webstack是一个纯静态的网址导航网站,内容均由viggo收集并整理。项目基于bootstrap前端框架开发。

image

在博客根目录 source/下新建tools,然后新建index.html,将webstack网页源码全选复制粘贴到里面。

注意:将源码里的部分信息以及跳转链接按照你真实个人博客的环境进行修改。

然后打开博客根目录下配置文件_config.yml,找到skip_render,做如下修改:

1
2
3
skip_render:
- 'tools/*'
- 'tools/**'

最后执行hexo cleanhexo s -g 本地预览,检查无误后hexo g -d部署到服务器上即可。

参考文章