主题说明
这是一款高自定义的博客园主题 Lite,快速预览 Himmelbleu 的 Lite 主题博客。
支持博主:GitHub 或 Gitee,点个 ⭐star 哟~。Lite 基于 Vue3 + Vite 建立在博客园之上的一款博客主题。
版本说明
目前已经更新到 v1.4.7
,本次版本主要完成了最大化配置主题:
- 主题几乎所有地方都可以配置:背景设置、卡片样式、盒子模型、字体相关等。右键随便任何一个区域都可以呼出设置面板,每个区域的设置面板都不一样,设置好了之后可以导出设置以作备份。
- 进入页面时做了一个淡入淡出以及顶部进度条的效果,比之前的版本体验更顺滑。
特别注意
有以下几个博客园的地方没有做:
- 日记页面;
- 文章页面;
- 公告栏:评论排行榜、文章档案等
部署说明
首页 HTML 代码
<!-- clear unused elems --> <script> $("head > link").remove(); $("#top_nav").remove(); $("#footer").remove(); $(".clear").remove(); </script> <!-- lite style --> <link rel="stylesheet" href="https://blog-static.cnblogs.com/files/blogs/666252/index.css" /> <!-- lite loading style --> <style> #home { display: none !important; } @-webkit-keyframes loading { 0% { opacity: 0; } to { opacity: 1; } } @keyframes loading { 0% { opacity: 0; } to { opacity: 1; } } .dark-loading { background: #222; } .light-loading { background: #fff; } .dark-loading, .light-loading { font-size: 1rem !important; font-family: "Helvetica Neue", Helvetica, "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "微软雅黑", Arial, sans-serif !important; font-weight: 400; position: fixed; top: 0; left: 0; bottom: 0; right: 0; display: -webkit-box; display: -ms-flexbox; display: flex; justify-content: center; align-items: center; -webkit-box-pack: center; -ms-flex-pack: center; -webkit-box-align: center; -ms-flex-align: center; z-index: 999999; } .box h2 { font-size: 1rem !important; font-family: "Helvetica Neue", Helvetica, "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "微软雅黑", Arial, sans-serif !important; font-weight: 400; color: #777; margin: 0; text-transform: uppercase; letter-spacing: 0.1em; text-align: center; } .box span { font-size: 1rem !important; font-family: "Helvetica Neue", Helvetica, "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "微软雅黑", Arial, sans-serif !important; font-weight: 400; display: inline-block; vertical-align: middle; width: 0.6em; height: 0.6em; margin: 0.19em; background: #007db6; border-radius: 0.6em; -webkit-animation: loading 1s infinite alternate; animation: loading 1s infinite alternate; } .box span:nth-of-type(2) { background: #008fb2; -webkit-animation-delay: 0.2s; animation-delay: 0.2s; } .box span:nth-of-type(3) { background: #009b9e; -webkit-animation-delay: 0.4s; animation-delay: 0.4s; } .box span:nth-of-type(4) { background: #00a77d; -webkit-animation-delay: 0.6s; animation-delay: 0.6s; } .box span:nth-of-type(5) { background: #00b247; -webkit-animation-delay: 0.8s; animation-delay: 0.8s; } .box span:nth-of-type(6) { background: #5ab027; -webkit-animation-delay: 1s; animation-delay: 1s; } .box span:nth-of-type(7) { background: #a0b61e; -webkit-animation-delay: 1.2s; animation-delay: 1.2s; } </style> <!-- lite loading --> <div class="dark-loading"> <div class="box"> <h2>Loading</h2> <span></span><span></span><span></span><span></span><span></span><span></span><span></span> </div> </div>
loading 借用了SILENCE 主题的 loading,你也可以自定义,但注意最外层盒子要保留一个 class 名:dark-loading
或light-loading
,这样 Lite 才可以关闭。
页脚 HTML 代码
<!-- lite config --> <script> window.__LITE_CONFIG__ = {}; </script> <script type="module" src="https://blog-static.cnblogs.com/files/blogs/666252/index.js"></script>
在你的博客园后台“选项”中,勾选“启用数学公式支持”和“数学公式渲染引擎”(选择 MathJax3),否则数学公式不生效。
部署问题
速度很慢
博客园会带有一个国外的请求,所以会比较慢,这不是主题的问题。如果遇到长时间停止在 loading 屏幕请清除缓存,多刷新几次。
控制台报错
如果遇到控制台报错,因为一些配置存储在 localStorage 中,可能是因为博主更新了,需要你手动清除 localStorage。
loading 不关闭
有可能是你不小心关闭了“博客数据从远程加载”,在页脚 HTML 代码最底部加一个 script 标签。也可以清除 localStorage,多刷新几次。
<!-- run lite --> <script> // 如果访问外网速度本身就很快,建议使用下面的代码。访问速度慢建议删除该 script 标签。 window.onload = () => { window.__LITE_CONFIG__.onLoaded(); }; </script>
配置说明
GitHub
window.__LITE_CONFIG__ = { github: "your github address" };
字段 | 描述 | 可选值 |
---|---|---|
github | github 角标,在浏览器左上角,PC 端可见 |
陈列柜
window.__LITE_CONFIG__ = { cabinet: { avatar: "url", signature: "your text", navs: [ // 可以插入图片、文本、svg { href: "https://i.cnblogs.com/posts/edit", text: "新随笔" }, { href: "https://gitee.com/Enziandom", svg: `<path d="M512 1024C230.4 1024 0 793.6 0 512S230.4 0 512 0s512 230.4 512 512-230.4 512-512 512z m259.2-569.6H480c-12.8 0-25.6 12.8-25.6 25.6v64c0 12.8 12.8 25.6 25.6 25.6h176c12.8 0 25.6 12.8 25.6 25.6v12.8c0 41.6-35.2 76.8-76.8 76.8h-240c-12.8 0-25.6-12.8-25.6-25.6V416c0-41.6 35.2-76.8 76.8-76.8h355.2c12.8 0 25.6-12.8 25.6-25.6v-64c0-12.8-12.8-25.6-25.6-25.6H416c-105.6 0-188.8 86.4-188.8 188.8V768c0 12.8 12.8 25.6 25.6 25.6h374.4c92.8 0 169.6-76.8 169.6-169.6v-144c0-12.8-12.8-25.6-25.6-25.6z""></path>` } ] } };
cabinet 是陈列柜,点击浏览器左右中间的透明条可以呼出。
字段 | 描述 |
---|---|
avatar | 头像 |
signature | 个性签名 |
navs | 左陈列柜导航项 |
鼠标悬浮在陈列柜项上时,比如“博客信息”,右边会有一个小的箭头出现,点击之后可以对该项内容进行收起或展开。
技能栈
window.__LITE_CONFIG__ = { graph: { alpha: 0.85, sides: 5, // 多少个边 layer: 5, // 多少层 lineWidth: 1, textSize: 12, // 以下四个字段可以不填 fillColor: "#409eff", strokeColor: "#A7A7A7", lineColor: "#A7A7A7", textColor: "#A7A7A7", comment: [ // 数据,长度必须和 sides 保持一致 { title: "CSS", star: 4 }, { title: "Vue", star: 4 }, { title: "Java", star: 3 }, { title: "JS/TS", star: 4 }, { title: "Android", star: 3 } ] } };
推荐链接
window.__LITE_CONFIG__ = { links: [ { href: "http://ts.xcatliu.com/index.html", text: "TypeScript 入门教程" } ] };
推荐书籍
window.__LITE_CONFIG__ = { books: [ { href: "https://baike.baidu.com/item/%E6%B7%B1%E5%85%A5%E7%90%86%E8%A7%A3JavaScript/19848692", text: "深入理解 JavaScript", img: "http://img3m1.ddimg.cn/85/1/11120396251-1_w_1.jpg", author: "[美]罗彻麦尔", rate: 4.5 } ] };
二次开发
npm install npm run dev npm build
二次开发需要把 build 之后的 index.css、index.js 上传到博客园后台“文件”。并获取这两个文件的链接,以替换部署说明中标签的引入链接。
建议多使用 UnoCSS,开发时请把 .env.development
中两个字段修改成你自己的,否则获取的数据是我本人博客上的,博客 ID 和博客 App 都可以 F12 查看你博客找到,搜索currentBlogId
和currentBlogApp
。
目录说明
components 下面的是组件,目前数量很少,组件在本项目的定义是:通用、可配置。重新思考 Vue 组件的定义:
- adapters:views 下渲染列表,其内容在其他视图中也重复使用。adapters 与 components 的区别是 adapters 不需要考虑“通用、可配置”。
- fragments:views 下有许多业务要处理,但业务与业务之间并不是相关的,所以需要把 views 中一块业务拆分成一个组件,fragments 有自己的逻辑(请求、函数等)和视图。fragments 与该 views 有很大关系。
- modules:路由组件,即注册到 vue-router 项里面的组件。
其他问题
如果有 Issues 请在仓库中提出,或者博客园私信本人。