IMathAS 项目启动与配置教程

IMathAS 项目启动与配置教程

IMathAS IMathAS Online Math Assessment 项目地址: https://gitcode.com/gh_mirrors/im/IMathAS

1. 项目的目录结构及介绍

IMathAS 是一个基于网络的数学评估系统，其目录结构清晰，便于维护和扩展。以下是主要目录及其功能的简要介绍：

• admin: 包含管理员功能的文件。
• assessment: 存放评估相关的文件，包括题目库和作业。
• course: 包含课程相关的文件和资源。
• diag: 诊断工具和脚本。
• docs: 项目文档。
• filestore: 文件存储目录，用于存放用户上传的文件。
• filter: 过滤器相关文件，用于处理数学公式等内容的显示。
• forums: 论坛功能相关的文件。
• i18n: 国际化文件，包含多语言支持。
• iconfonts: 图标字体文件。
• img: 图片资源目录。
• includes: 包含被多个文件共用的库和函数。
• javascript: JavaScript 文件。
• katex: KaTeX 数学公式渲染库。
• lti: LTI (Learning Tools Interoperability) 相关文件。
• mathquill: MathQuill 数学公式输入库。
• migrations: 数据库迁移脚本。
• msgs: 消息和通知相关文件。
• tests: 测试文件和测试用例。
• themes: 主题和样式表。
• tinymce4: TinyMCE 富文本编辑器相关文件。
• util: 实用工具和库。
• vendor: 通过 Composer 安装的第三方库。
• wikis: 维基功能相关的文件。

此外，还有一些重要的文件，如 config.php（配置文件）、install.php（安装脚本）、upgrade.php（升级脚本）等。

2. 项目的启动文件介绍

项目的启动主要是通过 install.php 脚本进行的。该脚本会引导用户完成以下步骤：

• 创建数据库连接。
• 设置数据库相关配置。
• 创建数据库结构和初始数据。
• 设置文件权限，确保 Web 服务器可以写入必要的目录。
• 提供一个界面，让用户可以选择安装示例问题。

完成这些步骤后，用户可以通过访问项目根目录的 index.php 文件来开始使用 IMathAS。

3. 项目的配置文件介绍

项目的配置主要通过 config.php 文件进行。以下是 config.php 中一些重要配置项的说明：

• $dbserver: 数据库服务器的地址。
• $dbname: IMathAS 使用的数据库名称。
• $dbusername: 数据库用户名。
• $dbpassword: 数据库用户密码。
• $installname: 安装名称，用于个性化设置。
• $longloginprompt: 新学生用户名提示信息。
• $loginprompt: 学生用户名提示信息。
• $loginformat: 用户名格式要求，使用正则表达式。
• $emailconfirmation: 是否需要通过电子邮件确认新用户。
• $sendfrom: 发送电子邮件的地址。
• $imasroot: IMathAS 安装的 Web 根路径。
• $mathimgurl: Mimetex 安装的路径或完整 URL，用于数学公式的图像化显示。
• $colorshift: 是否启用颜色变化提示功能。
• $smallheaderlogo: 小型（120x80）徽标，显示在课程页面的右上角。
• $allownongrouplibs: 是否允许非管理员创建非组库。
• $allowcourseimport: 是否允许从课程页面导入/导出问题和库。
• $enablebasiclti: 是否启用 IMathAS 作为 LTI 生产者。
• $AWSkey, $AWSsecret, $AWSbucket: 用于文件存储的 Amazon S3 密钥、密钥和存储桶。

config.php 文件应该在使用前根据实际情况进行相应的修改，以确保 IMathAS 可以正确运行。

IMathAS IMathAS Online Math Assessment 项目地址: https://gitcode.com/gh_mirrors/im/IMathAS