Essence is a functional and darkmode featured theme for Hexo.
Visit Sshwy's Notes for preview.
[TOC]
You can simply install it:
npm install hexo-theme-essence --save
# or
yarn install hexo-theme-essence --save
On another hand, the traditional way is still working, which means you clone this repository under <YourBlog>/themes/essence/
.
Whatever way you choose, please install these peer dependencies as well:
npm install hexo-renderer-stylus hexo-renderer-ejs --save
# or
yarn install hexo-renderer-stylus hexo-renderer-ejs --save
It's worth reminding that hexo-renderer-stylus
and hexo-renderer-ejs
is hexo's default render engine.
First of all, create a copy of default configuration under <YourBlog>/
, renaming it to _config.essence.yml
.
Then you can follow the comments to modify it just as you want .
If you use traditional way to install, Modifying <YourBlog>/themes/essence/_config.yml
directly is also a way, but not recommended.
Essence prepared some useful hexo tag plugins for you.
Inserts a user handle with Codeforces-like color style.
{% codeforces rating_label @ username %}
{% cf rating_label @ username %}
rating_label
insensitively can be:
lgm
for legendary grand master
igm
for international grand master
gm
for grand master
im
for international master
m
for master
cm
for candidate master
e
for expert
s
for specialist
p
for pupil
unr
for unrated
Examples:
{% codeforces im @ sshwyR %}
{% cf im @ sshwyR %}
Produce a HTML details block:
{% details [open] [@ title] %}
[content]
{% enddetails %}
Examples:
{% details open @ Default set to open %}
Details **Content**
{% enddetails %}
{% details @ Default set to close %}
Details **Content**
{% enddetails %}
{% details %}
No title
{% enddetails %}
Encrypt part of your post with custom password.
{% enc password [hint] %}
[content]
{% endenc %}
Examples:
{% enc 123456 password: 123456 (space is not allowed in password but allowed in hint) %}
test
{% enc 123456 123456 %}
Hi, there!
{% endenc %}
{% endenc %}
known issue: Can't work with markdown code fence block inside. solution: hexo code block tag plugin
Pull requests are welcome. For major changes and feature requests, please open an issue first to discuss what you would like to change or request.
View LICENSE.md for detailed information.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。