主题
目录结构
tools-site/
├── pc-web/ # 电脑 / 平板版(emphant.com)
│ ├── scripts/
│ │ ├── gen-pages.mjs # 由工具数据生成所有静态 HTML
│ │ ├── fetch-lottery.mjs # 构建期抓取彩票开奖数据
│ │ └── postbuild.mjs # 把 dist/pages 提到根目录
│ ├── src/
│ │ ├── data/ # 工具定义、栏目文案、教育内容、广告位
│ │ ├── tools/ # 88 个工具组件
│ │ ├── ui/ # 通用 UI 组件
│ │ ├── utils/ # 纯函数算法(彩票、日期、编码等)
│ │ └── styles/app.css # 设计令牌与全站样式
│ ├── pages/ # gen-pages 生成的 HTML 源文件(构建输入)
│ └── public/ # 图标、og 封面、data/lottery.json
│
├── mobile-web/ # 手机版(emphant.com/m/)
│ ├── src/
│ │ ├── views/ # 页面级组件
│ │ ├── tools/ # 为手机重写的工具组件
│ │ ├── shell/ # 底部导航、弹层等外壳
│ │ ├── router.js # hash 路由
│ │ └── styles/pc-compat.css# 把 pc 的类名映射到手机版设计令牌
│ └── vite.config.js # @pc 别名 + dedupe vue
│
├── docs-site/ # 项目文档(docs.emphant.com)
│ ├── .vitepress/config.mts # 导航、侧边栏、搜索、sitemap
│ └── guide/ project/ ops/ reference/
│
├── blog-site/ # 技术随笔(blog.emphant.com)
│ ├── .vitepress/config.mts # 博客配置 + 文章索引虚拟模块 + RSS
│ ├── .vitepress/theme/ # 自定义博客主题(文章列表、标签、meta)
│ └── posts/ # 一篇随笔一个 .md
│
├── scripts/deploy.py # 发布实现(被 deploy.sh 调用)
├── deploy.sh # 统一发布入口
├── README.md # 主站运维说明
└── 工具清单对照.md # 工具与栏目的人工核对表几个容易踩的目录约定
pc-web/pages/是生成物。不要手改里面的 HTML,下次gen-pages.mjs会覆盖;改文案请改src/data/。mobile-web不能单独拷走。它通过@pc → ../pc-web/src复用代码,脱离仓库会解析不到别名。dist/不进 Git。四个站点的构建产物都由发布脚本在服务器上落盘。docs-site与blog-site互不依赖。可以只发其中一个,deploy.sh docs/deploy.sh blog单独发布。
内容放在哪
| 想改什么 | 去哪里 |
|---|---|
| 工具的名称、描述、FAQ | pc-web/src/data/tools/<栏目>.js |
| 栏目介绍与 SEO 文案 | pc-web/src/data/categories.js |
| 教育栏目文章 | pc-web/src/data/edu/ |
| 测算栏目题目与计分 | pc-web/src/data/assess/ |
| 广告位 | pc-web/src/data/ads.js |
| 文档页面 | docs-site/<分组>/*.md + config.mts 侧边栏 |
| 随笔 | blog-site/posts/*.md |