官方链接:Icarus用户指南-主题配置
安装
- 下载,在博客根目录下执行
git clone https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus --depth 1
- 修改博客根目录下的
_config.yml
文件,把主题设置为icarus
theme: icarus
或使用hexo命令修改主题为Icarus:
hexo config theme icarus
最后,使用如下命令来启动Hexo本地测试服务器并开始创作。
hexo s
注意:这个时候,可能会报如下错误
这个错误原因就是有一些依赖插件没有安装,如果出现这个错误把下面的提示命令复制执行即可!
第一次部署博客时可能会有创建配置文件(根目录下_config.icarus.yml
为Icarus主题的配置文件)提示,按照提示执行即可。
友情链接:Icarus快速上手
主题配置
皮肤&图标
配置文件_config.icarus.yml
# 主题皮肤
variant: default # default或cyberpunk
# Favicon
head:
favicon: /img/favicon.svg # 后面附图片转svg在线链接
代码高亮
如果你已在Hexo中启用了代码高亮功能,你可以通过article
中的highlight
设置来自定义代码块。 请从highlight.js/src/styles下列出的所有主题中 选择一个主题。 然后,复制文件名(不带.css
后缀)到theme
设置项中。
如要隐藏复制代码按钮,将clipboard
设置为false
。 如果你希望折叠或展开所有代码块,将fold
设置为"folded"
或"unfolded"
。 你也可以将fold
设置为空来禁止代码块折叠。
# 代码高亮
article:
highlight:
# 代码高亮主题
# https://github.com/highlightjs/highlight.js/tree/master/src/styles
theme: atom-one-light # atelier-lakeside-dark
# 显示复制代码按钮
clipboard: true
# 代码块的默认折叠状态。可以是"", "folded", "unfolded"
fold: unfolded
此外,你可以在Markdown文件中使用下面的语法来折叠单独的代码块:
{% codeblock "可选文件名" lang:代码语言 >folded %}
...代码块内容...
{% endcodeblock %}
封面&缩略图
若要为文章添加封面图,请在文章的front-matter中添加cover
选项:
post.md
title: Icarus快速上手
cover: /gallery/covers/cover.jpg
---
Post content...
类似地,你也可以在文章的front-matter中为文章设置缩略图:
post.md
title: Icarus快速上手
thumbnail: /gallery/thumbnails/thumbnail.jpg
---
Post content...
文章的缩略图会显示在归档页面和最新文章挂件中。
如果你在front-matter中使用的是图片的路径,你需要确保它是绝对或者相对于你的source目录的路径。 例如,为使用<your blog>/source/gallery/image.jpg
作为缩略图,你需要在front-matter中使用/gallery/image.jpg
作为图片路径。
挂件
官方链接:Icarus用户指南-挂件
<链接名称>:
icon: <FontAwesome5_图标的_HTML_class名称>
url: <链接的URL地址>
点击发送邮件:mailto:youname.xxx.com
文章目录
若要展示文章目录,请在主题配置中添加如下挂件配置:
_config.icarus.yml
widgets:
-
type: toc
position: left
# 是否显示目录项目的序号
index: true
然后,在需要开启目录的文章头部加入toc: true
:
Post.md
title: 一篇有目录的文章
toc: true
---
文章内容...
内容折叠&分页
内容折叠
使用more
语法可以使标记一下的内容进行折叠
<!-- more -->
分页
修改_config.yml
文件
# 主页每页显示文章数
index_generator:
path: ''
per_page: 10
order_by: -date
新建文章时创建年份月份文件夹
修改_config.yml
new_post_name: ':year/:month/:title.md'
评论区