docs: update
This commit is contained in:
@@ -9,42 +9,48 @@
|
||||
## 对原主题的修改
|
||||
|
||||
### 新增功能
|
||||
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 开发
|
||||
2. 删除所有工具依赖, 引入 esbuild
|
||||
|
||||
@@ -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
|
||||
|
||||
## 计划
|
||||
|
||||
- [ ] 自定义配色
|
||||
- [ ] 调整代码高亮
|
||||
- [ ] 本地化
|
||||
|
||||
## 原主题
|
||||
|
||||
|
||||
Reference in New Issue
Block a user