Roadkill 项目启动与配置教程

1. 项目目录结构及介绍

Roadkill 是一个开源的 Wiki 系统项目，其目录结构如下：

roadkill/
├── bin/                      # 存放编译后的可执行文件
├── Content/                  # 存放静态内容，如CSS、JS、图片等
├── doc/                      # 项目文档
├──roadkill.ico               # 网站的图标文件
├── Roadkill.sln              # 解决方案文件，用于Visual Studio
├── Roadkill.suo              # Visual Studio的用户选项文件
├── Roadkill.Tests/           # 单元测试项目
├── Roadkill.Web/             # Web项目主目录
│   ├── App_Data/             # 存放应用程序数据，如数据库文件
│   ├── Content/             # Web项目的静态内容
│   ├── controllers/         # MVC控制器
│   ├── models/              # MVC模型
│   ├── views/               # MVC视图
│   ├── Properties/          # 存放配置文件和程序集信息
│   └── Roadkill.Web.csproj   # Web项目的项目文件
└── Roadkill.WindowsService/  # Windows服务项目

• bin/：编译后的程序集和依赖库文件存放目录。
• Content/：包含所有静态资源，如CSS、JavaScript文件和图片等。
• doc/：存放项目文档。
• roadkill.ico：网站图标文件。
• Roadkill.sln：Visual Studio解决方案文件，用于管理项目。
• Roadkill.suo：Visual Studio用户选项文件，通常不需要直接操作。
• Roadkill.Tests/：项目的单元测试。
• Roadkill.Web/：Web项目主目录，包含网站的所有动态内容。
  • App_Data/：存放应用程序数据，如数据库文件等。
  • Content/：Web项目的静态内容。
  • controllers/：MVC模式中的控制器，处理用户请求。
  • models/：MVC模式中的模型，表示应用程序的数据。
  • views/：MVC模式中的视图，用于显示信息。
  • Properties/：存放配置文件和程序集信息。
  • Roadkill.Web.csproj：Web项目的项目文件。

2. 项目的启动文件介绍

Roadkill 的启动主要通过 Roadkill.Web 目录下的 Global.asax 文件进行配置。以下是 Global.asax 的基本结构：

using System;
using System.Web;
using System.Web.Http;
using System.Web.Mvc;
using System.Web.Routing;

public class MvcApplication : HttpApplication
{
    protected void Application_Start()
    {
        // AreaRegistration.RegisterAllAreas(); // 注册区域
        GlobalConfiguration.Configure(WebApiConfig.Register); // 注册Web API
        FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters); // 注册全局过滤器
        RouteConfig.RegisterRoutes(RouteTable.Routes); // 注册路由
        BundleConfig.RegisterBundles(BundleTable.Bundles); // 注册捆绑
    }
}

Global.asax 文件负责初始化 MVC 应用程序，包括路由、Web API、全局过滤器等配置。

3. 项目的配置文件介绍

Roadkill 的配置文件主要包括 web.config 和 app.config。

• web.config：Web应用程序的配置文件，包含应用程序的设置、HTTP模块和处理器、安全策略、编译设置、应用程序错误处理等。

<configuration>
    <appSettings>
        <!-- 应用程序设置 -->
    </appSettings>
    <connectionStrings>
        <!-- 数据库连接字符串 -->
    </connectionStrings>
    <system.web>
        <!-- MVC、Web API、Web Forms 设置 -->
    </system.web>
    <runtime>
        <!-- 应用程序运行时设置 -->
    </runtime>
</configuration>

• app.config：通常用于存储应用程序的通用设置，如数据库连接字符串、应用程序设置等，在非Web环境中使用。

<configuration>
    <appSettings>
        <!-- 应用程序设置 -->
    </appSettings>
    <connectionStrings>
        <!-- 数据库连接字符串 -->
    </connectionStrings>
    <runtime>
        <!-- 应用程序运行时设置 -->
    </runtime>
</configuration>

这些配置文件允许开发者定义应用程序的基本设置，如数据库连接、应用程序行为等。