# 学科引擎SubjEngine

**Repository Path**: codekpy/subj-engine

## Basic Information

- **Project Name**: 学科引擎SubjEngine
- **Description**: 概述：EduTools 是一套面向高中教学的交互式网页教材与实验演示集合，包含物理、化学等学科的可视化模拟与教学工具。
特点：基于轻量 HTML/CSS/JavaScript（使用 Tailwind 等工具），界面响应式、交互友好、参数可调，便于课堂演示与学生自主探索。
目标受众：高中教师与学生，也适合作为教材补充与课堂实验预习资源。
贡献与部署：源码友好、便于扩展，欢迎加入项目
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://subj-engine.cloudroo.top/
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2025-12-13
- **Last Updated**: 2025-12-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SubjEngine (学科引擎)

这是一个用于聚合学科模拟动画的轻量网站（静态站点）。

主要内容：
- `index.html`：首页，按学科分组展示所有动画条目（从 `list.json` 加载）。
- `list.json`：条目数据（数组），每项字段示例见下。
- `tools/editor.html`：浏览器端的简单编辑器，可以加载、编辑并导出 `list.json`（需手动提交 PR）。

示例条目格式（`list.json` 内为数组）:

```json
[
  {
    "name": "洛伦兹力 — 圆周运动演示",
    "link": "Physics/BOp5H5rm_洛伦兹力-圆周运动演示.html",
    "summary": "演示带电粒子在磁场中的受力与圆周运动。",
    "author": "张三",
    "contact": "zhangsan@example.com",
    "time": "2025-12-01",
    "subject": "物理",
    "grade": "高中选修"
  }
]
```

如何本地预览：

```powershell
cd 'f:\program\StarBit\code\EduTools'
# 使用 Python 简单 HTTP 服务
python -m http.server 8000
# 浏览器打开 http://localhost:8000/
```

贡献说明：
- 通过仓库提交 PR（或 Issue）来添加/修改 `list.json` 条目。
- 编辑器位于 `tools/editor.html`，编辑后请导出并在本地替换 `list.json`，然后提交 PR。

仓库地址： https://gitee.com/codekpy/subj-engine.git# 学科引擎 / SubjEngine

这是一个聚合学科模拟动画的轻量网站集合，旨在将各类学科仿真/演示页面集中展示并便于贡献与协作。

## 目录结构（主要）

- `index.html` - 项目首页，按学科分组瀑布流展示条目。
- `list.json` - 动画条目列表（数组）。
- `author.json` - 共同创作者列表（数组）。
- `tools/editor.html` - 浏览器端小工具，用于加载、编辑、导出 `list.json`（不直接写文件）。
- `static/` - 静态资源（脚本与样式）。

## 本地预览

使用一个静态 HTTP 服务器来预览（推荐 Python）：

```powershell
cd 'f:\program\StarBit\code\EduTools'
python -m http.server 8000
# 然后打开 http://localhost:8000/
```

编辑器页面：`http://localhost:8000/tools/editor.html`。

## list.json 格式示例

每一项为对象，示例：

```json
{
  "name": "洛伦兹力 — 圆周运动演示",
  "link": "Physics/BOp5H5rm_洛伦兹力-圆周运动演示.html",
  "summary": "演示带电粒子在磁场中的受力与圆周运动。",
  "author": "张三",
  "contact": "zhangsan@example.com",
  "time": "2025-12-01",
  "subject": "物理",
  "grade": "高中选修"
}
```

`list.json` 的根是数组，便于多人协作（不要求 ID 字段）。

## 如何贡献

- 建议通过 Fork / Clone 仓库并提交 `list.json` 的变更（或直接在仓库中提交新条目）。
- 贡献方式：通过提交 PR 或在仓库中创建 Issue 讨论条目。

仓库地址：https://gitee.com/codekpy/subj-engine.git

示例 Git 操作（在项目根目录）：

```powershell
git add list.json
git commit -m "chore: update list.json"
git push
```

## 编辑器说明

`tools/editor.html` 可以加载 `/list.json`，在浏览器中修改条目并导出 JSON 或复制到剪贴板；随后将导出的 `list.json` 覆盖仓库中的文件并提交。

## 许可证

按仓库内 LICENSE（如有）执行；如果没有，请在贡献前指定许可证。

## 致谢

### 作者与贡献者

感谢所有为 SubjEngine（学科引擎）项目做出贡献的作者和开发者，你们的创意和努力让这个项目变得更加丰富和实用。

### 开源项目致谢

本项目使用了以下优秀的开源项目：

- **Tailwind CSS**：用于构建现代化、响应式的用户界面，提供了高效的样式开发体验。
- **MathJax**：用于在网页中渲染数学公式，支持多种数学符号和表达式。
- **Font Awesome**：提供了丰富的图标资源，增强了网站的视觉表现力。

这些开源项目的贡献对本项目的成功至关重要，在此向它们的开发者和社区表示衷心的感谢。