72 lines
3.8 KiB
Markdown
72 lines
3.8 KiB
Markdown
# JSKCloud / SCCK 静态站
|
||
|
||
两个网站分别位于 **jskcloud/** 和 **scck/**，各自包含完整 HTML、CSS、JS、图片、字体和三语页面。可将任意一个目录独立复制到 nginx 服务器，不需要另一站点或项目根目录中的工具文件。
|
||
|
||
```text
|
||
jskcloud/ JSKCloud 独立站点根目录
|
||
index.html 默认英文首页
|
||
assets/ 本站全部静态资源
|
||
en/ 英文页面
|
||
zh-cn/ 简体中文页面
|
||
zh-hk/ 繁体中文页面
|
||
docs/ news/ announce/ 文档、新闻、公告详情
|
||
404.html
|
||
nginx.conf.example 独立域名部署示例
|
||
site-manifest.json 页面映射、采集时间及源站异常记录
|
||
scck/ SCCK 独立站点根目录，默认简体中文
|
||
scripts/ 重新采集、生成、验证工具；部署时无需上传
|
||
```
|
||
|
||
## 部署
|
||
|
||
分别将 `jskcloud/`、`scck/` 放到服务器的 `/var/www/jskcloud` 和 `/var/www/scck`，使用各自目录内的 `nginx.conf.example` 配置，并根据服务器调整 `root` 和 `server_name`。已有 HTTPS 配置可沿用证书部分，把静态目录和 location 规则合并到现有 server 中。
|
||
|
||
如果要在同一个域名的 `/jskcloud/`、`/scck/` 下访问，使用根目录的 `nginx-subdirectories.conf.example`。页面和资源均使用相对路径。
|
||
|
||
nginx 的 http 配置应包含系统 `mime.types`。上线前执行 `nginx -t` 检查配置，再按服务器原有方式重新加载 nginx。不要配置 PHP 转发、API 反向代理或 SPA 首页兜底。
|
||
|
||
## 静态功能
|
||
|
||
- 首页、公开导航页、公开新闻/公告分类及详情、文档目录及详情均生成本地 HTML。
|
||
- 简体、繁体、英文均预生成；切换语言会跳转到同一页面的对应译文，不调用在线翻译。
|
||
- 云服务器入口指向只读的 `cloud.html`，显示公开参数及起售价；不提供配置提交、购物车或购买功能。
|
||
- 登录、注册、会员中心、充值、工单提交等入口已移除。后台及不存在的地址返回 HTTP 404。
|
||
- 菜单、轮播、展示筛选、文档本地搜索、图片预览在浏览器中运行。联系链接仍可由用户主动打开。
|
||
- 内容和价格为采集时快照；不会自动更新。译文使用本地词典，技术型号、参数、金额保留原值。
|
||
|
||
## 本地预览与维护
|
||
|
||
部署成品无需安装依赖。仅重新生成或运行验证工具时需要 Node.js、curl 和项目依赖：
|
||
|
||
```bash
|
||
npm ci
|
||
PLAYWRIGHT_BROWSERS_PATH=0 npx playwright install chromium
|
||
# 如系统缺少 Chromium 运行库，按 Playwright 提示安装对应系统依赖。
|
||
npm run preview
|
||
# 浏览 http://localhost:4173/jskcloud/ 和 http://localhost:4173/scck/
|
||
|
||
# 也可单独预览任意站点：
|
||
node scripts/preview.mjs jskcloud 4174
|
||
node scripts/preview.mjs scck 4175
|
||
|
||
# 需要联网，仅访问源站的公开内容：
|
||
npm run capture
|
||
npm run build
|
||
|
||
# 或仅更新一个站点：
|
||
node scripts/capture.mjs jskcloud
|
||
node scripts/build.mjs jskcloud
|
||
|
||
# 无需外网的本地检查：
|
||
npm run verify
|
||
node scripts/verify.mjs --static-only
|
||
# JSKCloud 导航专项：保留全部静态检查，仅运行首页导航的浏览器回归
|
||
node scripts/verify.mjs jskcloud --navigation-only
|
||
# JSKCloud 联系页专项：检查三语内容、联系入口及桌面/手机布局
|
||
node scripts/verify.mjs jskcloud --contact-only
|
||
```
|
||
|
||
`scripts/locales/en.json` 保存英文译文，可以校订后重新生成。采集缓存位于 `.cache/`；`capture --refresh` 可重新获取源站页面和内容数据。验证报告与桌面/手机截图位于 `test-results/`。
|
||
|
||
原站失效页面和资源记录在各站 `site-manifest.json` 中。可由公开内容重建的分类页会生成正常静态列表；已失效的装饰图片和未使用的支付图标引用会清理，不生成虚构图片或内容。
|