title: Hexo-绕过渲染
author: HaoQi
top: false
cover: false
toc: true
mathjax: false
tags:

  • Hexo
  • 渲染

reprintPolicy: cc_by
coverlmg:
categories:

  • 博客篇

summary: 在Hexo部署时会默认渲染source下的所有html页面，但有时候想在Hexo博客上单独自定义html页面或README.md时，却不希望被Hexo渲染。
abbrlink: 17a22bd2
date: 2022-03-11 14:35:09
img: https://cdn.jsdelivr.net/gh/haoqiyung/image/lmages/12.jpg
password:

1 Hexo 渲染

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

2 方法一：font matter

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

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

  1. ---
  2. title: tools
  3. date: 2022-03-11 00:00:00
  4. type: "tools"
  5. layout: false
  6. ---

3 方法二：skip render

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

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

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

4 案例：webstack 导航

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

Hexo-xr - 图1

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

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

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

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

注：此文是本人在大佬的基础上进行修改，如有侵犯联系我删除。