refactor!: migrate theme assets from css to scss and centralize deprecation detection (#735)

**Breaking changes**:

1. Legacy custom style/script files are no longer loaded automatically.
2. Users must migrate custom files to:
   - `custom.scss`
   - `override.scss`
   - `_variables.scss`
   - `assets/js/custom.js`

**Migration guide**:

1. Move `assets/css/_custom.scss` to `assets/scss/custom.scss`.
2. Move `assets/css/_override.scss` to `assets/scss/override.scss`.
3. Keep variables in `assets/scss/_variables.scss`.
4. Move `assets/js/_custom.js` to `assets/js/custom.js`.
5. Rebuild site and verify no deprecation warnings remain.
This commit is contained in:
Cell
2026-04-19 13:10:39 +08:00
parent b406a569f8
commit 09e08d0772
121 changed files with 426 additions and 505 deletions
+4 -10
View File
@@ -41,15 +41,9 @@ FixIt/
### 文件组织结构
1. **主入口文件**: `assets/css/style.scss`
2. **变量文件**: `assets/css/_variables.scss` - 全局变量定义
3. **覆写文件**: `assets/css/_override.scss` - 用户自定义覆写
4. **组织结构**:
- `_core/`: 核心样式(基础、布局、媒体查询等)
- `_mixin/`: SCSS mixins 和函数
- `_page/`: 页面特定样式
- `_partials/`: 组件样式
- `_shortcodes/`: 短代码样式
1. **主入口文件**: `assets/scss/main.scss`
2. **变量文件**: `assets/scss/_variables.scss` - 全局变量定义
3. **覆写文件**: `assets/scss/_override.scss` - 用户自定义覆写
### 命名约定
@@ -111,7 +105,7 @@ FixIt/
### 文件组织
1. **主题核心**: `assets/js/theme.js` - 主题核心逻辑
2. **工具函数**: `assets/js/util.js` - 通用工具函数
2. **工具函数**: `assets/js/utils/` - 通用工具函数
3. **特定功能**: 按功能划分独立模块
### 编码实例