基本配置

多语言支持

字段:language

在博客根目录的配置文件中:

1
2
3
4
5
language:
- zh-CN
- en
- zh-HK
- zh-TW

博客将按照给定的优先级显示语言,目前支持的语言只有这4种,如需其他语言,欢迎提供翻译。

站点信息

字段:title(网站标题)

在博客根目录的配置文件中:

1
title: my blog

字段:favicon(网站图标)

在博客根目录的配置文件中:

1
favicon: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/favicon/favicon.ico

字段:avatar(作者头像,会出现在文章标题下方,不同于侧边栏的大头像)

在博客根目录的配置文件中:

1
avatar: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/avatar/avatar.png

Import

字段:import 可以在无需修改主题文件的情况下在head和body中添加各种标签。

目前支持4个字段,metalink对应head中的<meta><link>标签。script可以在body末尾导入js文件。(如果还有什么需求可以在下方留言)

这是我的import示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
# 全局导入
import:
meta:
- "<meta name='theme-color' content='#FFFFFF'>"
- "<meta name='msapplication-TileColor' content='#1BC3FB'>"
- "<meta name='msapplication-config' content='https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/favicon/favicons/browserconfig.xml'>"
link:
- "<link rel='shortcut icon' type='image/x-icon' href='https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/favicon/favicon.ico'>"
- "<link rel='icon' type='image/x-icon' sizes='32x32' href='https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/favicon/favicons/favicon-32x32.png'>"
- "<link rel='apple-touch-icon' type='image/png' sizes='180x180' href='https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/favicon/favicons/apple-touch-icon.png'>"
- "<link rel='mask-icon' color='#1BC3FB' href='https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/favicon/favicons/safari-pinned-tab.svg'>"
- "<link rel='manifest' href='https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/favicon/favicons/site.webmanifest'>"
# script:

社交信息

字段:social

在主题的配置文件中:

1
2
3
4
5
6
7
8
# 页脚社交信息
social:
- icon: fas fa-envelope
url: mailto:[email protected]
- icon: fab fa-github
url: https://github.com/xaoxuu
- icon: fas fa-music
url: https://music.163.com/#/user/home?id=63035382

这些社交按钮也会同时出现在侧边栏头像下方,可以在侧边栏的配置中设置不显示。

封面1.2.0新增

在主题的配置文件中:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# page的封面
cover:
scheme: search # 后期将会提供多种封面方案
# height: half # full(默认值): 首页封面占据整个第一屏幕,其他页面占半个屏幕高度, half: 所有页面都封面都只占半个屏幕高度
title: "xaoxuu"
# logo: assets/logo.png # logo和title只显示一个,若同时设置,则只显示logo
# search_placeholder: '搜索'
# 主页封面菜单
features:
- name: 博文
icon: fas fa-rss
url: /
- name: 项目
icon: fas fa-code-branch
url: projects/
- name: 归档
icon: fas fa-archive
url: blog/archives/
rel: nofollow
- name: 关于
icon: fas fa-info-circle
url: about/
rel: nofollow

导航栏

字段:menu_desktop、menu_mobile

在主题的配置文件中:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# 桌面端导航栏菜单
menu_desktop:
- name: Cocoa Dev
icon: fab fa-apple
url: blog/categories/dev/cocoa/
- name: Dev
icon: fas fa-laptop-code
url: blog/categories/dev/
- name: Life
icon: fas fa-coffee
url: blog/categories/life/
rel: nofollow

# 手机端导航菜单(从右上角的按钮点击展开)
menu_mobile:
- name: 近期文章
icon: fas fa-clock
url: /
- name: 文章归档
icon: fas fa-archive
url: blog/archives/
rel: nofollow
- name: 开源项目
icon: fas fa-code-branch
url: projects/
- name: 歌单分享
icon: fas fa-compact-disc
url: music/
rel: nofollow
- name: 我的友链
icon: fas fa-link
url: friends/
rel: nofollow
- name: 主题文档
icon: fas fa-book
url: https://xaoxuu.com/wiki/material-x/
rel: nofollow
- name: 关于小站
icon: fas fa-info-circle
url: about/
rel: nofollow

其中 icon 是 fontawesome 图标名,你要显示什么图标,去 fontawesome.com 找免费版的就可以了。

页脚文字

字段:footer

在主题的配置文件中:

1
footer: '这是页脚文字,支持**markdown**语法。'

分享

在主题的配置文件中:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 分享按钮
# 当id为qrcode时需要安装插件 npm i -S hexo-helper-qrcode
share:
- id: qq
name: QQ好友
img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/logo/128/qq.png
- id: qzone
name: QQ空间
img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/logo/128/qzone.png
# - id: qrcode
# name: 微信
# img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/logo/128/wechat.png
- id: weibo
name: 微博
img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/logo/128/weibo.png
# - id: qrcode
# name: QRcode
# img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/logo/128/qrcode.png



评论

有疑问请前往本项目的【Issue】页面搜索问题,如果没有相关问题,点击【New issue】进行提问。