The whole problem with the world is that fools and fanatics are always so certain of themselves, but wiser people so full of doubts.

Inside 主题配置

Sep 5, 2018elmore

theme

一般设置。

1
2
3
4
5
6
theme:
api_prefix:
cdn:
background:
sidebar_background:
content_width:
  • api_prefix : json 数据请求前缀,缺省值 api
  • cdn : 静态资源 CDN 路径。
  • background : <body> 背景样式。
  • sidebar_background : sidebar 背景样式。
  • content_width : 内容区最大宽度。

背景样式取值以下均合理:

1
2
3
background: '#f5f7fa'
background: 'confectionary.png #f5f7fa'
background: 'url(confectionary.png) #f5f7fa'

设置 sidebar 导航链接。

1
2
3
4
5
menu:
Home: /
About: /about
Links: /links
Github: https://github.com/elmorec

profile

设置 sidebar 个人信息。

1
2
3
4
profile:
avatar:
email:
bio:
  • avatar : 头像图片 URL。
  • bio : 个性签名。
  • email : 如未指定 avatar,此处的邮箱用来生成 gravatar 头像 URL。
    如配置了 site.email,此项可缺省。

sns

设置 sidebar 底部社交媒体 URL。支持的项如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
sns:
email:
feed:
github:
twitter:
facebook:
google+:
instagram:
tumblr:
dribbble:
telegram:
youtube:
hangouts:
linkedin:
pinterest:
soundcloud:
myspace:
weibo:
qq:

若配置了 site.emailtheme.profile.emailsns.email 可留空。

若使用 hexo-generator-feed 同时已启用,sns.feed 可留空,自动取 site.feed.path

可通过改变项的先后顺序来自定义排序。

底部网站信息。

1
2
3
4
5
footer:
copyright:
powered:
theme:
custom:
footer.描述取值缺省值
copyrightcopyrightstring | false©2018 • 作者.
powered显示 Hexo 链接booleantrue
theme显示 Inside 主题链接booleantrue
custom自定义信息string

post

post 相关设置。

1
2
3
4
5
post:
per_page:
toc:
copyright:
reward:

post.per_page

首页 post card 列表的分页大小。缺省值为 10

post.toc

post 目录。

1
2
3
toc:
depth: 3
index: true
post.toc.描述取值缺省值
depth最多显示几层目录1 2 3 43
index是否显示标号booleantrue

post 目录默认启用,设置为 false 可禁用,如:

1
toc: false

post.copyright

post 底部版权声明。默认禁用,留空即启用。

1
2
3
4
5
copyright:
global:
link:
license:
published:
post.copyright.描述取值缺省值
global全局启用booleantrue
license版权声明stringAttribution-NonCommercial-NoDerivatives 4.0 International
(CC BY-NC-ND 4.0)
published显示发表日期booleantrue
author显示作者booleanfalse
link显示文章链接booleanfalse
updated显示修改日期booleanfalse
custom禁用以上设置,
显示自定义信息
string

可通过改变项的先后顺序来自定义排序。

post.reward

显示打赏。缺省值为 false

page

page 相关设置。

page.reward

显示打赏。缺省值为 false

archive

archive 相关设置。

archive.per_page

archive 分页大小。缺省值为 10

tag

tag 相关设置。

tag.per_page

tag 分页大小。缺省值为 10

category

category 相关设置。

category.per_page

category 分页大小。缺省值为 10

favicon

favicon,缺省值 favicon.ico

1
favicon: favicon.ico

assets

文章图片 CDN 设置。

1
2
3
assets:
prefix: 'https://cdn.example.com'
suffix: '?m=webp&q=80'

如:

1
![cat](images/cat.gif)

会被转成:

1
<img src="https://cdn.example.com/images/cat.gif?m=webp&q=80" alt="cat">

comments

评论。支持 DisqusLiveRe

comments.disqus

1
2
3
4
disqus:
shortname:
script:
autoload:
comments.disqus.描述取值缺省值
shortnamedisqus shortnamestring
scriptdisqus 脚本 url。
比如://shortname.disqus.com/embed.js
如果设置了 shortname 可以不管。
string
autoload自动加载 or 显示手动加载按钮。booleantrue

comments.livere

