From 55bd4da9803f15bb9794e2922fc6bffed7e4a1f9 Mon Sep 17 00:00:00 2001 From: Erzbir Date: Tue, 5 Aug 2025 20:49:53 +0800 Subject: [PATCH] docs: update --- README.md | 146 ++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 114 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 54c6dff..3ab44ef 100644 --- a/README.md +++ b/README.md @@ -9,43 +9,49 @@ ## 对原主题的修改 ### 新增功能 -1. 支持 PJAX -2. 支持亮暗模式 -3. 支持指定亮暗模式配色 -4. 支持子菜单 -5. 支持像素化开关 -6. 支持文章目录开关 + +1. PJAX +2. 自定义 CSS +3. 自定义主题配色 +4. 指定深色/浅色模式配色 +5. 子菜单 +6. 像素化开关 +7. 文章目录开关 ### 样式 -1. 去除 a 标签的下划线 -2. 修改分页与评论的排列顺序 -3. 修改默认字体为 JetBrains Mono -4. 修改一些固定文字 -5. 修改 footer 样式并且兼容小屏 -6. 修改文章之间的间隔 -7. 修改滑轨颜色为透明 -8. 修改滑块颜色 -9. 修改文章目录样式, 去除选中时的背景色 -10. 修改分页的样式, 只有一个时居中, 适配小屏端 -11. 修改一些标签的大小以及间距 -12. 修改标题与文章的分割线 -13. 让代码块背景色适配主题 -14. 让搜索组件颜色适配主题 -15. 让评论颜色适配主题 -16. 修改友链的样式 -17. 修改标签页以及归档页及分类页的列表显示 -18. 修改按扭边框样式 -19. 修改代码块背景 -20. 禁用字体连字 -21. 在移动端菜单纵向排列 -22. 调整各个元素的间距等 -23. 文章目录响应式显示 + +1. 更响应式的布局 +2. 去除 a 标签的下划线 +3. 修改分页与评论的排列顺序 +4. 修改默认字体为 JetBrains Mono +5. 修改一些固定文字 +6. 修改 footer 样式并且兼容小屏 +7. 修改文章之间的间隔 +8. 修改滑轨颜色为透明 +9. 修改滑块颜色 +10. 修改文章目录样式, 去除选中时的背景色 +11. 修改分页的样式, 只有一个时居中, 适配小屏端 +12. 修改一些标签的大小以及间距 +13. 修改标题与文章的分割线 +14. 让代码块背景色适配主题 +15. 让搜索组件颜色适配主题 +16. 让评论颜色适配主题 +17. 修改友链的样式 +18. 修改标签页以及归档页及分类页的列表显示 +19. 修改按扭边框样式 +20. 修改代码块背景 +21. 禁用字体连字 +22. 在移动端菜单纵向排列 +23. 调整各个元素的间距等 +24. 文章目录响应式显示 ### 优化 + 1. 防止由于滑块引起的页面抖动 ### 开发相关 -1. 项目迁移至 ES modules 使用原生 JS 开发 + +1. 项目迁移至 ES modules 使用原生 JS 开发 2. 删除所有工具依赖, 引入 esbuild ## 关于 PJAX @@ -72,6 +78,84 @@ - highlightjs 插件的 _复制按扭_ 数量会随页面切换增加 +## 关于自定义 CSS + +目前只有原始 CSS 输入, 在样式设置中可以填入原始 CSS, 主题会直接将这段 CSS 插入到 head + +### 新增自定义主题配色 + +比如这里增加一个名字叫 `default` 的配色: + +```css +html[theme-color-scheme='default'] { + --color-theme-background: #000000; + --color-theme-foreground: #4eee85; + --color-theme-accent: #4eee85; + --color-theme-tag: #4eee85; + --color-theme-title: #4eee85; + --color-theme-meta: #4eee85; + --color-theme-framed: #4eee85; + --color-theme-menu: #4eee85; + --color-theme-header: #4eee85; +} +``` + +将这段 CSS 代码填入 `自定义样式` 后, 在 `深色/浅色配色方案` 的下拉框中选择自定义, 并填入配色名: `default` 即可 + +也可以通过直接覆盖的方式来修改主题颜色, 比如 `深色配色方案` 是 `day`, 在代码框中填入: + +```css +html[theme-color-scheme='day'] { + --color-theme-background: #000000; + --color-theme-foreground: #4eee85; + --color-theme-accent: #4eee85; + --color-theme-tag: #4eee85; + --color-theme-title: #4eee85; + --color-theme-meta: #4eee85; + --color-theme-framed: #4eee85; + --color-theme-menu: #4eee85; + --color-theme-header: #4eee85; +} +``` + +### 覆盖其他变量 + +如果要覆盖其他变量, 需要查看主题定义的 `css` 并根据需要来覆盖, 一些全局变量在 `:root` 中定义: + +```css +:root { + --color-theme-background: ; + --color-theme-foreground: ; + --color-theme-accent: ; + --color-theme-tag: ; + --color-theme-title: ; + --color-theme-meta: ; + --color-theme-framed: ; + --color-theme-menu: ; + --color-theme-header: ; + --list-theme-marker: "►"; + --font-theme-size: 1rem; + --line-theme-height: calc(var(--font-theme-size) * 1.54); + --radius-theme-default: 0; + --font-theme-default: 'JetBrains Mono'; + --font-theme-fallback: Monaco, Consolas, -apple-system, BlinkMacSystemFont, 'segoe ui', + Roboto, Oxygen, Ubuntu, Cantarell, 'open sans', 'helvetica neue'; + --scrollbar-theme-width: thin; + --scrollbar-theme-color: rgba(134, 134, 134, 0.45) rgba(255, 255, 255, 0); + --font-theme-lig: none; +} +``` + +比如这里要让某个配色下面的字体使用 MacOS 默认的字体 + +```css +html[theme-color-scheme='matrix'] { + --font-theme-default: '-apple-system' +} +``` + +目前尚不方便, 等待将所有变量都放到 `:root` 中方便查看并覆盖 + ## 构建 项目使用原生 ES 模块, 用 `esbuild` 来构建, 使用 `pnpm` 管理依赖 @@ -86,9 +170,7 @@ make ## 计划 -- [ ] 自定义配色 - [ ] 调整代码高亮 -- [ ] 本地化 ## 原主题