昌江网站建设,三亚建设局网站,阿里云备案多个网站,郑州网站优化效果Dream 主题基于 Halo 博客系统开发#xff0c;本文将介绍本主题一些功能的使用#xff0c;文档将持续更新。
一、安装 更新
1.1 安装包安装 更新
进入主题 Release 界面#xff1a;https://github.com/nineya/halo-theme-dream/releases 下载主题压缩包 halo…Dream 主题基于 Halo 博客系统开发本文将介绍本主题一些功能的使用文档将持续更新。
一、安装 更新
1.1 安装包安装 更新
进入主题 Release 界面https://github.com/nineya/halo-theme-dream/releases 下载主题压缩包 halo-theme-dream.zip 压缩包文件进入博客后台管理 外观-主题-安装-本地上传选择下载的 halo-theme-dream.zip 安装包进行上传等待安装完成更新主题时同样前往主题 Release 界面下载主题安装包然后通过 外观-主题-Dream-更多-从主题包更新 方法上传安装包进行更新。
1.2 在线安装 更新
复制主题仓库地址 https://github.com/nineya/halo-theme-dream.git进入博客后台管理 外观-主题-安装-远程下载黏贴仓库地址进行安装等待安装完成在线更新主题时通过 外观-主题-Dream-更多-在线更新 方法进行更新。 在线安装 更新的方式不推荐 因为由于 GitHub 的网络问题很大几率会安装 更新失败主题是经过源码编译的直接从仓库下载包含了主题的源码以及开发所需的相关文件这些文件并不是安装主题所需要的。 二、导航栏 Dream 主题导航栏支持添加图标可在菜单项中填写 FontAwesome 的相关图标 class。 主题基于 FontAwesome 4.7.0 版本图标可参考网站http://www.fontawesome.com.cn/faicons/ 主题支持多级菜单但最多支持三级 有时候可能想临时关闭菜单项不想对菜单项进行重复的删除和添加主题支持通过在菜单栏名称前添加 #hide 临时隐藏菜单项。 [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-j5EXAyhg-1681178684990)(/upload/2022/05/image-20220501221505345-0ba8641ee686478f9c6f1e7ed8b955f3.png)]
三、侧边栏 主题默认采用经典的三列布局也支持在配置中隐藏左右其中一侧的侧边栏 侧边栏的 Widget 模块支持通过配置优先级的方式进行排序可填写一个数字值越大优先级越高 可能这是 FreeMarker 关于排序的 bug虽然指定的是一个数字但是底层应该是按字符串的方式来进行排序处理的且字符串的长度不做为排序的条件。 因此将出现这样的情况优先级为 9 的 Widget 优先级高于 80800甚至于 80000 所以配置优先级时切记数值要处于相同的分位简单说就是数值的字符串长度要相同避免引起歧义。
四、代码块
主题支持指定代码块的标题标题和代码块语言之间通过 | 或 号进行分隔。
“” 表示默认代码块为折叠“|” 表示默认代码块为展开。
示例
// 默认展开
{% codeblock lang|可选代码块标题 %}// 默认折叠
{% codeblock lang可选代码块标题 %}// 默认折叠且不指定代码块标题
{% codeblock lang %}// 默认折叠且不指定代码类型和代码块标题
{% codeblock %}需要注意halo 本身 markdown 具有一些限制如代码块名称不能包含空格。 五、元数据的使用
enable_copyright名称显示版权模块范围文章/自定义页面可选值true/false默认值无说明指定是否显示版权模块未指定该值时以主题配置界面中的配置为准。
thumbnail_mode名称缩略图显示模式范围文章可选值back/small/dafault默认值dafault说明指定文章列表中文章的缩略图显示方法。default 默认缩略图在标题的上方显示back 缩略图将以背景图的方式显示small 缩略图以小图的方式在文章摘要的左侧显示small-right 缩略图以小图的方式在文章摘要的右侧显示small-alter 缩略图以小图的方式在文章摘要的左右侧交替显示fold 置顶文章有效正文内容折叠。
tips名称文章提示信息内容范围文章/自定义页面可选值提示信息内容支持 html 标签默认值无说明文章正文顶部显示提示信息内容。
enable_katex名称启用数学公式支持范围文章/自定义页面可选值true/false默认值无说明指定是否启用数学公式支持未指定该值时以主题配置界面中的配置为准。
enable_share名称开启文章分享范围文章/自定义页面可选值true/false默认值无说明开启文章分享插件。
enable_bullet_screen名称开启评论弹幕范围文章/自定义页面可选值true/false默认值无说明开启评论弹幕。
index_carousel名称开启首页轮播范围置顶文章可选值true/false默认值无说明在首页时文章通过大图轮播方式展示仅对置顶文章有效。
六、启用Service Worker优化
Service Worker 支持自动切换异常的 CDN 站点对脚本等文件进行缓存提升网站的访问速度和稳定性。 有效解决该死的 jsdelivr 出现异常这种问题… Dream 主题支持使用 Service Worker 提升网站访问速度内部已经提供了 Service Worker 相关的实现但是由于 halo 博客系统的限制脚本文件不能放在网站的根目录导致 Service Worker 无法生效所以需要使用 Nginx 进行 url 重写将 sw.min.js 文件映射到网站根目录。 脚本必须与网站同域且在网站根目录且网站不能存在证书问题否则 Service Worker 将无法正常注册 打开 Nginx 的配置文件添加如下转发配置 location ~ ^/sw.min.js {rewrite ^/(.*) /themes/dream/source/js/$1 break;proxy_pass http://localhost:8090;proxy_set_header HOST $host;proxy_set_header X-Forwarded-Proto $scheme;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;}使配置生效
# 检查配置正确性
nginx -t# 重新加载配置
nginx -s reload通过 https://域名/sw.min.js 能够成功访问到文件即配置成功。 若你修改了主题的 css/js 文件需确保关闭 Service Worker 功能否则可能从远程 CDN 下载资源导致修改的内容不会生效。
