Hexo-Theme-Async

Appearance

页面配置 ​

本主题默认支持并使用以下页面类型。

文章 Posts ​

  • keywords：关键字，用于 meta 标签
  • description：描述，用于 meta 标签
  • cover：文章封面图，可为字符串或数组，如果数组长度为 2 则会根据主题自动切换。
  • sticky：首页排序值
  • banner：文章页横幅背景，字段参考 横幅 banner.default 字段。
  • toc：是否显示目录，仅当值为 false 生效。默认通过 _config.async.yaml 的 toc 控制。
  • single_column：单栏显示详情页，为 true 时生效。
  • author：文章作者
  • originalLink：文章源链接（用于转载）

内置的置顶脚本已删除，将 hexo-generator-index 升级到 2.0.0+ 以上版本即可。

yaml
---
title: 从零开始搭建一个后台模板
keywords: admin-template,vue,element,后台模板
cover: [https://www.logosc.cn/uploads/resources/2018/11/29/1543459457_thumb.jpg]
sticky: 10
banner:
  type: img
  bgurl: https://pic1.zhimg.com/v2-b3c2c6745b9421a13a3c4706b19223b3_r.jpg
  bannerText: Hi my new friend!
toc: false # 无需显示目录
---
---
title: 从零开始搭建一个后台模板
keywords: admin-template,vue,element,后台模板
cover: [https://www.logosc.cn/uploads/resources/2018/11/29/1543459457_thumb.jpg]
sticky: 10
banner:
  type: img
  bgurl: https://pic1.zhimg.com/v2-b3c2c6745b9421a13a3c4706b19223b3_r.jpg
  bannerText: Hi my new friend!
toc: false # 无需显示目录
---

归档 Archives ​

Hexo 默认支持。

分类 Categories ​

如果您尚未安装 hexo-generator-category，请输入 npm install hexo-generator-category。

新建 categories 页面，在博客根目录下输入：

bash
hexo new page categories
hexo new page categories

修改 source/categories/index.md 的 Front Matter

yaml
---
title: 分类
date: 2019-11-16 10:46:27
layout: category
---
---
title: 分类
date: 2019-11-16 10:46:27
layout: category
---

TIP

分类和标签

尽管 Hexo 支持了为一篇文章设置多个分类，但我个人更建议您一篇文章只放在一个分类下，而使用标签来为它进行多个描述。

同时太多的分类与标签，既不方便整理，也不利于移动端的展示。

标签 tags ​

如果您尚未安装 hexo-generator-tag，请输入 npm install hexo-generator-tag。

新建 tags 页面，在博客根目录下输入：

bash
hexo new page tags
hexo new page tags

修改 source/tags/index.md 的 Front Matter

yaml
---
title: 标签
date: 2019-11-16 10:46:27
layout: tag
---
---
title: 标签
date: 2019-11-16 10:46:27
layout: tag
---

新建友链页面。

bash
hexo new page links
hexo new page links

进入 source/links/index.md，设置 layout 字段。

yaml
---
title: 友情链接
layout: links
---
---
title: 友情链接
layout: links
---

在 _config.async.yml 中的添加 links 配置信息。

提示：（❌）不是在 banner.links 添加，（✔）是直接在配置文件添加新的 links 属性。

  • name：站点名称
  • url：博客链接
  • image：头像图片链接
  • desc：一句话描述
yaml
links:
  - name: 白云苍狗
    url: //www.imalun.com/
    image: //www.imalun.com/images/avatar.jpg
    desc: 醒，亦在人间；梦，亦在人间
links:
  - name: 白云苍狗
    url: //www.imalun.com/
    image: //www.imalun.com/images/avatar.jpg
    desc: 醒，亦在人间；梦，亦在人间

如果您的友链比较多，可能会导致 _config.async.yml 过长，您可以将 links 配置拆分出来。在 Hexo 工作目录下新建 source/_data/links.yml 文件，字段和 _config.async.yml 中的一致，只是不再需要 links 字段。

yaml
- name: 白云苍狗
  url: //www.imalun.com/
  image: //www.imalun.com/images/avatar.jpg
  desc: 醒，亦在人间；梦，亦在人间
- name: 白云苍狗
  url: //www.imalun.com/
  image: //www.imalun.com/images/avatar.jpg
  desc: 醒，亦在人间；梦，亦在人间

也可以是 source/_data/links.json 文件

json
[
	{
		"name": "白云苍狗",
		"url": "//www.imalun.com/",
		"image": "//www.imalun.com/images/avatar.jpg",
		"desc": "醒，亦在人间；梦，亦在人间"
	}
]
[
	{
		"name": "白云苍狗",
		"url": "//www.imalun.com/",
		"image": "//www.imalun.com/images/avatar.jpg",
		"desc": "醒，亦在人间；梦，亦在人间"
	}
]

关于 About ​

新建关于页面。

bash
hexo new page about
hexo new page about

进入 source/about/index.md，设置 layout 字段。

yaml
---
title: 关于
layout: about
---
---
title: 关于
layout: about
---

如果使用内置模板，可以设置 _config.async.yml 中的 about。

yaml
about:
  insert: none # 插入规则 before（插入在内容前） | after（插入在内容后） | none（不插入）
  title: # 标题
  introduction: # 个人简单描述
  blog: # 博客信息
  privacy: # 隐私权说明
about:
  insert: none # 插入规则 before（插入在内容前） | after（插入在内容后） | none（不插入）
  title: # 标题
  introduction: # 个人简单描述
  blog: # 博客信息
  privacy: # 隐私权说明

您也可以直接在 source/about/index.md 编写您的关于页面， 如果 about/index.md 有内容则优先使用自定义内容，否则使用配置项内容。

404 Not Found ​

可以直接在 source 目录下新建 404.md。

yaml
---
layout: 404
---
---
layout: 404
---

在本地，您也可以直接访问 /404.html 查看效果。只有当您将其部署到 GitHub Pages 上，您访问不存在的页面才会显示。

在 _config.async.yml 中修改 404 文案配置

yaml
not_found: 
	path: # 点击按钮跳转地址
	name: # 按钮显示文案
	text: # 提示文案
not_found: 
	path: # 点击按钮跳转地址
	name: # 按钮显示文案
	text: # 提示文案

自定义页面 Customize Page ​

新建自定义页面。像上面 友链、关于等页面也属于自定义页面，主要区别是它们可以通过约定配置，就可以输出主题内置页面样式，当然如果您想要个性化这些页面，也可以通过自定也页面覆盖主题的默认信行为。

bash
hexo new page xxxxx
hexo new page xxxxx

自定义页面只会保留顶部菜单、背景区域、左侧个人信息（如果不想要个人信息，可以将页面设置为单栏 single_column: true）。

yaml
---
title: 自定义页面
single_column: true
---
---
title: 自定义页面
single_column: true
---

在自定义页面时，可以直接复制主题中 HTML 代码使用，增加编写自定义页面效率，除了复用默认主题代码，还有其他内置卡片样式可以参考 自定义页面演示，以及主题内置的 Tag Plugins

相册页 ​

相册页面只是普通的页面，您只需要 hexo new page xxxxx 创建您的页面就行

然后使用标签外挂 gallery，具体用法请查看对应的内容。

markdown
<div class="row">
{% gallery '壁纸' '收藏的一些壁纸' '/gallery/wallpaper' https://th.wallhaven.cc/lg/z8/z8dg9y.jpg %}
{% gallery '图库' '收藏的一些壁纸' '/gallery/wallpaper' https://th.wallhaven.cc/lg/rd/rddgwm.jpg %}
</div>
<div class="row">
{% gallery '壁纸' '收藏的一些壁纸' '/gallery/wallpaper' https://th.wallhaven.cc/lg/z8/z8dg9y.jpg %}
{% gallery '图库' '收藏的一些壁纸' '/gallery/wallpaper' https://th.wallhaven.cc/lg/rd/rddgwm.jpg %}
</div>

相册详情页 ​

相册详情页面也是普通的页面，您只需要 hexo new page xxxxx 创建您的页面就行

然后使用标签外挂 galleryGroup，具体用法请查看对应的内容。

markdown
{% galleryGroup %}
{% galleryItem https://th.wallhaven.cc/orig/85/85oy2j.jpg https://w.wallhaven.cc/full/85/wallhaven-85oy2j.png %}
![](https://w.wallhaven.cc/full/jx/wallhaven-jx3z65.jpg)
{% galleryItem https://th.wallhaven.cc/orig/85/85oylj.jpg https://w.wallhaven.cc/full/85/wallhaven-85oylj.png %}
{% galleryItem https://th.wallhaven.cc/orig/vq/vq9688.jpg https://w.wallhaven.cc/full/vq/wallhaven-vq9688.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/2y/2y8q7m.jpg https://w.wallhaven.cc/full/2y/wallhaven-2y8q7m.png %}
{% galleryItem https://th.wallhaven.cc/orig/85/85oyzj.jpg https://w.wallhaven.cc/full/85/wallhaven-85oyzj.png %}
{% galleryItem https://th.wallhaven.cc/orig/7p/7p2589.jpg https://w.wallhaven.cc/full/7p/wallhaven-7p2589.png %}
{% galleryItem https://th.wallhaven.cc/orig/m3/m39kj1.jpg https://w.wallhaven.cc/full/m3/wallhaven-m39kj1.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/6d/6dorxl.jpg https://w.wallhaven.cc/full/6d/wallhaven-6dorxl.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/o5/o53ro5.jpg https://w.wallhaven.cc/full/o5/wallhaven-o53ro5.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/l8/l831lq.jpg https://w.wallhaven.cc/full/l8/wallhaven-l831lq.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/zy/zy8ewv.jpg https://w.wallhaven.cc/full/zy/wallhaven-zy8ewv.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/3l/3lz1pd.jpg https://w.wallhaven.cc/full/3l/wallhaven-3lz1pd.png %}
{% galleryItem https://th.wallhaven.cc/orig/1p/1pkz5w.jpg https://w.wallhaven.cc/full/1p/wallhaven-1pkz5w.png %}
{% galleryItem https://th.wallhaven.cc/orig/p9/p9kdej.jpg https://w.wallhaven.cc/full/p9/wallhaven-p9kdej.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/x6/x68mrd.jpg https://w.wallhaven.cc/full/x6/wallhaven-x68mrd.jpg %}
{% endgalleryGroup %}
{% galleryGroup %}
{% galleryItem https://th.wallhaven.cc/orig/85/85oy2j.jpg https://w.wallhaven.cc/full/85/wallhaven-85oy2j.png %}
![](https://w.wallhaven.cc/full/jx/wallhaven-jx3z65.jpg)
{% galleryItem https://th.wallhaven.cc/orig/85/85oylj.jpg https://w.wallhaven.cc/full/85/wallhaven-85oylj.png %}
{% galleryItem https://th.wallhaven.cc/orig/vq/vq9688.jpg https://w.wallhaven.cc/full/vq/wallhaven-vq9688.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/2y/2y8q7m.jpg https://w.wallhaven.cc/full/2y/wallhaven-2y8q7m.png %}
{% galleryItem https://th.wallhaven.cc/orig/85/85oyzj.jpg https://w.wallhaven.cc/full/85/wallhaven-85oyzj.png %}
{% galleryItem https://th.wallhaven.cc/orig/7p/7p2589.jpg https://w.wallhaven.cc/full/7p/wallhaven-7p2589.png %}
{% galleryItem https://th.wallhaven.cc/orig/m3/m39kj1.jpg https://w.wallhaven.cc/full/m3/wallhaven-m39kj1.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/6d/6dorxl.jpg https://w.wallhaven.cc/full/6d/wallhaven-6dorxl.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/o5/o53ro5.jpg https://w.wallhaven.cc/full/o5/wallhaven-o53ro5.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/l8/l831lq.jpg https://w.wallhaven.cc/full/l8/wallhaven-l831lq.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/zy/zy8ewv.jpg https://w.wallhaven.cc/full/zy/wallhaven-zy8ewv.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/3l/3lz1pd.jpg https://w.wallhaven.cc/full/3l/wallhaven-3lz1pd.png %}
{% galleryItem https://th.wallhaven.cc/orig/1p/1pkz5w.jpg https://w.wallhaven.cc/full/1p/wallhaven-1pkz5w.png %}
{% galleryItem https://th.wallhaven.cc/orig/p9/p9kdej.jpg https://w.wallhaven.cc/full/p9/wallhaven-p9kdej.jpg %}
{% galleryItem https://th.wallhaven.cc/orig/x6/x68mrd.jpg https://w.wallhaven.cc/full/x6/wallhaven-x68mrd.jpg %}
{% endgalleryGroup %}

Released under the SATA | MIT License.

Copyright © 2022-PRESENT MaLuns