建议有一定基础知识的朋友进行尝试。

将主题添加为子模块
git submodule add git@github.com:xaoxuu/hexo-theme-volantis themes/volantis

为网站提速

加载速度

  • 尝试安装 hexo-all-minifier 插件来压缩文件。
  • 减少不必要的 js 插件,例如字数统计、动态背景。
  • 查找并解决拖慢速度的资源,以 Chrome 浏览器为例:
    1. 页面中点击右键,选择「检查」。
    2. 在右边的窗口中「Network」选项卡,并勾选「Disable cache」。
    3. 刷新网页,查看加载速度慢的资源。
      3.1. 加载缓慢的图片,建议使用 CDN。
      3.2. 加载缓慢的可以不用的 js 插件,建议舍弃。
      3.3. 加载缓慢却必须使用的 js 插件,建议下载并自己上传至 jsdelivr

运行速度

  • 访问具有动态特效背景(如雪花、粒子等)的网站时,手机很快会发烫变卡,笔记本很快会风扇狂转并且浏览器提示建议关闭此页面。如果你希望网站有好的使用体验请尽量不要安装这类插件。
  • 强烈推荐安装 hexo-offline 插件,初次加载速度不变,后期切换页面和刷新网页速度越来越快。
  • 推荐安装图片懒加载插件 hexo-lazyload-image(需同时安装 hexo-fs 依赖库)。

优化SEO ^1.6.4

在 front-matter 中,可以设置 keywordsdescriptionrobotsseotitle。其中 seotitle 仅仅用作网页标题,优先级高于 title

使用 CDN

对于大部分将博客 deploy 到 GitHub 的用户来说,直接加载本地资源速度比较慢,可以使用 jsdelivr 为开源项目提供的 CDN 服务。

开启方法

blog/_config.yml
use_cdn: true

如果你需要对样式进行 DIY,可以只关闭 style 文件的 CDN。

自定义 CDN

如果你把对应的文件上传到自己的 CDN 服务器,可以把对应的链接改为自己的 CDN 链接。

安装「相关文章」插件

  1. 安装插件

    npm i -S hexo-related-popular-posts
  2. 在需要显示的位置添加 related_posts 例如放在侧边栏:

    blog/themes/volantis/_config.yml
    layout:
    on_page:
    sidebar: [related_posts]

分析与统计

默认支持并且开启 不蒜子 的访问统计,可以自行添加百度统计和 Google Analytics。

字数和阅读时长

  1. 安装以下插件:
    npm i --save hexo-wordcount
  2. 修改配置文件,将 wordcount 插件打开
    blog/themes/volantis/_config.yml
    plugins:
    ...
    # 文章字数统计、阅读时长,开启需要安装插件: npm i --save hexo-wordcount
    wordcount: true
  3. 然后修改配置文件,将 wordcount 写入需要显示的 meta 位置:
    blog/themes/volantis/_config.yml
    # 布局
    layout:
    on_list:
    meta: [..., wordcount, ...]
    on_page:
    meta:
    header: [..., wordcount, ...]
    footer: [..., wordcount, ...]

百度统计

blog/_config.yml
baidu_analytics_key: 百度统计的key

Google Analytics

blog/_config.yml
google_analytics_key: Google Analytics Key

CNZZ 统计

请参考 ZYMIN 的这篇教程:《hexo+ejs+material x 添加CNZZ统计代码》

网站运行时间等

请参考 TRHX 的这篇教程:《Hexo 博客主题个性化》

更多 DIY 玩法

详见 @TRHX 的这篇博客:《Hexo 博客主题个性化》

内含卡片半透明、增加卡通人物、自定义鼠标样式、鼠标特效、烟花特效、彩色滚动字体、网站运行时间、动态浏览器标题、雪花飘落特效等多种详细教程。

帮助

下述操作将协助您解决在使用过程中遇到的任何问题:

主题文件(除了配置文件以外)未经任何修改,无法成功搭建博客

此流程适用于直接使用主题搭建博客的用户,在仅仅修改了主题配置文件、Hexo配置文件、增加了自己的文章,这种情况下无法成功搭建或者部署的问题。

  1. 在 Volantis 文档右上角搜索关键词,查看是否有相关内容。
  2. Hexo 官方文档 中搜索关键词,查看是否有相关内容。
  1. 下载 本站源码 ,然后下载 主题源码themes/volantis
  2. 执行 npm install 安装依赖包。
  3. 执行 hexo s 运行。

如果正常,请一步一步将配置文件修改为您原来的设定,直至找到出问题的地方。
如果依然不能运行,请检查 Hexo 环境配置,或者重新安装 Hexo 。

按照文档描述进行修改配置之后发生错误,可能是文档有误或者过时。可以在 issues 页面发帖求助,务必按照 issue 模板提供尽可能详细的信息,如果只写个标题,我们很难帮助您解决问题。

对应的 issue 模板类型: Question Report

主题文件(ejs、js、css、第三方插件等)有修改,无法成功搭建博客

此流程适用于 fork 主题并对主题文件(ejs、js、css 等)进行了修改后搭建博客的用户,无法成功搭建或者部署的问题。

  1. 在 git 历史中新建分支还原修改,或者尝试直接下载本站源码和主题源码运行。
  2. 如果未经修改可以正常搭建,请定位到自己修改的内容,查看是否有误。

如果是主题文档中提到过的第三方插件(意味着有主动兼容),遇到无法使用的情况,可以在 issues 页面新建 issue 详细描述您的问题。对应的 issue 模板类型: Question Report

如果是主题文档中没有提到过的第三方插件,可能存在没有兼容的情况,可以在 issues 页面新建 issue 请求兼容。对应的 issue 模板类型: Feature Request

有明确的 BUG 或者建议

此流程适用于您已经定位到了问题的具体所在,不需要协助定位问题。希望开发者予以修正。

例如主题文档中也存在的问题,或者在指定的浏览器、平台,经过某个操作后确定可以复现的问题。请在 issues 页面新建 issue 进行反馈。对应的 issue 模板类型: Bug Report

反馈一个 BUG 需要按照 issue 模板提供尽可能详细的信息,如果只有一个标题或者一句话,我们无法进行复现的话,是无法解决问题的。

请在 issues 页面新建 issue 进行反馈。对应的 issue 模板类型: Feature Request