hexo配置

hexo，快速、简洁且高效的博客框架

基本操作

hexo clean // 清除缓存
hexo g // 创建静态文件
hexo s // 本地运行
hexo d // 部署到远程

主题

主题文件夹放在./theme/ 下，_config.yml 中theme: 改成主题文件夹名

文章

文章存放路径/source/_posts/*.md

文章头部

---
date: 2017/8/3 18:20:00 //发布时间
tags: hexo //分类
mathjax: true //使用mathjax渲染公式
title: hexo博客 //标题
---

文章折叠

需要折叠的部分之前加

1	<!-- more -->

以下 hexo-toc 插件与 next 主题侧边目录栏冲突(安装后导致侧边栏目录失效)

安装npm install hexo-toc --save
在博客根目录下的 _config.yml 中如下配置：
1
2
3
>#文章目录
>toc:
   maxDepth: 3 #表示目录深度为3，即最多生成三级目录
在Markdown中需要显示文章目录的地方添加


公式

卸载原有公式渲染引擎 npm uninstall hexo-renderer-marked --save
安装kramed npm install hexo-renderer-kramed --save

问题1：kramed对\,{,}有转义，无法正常显示

解决方法：

定位到博客根目录，找到/node_modules/kramed/lib/rules/inline.js文件，进行部分修改：
1
2
3
4
//escape: /^\\([\\`*{}\[\]()#$+\-.!_>])/,      第11行，将其修改为
escape: /^\\([`*\[\]()#$+\-.!_>])/,
//em: /^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,    第20行，将其修改为
em: /^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
问题2：公式中以下符号会解析错误{{` `}} {%` `%}

解决方法：中间加空格，变为{ { } } { % % }

图片居中(md支持html语法)

1
2
3

<div align="center">
    <img src="/img/..."/>
</div>

多分支管理

同时管理了两个分支：

master -负责展示静态网页
hexo -备份本地hexo文件（默认分支）

执行hexo d时，自动更新master分支（config文件中deploy配置）

add, commit, pull更新hexo分支需要备份的源文件

中文目录无法跳转

fix: Chinese TOC cannot jump by jiangtj · Pull Request #1540 · theme-next/hexo-theme-next (github.com)

解决方法：在 themes/next/source/js/util.js 中增加两行代码，删除两行代码。保存后hexo clean & hexo g & hexo s 即可解决。

const navItems = document.querySelectorAll('.post-toc li');
   const sections = [...navItems].map(element => {
     var link = element.querySelector('a.nav-link');
     //增加该行
     var target = document.getElementById(decodeURI(link.getAttribute('href')).replace('#', ''));
     // TOC item animation navigate.
     link.addEventListener('click', event => {
       event.preventDefault();
       //删除该行
       //var target = document.getElementById(event.currentTarget.getAttribute('href').replace('#', ''));
       var offset = target.getBoundingClientRect().top + window.scrollY;
       window.anime({
         targets  : document.scrollingElement,
         duration : 500,
         easing   : 'linear',
         scrollTop: offset + 10
       });
     });
     // 删除该行 
     //return document.getElementById(link.getAttribute('href').replace('#', ''));
     // 增加该行
     return target;
   });

其他

无法解决的问题尝试清除缓存hexo clean后重新生成