物理计算方法案例广场

物理计算方法案例广场 是一个为教育和学习场景设计的在线平台，专注于展示和运行 Jupyter Notebook 文件。

简体中文 | English

分享物理计算方法案例广场

目录

目录

• 👋🏻 介绍
• ✨ 特点
• 📘 使用指南
• 🛠 技术细节
• 🚀 部署指南
• 🤝 贡献指南
• 📄 许可证

物理计算方法案例广场

简体中文 | English

👋🏻 介绍

物理计算方法案例广场 是一个为教育和学习场景设计的在线平台，专注于展示和运行 Jupyter Notebook 文件。我们提供一个方便的环境，让教师和学生能够上传他们的 Jupyter Notebook 作业，并将其分类整理，以便其他人能够方便地浏览和运行。

💡 特点

• 分类展示: 我们根据每次作业或项目来分类展示 Jupyter Notebook 文件，使其更易于查找和浏览。
• 在线运行: 用户可以直接在我们的网站上运行 Jupyter Notebook 文件，无需在本地环境进行任何配置。
• 数据打包: 每个 Jupyter Notebook 文件都可以附带其需要处理的数据，方便上传和下载。
• 独立运行环境: 我们确保每个 Jupyter Notebook 文件在一个相对独立的位置运行，以确保数据安全和运行稳定。

📘 使用指南

1. 上传作业: 教师或学生可以通过我们的上传功能，将他们的 Jupyter Notebook 文件和相关数据上传到平台。
2. 浏览作业: 用户可以在首页浏览所有已上传的作业，并可以根据分类来筛选他们感兴趣的内容。
3. 运行作业: 用户可以点击任一作业，进入在线运行环境，并直接运行 Jupyter Notebook。

🛠 技术细节

• 前端: 我们使用 HTML、CSS、Javascript 和 Bootstrap 构建了一个直观的用户界面。
• 后端: 我们使用 Flask 框架来处理用户请求并管理数据。
• 数据库: 我们使用 SQLite 来存储作业的元数据。
• 存储: 服务器自动将文件推送到GitHub或Gitee仓库进行存储。
• 运行环境: 我们使用 MyBinder 提供 Jupyter Notebook 的在线运行环境。

🚀 部署指南

本项目使用 Docker 进行部署，请确保你的服务器已安装 Docker 和 Docker Compose。

1. 将仓库克隆到你的服务器。
2. 修改根目录下的app.py文件，将GITHUB_TOKEN和GITEE_TOKEN的值改为你的 GitHub 或 Gitee 仓库的 Token，并将GITHUB_REPO和GITEE_REPO的值改为你的 GitHub 或 Gitee 仓库的地址。
3. 设置GITHUB_OR_GITEE的值为github或gitee，以指定使用 GitHub 还是 Gitee 作为仓库。国内推荐使用 Gitee，传输比较稳定，避免服务器无法连接 GitHub。
4. 在项目根目录下运行 docker-compose up --build。
5. 访问 http://your-server-ip:1753。

🤝 贡献指南

如果你有任何建议或想要贡献代码，请提交 Issue 或 Pull Request。

📄 许可证

本项目采用 MIT许可证。