INGInious 项目启动与配置教程

1. 项目目录结构及介绍

INGInious 是一个开源的在线编程平台，用于创建和运行编程作业。以下是项目的目录结构及其简要介绍：

INGInious/
├── contest/             # 存放比赛相关的文件
├── contributions/       # 存放贡献者的文件
├── documentation/       # 存放项目文档
├── grading/             # 存放评分相关的文件和工具
├── inginious/           # 核心代码，包括服务器端逻辑
├── lti/                 # LTI (Learning Tools Interoperability) 集成
├── plugins/             # 插件目录，包含各种可扩展功能
├── scripts/             # 存放脚本文件，用于管理和服务操作
├── skins/               # 界面皮肤和主题
├── student/             # 学生界面相关的文件
├── teacher/             # 教师界面相关的文件
├── testsuite/           # 测试套件，用于测试平台功能
├── utils/               # 工具类文件
└── webapp/              # Web应用程序的静态文件和模板

2. 项目的启动文件介绍

项目的启动文件通常位于 inginious/ 目录下，主要的启动文件有：

• inginious.py：INGInious 的主入口文件，用于启动服务器。
• config.py：项目配置文件，用于设置服务器参数。

启动服务器的方法通常是通过命令行执行以下命令：

python3 inginious.py

这会启动一个默认配置的服务器，通常用于开发和测试。

3. 项目的配置文件介绍

INGInious 的配置文件是 config.py，它用于设置服务器的运行参数和环境。以下是一些常见配置项：

• general: 通用设置，包括服务器端口、日志等级等。
• database: 数据库连接配置，包括数据库类型、地址、端口、用户名、密码等。
• plugins: 插件配置，用于启用或禁用特定插件。
• themes: 主题配置，用于选择和配置界面主题。

以下是一个简单的配置文件示例：

import os

# 通用设置
general = {
    'base_url': 'http://localhost:8000',
    'port': 8000,
    'loglevel': 'INFO',
}

# 数据库配置
database = {
    'type': 'SQLite',
    'filename': os.path.join(os.path.dirname(__file__), 'inginious.db')
}

# 插件配置
plugins = {
    '-enabled': ['standard', 'zip'],
}

# 主题配置
themes = {
    'default': 'default',
}

根据实际需求，开发者可以对配置文件进行相应的修改以适应不同的运行环境。在完成配置后，重新启动服务器即可使配置生效。