Skip to content

Latest commit

 

History

History
98 lines (56 loc) · 5.48 KB

FAQ.md

File metadata and controls

98 lines (56 loc) · 5.48 KB
Raw

常见问题

这里收录了使用主题 Stun 时一些常见的问题。很多是没有阅读文档或阅读文档不仔细导致的。所以建议提出新的 issue 之前，阅读文档、阅读常见问题、参考已有的 issue，上述途径可以解决你绝大部分问题。

首页中，如何保留文章摘要

这是所有 Hexo 都会有的常见问题，在没有进行任何设置时，Stun 主题默认在首页显示文章的所有内容。

在文章的 Markdown 文件中添加 <!-- more --> 标记，标记之前的部分会被当做文章摘要显示在首页（这个标记是 Hexo 的一个功能，与主题无关）

各种控制台报错问题

  • 主题版本升级之后，启动时控制台报错

    相关 Issue：版本升级之后控制台报错

    如果你没有更新主题版本之前可以正常运行，更新之后控制台就会报错，那么这样的错误基本都是和配置文件相关，分为以下两种情况：

    • 你使用了平滑升级这一特性来备份配置文件

      由于主题在新的版本中可能会更改配置项（如果有更改，会在版本发布的文档中进行说明），你必须保持 stun.yml 和 主题的 _config.yml 里的配置项同步，否则就会出现报错。

    • 你通过修改主题的 _config.yml 文件来配置主题

      这种情况下，在升级主题版本之前，为了保留原来配置好的数据，你可能会将该文件复制一份，然后等版本更新之后再复制回去。

      这种做法正常情况下没有问题，但是如果主题在新的版本中更改了配置项，你的这种 “复制粘贴” 的做法会使得新的配置项被覆盖，从而引起报错。

  • Hexo 版本更新后，启动时控制台报错

    当你更新 Hexo 版本后，使用 Stun 主题启动时控制台报错，这很可能是因为 Stun 在较早的版本中，依赖于 cheerio 这个库，详见：#25，将主题版本更新到 v1.6.0+ 即可解决该问题。

使用或更换到 Stun 主题后运行出错

相关 Issue：初次使用 stun 运行不起来

使用 Stun 主题并运行后，浏览器里显示类似如下信息：

extends ./_layout.pug block content include ./_partials/post/post-list.pug if theme.post_list.paginate.home include ./_partials/widgets/paginator.pug

原因是没有安装依赖 hexo-renderer-pug，在 Hexo 根目录执行下面这条指令，然后重启服务器即可：

$ npm install hexo-renderer-pug --save

文章解析的一些问题

类似这种问题，都是因为 Markdown 渲染器引起的。Hexo 默认安装的 Markdown 渲染器是 hexo-renderer-marked，这个渲染器功能很少，已经满足不了大多数用户的需求，所以推荐将其卸载换成 hexo-renderer-markdown-it-plus。在 Hexo 根目录执行下面这些指令，然后重启服务器即可：

# 卸载原来的渲染器
$ npm uninstall hexo-renderer-marked --save

# 安装新的渲染器
$ npm install hexo-renderer-markdown-it-plus --save

文章置顶失效

文章置顶功能依赖于 hexo-generator-index-pin-top 插件，并且需要将原有的 hexo-generator-index 插件卸载。如果你设置了文章置顶，但没有生效，很可能是因为没有卸载原有的插件。在 Hexo 根目录执行下面这条指令，然后重启服务器：

$ npm uninstall hexo-generator-index --save

如何设置每次切换页面后，滚动到顶部大图下方

这个功能需要启用 Pjax 后才能使用。如果想设置这个功能，需要修改主题配置文件：

pjax:
  enable: true
  avoid_banner: true

注意：启用上述功能后，Pjax 的配置项 scrollTo 将失效。详见：启用 Pjax。

点击搜索按钮没有任何反应

相关 Issue：search window does not appear when hit search button

通过 Issue 中的讨论交流，发现这个问题与插件 hexo-inject 有关。解决办法很简单，卸载该插件即可。

hexo-inject 插件早已弃用，不再维护（使用不再维护的项目会带来很多问题，因此建议所有人：不要使用任何不再维护的项目）。

Hexo 从 5.0.0 版本开始，将 hexo-inject 插件的功能内置了，所以如果你需要该插件的功能，那么将 Hexo 升级到 v5.0.0+ 即可。详见：Hexo - Injector。