Skip to content

Commit aeb24d3

Browse files
author
白云苍狗
committed
📃 docs: 增加修改示例
1 parent 51b8e4d commit aeb24d3

File tree

6 files changed

+86
-29
lines changed

6 files changed

+86
-29
lines changed

‎demo/_config.async.yml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -139,12 +139,12 @@ cover:
139139
- https://img1.wallspic.com/previews/8/8/7/8/5/158788/158788-e_mo_sha_shoukimetsu_no_yaiba-shnen_man_hua-tao-ka_tong-azure-500x.jpg
140140
type: random
141141

142-
layout:
143-
footer: async/footer
144-
page_loading: async/page-loading
145-
post_card: async/post-card
146-
fixed_btn: async/fixed-btn
147-
# header_search: async/empty
142+
# layout:
143+
# footer: async/footer
144+
# page_loading: async/page-loading
145+
# post_card: async/post-card
146+
# fixed_btn: async/fixed-btn
147+
# header_search: async/empty
148148

149149
banner:
150150
danmu:

‎docs/.vitepress/assets/log.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,16 @@
22
{
33
"large_version": "v2.1.x",
44
"children": [
5+
{
6+
"version": "2.1.14",
7+
"date": "2024-03-28",
8+
"logs": [
9+
{
10+
"type": "fix",
11+
"text": "修复弹幕动画重叠问题"
12+
}
13+
]
14+
},
515
{
616
"version": "2.1.13",
717
"date": "2024-03-20",

‎docs/.vitepress/config.ts

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,28 @@ export default defineConfig({
55
title: 'Hexo-Theme-Async',
66
description: '🎈 A simple, lightweight Hexo theme',
77
lastUpdated: true,
8-
head: [['link', { rel: 'icon', href: '/favicon.svg' }]],
8+
head: [
9+
['link', { rel: 'icon', href: '/favicon.svg' }],
10+
['meta', { property: 'og:type', content: 'website' }],
11+
['meta', { property: 'og:title', content: 'hexo-theme-async 主题' }],
12+
['meta', { property: 'og:image', content: '/favicon.svg' }],
13+
['meta', { property: 'og:url', content: 'https://www.imalun.com' }],
14+
['meta', { property: 'og:description', content: '一个简单而轻量级的 Hexo 主题' }],
15+
// 添加百度统计代码
16+
[
17+
'script',
18+
{},
19+
`
20+
var _hmt = _hmt || [];
21+
(function() {
22+
var hm = document.createElement("script");
23+
hm.src = "https://hm.baidu.com/hm.js?bfb308357e73d7e9c856af04a77e822d";
24+
var s = document.getElementsByTagName("script")[0];
25+
s.parentNode.insertBefore(hm, s);
26+
})();
27+
`,
28+
],
29+
],
930
locales: {
1031
'/en/': {
1132
lang: 'en-US',
@@ -159,7 +180,7 @@ export default defineConfig({
159180
},
160181
footer: {
161182
message: 'Released under the SATA | MIT License.',
162-
copyright: 'Copyright © 2020-PRESENT MaLuns',
183+
copyright: 'Copyright © 2022-PRESENT MaLuns',
163184
},
164185
},
165186
});

‎docs/.vitepress/theme/styles/index.less

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,15 @@
3737

3838
--vp-home-hero-name-background: linear-gradient(135deg, #43cbff 10%, #9708cc 100%);
3939
--vp-home-hero-name-color: transparent;
40+
--vp-home-hero-image-background-image: linear-gradient(-45deg, #85ff7e 50%, #e391ff 50%);
41+
--vp-home-hero-image-filter: blur(72px);
4042
/* --vp-home-hero-image-background-image: linear-gradient(-45deg, #bd34fe 50%, #47caff 50%);
4143
--vp-home-hero-image-filter : blur(80px); */
4244

45+
.VPImage.image-src {
46+
width: 160px;
47+
}
48+
4349
&.dark {
4450
.VPImage.image-src {
4551
filter: invert(1);

‎docs/guide/index.md

Lines changed: 30 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,11 @@
1010

1111
::: danger 提醒
1212

13-
- 安装问题
13+
- 安装问题
1414

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

17-
- 配置问题
17+
- 配置问题
1818

1919
**本文档已经覆盖了，本主题使用的 99% 配置**。遇到问题时，**请优先翻阅文档**，参考文档里的说明。如果使用中发现文档中有解释存在歧义地方，可以通过上面多种渠道进行反馈，也可以提交 PR 进行完善。
2020
:::
@@ -40,7 +40,7 @@ yarn add -D hexo-renderer-less hexo-renderer-ejs
4040

4141
## 安装主题 Install
4242

43-
- 通过 npm 安装 （推荐）
43+
- 通过 npm 安装 （推荐）
4444

4545
![npm (tag)](https://img.shields.io/npm/v/hexo-theme-async/latest?color=red&label=hexo-theme-async%40latest&logo=npm&style=for-the-badge)
4646

@@ -50,7 +50,7 @@ yarn add -D hexo-renderer-less hexo-renderer-ejs
5050
npm i hexo-theme-async@latest
5151
```
5252

53-
- 通过克隆本仓库安装（不推荐）
53+
- 通过克隆本仓库安装（不推荐）
5454

5555
::: danger
5656
不推荐直接使用这种方式安装，会导致 bug 版本定位和后续升级比较麻烦。如果您需要自定义样式和页面模块，可以优先使用 [自定义样式](./config.html#自定义样式-style) 和 [自定义模板](./config.html#自定义模板-layout) 配置来个性话您的博客，如果以上方式无法满足您的需求时，且不在需要升级时可选择通过这种方式安装。
@@ -82,7 +82,7 @@ npm i hexo-theme-async@latest
8282

8383
:::
8484

85-
- 通过 npm 安装预览版
85+
- 通过 npm 安装预览版
8686

8787
![npm (tag)](https://img.shields.io/npm/v/hexo-theme-async/beta?color=red&label=hexo-theme-async%40beta&logo=npm&style=for-the-badge)
8888

@@ -119,34 +119,45 @@ theme: async
119119

120120
```yaml
121121
theme:
122-
switch: true
123-
default: style-light # style-light style-dark
122+
switch: true
123+
default: style-light # style-light style-dark
124124
```
125125

126126
您可以在 `_config.async.yml` 中仅定义（当然，全部覆盖也是可以的）需要覆盖配置
127127

128128
```yaml
129129
theme:
130-
default: style-dark
130+
default: style-dark
131131
```
132132

133133
:::
134134

135135
更多主题配置 [请看这里](./config)
136136

137+
## 代码示例 Demo Code
138+
139+
自定义个性化修改示例
140+
141+
- [在线体验](https://stackblitz.com/edit/node-tshsxq?embed=1&file=README.md)
142+
- [添加背景纹理样式示例](https://stackblitz.com/edit/node-bgnr3f?embed=1&file=README.md)
143+
- [自定义文章卡片示例](https://stackblitz.com/edit/node-xxazk9?file=README.md)
144+
- [自定义加载动画示例](https://stackblitz.com/edit/node-symrnq?file=README.md)
145+
- [搜索、主题按钮调整示例](https://stackblitz.com/edit/node-ghpn8p?file=README.md)
146+
147+
137148
## 安装演示视频 Demo Video
138149

139-
- 安装
140-
- [npm 安装演示](https://www.bilibili.com/video/BV1Cs4y1J7vv/)
141-
- [下载到 themes 目录演示](https://www.bilibili.com/video/BV1mg4y137Zi/)
142-
- 配置
143-
- [常用配置演示](https://www.bilibili.com/video/BV1cm4y1z7tQ/)
144-
- [主题自定义图标、自定义代码高亮演示](https://www.bilibili.com/video/BV1Da4y1M7UF/)
145-
- [随机封面、友链页、相册页面配置演示](https://www.bilibili.com/video/BV1cs4y1m7RT/)
146-
- 运行源码
147-
- [hexo-theme-async 源码运行演示](https://www.bilibili.com/video/BV19L41127LH/)
148-
- 在线体验
149-
- [stackblitz](https://stackblitz.com/edit/node-tshsxq?embed=1&file=README.md)
150+
- 安装
151+
- [npm 安装演示](https://www.bilibili.com/video/BV1Cs4y1J7vv/)
152+
- [下载到 themes 目录演示](https://www.bilibili.com/video/BV1mg4y137Zi/)
153+
- 配置
154+
- [常用配置演示](https://www.bilibili.com/video/BV1cm4y1z7tQ/)
155+
- [主题自定义图标、自定义代码高亮演示](https://www.bilibili.com/video/BV1Da4y1M7UF/)
156+
- [随机封面、友链页、相册页面配置演示](https://www.bilibili.com/video/BV1cs4y1m7RT/)
157+
- 运行源码
158+
- [hexo-theme-async 源码运行演示](https://www.bilibili.com/video/BV19L41127LH/)
159+
- 在线体验
160+
- [stackblitz](https://stackblitz.com/edit/node-tshsxq?embed=1&file=README.md)
150161

151162
安装示例视频，更多视频前往[这里](https://space.bilibili.com/12763040/channel/seriesdetail?sid=3170241)
152163

‎docs/index.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ layout: home
55
hero:
66
name: Hexo-Theme-Async
77
image:
8-
src: /logo.gif
9-
tagline: 🎈 A simple & lightweight theme for Hexo.
8+
src: /logo.svg
9+
tagline: 🎈 A simple & lightweight theme for Hexo. <br> 一个简单而轻量级的 Hexo 主题。
1010
actions:
1111
- text: 🚀 Get Started
1212
link: /guide/
@@ -24,6 +24,15 @@ features:
2424
- title: PWA
2525
icon: 🛠️
2626
details: 支持PWA，提升访问速度，可离线使用。
27+
- title: 个性化
28+
icon: 🌈
29+
details: 高度可配置，可自定义主题色调
30+
- title: 模块化
31+
icon: 🧱
32+
details: 所有模块皆可替代，快速个性化局部模块
33+
- title: 示例
34+
icon: 🌼
35+
details: 提供完整文档，以及个性化示例
2736

2837
footer:
2938
license: MIT Licensed

0 commit comments

Comments
 (0)