Joe 主题 Halo 移植版 Joe2.0 是 Typecho Themes Joe 主题的 Halo 版，由于社区之前有兄弟移植过，这次就叫 Joe2.0 吧，此次在原版主题上做了不少修改和适配，由原版的 php 模板调整为 freemarker，移除了平台无关的特性，同时增加了一些平台特定的配置，保持灵活性的同时最大限度的移植了原版功能，希望大家喜欢 ❤️ 🌸 同时也要在此感谢原作者 Joe 。 👀 预览主题首页截图 👇 🌈 主题安装复制主题仓库地址 https://github.com/qinhua/halo-theme-joe2.0.git 进入博客后台管理外观-主题-安装-在线安装，贴入仓库地址进行安装（建议直接使用最新版本）。如果在线安装失败，可以选择本地安装，到主题 Release 页面下载指定版本主题包，并以附件形式传上去；等待提示安装完成即可。 ⚠️ 注意：安装主题后请务必到后台管理 - 博客设置 - 高级选项中开启 API服务并配置 Access key 为 joe2.0 （注意：这里没必要一定是 joe2.0，可以配置为任意值），不然部分用到 Content API 的页面会请求失败，导致报错。 Tip：如果你后台管理中之前已经配置了其它的 Access Key （内容不是 joe2.0 ），那么需要你到本主题设置中的基本设置配置一下 AccessKey<必填> ，和你后台中的一致即可（切记一致才行，且不要填写中文或特殊字符）。主题升级后配置项变化较大时可能报错，导致页面渲染不出来。只需要进入当前主题的设置界面执行一下保存操作来更新旧的配置，然后再访问页面即可有时主题已经更新成功了，但是页面还是加载的旧版本的文件，可能是由于主题激活状态不正常导致的。此时只需要先切换到其他主题再切回来即可。或者可以试着重启下后台试试。刷新时记得打开控制台进行强刷，避免潜在缓存的影响， CDN缓存也要及时清除。 🔧 主题配置此次修改对外暴露了大量的设置项，主要是为了最大程度方便用户对博客进行配置，详细设置项请参见主题根目录下的 settings.yaml 文件。 ⭐️ 主题功能此次在功能上做了大量移植，在尽量不破坏原主题风格的情况下，加入了 halo 主题常见的配置项，也融入了一些自己的改进 🤔。具体功能请在后台 -> 外观 -> 主题 -> 设置中进行配置，配置项已按不同场景分类，便于快速查找。浅色/暗黑模式三级导航轮播图自定义主题色自定义字体自定义背景图自定义社交渠道归档页定制(按年/月统计) 日志页面定制文章分享 Toc 目录<可通过文章设置单独控制> 代码高亮 + 行号 + 复制 + 折叠文章和日志页点赞 + 评论文章页 a 标签新页面打开文章页复制加版权文字留言页面网易歌单(api 好像不稳定) 博主可选头像框博主等级展示全局预载图自定义缺省图片配置每日一句百度收录查询 + 主动推送页面加载条离屏提醒网站公告二维码模块 3D 标签云看板娘图库页面定制自定义邮件模板社交账号配置二维码打赏广告配置（侧边栏 + 文章页）自定义 JS/CSS 自定义 favicon（支持视频、动图）站点运行时间绿色模式（备案模式）灰色模式（RIP 模式） ✨ 改进点 meta 标签优化 ftl 模板格式化导航栏优化页脚调整评论组件定制 SEO 优化样式优化使用 Less 根据主题模式调整了部分配色优化 z-index 属性滚动优化代码优化代码风格 Eslint + Stylelint JS 和 CSS 兼容性处理 JS 使用 Babel 转换 CSS 引入 autoprefixer 移除部分页面 Grid 布局页面性能优化按需引入图片懒加载 DNS 预解析 Gzip 加载状态优化加载条预载图错误图空白状态 404 页面去除无用配置项目目录调整简化目录部分缺陷修复解析主题配置项 📈 状态 📃 TODO 目前仍有部分功能不完善，暂时没时间做，后面继续迭代。博客总访问量归档页统计图标评论组件定制化（皮肤、参数简化、头像保存等）动态背景国际化全站 Pjax 欢迎页面视频播放插件相册页优化多种布局切换展示动画优化外链页面评论模块自定义模板引擎文章评论后可见博客自动备份 📚 开发指南 1、推荐使用 VSCode 开发，首先安装 EasyLess 插件来转换并压缩 less 文件，保存时会自动生成 *.min.css 文件，配置如下： "less.compile": { "out": "./min/", "outExt": ".min.css", "compress": true, "sourceMap": false, "autoprefixer": "> 2%, last 2 versions, not ie 6-9" } 2、安装 JS & CSS Minifier 插件来转换并压缩 js 文件，保存时会自动生成 *.min.js 文件，配置如下： "es6-css-minify.js": { "mangle": false, "compress": { "unused": true }, "output": { "quote_style": 0 }, "warnings": true }, // 保存时自动生成，no为手动，可点击编辑器底部 Minify 按钮生成 "es6-css-minify.minifyOnSave": "yes", "es6-css-minify.jsMinPath": "/source/js/min" 3、转换并压缩 ES6+ 代码（前 2 步里的 js 没有经过 babel 编译，只可用于开发环境）：安装 nodejs ; 主题目录下执行 npm i 安装依赖; 执行 npm run build 即可在相应目录生成可用于生产环境的 js 文件。 🔍 代码提交规范项目默认配置了 husky 和 lint-staged ，在 commit 阶段通过 eslint 和 stylelint 对代码进行自动格式化，然后打包，保证最终提交代码的规范性。 🤔 注意点主要是一些开发及使用过程中暴露出来的问题 1、如何在浏览器中获取当前主题的配置信息？可以通过 window.ThemeConfig 直接获取。 2、如何自定义导航条图标？主题自身已经引入了部分 iconfont 图标，你可以直接用（全在这里），如果想在这个基础上增加图标，可联系我加入该项目的图标组。 iconfont 使用方式如下： **如果你要用自己的图标，请往下看：** - 首先通过 [iconfont](https://www.iconfont.cn/) 获取自己的图标链接，也可以用 [fontawesome](http://www.fontawesome.com.cn/) 的字体，注意要使用 `font-class` 类型，最后这种地址：//at.alicdn.com/t/font_2788564_1f1rnuqwnzj.css - 通过 `管理后台-外观-主题-Joe2.0-设置-自定义`，将图标地址贴入 `字体图标链接` 中并保存； - 通过 `管理后台-外观-菜单`，为相关菜单添加图标，也就是字体图标的类名，类似如下这种（字体名称 + 图标名称），记得保存； ```text iconfont icon-home 最后，重新进入你的博客即可看到效果。 tips: 目前主题菜单只支持字体图标，若要用图片请自行修改代码。 3、如果一个菜单有子菜单，如何禁止父菜单跳转？通过管理后台-外观-菜单，设置相关菜单的地址为 # ，保存即可，子菜单同理；最后，重新进入你的博客即可看到效果。 tips: 为了适配和展示效果，不建议添加过多菜单。目前最多可展示 3 级。 4、子菜单如何设置新页面打开？通过管理后台-外观-菜单，设置菜单的打开方式为新页面，保存即可。 5、如何配置邮件服务？ Halo 已经提供好了邮件服务，我们只需要配置相关参数即可。请参见《Halo 博客配置邮件通知服务》 6、如何配置留言页？目前主题中的留言页面是自定义页面，所以需要你进入后台管理-页面，点击新建页面添加留言页，然后把下面的模板复制进去并保存，最后进入外观-菜单添加刚才自定义的留言页，保存后刷新前台页面即可，其他自定义页面同理。 <div class="joe_detail__leaving-none">暂无留言，期待第一个脚印。</div> 7、自己修改了主题中的 CSS 或 JS 后为什么还是用的以前的？目前主题默认使用 CDN 加载静态资源，要使用自己修改后的版本，需要到后台管理-外观-主题设置-其它中关闭使用CDN加载静态资源即可生效。但关闭后同时也失去了 CDN 加载的优势，如果你不想关闭，就需要自己单独修改文件引入处的链接。比如我修改了 joe.index.min.css 这个文件，那么就需要到 template/module/link.ftl 中找到引入它的地方： <link rel="preload stylesheet" as="style" href="${BASE_RES_URL}/source/css/min/joe.index.min.css?v=${theme.version!}" /> 把其中的 ${BASE_RES_URL} 修改为主题自身路径 ${theme_base!} 即可。 8、如何通过元数据为文章详情页进行单独的功能配置？很多时候，我们希望能够单独控制文章详情页的功能，如分享、打赏、复制、点赞、评论、目录等。主题目前已经为文章详情页暴露了常用的元数据配置，具体大家可以查看 theme.yaml 文件中的 postMetaField 字段。如果我们想通过这些元数据来单独控制页面功能，可以到后台管理-文章-所有文章中找到要修改的文章，然后点击设置，再点击底部保存按钮旁的高级，即可在弹框中对元数据进行配置，字段格式和主题配置是一致的，布尔值填 true 或 false，都是字符串形式。 9、如何查看博客后台日志？有时博客访问不了，想查看后台日志，可以进入后台管理-系统-小工具-实时日志查看，生成环境可能需要先开启彩蛋（连续点击 Halo Dashboard 10 次触发），更多请参见 Halo 隐藏功能。 10、Freemarker 相关小技巧主要是本人在开发主题过程中积累的一些 Freemarker 技能，希望能帮到需要的人。请参见 FreeMarker 常用技巧 😈 小建议 1、大家可以为站点资源开启防盗链很简单，直接在 nginx 里配一下就可以，不过记得添加白名单（如 logo 和 avatar ），配置如下： # 资源防盗链（指定目录or指定文件类型） # location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ { location /upload/ { access_log off; # 域名白名单，去掉则阻止所有非本站请求 valid_referers none blocked server_names *.bbchin.com 127.0.0.1 localhost ~\.google\. ~\.baidu\. ~\.qq\.; if ($invalid_referer) { rewrite ^/ https://cdn.jsdelivr.net/gh/qinhua/cdn_assets/img/robber.jpg; } proxy_pass http://127.0.0.1:8090; } 2、可以使用 webp_server_go 这个工具对全站图片进行 webp 化，提高加载速度，具体使用请参考如何无痛切换网站图片格式到 webp 。  🏭 贡献如果你想帮助完善 Joe2.0 主题，请：点 star 提 issue 修 bugs 推 pr 🙆♂️ 感谢在此感谢以下项目提供的支持： Halo Typecho Themes Joe halo-live2d halo-comment-sakura halo-theme-sagari