1
2
3
4
livere:
uid:
script:
autoload:
comments.livere.描述取值缺省值
uidLiveRe uidstring
scriptLiveRe city 版脚本 url。stringhttps://cdn-city.livere.com/js/embed.dist.js
autoload自动加载 or 显示手动加载按钮。booleantrue

pwa

PWA 相关设置。

pwa.workbox

主题使用 workbox 来支持离线缓存。默认禁用,留空即启用。

1
2
3
4
5
6
workbox:
cdn:
module_path_prefix:
expire:
name:
rules:
pwa.workbox.描述取值缺省值
cdnworkbox CDNstringhttps://storage.googleapis.com/workbox-cdn/releases/3.3.0/workbox-sw.js
module_path_prefixworkbox.modulePathPrefixstring
expire过期时间(小时)number4(设置为 0 可持久缓存)
name生成的 service worker 脚本名stringsw.js
rules自定义缓存规则array

自定义缓存规则 rules 设置:

  • name : 缓存名称 (主要用于区分)。
  • strategy : workbox 的缓存策略,见 Workbox Strategies
  • regex : 用于路由匹配的正则。
  • expire: 过期时间(小时)。

举例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
pwa:
workbox:
# 使用 alicdn
cdn: https://g.alicdn.com/kg/workbox/3.3.0/workbox-sw.js
module_path_prefix: https://g.alicdn.com/kg/workbox/3.3.0/
# expire 设置为 0 使缓存永不过期
expire: 0
name: sw.js
rules:
# 使用 staleWhileRevalidate 策略缓存 jsdelivr 请求
- name: jsdelivr
strategy: staleWhileRevalidate
regex: https://cdn\\.jsdelivr\\.net
# 使用 cacheFirst 策略缓存静态资源
- name: theme
strategy: staleWhileRevalidate
regex: /.*\\.(?:js|css|woff2|png|jpg|gif)$
# 使用 cacheFirst 策略缓存 json 文件
- name: json
strategy: cacheFirst
regex: your_api_prefix/.*\\.json

若启用了 workbox,主题默认会对页面请求进行缓存,此外的其他请求都需要自行设置缓存规则。

pwa.manifest

设置 manifest.json 内容,默认禁用。

1
2
3
4
5
6
7
8
9
10
11
12
13
manifest:
short_name:
name:
start_url: /
theme_color: '#2a2b33'
background_color: '#2a2b33'
icons:
- src: icon-194x194.png
sizes: 194x194 512x512
type: image/png
- src: icon-144x144.png
sizes: 144x144
type: image/png

有关 manifest.json 的信息见 The Web App Manifest,默认取值如下:

manifest.缺省值
short_namesite.title
namesite.title
start_url.
theme_color#2a2b33
background_color#2a2b33

seo

1
2
seo:
structured_data: true

reward

打赏设置。默认禁用。

1
2
3
4
5
6
7
reward:
text:
methods:
- name:
qrcode:
url:
text:
reward.描述取值缺省值
text描述文本stringBuy me a cup of coffee ☕.
methods支付方式列表array

methods 设置:

  • name : 支持 wechat alipay paypal bitcoin
  • qrcode : 二维码地址
  • url : 链接地址
  • text : 用于链接地址的文本

必须至少设置 qrcodeurl

ga

谷歌统计。

1
ga: UA-00000000-0

Buy me a cup of coffee ☕.

  • Copyright:

    自由转载-非商用-禁止演绎-保持署名(CC BY-NC-ND 4.0

  • Published:

    September 5, 2018

Load Disqus
  1. 1 theme
  2. 2 menu
  3. 3 profile
  4. 4 sns
  5. 5 footer
  6. 6 post
    1. 6.1 post.per_page
    2. 6.2 post.toc
    3. 6.3 post.copyright
    4. 6.4 post.reward
  7. 7 page
    1. 7.1 page.reward
  8. 8 archive
    1. 8.1 archive.per_page
  9. 9 tag
    1. 9.1 tag.per_page
  10. 10 category
    1. 10.1 category.per_page
  11. 11 favicon
  12. 12 assets
  13. 13 comments
    1. 13.1 comments.disqus
    2. 13.2 comments.livere
  14. 14 pwa
    1. 14.1 pwa.workbox
    2. 14.2 pwa.manifest
  15. 15 seo
  16. 16 reward
  17. 17 ga