Skip to content

使用指南

本主题为 Hexo 主题,请确保您已了解 Hexo 的基本使用方式。更多信息请参见 Hexo 官网

有任何关于本主题的缺陷报告与功能建议,可以发起 Issues

如果您有其他相关的想法与问题,可前往 Discussions

提醒

  • 安装问题

本插件为 Hexo 主题插件,如果您想使用这款主题模板,请确保您对 Hexo 有一些基本了解。关于 Hexo 初始化不成功、Npm 安装失败等问题,一般与主题无关,请检查自己网络环境,合理利用搜索引擎解决。

  • 配置问题

本文档已经覆盖了,本主题使用的 99% 配置。遇到问题时,请优先翻阅文档,参考文档里的说明。如果使用中发现文档中有解释存在歧义地方,可以通过上面多种渠道进行反馈,也可以提交 PR 进行完善。

开始前,请确保您的 Hexo 初始化工作已经准备完成,请参考 Hexo 安装。本主题依赖于 Node 14.x 以上版本,请注意您本地 Node 环境。

快速开始

渲染器

如果您没有 ejsless 的渲染器,请先安装: hexo-renderer-ejshexo-renderer-less

bash
npm install --save hexo-renderer-less hexo-renderer-ejs
npm install --save hexo-renderer-less hexo-renderer-ejs

或者

bash
yarn add -D hexo-renderer-less hexo-renderer-ejs
yarn add -D hexo-renderer-less hexo-renderer-ejs

安装主题

  • 通过 npm 安装 (推荐)

npm (tag)

进入您的 Hexo 博客根目录,执行:

bash
npm i hexo-theme-async@latest
npm i hexo-theme-async@latest
  • 通过克隆本仓库安装(不推荐)

DANGER

不推荐直接使用这种方式安装,会导致 bug 版本定位和后续升级比较麻烦。如果您需要自定义样式和页面模块,可以优先使用 自定义样式自定义模板 配置来个性话您的博客,如果以上方式无法满足您的需求时,且不在需要升级时可选择通过这种方式安装。

v2.0.0 后版本

从 v2.0.0 开始不在支持拉取后直接使用。新版本的脚本使用 TypeScript 进行重构,项目中不在提供打包压缩后的脚本。

如果您只想修改模板,您可以前往 Github Releases 的 Assets 下载打包文件 hexo-theme-async

如果您仍然想要使用该方式,请 clone 项目后,手动执行 yarn && yarn run lib:build 以构建压缩后的脚本。

v1.1.0 至 v2.0.0 版本

从 v1.1.0 后,由于项目结构调整,不再需要整个仓库文件了。clone 项目后,只需要将 packages/hexo-theme-async 复制到 themes/async 目录下即可。

您的项目结构应该是这样

txt
┌── blog
│   ├── source
│   └── themes
│       ├── async // 克隆到此处

│   ├── _config.yml
│   ├── _config.async.yml // 增加配置文件
┌── blog
│   ├── source
│   └── themes
│       ├── async // 克隆到此处

│   ├── _config.yml
│   ├── _config.async.yml // 增加配置文件
  • 通过 npm 安装预览版

npm (tag)

进入您的 Hexo 博客根目录,执行:

bash
npm i hexo-theme-async@beta
npm i hexo-theme-async@beta

WARNING

预览版本仅在主版本更新时使用,预览版还处于功能开发和 bug 修复阶段。如果您想提前尝试新功能,可以安装它,顺便能帮忙找找 Bug 🤣

启用主题

修改 Hexo 站点配置文件 _config.yml

yaml
# 将主题设置为 hexo-theme-async
theme: async
# 将主题设置为 hexo-theme-async
theme: async

配置主题

在 Hexo 工作目录下新建 _config.async.yml( Hexo 5.0.0 + 起提供),您仅需在 _config.async.yml 中自定义您想要覆盖的配置,其余将自动与主题默认配置合并。

如果您是通过克隆代码到本地方式安装主题,也优先推荐使用这种方式,而不是去修的主题目录下的 _config.yml 文件。(这样做也更方便日后的升级)

TIP

如:

主题模式的完整配置如下

yaml
theme:
  switch: true
  default: style-light # style-light style-dark
theme:
  switch: true
  default: style-light # style-light style-dark

您可以在 _config.async.yml 中仅定义(当然,全部覆盖也是可以的)需要覆盖配置

yaml
theme:
  default: style-dark
theme:
  default: style-dark

更多主题配置 请看这里

代码示例

自定义个性化修改示例

安装演示视频

安装示例视频,更多视频前往这里

Released under the SATA | MIT License.