@happyvertical/smrt-template-site-staric-json (英语)
基于JSON的数据存储的静态社区新闻网站模板. 生成一个 SvelteKit 静态站点,与天气融合(Caelus)和理事会会刮取(Praeco).
此模板提供了什么
- 使用 SvelteKit 键
adapter-static用于静态站点生成 - JSON 文件数据存储于
data/ - 配置驱动的站点身份、导航、类别和通过
smrt.config.js - 通过Caelus(加拿大环境部)的天气预报
- 理事会会议刮取和通过普拉科制作文章
- 已打入站点配置帮助器( O)
initSiteConfig()编号 :getSite()(中文(简体) ) - 预建路线:家、约、联系
- 内容渲染的标记下工具
先决条件
- 节点.js 18+
- pnpm(建议)
- 双子座 API 密钥( 用于 Praeco 文章生成)
使用量
smrt gnode create my-town-site --template site-static-json \
--location "My Town, AB" \
--lat 53.5 --lon -113.5
cd my-town-site
pnpm install
cp .env.example .env # Add your GEMINI_API_KEY
pnpm run init-data # Initialize data directory
pnpm dev # Start dev server
环境变量
定义 .env.example数字 :
| 变量 | 需求 | 说明 |
|---|---|---|
GEMINI_API_KEY | 对 | Praeco 文章生成的 Google 双子座 API 密钥 |
PUBLIC_GTM_ID | 没有 | Google 标签管理器容器ID |
CUSTOM_DOMAIN | 没有 | 自定义部署域 |
配置
编辑 smrt.config.js 来定制。 主要章节:
site-- 名称、描述、位置、导航链接、主题颜色categories-- 路线的内容类别(例如:,politics/local(中文(简体) )modules.praeco- 理事会会议来源和报告配置modules.caelus-- -- 天气位置(自--lat编号 :--lon旗帜)
可用的脚本
| 脚本 | 说明 |
|---|---|
pnpm dev | 启动开发服务器 |
pnpm build | 构建静态站点至 ./build |
pnpm preview | 预览已建站点 |
pnpm run init-data | 初始化 JSON 数据文件 |
pnpm run workflow:caelus | 获取天气数据 |
pnpm run workflow:praeco | 党代会会议 |
pnpm run validate:json | 验证 JSON 数据文件 |
pnpm run validate:slugs | 校验内容弹片 |
模板结构
template/
├── .env.example # Environment variables
├── .gitignore
├── package.json # Scripts and dependency placeholders
├── smrt.config.js # Site identity, modules, theme
├── svelte.config.js # SvelteKit with adapter-static
├── tsconfig.json
├── vite.config.ts
├── data/ # JSON data storage directory
├── scripts/
│ └── init-data.ts # Data initialization script
└── src/
├── app.css # Global styles
├── app.d.ts # SvelteKit type declarations
├── app.html # HTML shell
├── site.config.ts # Typed config helper (initSiteConfig/getSite)
├── lib/
│ └── utils/
│ └── markdown.ts # Markdown rendering utility
└── routes/
├── +layout.server.ts # Loads site config for all routes
├── +layout.svelte # Root layout
├── +page.server.ts # Home page data
├── +page.svelte # Home page
├── about/ # About page
└── contact/ # Contact page
占位符替换
期间 smrt gnode create,占位符喜欢 {{SITE_NAME}}, (中文(简体) ), {{LOCATION_NAME}}, (中文(简体) ), {{LATITUDE}}, (中文(简体) ), {{LONGITUDE}},以及 {{TIMEZONE}} 由CLI旗替换。 见 template.config.js 整个地图.
部署
本模板使用斯维尔特基特的静态适配器. 构建并部署到任何静态主机 :
pnpm build
# Deploy ./build to S3, Netlify, Vercel, Cloudflare Pages, etc.