首次安装主题,首页可能空白,请先补充文章内容,按主题教程配置主题功能。
安装主题
目前 Halo 提供了两种主题安装方式:
- 通过控制台上传安装
- 将主题文件夹拷贝到服务器上的
{Halo 工作目录}/themes/
目录下等待 Halo 自动扫描
针对第一种安装方式,你可以点击主题管理对话框下方的 安装主题
按钮,在弹出的文件上传对话框中上传主题压缩包。

主题安装成功后,便会出现在已安装主题列表中。
针对第二种方式,你需要手动将解压后的主题文件夹拷贝到服务器上的指定目录下,如果主题校验通过,你便可以在主题列表的 未安装
标签页中看到该主题。
之后点击主题所在行后方的 安装
按钮,即可完成该主题的安装。
切换主题
同样点击主题页面右上方的 主题管理
按钮弹出主题管理对话框。
在弹框中点击选中要切换的目标主题,此时页面返回到主题详情页,点击右上角的 启用
按钮即可将当前主题切换为实际使用的主题。
修改主题设置
主题页面默认显示出了当前主题的详细信息,在详细信息标签页后方的标签页,即为主题提供的相关设置。
Alright 主题提供了全局、样式、首页、文章、侧边栏、社交媒体及备案设置共7组配置项。

全局设置:是网站的基础设置,请务必设置好。
1、菜单栏Logo类型,如果选择了图片,⚠️请在「设置」-「基础设置」中设置站点标题或者LOGO,LOGO尺寸推荐200x50。如果「样式」开启了深色模式或者跟随系统,请务必设置好深色模式的logo。
2、网站背景:可设置网站全局背景图,分默认和深色模式的背景图,请分开设置2张图片,一张浅色,一张深色。
3、延迟加载图:主题全局延迟加载所有图片,请设置好默认加载图。建议图片文件尽量的小。
4、分类封面图:显示在文章分类列表上方,这是一张默认图,当分类中没有设置封面图的时候,显示该图。
5、默认文章缩略图:功能如同4。
6、默认头像:功能如同4,当用户没有设置头像时,显示该图。
7、顶部菜单、移动端菜单,请先前往「菜单」中,设置对应的菜单后,再进行选择即可。
8、显示滚动到顶部按钮
9、显示网站加载动效:在网站加载的时候,会有加载动效,待网站加载完成后,加载动效将自动消失。
10、图库插件的相关设置,请先安装插件。
首页设置

1、首页轮播图,设置图片和链接即可,图片比例为3:1。
2、首页 Tab 栏:位于轮播图下方,推荐设置文章栏目菜单,然后选择对应的菜单即可。

侧边栏设置
1、小工具可自由排序,见下图。

2、站点资料小工具:请设置好下方的站点资料,见下图。

侧边栏下方的设置项目,即便你可能目前还用不到某些小工具,但建议先都设置好。

升级主题
点击主题详情页右上角的 ···
更多操作按钮,选择其中的 升级
选项即可上传新的主题包对当前主题进行升级更新。
重载主题配置
如果当前主题提供的设置项发生变化,可以通过 ···
更多操作中的 重载主题配置
选项对主题配置项进行更新。

文章相关说明
请查看官方详细的文章发布教程:https://docs.halo.run/user-guide/posts
相关元数据字段说明
我们分别为文章分类、链接分组、菜单项增加「图标」字段,比如可在分类名称前添加对应的图标

图标支持主题自带的iconfont图标,可把主题包下载到本地,解压在本地电脑中,根据路径:theme-alright/templates/assets/plugins/iconfont
,找到iconfont的文件夹,使用浏览器打开里面的demo_index.html
文件,即可看到图标列表以及对应图标的代码。

输入图标代码时,需要在按这个格式进行填写,请务必加上iconfont 加上图标代码(如icon-lightning_line
)
iconfont icon-lightning_line

如果你使用图库插件,我们增加了图库图片的元数据字段,可以让用户在点击图片的时候,跳转到指定的网址,扩展了图库的使用范围。

其他说明
1、如何插入百度站长数据统计代码?Halo 管理后台——设置——代码注入,选择其中一个插入,见下图。
2、欢迎主题用户加入用户微信群,和其他用户一同交流主题使用心得。在官网「我的订单」中,找到订单,点击「微信交流群」,扫码加入即可。微信群仅限主题订单购买者进群,请勿邀请其他人进群。

插件推荐
主题兼容的插件功能,需使用插件后才有对应的模块。
- 评论功能 plugin-comment-widget
- 搜索功能 plugin-search-widget
- 友链页面 plugin-links
- 瞬间页面 plugin-moments
- 图库插件 plugin-photos
- 图片点击放大功能:plugin-lightgallery
代码高亮插件,开启后,如下图填写即可实现

图片点击放大使用的插件,开启后,按下图填写「内容页面匹配」:.post-content

插件具体使用说明,请查看插件的说明文档。nicetheme 暂不提供操作文档。