DrLiu123 主题安装后，可能会遇到一些问题，请务必先查看主题文档，减少沟通成本，或者加入 Joe2.0 交流群。

提了个关于 Access key 的 issue ，希望大佬考虑一下🤣

上架到官网了 https://halo.run/archives/joe20.html

我复制了我的歌单ID，歌单部分显示空白，轮播图部分我想修改高度，修改了index.less文件后覆盖更新没生效，又修改min.css后也没生效，该怎么修改

太好看啦！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！

LDWBFS 1、歌单出不来应该是 Metingjs 的 api 不稳定导致的，这个我后面单独搭个服务就可以了； 2、目前主题默认使用 CDN 加载静态资源，要使用自己修改后的版本，需要在后台管理-外观-主题设置-其它中关闭使用CDN加载静态资源即可生效。但关闭后同时也失去了 CDN 加载的优势，如果你不想关闭，就需要自己单独修改文件引入处的链接。比如我修改了 joe.index.min.css 这个文件，那么就需要到 template/module/link.ftl 中找到引入它的地方： <link rel="preload stylesheet" as="style" href="${RES_BASE_URL}/source/css/min/joe.index.min.css?v=${theme.version!}">` 把其中的 ${RES_BASE_URL} 修改为主题自身路径 ${theme_base!} 即可。 BTW，目前大部分配置都是约定好的

【Joe2.0】Halo-theme-joe2.0 主题发布 🚀🚀🚀

qinhua

Brian 什么浏览器，我这边测试你这个时间是可以的

Brian

qinhua edge 95.0.1020.53

qinhua

Brian 我昨晚试了一下，Edge 没这个问题，看是不是主题有缓存，你下个其他主题，然后先切到那个主题，再切回来看看。

xJavae

qinhua 您好，请问git仓库主题更新的话，我们博客这边需要怎么保持同步更新呢？

qinhua

xJavae 关注 git 仓库即可，目前主题更新只能手动实现，直接下载主题安装包，从主题包更新即可。
有时候更新后，前台还是旧的代码，是缓存的原因，需要先切换到其他主题，再切回来就可以了。
后台管理也在不断迭代，后面应该可以在后台管理看到主题版本及更新提示，一切都会变得越来越好的。

xJavae

qinhua 好的，谢谢！

Brian

qinhua 切过主题😅，算了先这样用着。

Ryan Wang

@qinhua 是否需要我把这个帖子的内容更新为 GitHub 最新的 readme？

qinhua

Ryan Wang 🤝 那就麻烦大哥了，一直以为这个编辑不了了。

RalstonLiu

支持！我typecho用的就是joe主题，这下不用搞俩个博客啦，太赞了

RalstonLiu

请教一下，【建议复制主题的页脚 html 结构进行修改，然后粘贴到后台的页脚配置内（主题无法保证自定义页脚的样式及适配，请视具体情况设置）】这边页脚的html在哪个文件夹下呀，我在“外观“——”主题编辑“下面没找着😑

RalstonLiu

RalstonLiu 找到了，在“template”里头

Ryan Wang

qinhua 嗯，只有管理员可以编辑帖子内容

bingo084

我的推荐文章显示不出来，导航栏子菜单也显示不了，浏览器控制台报错：Uncaught ReferenceError: ThemeConfig is not defined，请问是哪里的问题？

qinhua

bingo084 不太清楚你的具体情况和场景，可以先看主题文档说明，有问题直接提 issue，附上完整的问题描述。

bingo084

qinhua 推荐文章需要单独设置吗？是来自于哪里的？置顶文章吗？

bingo084

首页上，我的控制台报错：ThemeConfig is not defined，同时我通过window.ThemeConfig在浏览器（edge、chrome）中获取不到这个变量，请问可能是什么问题？我试过文档说明里的方法重装过，也设置过accessKey，还是不行

qinhua

Tanstyle

请问轮播图是否可以设置轮播最新发布的文章或者其他指定栏目的文章封面图呢？

qinhua

Tanstyle 可以，但是目前不支持

qinhua

Tanstyle 有好的建议，都可以去 github 提出来，一起迭代完善

Tanstyle

qinhua
期待后续迭代成能够自动的，不用手动就好啦，谢谢大佬

Ryan Wang

qinhua 可以提供三种模式，1. 手动设置封面。2. 取置顶的文章。3. 置顶分类或者标签，取其下面的文章。

qinhua

Ryan Wang 可以，我也是这样想的，有时间我就加上去。