hexo-theme-clarity 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.travis.yml +5 -0
- package/LICENSE +7 -0
- package/README-en.md +319 -0
- package/README.md +343 -0
- package/_config.yml +180 -0
- package/languages/de-DE.yml +22 -0
- package/languages/en.yml +37 -0
- package/languages/es-ES.yml +22 -0
- package/languages/fr-FR.yml +22 -0
- package/languages/ko.yml +22 -0
- package/languages/nb-NO.yml +38 -0
- package/languages/ru.yml +22 -0
- package/languages/zh-CN.yml +38 -0
- package/languages/zh-TW.yml +38 -0
- package/layout/_partial/after_footer.pug +60 -0
- package/layout/_partial/comments.pug +183 -0
- package/layout/_partial/darkmode.pug +13 -0
- package/layout/_partial/footer.pug +26 -0
- package/layout/_partial/head.pug +61 -0
- package/layout/_partial/helpers.pug +21 -0
- package/layout/_partial/mathjax.pug +6 -0
- package/layout/_partial/mathjax2.pug +1 -0
- package/layout/_partial/paginator.pug +3 -0
- package/layout/_partial/post_nav.pug +6 -0
- package/layout/_partial/tag.pug +2 -0
- package/layout/_partial/totop.pug +5 -0
- package/layout/_partial/wordcount.pug +11 -0
- package/layout/_widget/category.pug +4 -0
- package/layout/_widget/copyright.pug +27 -0
- package/layout/_widget/donate.pug +19 -0
- package/layout/_widget/info.pug +21 -0
- package/layout/_widget/links.pug +6 -0
- package/layout/_widget/recent_comments.pug +12 -0
- package/layout/_widget/recent_posts.pug +4 -0
- package/layout/_widget/search.pug +26 -0
- package/layout/_widget/tag.pug +5 -0
- package/layout/archive.pug +24 -0
- package/layout/base-without-sidebar.pug +38 -0
- package/layout/base.pug +47 -0
- package/layout/blogroll.pug +21 -0
- package/layout/index.pug +50 -0
- package/layout/page.pug +12 -0
- package/layout/post.pug +60 -0
- package/layout/single-column.pug +10 -0
- package/layout/tagcloud.pug +23 -0
- package/layout/timeline.pug +28 -0
- package/package.json +15 -0
- package/source/css/copycode.scss +32 -0
- package/source/css/copyright.scss +43 -0
- package/source/css/donate.scss +308 -0
- package/source/css/search.scss +13 -0
- package/source/css/style.scss +2536 -0
- package/source/img/alipay.svg +1 -0
- package/source/img/avatar.png +0 -0
- package/source/img/bei.png +0 -0
- package/source/img/bitcoin.svg +1 -0
- package/source/img/github.svg +1 -0
- package/source/img/like.svg +1 -0
- package/source/img/paypal.svg +1 -0
- package/source/img/wechat.svg +1 -0
- package/source/js/codeblock-resizer.js +51 -0
- package/source/js/copycode.js +30 -0
- package/source/js/copyright.js +17 -0
- package/source/js/donate.js +49 -0
- package/source/js/fancybox.js +19 -0
- package/source/js/love.js +1 -0
- package/source/js/recent-comments.js +54 -0
- package/source/js/search.js +101 -0
- package/source/js/share.js +60 -0
- package/source/js/smartresize.js +32 -0
- package/source/js/totop.js +12 -0
package/README.md
ADDED
|
@@ -0,0 +1,343 @@
|
|
|
1
|
+
# Clarity
|
|
2
|
+
|
|
3
|
+
[](https://github.com/guozhenyi/hexo-theme-clarity/blob/main/LICENSE)
|
|
4
|
+
|
|
5
|
+
[预览](https://www.guozhenyi.com)|[English Document](./README-en.md)
|
|
6
|
+
|
|
7
|
+
一款还在持续演进的简洁、明快的 Hexo 主题。由 [maupassant](https://github.com/tufu9441/maupassant-hexo) Fork 而来。
|
|
8
|
+
|
|
9
|
+
我在原主题 maupassant 上做了一些改进,本想合并到 maupassant,又担心我的这些改动太激进了而被作者拒绝,就干脆 Fork 过来做演进了。
|
|
10
|
+
|
|
11
|
+
## 安装
|
|
12
|
+
|
|
13
|
+
在 Hexo 创建的项目根目录中,安装主题和模板引擎:
|
|
14
|
+
|
|
15
|
+
```shell
|
|
16
|
+
$ git clone https://github.com/guozhenyi/hexo-theme-clarity.git themes/clarity
|
|
17
|
+
$ npm install hexo-renderer-pug --save
|
|
18
|
+
$ npm install hexo-renderer-sass-next --save
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
之后,在 `_config.yml` 文件中将 `theme` 的值改为 `clarity`。
|
|
22
|
+
|
|
23
|
+
## 配置
|
|
24
|
+
|
|
25
|
+
默认配置:
|
|
26
|
+
|
|
27
|
+
```YAML
|
|
28
|
+
disqus:
|
|
29
|
+
enable: false ## If you want to use Disqus comment system, please set the value to true.
|
|
30
|
+
shortname: ## Your disqus_shortname, e.g. username
|
|
31
|
+
api: ## You can visit Disqus comments in China mainland without barriers using Disqus API, e.g. https://disqus.skk.moe/disqus/
|
|
32
|
+
apikey: ## Your API key obtained in Disqus API Application, e.g. yk00ZB1fjYGRkrCrDDRYDUjpp26GJWJiJRZQZ5SY0r3th5FMW6pnSzQMnWH7ua7r
|
|
33
|
+
admin: ## Username of your Disqus moderator, e.g. username
|
|
34
|
+
admin_label: ## The text of Disqus moderator badge, e.g. Mod
|
|
35
|
+
uyan: ## Your uyan_id. e.g. 1234567
|
|
36
|
+
livere: ## Your livere data-uid, e.g. MTAyMC8zMDAxOC78NTgz
|
|
37
|
+
changyan: ## Your changyan appid, e.g. cyrALsXc8
|
|
38
|
+
changyan_conf: ## Your changyan conf, e.g. prod_d8a508c2825ab57eeb43e7c69bba0e8b
|
|
39
|
+
gitalk: ## See: https://github.com/gitalk/gitalk
|
|
40
|
+
enable: false ## If you want to use Gitment comment system please set the value to true.
|
|
41
|
+
owner: ## Your GitHub ID, e.g. username
|
|
42
|
+
repo: ## The repository to store your comments, make sure you're the repo's owner, e.g. gitalk.github.io
|
|
43
|
+
client_id: ## GitHub client ID, e.g. 75752dafe7907a897619
|
|
44
|
+
client_secret: ## GitHub client secret, e.g. ec2fb9054972c891289640354993b662f4cccc50
|
|
45
|
+
admin: ## Github repo owner and collaborators, only these guys can initialize github issues.
|
|
46
|
+
valine: ## See: https://valine.js.org
|
|
47
|
+
enable: false ## If you want to use Valine comment system, please set the value to true.
|
|
48
|
+
appid: ## Your LeanCloud application App ID, e.g. pRBBL2JR4N7kLEGojrF0MsSs-gzGzoHsz
|
|
49
|
+
appkey: ## Your LeanCloud application App Key, e.g. tjczHpDfhjYDSYddzymYK1JJ
|
|
50
|
+
notify: false ## Mail notifier, see https://github.com/xCss/Valine/wiki/Valine-评论系统中的邮件提醒设置
|
|
51
|
+
verify: false ## Validation code.
|
|
52
|
+
placeholder: Just so so ## Comment box placeholders.
|
|
53
|
+
avatar: "mm" ## Gravatar type, see https://github.com/xCss/Valine/wiki/avatar-setting-for-valine
|
|
54
|
+
pageSize: 10 ## Number of comments per page.
|
|
55
|
+
guest_info: nick,mail,link ## Attributes of reviewers.
|
|
56
|
+
minivaline: ## See: https://github.com/MiniValine/MiniValine
|
|
57
|
+
enable: false ## If you want to use MiniValine comment system, please set the value to true.
|
|
58
|
+
appId: ## Your LeanCloud application App ID, e.g. pRBBL2JR4N7kLEGojrF0MsSs-gzGzoHsz
|
|
59
|
+
appKey: ## Your LeanCloud application App Key, e.g. tjczHpDfhjYDSYddzymYK1JJ
|
|
60
|
+
placeholder: Write a Comment ## Comment box placeholder.
|
|
61
|
+
adminEmailMd5: ## The MD5 of Admin Email to show Admin Flag.
|
|
62
|
+
math: true ## Support MathJax.
|
|
63
|
+
md: true ## Support Markdown.
|
|
64
|
+
# MiniValine's display language depends on user's browser or system environment
|
|
65
|
+
# If you want everyone visiting your site to see a uniform language, you can set a force language value
|
|
66
|
+
# Available values: en | zh-CN | (and many more)
|
|
67
|
+
# More i18n info: https://github.com/MiniValine/minivaline-i18n
|
|
68
|
+
lang:
|
|
69
|
+
waline: ## See: https://waline.js.org/
|
|
70
|
+
enable: false ## If you want to use Waline comment system, please set the value to true.
|
|
71
|
+
serverURL: ## Your server url, e.g. https://your-domain.vercel.app
|
|
72
|
+
pageSize: 30 ## The desired number of comments shown in each page.
|
|
73
|
+
wordLimit: 500 ## Limit the number of words in comments, 0 means no limit.
|
|
74
|
+
requiredMeta: ['nick','mail'] ## Required user information, e.g. ['nick','mail','link']
|
|
75
|
+
count: 5 ## The number comments displayed in the recent_comments widget, default is 10.
|
|
76
|
+
utterances: ## See: https://utteranc.es
|
|
77
|
+
enable: false ## If you want to use Utterances comment system, please set the value to true.
|
|
78
|
+
repo: ## The repository utterances will connect to, e.g. tufu9441/comments
|
|
79
|
+
identifier: title ## The mapping between blog posts and GitHub issues.
|
|
80
|
+
theme: github-light ## Choose an Utterances theme which matches your blog.
|
|
81
|
+
twikoo: ## See: https://twikoo.js.org
|
|
82
|
+
enable: false ## If you want to use twikoo comment system, please set the value to true.
|
|
83
|
+
envId: ## Tencent CloudBase envId
|
|
84
|
+
region: ## Tencent CloudBase region, e.g. ap-shanghai
|
|
85
|
+
path: ## Article path, e.g. window.location.pathname
|
|
86
|
+
|
|
87
|
+
google_search: true ## Use Google search, true/false.
|
|
88
|
+
baidu_search: false ## Use Baidu search, true/false.
|
|
89
|
+
swiftype: ## Your swiftype_key, e.g. m7b11ZrsT8Me7gzApciT
|
|
90
|
+
self_search: false ## Use a jQuery-based local search engine, true/false.
|
|
91
|
+
google_analytics: ## Your Google Analytics tracking id, e.g. UA-42425684-2
|
|
92
|
+
baidu_analytics: ## Your Baidu Analytics tracking id, e.g. 8006843039519956000
|
|
93
|
+
microsoft_clarity: ## Your Microsoft Clarity tracking id, e.g. zg2ctuea9j
|
|
94
|
+
fancybox: true ## 是否启用图片灯箱效果,默认启用。设为 false 可禁用。
|
|
95
|
+
show_category_count: false ## If you want to show the count of categories in the sidebar widget please set the value to true.
|
|
96
|
+
toc_number: true ## If you want to add list number to toc please set the value to true.
|
|
97
|
+
shareto: false ## If you want to use the share button please set the value to true, and you must have hexo-helper-qrcode installed.
|
|
98
|
+
busuanzi: false ## If you want to use Busuanzi page views please set the value to true.
|
|
99
|
+
wordcount: false ## If you want to display the word counter and the reading time expected to spend of each post please set the value to true, and you must have hexo-wordcount installed.
|
|
100
|
+
widgets_on_small_screens: false ## Set to true to enable widgets on small screens.
|
|
101
|
+
canvas_nest:
|
|
102
|
+
enable: false ## If you want to use dynamic background please set the value to true, you can also fill the following parameters to customize the dynamic effect, or just leave them blank to keep the default effect.
|
|
103
|
+
color: ## RGB value of the color, e.g. "100,99,98"
|
|
104
|
+
opacity: ## Transparency of lines, e.g. "0.7"
|
|
105
|
+
zIndex: ## The z-index property of the background, e.g. "-1"
|
|
106
|
+
count: ## Quantity of lines, e.g. "150"
|
|
107
|
+
donate:
|
|
108
|
+
enable: false ## If you want to display the donate button after each post, please set the value to true and fill the following items on your need. You can also enable donate button in a page by adding a "donate: true" item to the front-matter.
|
|
109
|
+
github: ## GitHub URL, e.g. https://github.com/Kaiyuan/donate-page
|
|
110
|
+
alipay_qr: ## Path of Alipay QRcode image, e.g. /img/AliPayQR.png
|
|
111
|
+
wechat_qr: ## Path of Wechat QRcode image, e.g. /img/WeChatQR.png
|
|
112
|
+
btc_qr: ## Path of Bitcoin QRcode image, e.g. /img/BTCQR.png
|
|
113
|
+
btc_key: ## Bitcoin key, e.g. 1KuK5eK2BLsqpsFVXXSBG5wbSAwZVadt6L
|
|
114
|
+
paypal_url: ## Paypal URL, e.g. https://www.paypal.me/tufu9441
|
|
115
|
+
post_copyright:
|
|
116
|
+
enable: false ## If you want to display the copyright info after each post, please set the value to true and fill the following items on your need.
|
|
117
|
+
author: ## Your author name, e.g. tufu9441
|
|
118
|
+
copyright_text: ## Your copyright text, e.g. The author owns the copyright, please indicate the source reproduced.
|
|
119
|
+
love: false ## If you want the peach heart to appear when you click anywhere, set the value to true.
|
|
120
|
+
plantuml: ## Using PlantUML to generate UML diagram, must install hexo-filter-plantuml (https://github.com/miao1007/hexo-filter-plantuml).
|
|
121
|
+
render: "PlantUMLServer" ## Local or PlantUMLServer.
|
|
122
|
+
outputFormat: "svg" ## common options: svg/png
|
|
123
|
+
copycode: true ## If you want to enable one-click copy of the code blocks, set the value to true.
|
|
124
|
+
dark: false ## If you want to toggle between light/dark themes, set the value to true.
|
|
125
|
+
totop: true ## If you want to use the rocketship button to return to the top, set the value to true.
|
|
126
|
+
external_css: false ## If you want to load an external CSS file, set the value to true and create a file named "external.css" in the source/css folder.
|
|
127
|
+
post_content_length: 180 ## Set the length of the post summary displayed on home page when no description written.
|
|
128
|
+
icp: ## 显示 icp 信息
|
|
129
|
+
bei: ## 显示公安部备案信息
|
|
130
|
+
|
|
131
|
+
menu: # 菜单项,记得要在 source 创建 directory 中填写的目录(archives不用自己创建,about需要自己创建)
|
|
132
|
+
- page: home
|
|
133
|
+
directory: .
|
|
134
|
+
icon: fa-home
|
|
135
|
+
- page: archive
|
|
136
|
+
directory: archives/
|
|
137
|
+
icon: fa-archive
|
|
138
|
+
- page: about
|
|
139
|
+
directory: about/
|
|
140
|
+
icon: fa-user
|
|
141
|
+
- page: rss
|
|
142
|
+
directory: atom.xml
|
|
143
|
+
icon: fa-rss
|
|
144
|
+
|
|
145
|
+
widgets: ## Seven widgets in sidebar provided: search, info, category, tag, recent_posts, recent_comments and links.
|
|
146
|
+
- search
|
|
147
|
+
- info
|
|
148
|
+
- category
|
|
149
|
+
- tag
|
|
150
|
+
- recent_posts
|
|
151
|
+
- recent_comments
|
|
152
|
+
- links
|
|
153
|
+
|
|
154
|
+
info:
|
|
155
|
+
avatar: /img/avatar.png
|
|
156
|
+
discription: To be a better man.
|
|
157
|
+
outlinkitem:
|
|
158
|
+
- name: twitter
|
|
159
|
+
outlink: https://twitter.com/username
|
|
160
|
+
message: Twitter
|
|
161
|
+
- name: envelope
|
|
162
|
+
outlink: mailto:admin@domain.com
|
|
163
|
+
message: Email
|
|
164
|
+
- name: github
|
|
165
|
+
outlink: https://github.com/username
|
|
166
|
+
message: Github
|
|
167
|
+
- name: rss
|
|
168
|
+
outlink: /atom.xml
|
|
169
|
+
message: RSS
|
|
170
|
+
|
|
171
|
+
links:
|
|
172
|
+
- title: site-name1
|
|
173
|
+
url: http://www.example1.com/
|
|
174
|
+
src: https://www.example1.com/favicon.ico
|
|
175
|
+
desc: XXX's Blog
|
|
176
|
+
- title: site-name2
|
|
177
|
+
url: http://www.example2.com/
|
|
178
|
+
src: https://www.example1.com/favicon.ico
|
|
179
|
+
desc: YYY's Blog
|
|
180
|
+
- title: site-name3
|
|
181
|
+
url: http://www.example3.com/
|
|
182
|
+
src: https://www.example3.com/favicon.ico
|
|
183
|
+
desc: ZZZ's Blog
|
|
184
|
+
|
|
185
|
+
timeline:
|
|
186
|
+
- num: 1
|
|
187
|
+
word: 2014/06/12-Start
|
|
188
|
+
- num: 2
|
|
189
|
+
word: 2014/11/29-XXX
|
|
190
|
+
- num: 3
|
|
191
|
+
word: 2015/02/18-DDD
|
|
192
|
+
- num: 4
|
|
193
|
+
word: More
|
|
194
|
+
|
|
195
|
+
# Static files
|
|
196
|
+
js: js
|
|
197
|
+
css: css
|
|
198
|
+
|
|
199
|
+
# Theme version
|
|
200
|
+
version: 1.0.0
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
- disqus - [Disqus](https://disqus.com) 评论系统, 支持 [DisqusJS](https://github.com/SukkaW/DisqusJS) API.
|
|
204
|
+
- uyan - [Uyan](http://www.uyan.cc) id
|
|
205
|
+
- livere - [LiveRe](https://livere.com) data-uid
|
|
206
|
+
- changyan - [Changyan](http://changyan.kuaizhan.com) appid
|
|
207
|
+
- gitalk - [Gitalk](https://github.com/gitalk/gitalk) 评论系统
|
|
208
|
+
- valine - [Valine](https://valine.js.org) 评论系统
|
|
209
|
+
- minivaline - [MiniValine](https://github.com/MiniValine/MiniValine) 评论系统
|
|
210
|
+
- waline - [Waline](https://waline.js.org) 评论系统
|
|
211
|
+
- utterances - [Utterances](https://utteranc.es) 评论系统
|
|
212
|
+
- twikoo - [Twikoo](https://twikoo.js.org) 评论系统
|
|
213
|
+
- google_search - 默认使用Google搜索引擎
|
|
214
|
+
- baidu_search - 若想使用百度搜索,将其设定为 `true`
|
|
215
|
+
- swiftype - [Swiftype Search](https://swiftype.com) key
|
|
216
|
+
- self_search - 基于jQuery的 [本地搜索引擎](https://www.hahack.com/codes/local-search-engine-for-hexo/), 需要安装 [hexo-generator-search](https://github.com/wzpan/hexo-generator-search) 插件使用
|
|
217
|
+
- google_analytics - [Google Analytics](https://www.google.com/analytics/) 跟踪ID
|
|
218
|
+
- baidu_analytics - [Baidu Analytics](https://tongji.baidu.com) 跟踪ID
|
|
219
|
+
- microsoft_clarity - [Microsoft Clarity](https://clarity.microsoft.com/) 跟踪ID
|
|
220
|
+
- fancybox - 是否启用 [Fancybox](https://fancyapps.com/fancybox/) 图片灯箱效果
|
|
221
|
+
- show_category_count - 是否在侧边栏显示分类数目
|
|
222
|
+
- toc_number - Show the list number of toc
|
|
223
|
+
- shareto - 是否显示分享按钮, 需要安装 [hexo-helper-qrcode](https://github.com/yscoder/hexo-helper-qrcode) 插件使用
|
|
224
|
+
- busuanzi - 是否使用 [不蒜子](http://ibruce.info) 页面访问统计
|
|
225
|
+
- wordcount - 是否使用 [hexo-wordcount](https://github.com/willin/hexo-wordcount) 统计文章字数
|
|
226
|
+
- widgets_on_small_screens - 是否在移动设备屏幕底部显示侧边栏
|
|
227
|
+
- canvas_nest - 是否使用 [canvas-nest.js](https://github.com/hustcc/canvas-nest.js/blob/master/README-zh.md) 动态背景
|
|
228
|
+
- donate - 是否在每篇文章后面显示捐赠按钮
|
|
229
|
+
- post_copyright - 是否在每篇文章后面显示版权信息
|
|
230
|
+
- love - 是否在任意点击处出现桃心
|
|
231
|
+
- plantuml - 是否使用 PlantUML 生成 UML 图表
|
|
232
|
+
- copycode - 是否为代码快启用一键复制功能
|
|
233
|
+
- dark - Enable to toggle between light/dark modes of the theme
|
|
234
|
+
- totop - 是否使用返回顶部小火箭图标
|
|
235
|
+
- external_css - 是否加载外部CSS文件
|
|
236
|
+
- post_content_length - Abstract length of each post
|
|
237
|
+
- menu - Customize your menu of pages here, just follow the format of existied items. Don't forget to create corresponding folders inlcuding `index.md` in `source` folder to ensure the pages will correctly display. [FontAwesome](https://fontawesome.com) icon fonts have been integrated, and you can choose other icons which you like [here](https://fontawesome.com/icons/) and use them according to the instruction.
|
|
238
|
+
- widgets - Choose and arrange the widgets in sidebar here.
|
|
239
|
+
- info - Set your personal information of the info widget here.
|
|
240
|
+
- links - Edit your blogroll here, and an independent blogroll page can be displayed by setting `layout: blogroll` of a page.
|
|
241
|
+
- timeline - 网站历史时间线,在页面 `front-matter` 中设置 `layout: timeline` 可显示
|
|
242
|
+
- Static files - 静态文件存储路径,方便设置CDN缓存。
|
|
243
|
+
- Theme version - For automatic refresh of static files on CDN.
|
|
244
|
+
|
|
245
|
+
## 主题特性
|
|
246
|
+
#### 网站图标
|
|
247
|
+
|
|
248
|
+
若要设置网站 Favicon,可以将 **favicon.ico** 放在 Hexo 根目录的 `source` 文件夹下,建议的大小:32px*32px。
|
|
249
|
+
|
|
250
|
+
若要为网站添加苹果设备图标,请将命名为 **apple-touch-icon.png** 的图片放在同样的位置,建议的大小:114px*114px。
|
|
251
|
+
|
|
252
|
+
#### 文章摘要
|
|
253
|
+
|
|
254
|
+
首页默认显示文章摘要而非全文,可以在文章的 `front-matter` 中填写一项 `description:` 来设置你想显示的摘要,或者直接在文章内容中插入 `<!--more-->` 以隐藏后面的内容,若两者都未设置,则自动截取文章第一段作为摘要。
|
|
255
|
+
|
|
256
|
+
#### 添加页面
|
|
257
|
+
|
|
258
|
+
在 `source` 目录下创建相应名称的文件夹,然后在文件夹中创建 `index.md` 文件,并在 `index.md` 的 `front-matter` 中设置 `layout` 为 `layout: page` 。现已支持添加标签页面,将页面的 `layout` 设置为 `layout: tagcloud` 即可。若需要单栏页面,就将 layout 设置为 `layout: single-column`。
|
|
259
|
+
|
|
260
|
+
#### 文章目录
|
|
261
|
+
|
|
262
|
+
在文章的 `front-matter` 中添加 `toc: true` 即可让该篇文章显示目录。
|
|
263
|
+
|
|
264
|
+
#### 文章评论
|
|
265
|
+
|
|
266
|
+
文章和页面的评论功能可以通过在 `front-matter` 中设置 `comments: true` 或 `comments: false` 来进行开启或关闭(默认开启)。比如我们创建的 `about` 页面通常不想要评论功能,就可以通过在 `about/index.md` 的头部添加 `comments: false` 来禁用评论功能。
|
|
267
|
+
|
|
268
|
+
```index.md
|
|
269
|
+
---
|
|
270
|
+
title: 关于
|
|
271
|
+
date: 2025-02-25 20:58:32
|
|
272
|
+
comments: false
|
|
273
|
+
---
|
|
274
|
+
|
|
275
|
+
contents of about ...
|
|
276
|
+
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
#### 语法高亮
|
|
280
|
+
|
|
281
|
+
要启用代码高亮,请在Hexo目录的 `_config.yml` 中将 `highlight` 选项按照如下设置:
|
|
282
|
+
|
|
283
|
+
```YAML
|
|
284
|
+
highlight:
|
|
285
|
+
enable: true
|
|
286
|
+
auto_detect: true
|
|
287
|
+
line_number: true
|
|
288
|
+
tab_replace:
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
#### 数学公式
|
|
292
|
+
|
|
293
|
+
要启用数学公式支持,请在 Hexo 目录的 `_config.yml` 中添加:
|
|
294
|
+
|
|
295
|
+
Add
|
|
296
|
+
```YAML
|
|
297
|
+
mathjax: true
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
并在相应文章的 front-matter 中添加 `mathjax: true` ,例如:
|
|
301
|
+
|
|
302
|
+
```YAML
|
|
303
|
+
title: Test Math
|
|
304
|
+
date: 2016-04-05 14:16:00
|
|
305
|
+
categories: math
|
|
306
|
+
mathjax: true
|
|
307
|
+
---
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
数学公式的默认定界符是 `$$...$$` 和 `\\[...\\]`(对于块级公式),以及 `$...$` 和 `\\(...\\)`(对于行内公式)。
|
|
311
|
+
|
|
312
|
+
但是,如果你的文章内容中经常出现美元符号“`$`”, 或者说你想将“`$`”用作美元符号而非行内公式的定界符,请在 Hexo 目录的 `_config.yml` 中添加:
|
|
313
|
+
|
|
314
|
+
```YAML
|
|
315
|
+
mathjax2: true
|
|
316
|
+
```
|
|
317
|
+
|
|
318
|
+
而不是 `mathjax: true`。 相应地,在需要使用数学公式的文章的 front-matter 中也添加 `mathjax2: true`。
|
|
319
|
+
|
|
320
|
+
#### 支持语言
|
|
321
|
+
|
|
322
|
+
目前支持简体中文(zh-CN),繁体中文(zh-TW),英语(en),法语(fr-FR),德语(de-DE),韩语(ko)和西班牙语(es-ES),欢迎翻译至其它语言。
|
|
323
|
+
|
|
324
|
+
## 问题解决
|
|
325
|
+
|
|
326
|
+
- 检查一下终端当前的目录是否为 Hexo 的根目录,并包含 `source/` 和 `themes/`。
|
|
327
|
+
- 使用过程中遇到问题欢迎提交 [issue](https://github.com/guozhenyi/hexo-theme-clarity/issues).
|
|
328
|
+
|
|
329
|
+
## 浏览器支持
|
|
330
|
+
|
|
331
|
+
| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="IE / Edge" width="24px" height="24px" />](https://godban.github.io/browsers-support-badges/)<br/>IE / Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](https://godban.github.io/browsers-support-badges/)<br/>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](https://godban.github.io/browsers-support-badges/)<br/>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](https://godban.github.io/browsers-support-badges/)<br/>Safari | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/opera/opera_48x48.png" alt="Opera" width="24px" height="24px" />](https://godban.github.io/browsers-support-badges/)<br/>Opera |
|
|
332
|
+
| --------- | --------- | --------- | --------- | --------- |
|
|
333
|
+
| IE9+, Edge| last 10 versions| last 10 versions| last 7 versions| last 10 versions
|
|
334
|
+
|
|
335
|
+
## 贡献代码
|
|
336
|
+
|
|
337
|
+
接受贡献: [pull request](https://github.com/guozhenyi/hexo-theme-clarity/pulls).
|
|
338
|
+
|
|
339
|
+
## 贡献者
|
|
340
|
+
|
|
341
|
+
<a href="https://github.com/guozhenyi/hexo-theme-clarity/graphs/contributors">
|
|
342
|
+
<img src="https://contrib.rocks/image?repo=guozhenyi/hexo-theme-clarity" />
|
|
343
|
+
</a>
|
package/_config.yml
ADDED
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
disqus:
|
|
2
|
+
enable: false ## If you want to use Disqus comment system, please set the value to true.
|
|
3
|
+
shortname: ## Your disqus_shortname, e.g. username
|
|
4
|
+
api: ## You can visit Disqus comments in China mainland without barriers using Disqus API, e.g. https://disqus.skk.moe/disqus/
|
|
5
|
+
apikey: ## Your API key obtained in Disqus API Application, e.g. yk00ZB1fjYGRkrCrDDRYDUjpp26GJWJiJRZQZ5SY0r3th5FMW6pnSzQMnWH7ua7r
|
|
6
|
+
admin: ## Username of your Disqus moderator, e.g. username
|
|
7
|
+
admin_label: ## The text of Disqus moderator badge, e.g. Mod
|
|
8
|
+
uyan: ## Your uyan_id. e.g. 1234567
|
|
9
|
+
livere: ## Your livere data-uid, e.g. MTAyMC8zMDAxOC78NTgz
|
|
10
|
+
changyan: ## Your changyan appid, e.g. cyrALsXc8
|
|
11
|
+
changyan_conf: ## Your changyan conf, e.g. prod_d8a508c2825ab57eeb43e7c69bba0e8b
|
|
12
|
+
gitalk: ## See: https://github.com/gitalk/gitalk
|
|
13
|
+
enable: false ## If you want to use Gitment comment system please set the value to true.
|
|
14
|
+
owner: ## Your GitHub ID, e.g. username
|
|
15
|
+
repo: ## The repository to store your comments, make sure you're the repo's owner, e.g. gitalk.github.io
|
|
16
|
+
client_id: ## GitHub client ID, e.g. 75752dafe7907a897619
|
|
17
|
+
client_secret: ## GitHub client secret, e.g. ec2fb9054972c891289640354993b662f4cccc50
|
|
18
|
+
admin: ## Github repo owner and collaborators, only these guys can initialize github issues.
|
|
19
|
+
valine: ## See: https://valine.js.org
|
|
20
|
+
enable: false ## If you want to use Valine comment system, please set the value to true.
|
|
21
|
+
appid: ## Your LeanCloud application App ID, e.g. pRBBL2JR4N7kLEGojrF0MsSs-gzGzoHsz
|
|
22
|
+
appkey: ## Your LeanCloud application App Key, e.g. tjczHpDfhjYDSYddzymYK1JJ
|
|
23
|
+
serverURLs: ## If you are the "LeanCloud" in China, then this option is not mandatory to fill out. REST API Server Url" of your "LeanCloud, e.g. https://prbbl2jr.api.lncldglobal.com
|
|
24
|
+
notify: false ## Mail notifier, see https://github.com/xCss/Valine/wiki/Valine-评论系统中的邮件提醒设置
|
|
25
|
+
verify: false ## Validation code.
|
|
26
|
+
placeholder: Just so so ## Comment box placeholders.
|
|
27
|
+
avatar: "mm" ## Gravatar type, see https://github.com/xCss/Valine/wiki/avatar-setting-for-valine
|
|
28
|
+
pageSize: 10 ## Number of comments per page.
|
|
29
|
+
guest_info: nick,mail,link ## Attributes of reviewers.
|
|
30
|
+
minivaline: ## See: https://github.com/MiniValine/MiniValine
|
|
31
|
+
enable: false ## If you want to use MiniValine comment system, please set the value to true.
|
|
32
|
+
appId: ## Your LeanCloud application App ID, e.g. pRBBL2JR4N7kLEGojrF0MsSs-gzGzoHsz
|
|
33
|
+
appKey: ## Your LeanCloud application App Key, e.g. tjczHpDfhjYDSYddzymYK1JJ
|
|
34
|
+
placeholder: Write a Comment ## Comment box placeholder.
|
|
35
|
+
adminEmailMd5: ## The MD5 of Admin Email to show Admin Flag.
|
|
36
|
+
math: true ## Support MathJax.
|
|
37
|
+
md: true ## Support Markdown.
|
|
38
|
+
# MiniValine's display language depends on user's browser or system environment
|
|
39
|
+
# If you want everyone visiting your site to see a uniform language, you can set a force language value
|
|
40
|
+
# Available values: en | zh-CN | (and many more)
|
|
41
|
+
# More i18n info: https://github.com/MiniValine/minivaline-i18n
|
|
42
|
+
lang:
|
|
43
|
+
waline: ## See: https://waline.js.org/
|
|
44
|
+
enable: false ## If you want to use Waline comment system, please set the value to true.
|
|
45
|
+
serverURL: ## Your server url, e.g. https://your-domain.vercel.app
|
|
46
|
+
pageSize: 30 ## The desired number of comments shown in each page.
|
|
47
|
+
wordLimit: 500 ## Limit the number of words in comments, 0 means no limit.
|
|
48
|
+
requiredMeta: ['nick','mail'] ## Required user information, e.g. ['nick','mail','link']
|
|
49
|
+
count: 5 ## The number comments displayed in the recent_comments widget, default is 10.
|
|
50
|
+
locale: {
|
|
51
|
+
placeholder: '欢迎评论',
|
|
52
|
+
sofa: '来发评论吧~'
|
|
53
|
+
}
|
|
54
|
+
utterances: ## See: https://utteranc.es
|
|
55
|
+
enable: false ## If you want to use Utterances comment system, please set the value to true.
|
|
56
|
+
repo: ## The repository utterances will connect to, e.g. tufu9441/comments
|
|
57
|
+
identifier: title ## The mapping between blog posts and GitHub issues.
|
|
58
|
+
theme: github-light ## Choose an Utterances theme which matches your blog.
|
|
59
|
+
twikoo: ## See: https://twikoo.js.org
|
|
60
|
+
enable: false ## If you want to use twikoo comment system, please set the value to true.
|
|
61
|
+
envId: ## Tencent CloudBase envId
|
|
62
|
+
region: ## Tencent CloudBase region, e.g. ap-shanghai
|
|
63
|
+
path: ## Article path, e.g. window.location.pathname
|
|
64
|
+
|
|
65
|
+
google_search: true ## Use Google search, true/false.
|
|
66
|
+
baidu_search: false ## Use Baidu search, true/false.
|
|
67
|
+
swiftype: ## Your swiftype_key, e.g. m7b11ZrsT8Me7gzApciT
|
|
68
|
+
self_search: false ## Use a jQuery-based local search engine, true/false.
|
|
69
|
+
google_analytics: ## Your Google Analytics tracking id, e.g. UA-42425684-2
|
|
70
|
+
baidu_analytics: ## Your Baidu Analytics tracking id, e.g. 8006843039519956000
|
|
71
|
+
microsoft_clarity: ## Your Microsoft Clarity tracking id, e.g. zg2ctuea9j
|
|
72
|
+
fancybox: true ## If you want to use fancybox please set the value to true.
|
|
73
|
+
show_category_count: false ## If you want to show the count of categories in the sidebar widget please set the value to true.
|
|
74
|
+
toc_number: true ## If you want to add list number to toc please set the value to true.
|
|
75
|
+
shareto: false ## If you want to use the share button please set the value to true, and you must have hexo-helper-qrcode installed.
|
|
76
|
+
busuanzi: false ## If you want to use Busuanzi page views please set the value to true.
|
|
77
|
+
wordcount: false ## If you want to display the word counter and the reading time expected to spend of each post please set the value to true, and you must have hexo-wordcount installed.
|
|
78
|
+
widgets_on_small_screens: false ## Set to true to enable widgets on small screens.
|
|
79
|
+
canvas_nest:
|
|
80
|
+
enable: false ## If you want to use dynamic background please set the value to true, you can also fill the following parameters to customize the dynamic effect, or just leave them blank to keep the default effect.
|
|
81
|
+
color: ## RGB value of the color, e.g. "100,99,98"
|
|
82
|
+
opacity: ## Transparency of lines, e.g. "0.7"
|
|
83
|
+
zIndex: ## The z-index property of the background, e.g. "-1"
|
|
84
|
+
count: ## Quantity of lines, e.g. "150"
|
|
85
|
+
donate:
|
|
86
|
+
enable: false ## If you want to display the donate button after each post, please set the value to true and fill the following items on your need. You can also enable donate button in a page by adding a "donate: true" item to the front-matter.
|
|
87
|
+
github: ## GitHub URL, e.g. https://github.com/Kaiyuan/donate-page
|
|
88
|
+
alipay_qr: ## Path of Alipay QRcode image, e.g. /img/AliPayQR.png
|
|
89
|
+
wechat_qr: ## Path of Wechat QRcode image, e.g. /img/WeChatQR.png
|
|
90
|
+
btc_qr: ## Path of Bitcoin QRcode image, e.g. /img/BTCQR.png
|
|
91
|
+
btc_key: ## Bitcoin key, e.g. 1KuK5eK2BLsqpsFVXXSBG5wbSAwZVadt6L
|
|
92
|
+
paypal_url: ## Paypal URL, e.g. https://www.paypal.me/tufu9441
|
|
93
|
+
post_copyright:
|
|
94
|
+
enable: false ## If you want to display the copyright info after each post, please set the value to true and fill the following items on your need.
|
|
95
|
+
author: ## Your author name, e.g. tufu9441
|
|
96
|
+
copyright_text: ## Your copyright text, e.g. The author owns the copyright, please indicate the source reproduced.
|
|
97
|
+
love: false ## If you want the love to appear when you click anywhere, set the value to true.
|
|
98
|
+
plantuml: ## Using PlantUML to generate UML diagram, must install hexo-filter-plantuml (https://github.com/miao1007/hexo-filter-plantuml).
|
|
99
|
+
render: "PlantUMLServer" ## Local or PlantUMLServer.
|
|
100
|
+
outputFormat: "svg" ## Common options: svg/png
|
|
101
|
+
copycode: true ## If you want to enable one-click copy of the code blocks, set the value to true.
|
|
102
|
+
dark: false ## If you want to toggle between light/dark themes, set the value to true.
|
|
103
|
+
totop: true ## If you want to use the rocketship button to return to the top, set the value to true.
|
|
104
|
+
external_css: false ## If you want to load an external CSS file, set the value to true and create a file named "external.css" in the source/css folder.
|
|
105
|
+
post_content_length: 180 ## Set the length of the post summary displayed on home page when no description written.
|
|
106
|
+
icp: ## China mainland only, show icp info on the bottom.
|
|
107
|
+
bei: ## China mainland only, show bei info on the bottom.
|
|
108
|
+
|
|
109
|
+
menu:
|
|
110
|
+
- page: home
|
|
111
|
+
directory: .
|
|
112
|
+
icon: fa-home
|
|
113
|
+
- page: archive
|
|
114
|
+
directory: archives/
|
|
115
|
+
icon: fa-archive
|
|
116
|
+
- page: about
|
|
117
|
+
directory: about/
|
|
118
|
+
icon: fa-user
|
|
119
|
+
- page: rss
|
|
120
|
+
directory: atom.xml
|
|
121
|
+
icon: fa-rss
|
|
122
|
+
|
|
123
|
+
widgets: ## Seven widgets in sidebar provided: search, info, category, tag, recent_posts, recent_comments and links.
|
|
124
|
+
- search
|
|
125
|
+
- info
|
|
126
|
+
- category
|
|
127
|
+
- tag
|
|
128
|
+
- recent_posts
|
|
129
|
+
- recent_comments
|
|
130
|
+
- links
|
|
131
|
+
|
|
132
|
+
info:
|
|
133
|
+
avatar: /img/avatar.png
|
|
134
|
+
discription: To be a better man.
|
|
135
|
+
outlinkitem:
|
|
136
|
+
- name: twitter
|
|
137
|
+
outlink: https://twitter.com/username
|
|
138
|
+
message: Twitter
|
|
139
|
+
- name: github
|
|
140
|
+
outlink: https://github.com/username
|
|
141
|
+
message: Github
|
|
142
|
+
- name: envelope
|
|
143
|
+
outlink: mailto:admin@domain.com
|
|
144
|
+
message: Email
|
|
145
|
+
color: '#007bff'
|
|
146
|
+
- name: rss
|
|
147
|
+
outlink: /atom.xml
|
|
148
|
+
message: RSS
|
|
149
|
+
color: '#ff5722'
|
|
150
|
+
|
|
151
|
+
links:
|
|
152
|
+
- title: site-name1
|
|
153
|
+
url: http://www.example1.com/
|
|
154
|
+
src: https://www.example1.com/favicon.ico
|
|
155
|
+
desc: XXX's Blog
|
|
156
|
+
- title: site-name2
|
|
157
|
+
url: http://www.example2.com/
|
|
158
|
+
src: https://www.example1.com/favicon.ico
|
|
159
|
+
desc: YYY's Blog
|
|
160
|
+
- title: site-name3
|
|
161
|
+
url: http://www.example3.com/
|
|
162
|
+
src: https://www.example3.com/favicon.ico
|
|
163
|
+
desc: ZZZ's Blog
|
|
164
|
+
|
|
165
|
+
timeline:
|
|
166
|
+
- num: 1
|
|
167
|
+
word: 2014/06/12-Start
|
|
168
|
+
- num: 2
|
|
169
|
+
word: 2014/11/29-XXX
|
|
170
|
+
- num: 3
|
|
171
|
+
word: 2015/02/18-DDD
|
|
172
|
+
- num: 4
|
|
173
|
+
word: More
|
|
174
|
+
|
|
175
|
+
# Static files
|
|
176
|
+
js: js
|
|
177
|
+
css: css
|
|
178
|
+
|
|
179
|
+
# Theme version
|
|
180
|
+
version: 1.0.0
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
reading_label: Beiträge in %s
|
|
2
|
+
blog: Blog
|
|
3
|
+
albums: Alben
|
|
4
|
+
categories: Kategorien
|
|
5
|
+
tags: Tags
|
|
6
|
+
archive: Archiv
|
|
7
|
+
links: Links
|
|
8
|
+
about: Über
|
|
9
|
+
recent: Letzte
|
|
10
|
+
next: Nächster
|
|
11
|
+
previous: Vorheriger
|
|
12
|
+
notitle: Kein Titel
|
|
13
|
+
blogroll: Blogroll
|
|
14
|
+
history: Chronik
|
|
15
|
+
rss: RSS
|
|
16
|
+
guestbook: Gästebuch
|
|
17
|
+
home: Start
|
|
18
|
+
recent_comments: Letzte Kommentare
|
|
19
|
+
Readmore: Mehr lesen
|
|
20
|
+
belongsto: kategorisiert in
|
|
21
|
+
contents: Inhalte
|
|
22
|
+
shareto: Aktie
|
package/languages/en.yml
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
reading_label: Reading articles in %s
|
|
2
|
+
blog: Blog
|
|
3
|
+
albums: Albums
|
|
4
|
+
categories: Categories
|
|
5
|
+
tags: Tags
|
|
6
|
+
archive: Archive
|
|
7
|
+
links: Links
|
|
8
|
+
about: About
|
|
9
|
+
recent: Recent
|
|
10
|
+
next: Next
|
|
11
|
+
previous: Previous
|
|
12
|
+
notitle: No Title
|
|
13
|
+
blogroll: Links
|
|
14
|
+
history: History
|
|
15
|
+
rss: RSS
|
|
16
|
+
guestbook: Guestbook
|
|
17
|
+
home: Home
|
|
18
|
+
recent_comments: Recent Comments
|
|
19
|
+
Readmore: Read More
|
|
20
|
+
belongsto: Categorized in
|
|
21
|
+
contents: Contents
|
|
22
|
+
shareto: Share
|
|
23
|
+
Discuss: Discuss
|
|
24
|
+
Comment: Comment
|
|
25
|
+
Hits: Hits
|
|
26
|
+
copyright_title_prefix: "Title: "
|
|
27
|
+
copyright_date_prefix: "Date: "
|
|
28
|
+
copyright_update_prefix: "Last Update: "
|
|
29
|
+
copyright_author_prefix: "Author: "
|
|
30
|
+
copyright_link_prefix: "Blog Link: "
|
|
31
|
+
copyright_declare_prefix: "Copyright Declaration: "
|
|
32
|
+
copyright_default_text: "The author owns the copyright. Please indicate the source reproduced!"
|
|
33
|
+
word_cnt: Words
|
|
34
|
+
read_time: Minutes
|
|
35
|
+
copy_success_text: "Copy Successed!"
|
|
36
|
+
Copy_address_and_show_QRCode: "Copy address and show QRCode"
|
|
37
|
+
Sticky: Top
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
reading_label: Leyendo artículos en %s
|
|
2
|
+
blog: Blog
|
|
3
|
+
albums: Álbums
|
|
4
|
+
categories: Categorías
|
|
5
|
+
tags: Etiquetas
|
|
6
|
+
archive: Archivo
|
|
7
|
+
links: Enlaces
|
|
8
|
+
about: Acerca de
|
|
9
|
+
recent: Recientes
|
|
10
|
+
next: Siguiente
|
|
11
|
+
previous: Anterior
|
|
12
|
+
notitle: Sin título
|
|
13
|
+
blogroll: Blogroll
|
|
14
|
+
history: Historial
|
|
15
|
+
rss: RSS
|
|
16
|
+
guestbook: Libro de visitas
|
|
17
|
+
home: Inicio
|
|
18
|
+
recent_comments: Comentarios recientes
|
|
19
|
+
Readmore: Leer más
|
|
20
|
+
belongsto: Guardado en
|
|
21
|
+
contents: Contenidos
|
|
22
|
+
shareto: Cuota
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
reading_label: Reading articles in %s
|
|
2
|
+
blog: Blog
|
|
3
|
+
albums: Albums
|
|
4
|
+
categories: Catégories
|
|
5
|
+
tags: Tags
|
|
6
|
+
archive: Archive
|
|
7
|
+
links: Liens
|
|
8
|
+
about: À propos
|
|
9
|
+
recent: Récent
|
|
10
|
+
next: Suivant
|
|
11
|
+
previous: Précdent
|
|
12
|
+
notitle: Sans titre
|
|
13
|
+
blogroll: À suivre
|
|
14
|
+
history: Historique
|
|
15
|
+
rss: RSS
|
|
16
|
+
guestbook: Livre d'or
|
|
17
|
+
home: Accueil
|
|
18
|
+
recent_comments: Commentaires récents
|
|
19
|
+
Readmore: Lire plus
|
|
20
|
+
belongsto: Catégorisé dans
|
|
21
|
+
contents: Contenus
|
|
22
|
+
shareto: Partager
|
package/languages/ko.yml
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
reading_label: '%s 의 게시물 모음'
|
|
2
|
+
blog: 블로그
|
|
3
|
+
albums: 앨범
|
|
4
|
+
categories: 카테고리
|
|
5
|
+
tags: 태그
|
|
6
|
+
archive: 아카이브
|
|
7
|
+
links: 링크
|
|
8
|
+
about: 소개
|
|
9
|
+
recent: 과거
|
|
10
|
+
next: 다음
|
|
11
|
+
previous: 이전
|
|
12
|
+
notitle: 제목없음
|
|
13
|
+
blogroll: 블로그롤
|
|
14
|
+
history: 히스토리
|
|
15
|
+
rss: RSS
|
|
16
|
+
guestbook: 방명록
|
|
17
|
+
home: 홈
|
|
18
|
+
recent_comments: 최근 댓글
|
|
19
|
+
Readmore: 더보기
|
|
20
|
+
belongsto: 분류됨
|
|
21
|
+
contents: 컨텐츠
|
|
22
|
+
shareto: 공유하기
|