feat: 升级 timeTableFix 子模块(时区选择)+ 修正 README 构建路径

- 子模块 timeTableFix 升级至时区选择版本:加载自动检测用户时区,取不到
  回退墨尔本;仅作新建事件默认 tzid 与下载 ICS 的 X-WR-TIMEZONE,不换算
- 修正 README:构建输出到 dist/(非 /root/html),由 npm run deploy rsync
  到站点根;补 npm run deploy 命令;细节记于 docs/readme-fixes.md
- 集成构建验证通过(npm run build)
This commit is contained in:
2026-07-27 09:51:43 +08:00
parent 1379e1a607
commit 3e5c1d5494
3 changed files with 26 additions and 4 deletions

View File

@@ -10,7 +10,7 @@ Zikai 的作品集主页 -- Vue 3 模块化多项目展示站。浅色极简、
mainPage/
├── index.html
├── package.json # 含 ical.js / vue-i18n子模块嵌入时共享
├── vite.config.js # 构建输出到 /root/htmlemptyOutDir=false不清空既有文件
├── vite.config.js # 构建输出到 dist/,再由 npm run deploy rsync 到 /root/html
├── .gitmodules # git submoduletimeTableFix / z449
├── README.md
├── docs/ # 架构 / 新增页签 / 子模块管理文档
@@ -62,7 +62,7 @@ npm install
(cd third_party/z449 && npm install)
(cd third_party/timeTableFix && npm install)
# 3. 构建(产物输出到 /root/html,不清空既有文件
# 3. 构建到 dist/(再由 npm run deploy rsync 同步到 /root/html
npm run build
# 4. 安装并启用 Apache
@@ -87,7 +87,8 @@ RewriteRule ^ index.html [L]
```bash
npm install # 首次安装依赖
npm run dev # 开发服务器 http://localhost:5173
npm run build # 构建到 /root/html
npm run build # 构建到 dist/
npm run deploy # 构建并 rsync 同步到 /root/html
npm run preview # 本地预览构建产物
```
@@ -97,3 +98,4 @@ npm run preview # 本地预览构建产物
- [如何新增一个项目页签](./docs/add-module.md)
- [子项目 timeTableFix 管理submodule 升级 / 移除)](./docs/submodule-timeTableFix.md)
- [子项目 z449 管理submodule + i18n prop 桥接)](./docs/submodule-z449.md)
- [README 勘误记录](./docs/readme-fixes.md)

20
docs/readme-fixes.md Normal file
View File

@@ -0,0 +1,20 @@
# README 勘误记录
本文件记录 mainPage README 中发现并修正的错误,便于追溯。
## 2026-07-27构建输出路径描述错误
**原描述(错误)**
- 项目结构注释:`vite.config.js # 构建输出到 /root/htmlemptyOutDir=false不清空既有文件`
- 如何使用:`# 3. 构建(产物输出到 /root/html不清空既有文件`
- 开发命令:`npm run build # 构建到 /root/html`
**实际行为**(见 `vite.config.js`
- `npm run build` 输出到项目本地 `dist/``emptyOutDir: true`,每次清空)。
- `npm run deploy` 才用 rsync 把 `dist/` 同步到 Apache 站点根 `/root/html`(脚本:`vite build && rsync ... dist/... /root/html/...`)。
**修正**:三处均改为说明构建输出到 `dist/`,由 `npm run deploy` rsync 到 `/root/html`,并在「开发命令」补 `npm run deploy` 一行。
> 背景:本次升级 timeTableFix 子模块(新增时区选择)时,按 README 从 0 构建复现发现该不一致。