KoalaWiki 项目启动与配置教程

1. 项目目录结构及介绍

KoalaWiki 项目的目录结构如下所示：

KoalaWiki/
├── .gitignore           # Git 忽略文件
├── Dockerfile           # Docker 配置文件
├── LICENSE              # 项目许可证文件
├── README.md            # 项目说明文件
├── appsettings.json     # 项目配置文件
├── koalawiki.xproj      # 项目文件
├── koalawiki.sln        # 解决方案文件
├── Models               # 模型类目录
│   └── ...
├── Services             # 服务类目录
│   └── ...
├── Views                # 视图目录
│   └── ...
├── wwwroot              # 静态文件目录
│   ├── css
│   ├── js
│   └── ...
└── ...

• .gitignore：指定 Git 忽略跟踪的文件和目录。
• Dockerfile：用于创建 Docker 容器的配置文件。
• LICENSE：项目的开源许可证。
• README.md：项目的基本介绍和说明。
• appsettings.json：项目的配置文件，用于存储项目的配置信息。
• koalawiki.xproj：项目的项目文件，包含了项目的各种设置。
• koalawiki.sln：项目的解决方案文件，用于管理项目中的多个项目。
• Models：存放实体模型的目录。
• Services：存放业务逻辑服务的目录。
• Views：存放视图文件的目录，用于展示用户界面。
• wwwroot：存放静态文件的目录，如 CSS、JavaScript 文件等。

2. 项目的启动文件介绍

KoalaWiki 项目的启动文件是 koalawiki.xproj。该文件是项目的核心，包含了项目的各种设置和引用。在 Visual Studio 或其他支持 .NET Core 的 IDE 中打开该文件，即可加载整个项目。

打开项目后，可以通过 Visual Studio 的“开始”菜单或使用命令行工具运行项目。以下是使用命令行启动项目的步骤：

1. 打开命令行工具。
2. 切换到包含 koalawiki.xproj 文件的目录。
3. 运行以下命令以启动项目：

dotnet run

执行此命令后，项目将开始运行，通常在默认的网络浏览器中自动打开一个新标签页，地址通常是 http://localhost:5000。

3. 项目的配置文件介绍

KoalaWiki 项目的配置文件是 appsettings.json。该文件用于存储项目所需的各种配置信息，如数据库连接字符串、API 密钥、外部服务配置等。

以下是 appsettings.json 文件的一个基本示例：

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=.;Database=KoalaWikiDB;Trusted_Connection=True;MultipleActiveResultSets=true;"
  },
  "Logging": {
    "IncludeScopes": false,
    "LogLevel": {
      "Default": "Debug",
      "System": "Information",
      "Microsoft": "Information"
    }
  }
}

在此示例中，ConnectionStrings 部分包含了数据库连接字符串，而 Logging 部分则定义了日志的配置。

在项目代码中，可以通过 IConfiguration 接口来访问 appsettings.json 文件中的配置信息。例如：

public class MyService
{
    private readonly IConfiguration _configuration;

    public MyService(IConfiguration configuration)
    {
        _configuration = configuration;
    }

    public string GetDatabaseConnectionString()
    {
        return _configuration.GetConnectionString("DefaultConnection");
    }
}

以上代码示例展示了如何在一个服务中注入 IConfiguration，然后使用它来获取配置文件中的数据库连接字符串。