docs: update

This commit is contained in:
Erzbir
2025-08-05 20:49:53 +08:00
parent 0d42224d39
commit 55bd4da980
+114 -32
View File
@@ -9,43 +9,49 @@
## 对原主题的修改 ## 对原主题的修改
### 新增功能 ### 新增功能
1. 支持 PJAX
2. 支持亮暗模式 1. PJAX
3. 支持指定亮暗模式配色 2. 自定义 CSS
4. 支持子菜单 3. 自定义主题配色
5. 支持像素化开关 4. 指定深色/浅色模式配色
6. 支持文章目录开关 5. 子菜单
6. 像素化开关
7. 文章目录开关
### 样式 ### 样式
1. 去除 a 标签的下划线
2. 修改分页与评论的排列顺序 1. 更响应式的布局
3. 修改默认字体为 JetBrains Mono 2. 去除 a 标签的下划线
4. 修改一些固定文字 3. 修改分页与评论的排列顺序
5. 修改 footer 样式并且兼容小屏 4. 修改默认字体为 JetBrains Mono
6. 修改文章之间的间隔 5. 修改一些固定文字
7. 修改滑轨颜色为透明 6. 修改 footer 样式并且兼容小屏
8. 修改滑块颜色 7. 修改文章之间的间隔
9. 修改文章目录样式, 去除选中时的背景色 8. 修改滑轨颜色为透明
10. 修改分页的样式, 只有一个时居中, 适配小屏端 9. 修改滑块颜色
11. 修改一些标签的大小以及间距 10. 修改文章目录样式, 去除选中时的背景色
12. 修改标题与文章的分割线 11. 修改分页的样式, 只有一个时居中, 适配小屏端
13. 让代码块背景色适配主题 12. 修改一些标签的大小以及间距
14. 让搜索组件颜色适配主题 13. 修改标题与文章的分割线
15. 让评论颜色适配主题 14. 让代码块背景色适配主题
16. 修改友链的样式 15. 让搜索组件颜色适配主题
17. 修改标签页以及归档页及分类页的列表显示 16. 让评论颜色适配主题
18. 修改按扭边框样式 17. 修改友链的样式
19. 修改代码块背景 18. 修改标签页以及归档页及分类页的列表显示
20. 禁用字体连字 19. 修改按扭边框样式
21. 在移动端菜单纵向排列 20. 修改代码块背景
22. 调整各个元素的间距等 21. 禁用字体连字
23. 文章目录响应式显示 22. 在移动端菜单纵向排列
23. 调整各个元素的间距等
24. 文章目录响应式显示
### 优化 ### 优化
1. 防止由于滑块引起的页面抖动 1. 防止由于滑块引起的页面抖动
### 开发相关 ### 开发相关
1. 项目迁移至 ES modules 使用原生 JS 开发
1. 项目迁移至 ES modules 使用原生 JS 开发
2. 删除所有工具依赖, 引入 esbuild 2. 删除所有工具依赖, 引入 esbuild
## 关于 PJAX ## 关于 PJAX
@@ -72,6 +78,84 @@
- highlightjs 插件的 _复制按扭_ 数量会随页面切换增加 - 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` 管理依赖 项目使用原生 ES 模块, 用 `esbuild` 来构建, 使用 `pnpm` 管理依赖
@@ -86,9 +170,7 @@ make
## 计划 ## 计划
- [ ] 自定义配色
- [ ] 调整代码高亮 - [ ] 调整代码高亮
- [ ] 本地化
## 原主题 ## 原主题