@happyvertical/smrt-template-site-static-json

中文文档
0.62.1发布于 2026/11/17MITES Module零依赖近 30 天下载 1.5万

有JSON数据存储和SMRT框架的静态社区站点模板

中文使用文档
文档目录10 节
  1. 此模板提供了什么
  2. 先决条件
  3. 使用量
  4. 环境变量
  5. 配置
  6. 可用的脚本
  7. 模板结构
  8. 占位符替换
  9. 部署
  10. 相关

@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.

版本与发布记录

@happyvertical/smrt-template-site-static-json 共发布 365 个版本,首次发布于 2026/06/23;过去 12 个月发布了 365 个版本。

版本发布日期距今
0.62.1latest2026/11/17今天
0.62.02026/11/17今天
0.61.62026/11/161 天前
0.61.52026/11/161 天前
0.61.42026/11/161 天前
0.61.32026/11/152 天前

关于 @happyvertical/smrt-template-site-static-json 的常见问题

@happyvertical/smrt-template-site-static-json 是什么?

有JSON数据存储和SMRT框架的静态社区站点模板

如何安装 @happyvertical/smrt-template-site-static-json?

在项目目录运行 npm install @happyvertical/smrt-template-site-static-json,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@happyvertical/smrt-core(0.62.1)、@happyvertical/smrt-config(0.62.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@happyvertical/smrt-template-site-static-json 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/happyvertical__smrt-template-site-static-json 是否存在。

@happyvertical/smrt-template-site-static-json 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@happyvertical/smrt-template-site-static-json 可以商用吗?

@happyvertical/smrt-template-site-static-json 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@happyvertical/smrt-template-site-static-json 的下载量有多少?

根据 npm 官方下载统计,@happyvertical/smrt-template-site-static-json 在 2026/10/17 – 2026/11/15 这 30 天内被下载 14,826 次,日均约 494 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@happyvertical/smrt-template-site-static-json 还在维护吗?

最新版本 0.62.1 发布于 2026/11/17(今天);至今共发布 365 个版本,其中过去 12 个月发布了 365 个;首次发布于 2026/06/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。