wouso 的安装和配置教程

项目基础介绍和主要编程语言

wouso 是一个开源的 quiz game 框架，它自 2007 年起被用于支持罗马尼亚布加勒斯特理工大学自动控制与计算机学院一年级学生的操作系统导论课程（USO）。该项目主要使用 Python 编程语言开发，同时包含了 HTML、JavaScript 和 CSS 等技术。

项目使用的关键技术和框架

• Django: Python 的高级 Web 框架，用于快速开发安全且易于维护的网站。
• Python: 一种广泛使用的高级编程语言，适用于 web 开发、数据科学、自动化脚本等。
• Virtualenv: 用于创建独立的 Python 环境的工具，可以避免不同项目间包版本的冲突。

项目安装和配置的准备工作

在开始安装 wouso 之前，请确保您的系统中安装了以下必要的软件包：

• Python 2.7
• python-pip
• python-django
• python-dev
• python-virtualenv
• libldap2-dev
• libsasl2-dev
• libssl-dev

对于基于 Debian 的系统，可以使用以下命令安装：

sudo apt-get install python2.7 python-pip python-django python-dev python-virtualenv libldap2-dev libsasl2-dev libssl-dev

对于 Fedora 22 或更高版本，可以使用以下命令安装：

sudo dnf -y install python-pip python-django python-devel python-virtualenv openldap-devel libgsasl-devel openssl-devel

对于 Fedora 21 或更低版本，可以使用以下命令安装：

sudo yum -y install python-pip python-django python-devel python-virtualenv openldap-devel libgsasl-devel openssl-devel

如果需要支持 MySQL，还需要安装 MySQL 服务器和客户端软件包以及对应的 Python 库。

项目安装步骤

1. 克隆项目仓库

   首先，从 GitHub 上克隆 wouso 项目的仓库：

   git clone https://github.com/rosedu/wouso.git
   

2. 设置虚拟环境

   进入克隆的项目目录，并创建一个虚拟环境：

   cd wouso
   virtualenv -p python2.7 sandbox
   source sandbox/bin/activate
   

   激活虚拟环境后，命令行提示符会发生变化。

3. 安装项目依赖

   在虚拟环境内，安装项目所需的依赖：

   pip install -r requirements-pip
   pip install -r requirements-extra
   

4. 安装 Django-piston

   由于某些原因，需要手动安装 django-piston：

   curl 'https://pypi.python.org/packages/source/d/django-piston/django-piston-0.2.3.tar.gz' | tar xzf -
   cd django-piston-0.2.3; python setup.py install
   cd ..; rm -r django-piston-0.2.3
   

5. 配置项目

   进入 wouso 子目录，复制示例设置文件并编辑：

   cd wouso/
   cp settings.py.example settings.py
   

   在 settings.py 文件中，您可能需要更新 DATABASES 设置。

6. 创建数据库

   如果您选择使用 MySQL 数据库，确保安装了 MySQL 服务器和客户端软件包以及 MySQL-python Python 库。然后创建数据库和用户：

   create database wouso default character set utf8 default collate utf8_general_ci;
   create user 'wouso'@'localhost' identified by 'some_pass';
   grant all privileges on wouso.* to 'wouso'@'localhost';
   flush privileges;
   

   并在 settings.py 中配置相应的数据库设置。

7. 初始化数据库

   创建数据库表并加载初始数据：

   ./manage.py wousoctl --setup
   

   您会被要求输入管理员用户的用户名和密码。

8. 运行服务器

   运行开发服务器：

   ./manage.py runserver
   

   默认情况下，服务器将在本地主机的 8000 端口上监听。如果需要在所有接口上监听，请运行：

   ./manage.py runserver 0.0.0.0:8000
   

   现在，您可以在浏览器中访问 http://localhost:8000 或 http://<IP>:8000/ (<IP> 是您安装 World of USO 的主机的 IP 地址)。

9. 退出虚拟环境

   如果要离开虚拟环境，运行：

   deactivate
   

通过上述步骤，您应该能够成功安装和配置 wouso 项目。如果遇到任何问题，可以查看项目文档或相关社区论坛寻求帮助。