hexo-theme-stellar/_config.yml

277 lines
9.3 KiB
YAML
Raw Normal View History

2021-02-19 23:33:19 +08:00
######## Stellar info ########
stellar:
2022-03-29 22:04:54 +08:00
version: '1.7.0'
2021-02-21 20:53:49 +08:00
homepage: 'https://xaoxuu.com/wiki/stellar/'
repo: 'https://github.com/xaoxuu/hexo-theme-stellar'
2021-02-21 21:31:43 +08:00
cdn_css: # Use cdn links instead of /css/main.css
cdn_js: # Use cdn links instead of /js/main.js
2021-02-19 23:33:19 +08:00
######## head tags ########
2021-02-21 03:13:21 +08:00
open_graph:
enable: true
twitter_id: # for open_graph meta
2021-02-19 23:33:19 +08:00
######## Sidebar ########
sidebar:
logo:
2021-02-24 21:27:31 +08:00
avatar: '[config.avatar](/about/)' # you can set avatar link in _config.yml or '[https://xxx.png](/about/)'
title: '[config.title](/)' # you can set html tag like: '[<img no-lazy height="32px" src="xxx"/>](/)'
2021-02-19 23:33:19 +08:00
menu:
2021-11-19 20:25:18 +08:00
# post: '[btn.blog](/)'
# wiki: '[btn.wiki](/wiki/)'
# friends: '[友链](/friends/)'
# about: '[关于](/about/)'
2021-02-19 23:33:19 +08:00
# Sidebar widgets
2021-11-19 22:04:14 +08:00
widget_layout:
index: [welcome, recent] # for home/wiki/categories/tags/archives/404 pages
page: [welcome, toc] # for pages using 'layout:page'
post: [toc, repo_info] # for pages using 'layout:post'
wiki: [toc, repo_info, wiki_more] # for pages using 'layout:wiki'
2021-02-19 23:33:19 +08:00
widgets:
# Recent update
recent:
layout: recent
2021-03-13 23:31:52 +08:00
rss: # /atom.xml # npm i hexo-generator-feed
2021-02-19 23:33:19 +08:00
limit: 5 # Count of posts
# TOC (valid only in layout:post/wiki)
toc:
layout: toc
list_number: false
min_depth: 2
max_depth: 5
2021-04-07 21:34:11 +08:00
fallback: recent # Use a backup widget when toc does not exist.
2021-02-19 23:33:19 +08:00
# welcome
welcome:
layout: markdown
2021-08-02 19:23:50 +08:00
title: Stellar 入门指南
2021-11-19 20:25:39 +08:00
content: | # support markdown
欢迎使用 [Stellar](https://github.com/xaoxuu/hexo-theme-stellar/) 主题,下面是您的入门指南,祝您使用愉快!
<br>
**第一步**
创建 `blog/_config.stellar.yml` 文件,在此文件中填写需要自定义的主题配置。
<br>
**第二步**
创建 `blog/source/_data/widgets.yml` 文件,此文件中填写需要自定义的侧边栏组件,例如 `welcome` 组件。
<br>
如果有任何疑问,请先查阅[文档](https://xaoxuu.com/wiki/stellar/),如果文档中没有提供,请提 [issue](https://github.com/xaoxuu/hexo-theme-stellar/issues/) 向开发中询问。
2021-02-19 23:33:19 +08:00
2021-08-28 13:08:53 +08:00
######## Main ########
breadcrumb:
2021-11-19 22:04:14 +08:00
home: home # config.title / config.author / home or custom content
2021-08-28 13:08:53 +08:00
2021-02-19 23:33:19 +08:00
######## Article ########
article:
2021-07-25 16:44:55 +08:00
# 如果没有指定封面,是否根据 tags 作为关键词搜索封面?
2021-08-23 23:47:12 +08:00
auto_cover: false # search from https://source.unsplash.com/
2021-02-19 23:33:19 +08:00
# 如果没有指定 excerpt 和 description将自动取多长的内容作为文章摘要
auto_excerpt: 200
2021-02-23 21:09:49 +08:00
# 分类颜色
category_color:
'新闻稿': '#DA0F47'
2021-02-25 00:05:23 +08:00
# 文章许可协议
2021-02-26 20:02:32 +08:00
license: '本文采用 [署名-非商业性使用-相同方式共享 4.0 国际](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可协议,转载请注明出处。'
2021-02-25 00:05:23 +08:00
# 分享
2021-03-01 23:24:57 +08:00
share: # [wechat, weibo, email, link]
2021-02-19 23:33:19 +08:00
# 相关文章,需要安装插件 (for layout: post)
# npm i hexo-related-popular-posts
related_posts:
enable: false
max_count: 5
2021-07-25 16:44:55 +08:00
auto_cover: true # 如果没有封面就根据 tags 作为关键词搜索封面,开了此项将不会自动从文章中提取首张图片作为封面了。
2021-02-19 23:33:19 +08:00
######## Comments ########
comments:
2021-07-23 12:10:24 +08:00
service: # beaudar, utterances, valine, twikoo
# beaudar
# https://beaudar.lipk.org/
beaudar:
repo: xxx/xxx
issue-term: pathname
issue-number:
theme: preferred-color-scheme
2021-07-23 23:44:25 +08:00
label:
2021-07-23 12:10:24 +08:00
input-position: top # top/bottom 评论框位置
comment-order: desc # desc 排序
keep-theme: # true/false
2021-07-23 23:44:25 +08:00
loading: false
branch: main
2021-02-19 23:33:19 +08:00
# utterances
# https://utteranc.es/
utterances:
repo: xxx/xxx
issue-term: pathname
issue-number:
2021-07-23 12:10:24 +08:00
theme: preferred-color-scheme
2021-07-23 23:44:25 +08:00
label:
2021-03-13 22:30:07 +08:00
valine:
js: https://cdn.jsdelivr.net/gh/XuxuGood/simple-blog-cdn@main/js/Valine.min.js
2021-03-13 22:30:07 +08:00
appId: # your appId
appKey: # your appKey
2021-04-01 23:34:25 +08:00
placeholder:
requiredFields: [nick, mail]
2021-03-13 22:30:07 +08:00
enableQQ: true # Unstable avatar link
recordIP: false # Record commenter IP
avatar: robohash # gravatar style https://valine.js.org/avatar
pageSize: 10 # comment list page size
lang: zh-cn
highlight: true
mathJax: false
2021-04-01 23:34:25 +08:00
tagMeta: [博主, 小伙伴, 访客] # 标签要显示的文字,默认'博主,小伙伴,访客'
metaPlaceholder:
nick: "昵称/QQ号(必填)"
mail: "邮箱(必填,完全保密)"
link: "网址(https://)"
master: #md5加密后的博主邮箱
2021-04-01 23:34:25 +08:00
- 6783037F2DF30EAB99F9FC256157D875
friends: #md5加密后的小伙伴邮箱
2021-04-01 23:34:25 +08:00
- 6783037F2DF30EAB99F9FC256157D875
# Twikoo
# https://twikoo.js.org/
twikoo:
js: https://cdn.jsdelivr.net/npm/twikoo@1.4.0/dist/twikoo.all.min.js # 建议锁定版本
envId: https://xxx # vercel函数
2021-02-19 23:33:19 +08:00
######## Footer ########
footer:
social:
2021-11-19 20:37:42 +08:00
# github:
# icon: '<img src="https://cdn.jsdelivr.net/gh/cdn-x/placeholder@1.0.3/social/08a41b181ce68.svg"/>'
2021-03-13 22:30:07 +08:00
# url: /
2021-11-19 20:37:42 +08:00
# music:
# icon: '<img src="https://cdn.jsdelivr.net/gh/cdn-x/placeholder@1.0.3/social/3845874.svg"/>'
2021-03-13 22:30:07 +08:00
# url: /
2021-11-19 20:37:42 +08:00
# unsplash:
# icon: '<img src="https://cdn.jsdelivr.net/gh/cdn-x/placeholder@1.0.3/social/3616429.svg"/>'
2021-03-13 22:30:07 +08:00
# url: /
2021-11-19 20:37:42 +08:00
# comments:
# icon: '<img src="https://cdn.jsdelivr.net/gh/cdn-x/placeholder@1.0.3/social/942ebbf1a4b91.svg"/>'
# url: /about/#comments
2021-06-26 16:08:16 +08:00
sitemap:
# '博客':
# - '[近期](/)'
# - '[分类](/)'
# - '[标签](/)'
# - '[归档](/)'
# '项目':
# - '[开源库](/)'
# '社交':
# - '[友链](/)'
# - '[留言板](/)'
# '更多':
# - '[关于本站](/)'
# - '[GitHub](/)'
2021-02-21 03:13:21 +08:00
license: '[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)'
source: #'[GitHub](https://github.com/xaoxuu/hexo-theme-stellar)'
2021-07-31 18:20:25 +08:00
more: # string or array (support markdown)
2021-02-19 23:33:19 +08:00
######## Tag Plugins ########
tag_plugins:
# {% note text %}
note:
2021-07-03 23:43:52 +08:00
default_color: '' # light, dark, red, orange, yellow, green, cyan, blue, purple
2021-02-19 23:33:19 +08:00
# {% checkbox %}
checkbox:
interactive: false # enable interactive for user
2022-01-04 23:34:21 +08:00
# {% quot %}
quot:
default: # 可以自行配置多种图标方案
prefix: https://s2.loli.net/2022/01/04/vsTB5pGrIHfPxSj.png
suffix: https://s2.loli.net/2022/01/04/NORdtjlAhifZSns.png
hashtag:
prefix: https://s2.loli.net/2022/01/04/UvHcsa73jQPnobq.png
# {% emoji %}
2021-08-02 16:25:27 +08:00
emoji:
default: https://cdn.jsdelivr.net/gh/volantis-x/cdn-emoji/qq/%s.gif
twemoji: https://cdn.jsdelivr.net/gh/twitter/twemoji/assets/svg/%s.svg
qq: https://cdn.jsdelivr.net/gh/volantis-x/cdn-emoji/qq/%s.gif
aru: https://cdn.jsdelivr.net/gh/volantis-x/cdn-emoji/aru-l/%s.gif
tieba: https://cdn.jsdelivr.net/gh/volantis-x/cdn-emoji/tieba/%s.png
2022-01-27 13:46:11 +08:00
# {% image %}
image:
fancybox: # true, false
2021-02-19 23:33:19 +08:00
######## JS Plugins ########
plugins:
## required plugins ##
# jquery
jquery: https://cdn.jsdelivr.net/npm/jquery@3.5.1/dist/jquery.min.js
2021-02-21 04:01:17 +08:00
# issues api
2021-03-03 22:05:29 +08:00
sitesjs: /js/plugins/sites.js
friendsjs: /js/plugins/friends.js
2021-02-21 03:13:21 +08:00
2021-02-19 23:33:19 +08:00
## optional plugins ##
# preload
preload:
2021-02-21 03:13:21 +08:00
enable: true
service: flying_pages # instant_page, flying_pages
2021-02-20 18:37:42 +08:00
instant_page: https://cdn.jsdelivr.net/gh/volantis-x/cdn-volantis@4.1.2/js/instant_page.js
2021-02-19 23:33:19 +08:00
flying_pages: https://cdn.jsdelivr.net/gh/gijo-varghese/flying-pages@2.1.2/flying-pages.min.js
# image lazyload
# https://www.npmjs.com/package/vanilla-lazyload
lazyload:
2021-02-21 17:27:48 +08:00
enable: true # [hexo clean && hexo s] is required after changing this value.
2021-02-19 23:33:19 +08:00
js: https://cdn.jsdelivr.net/npm/vanilla-lazyload@17.3.1/dist/lazyload.min.js
2021-03-04 22:30:56 +08:00
transition: blur # blur, fade
2021-02-19 23:33:19 +08:00
# https://scrollrevealjs.org/api/reveal.html
scrollreveal:
2021-07-14 01:18:25 +08:00
enable: #true
2021-03-08 00:20:51 +08:00
js: https://cdn.jsdelivr.net/npm/scrollreveal@4.0.9/dist/scrollreveal.min.js
2021-02-22 13:19:21 +08:00
distance: 8px
duration: 500 # ms
2021-03-04 23:38:41 +08:00
interval: 100 # ms
2021-02-19 23:33:19 +08:00
scale: 1 # 0.1~1
2022-01-27 13:46:11 +08:00
2022-01-21 11:24:32 +08:00
# https://fancyapps.com/docs/ui/fancybox/
2022-01-27 13:46:11 +08:00
# available for {% image xxx %}
2022-01-21 11:24:32 +08:00
fancybox:
2022-01-27 13:46:11 +08:00
enable: true
2022-01-21 11:24:32 +08:00
js: https://cdn.jsdelivr.net/npm/@fancyapps/ui@4.0/dist/fancybox.umd.js
css: https://cdn.jsdelivr.net/npm/@fancyapps/ui@4.0/dist/fancybox.css
2022-01-27 13:46:11 +08:00
# 可以处理评论区的图片(不支持 iframe 类评论系统)例如:
# 使用valine评论可以写: .vcontent img:not(.vemoji)
# 使用twikoo评论可以写: .tk-content img:not([class*="emo"])
selector: .swiper-slide img # 多个选择器用英文逗号隔开
# swiper
swiper:
enable: true
css: https://unpkg.com/swiper@6/swiper-bundle.min.css
js: https://unpkg.com/swiper@6/swiper-bundle.min.js
2022-03-02 14:50:45 +08:00
# 赫蹏 (Heti) - 专为中文网页内容设计的排版样式增强
# https://github.com/sivan/heti
2022-03-02 14:50:45 +08:00
heti:
enable: false
css: https://unpkg.com/heti/umd/heti.min.css
js: https://unpkg.com/heti/umd/heti-addon.min.js
2021-03-04 23:38:41 +08:00
2021-04-02 20:24:16 +08:00
style:
2021-08-28 14:03:54 +08:00
darkmode: auto # auto / always / false
2021-06-23 13:41:05 +08:00
theme:
light: '#f8f8f8'
2021-08-29 02:21:25 +08:00
dark: '#313438'
2021-04-07 22:38:13 +08:00
animated_avatar:
animate: auto # auto, always
2021-04-07 22:53:26 +08:00
background: https://cdn.jsdelivr.net/gh/cdn-x/placeholder@1.0.2/avatar/round/rainbow64@3x.webp
2021-07-14 00:15:21 +08:00
codeblock:
scrollbar: 4px
2021-04-01 22:36:26 +08:00
2021-03-04 23:38:41 +08:00
default:
2021-03-08 01:41:59 +08:00
avatar: https://cdn.jsdelivr.net/gh/cdn-x/placeholder@1.0.1/avatar/round/3442075.svg
link: https://cdn.jsdelivr.net/gh/cdn-x/placeholder@1.0.1/link/8f277b4ee0ecd.svg
cover: https://cdn.jsdelivr.net/gh/cdn-x/placeholder@1.0.1/cover/76b86c0226ffd.svg
image: https://cdn.jsdelivr.net/gh/cdn-x/placeholder@1.0.1/image/2659360.svg