博客搭建遇到的问题及解决方法

---

title: 博客使用常见的问题
date: 2020-02-25 17:46:25
categories: Hexo

---

1、NexT主题下新建了标签和分类页无法正常显示：

在点击主页的这些标签后出现了404，并且跳转的链接后出现了%20的符号。Google一番发现，%20的出现是由于在链接后有空格，浏览器解析链接时将空格解析为%20而不是去除，导致了找不到相应页面， 因此解决方案就是在主题配置文件中，搜索找到：

menu:
  home: / || home
  tags: /tags/ || tags
  categories: /categories/ || list
  archives: /archives/ || archive

将||符号前后的空格全部删掉，问题解决！

2、Hexo部署到Github后文件夹名大小写引起的问题：

修改的内容涉及到英文字母大写改小写或小写改大写，譬如news改为News，字母N修改后确发现部署到Github上无法生效，而此时你若在本地预览确一切正常。
由于在发布的文章中出现的Tag或Categories会对应在tag或categories页面中显示，因此当点击对应的Tag或Categories时会出现路径无法找到从而跳转到404页面。
这个现象的问题是由于git命令默认的配置中忽略了文件名的大小写，因此即便文件夹的大小写发生了变更，git也会表现出置之不理。
分类：hexo->Hexo

3、markdown原生表格时遇到问题：

表格不能正常显示，输出格式与输入格式一样。在表格前面添加一空行后，问题解决！

4、插入图片无法本地无法预览并且布署到Git上不显示的问题：

配置站点文件

post_asset_folder: true

将post_asset_folder设为true后，执行命令：
$ hexo new post_name
在source/_posts中会生成文章post_name.md和同名文件夹post_name。将图片资源放在post_name中，文章就可以使用相对路径引用图片资源了。引用语法

![](image.jpg)

问题解决！

插入图片放缩：<img src="1.png" width = "80%" />

5、数学公式无法显示：

1、更换Hexo的markdown渲染引擎

先后执行下面的两条命令，第一条表示将默认的渲染引擎hexo-renderer-marked卸载，第二条命令是安装hexo-renderer-kramed渲染引擎

npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-kramed --save

2、修改node_modules\kramed\lib\rules\inline.js文件

hexo-renderer-marked渲染引擎仍然存在一些语义冲突问题，到博客的根目录下，找到node_modules\kramed\lib\rules\inline.js，把第11行的escape变量的值做相应的修改：

//  escape: /^\\([\\`*{}\[\]()#$+\-.!_>])/,
  escape: /^\\([`*\[\]()#$+\-.!_>])/,

这一步是在原基础上取消了对,{,}的转义(escape)。

同时把第20行的em变量也要做相应的修改。

//  em: /^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
  em: /^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,

3、在主题中开启mathjax开关

到博客根目录下，找到themes/next/_config.yml，把math默认的flase修改为true，具体如下：

# Math Equations Render Support
math:
  enable: true
  per_page: true
  engine: mathjax

4、在文章的Front-matter里打开mathjax开关

如果你写的文章里面用到了数学公式，需要在文章Front-matter里打开mathjax开关。如果用不到数学公式，则不需要管它。

---
title: index.html
date: 2018-12-5 01:30:30
tags:
mathjax: true
--

6、HEXO首页只显示部分摘要：

首先需要在Next主题的_config.yml中把设置打开：excerpt_description: true

然后在需要截断的地方加入：

<!--more-->