ASP.NET Core 中文文档项目教程

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

ASP.NET Core 中文文档项目的目录结构如下：

aspnetcore-doc-cn/
├── _exported_templates/
├── aspnetcore/
├── BuildTools/
├── CONTRIBUTING.md
├── gitattributes
├── gitignore
├── LICENSE
├── LICENSE-CODE
├── openpublishing.build.ps1
├── openpublishing.publish.config.json
├── openpublishing.redirection.json
└── README.md

目录结构介绍

• _exported_templates/: 包含导出的模板文件。
• aspnetcore/: 包含主要的文档内容。
• BuildTools/: 包含构建工具的相关文件。
• CONTRIBUTING.md: 贡献指南。
• gitattributes: Git属性配置文件。
• gitignore: Git忽略配置文件。
• LICENSE: 项目许可证。
• LICENSE-CODE: 代码许可证。
• openpublishing.build.ps1: 构建脚本。
• openpublishing.publish.config.json: 发布配置文件。
• openpublishing.redirection.json: 重定向配置文件。
• README.md: 项目介绍文件。

2. 项目的启动文件介绍

在 ASP.NET Core 中文文档项目中，启动文件通常指的是 Program.cs 和 Startup.cs 文件。这些文件定义了应用程序的入口点和配置。

Program.cs

Program.cs 文件包含 Main 方法，这是应用程序的入口点。它负责创建 Web 主机并运行应用程序。

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            });
}

Startup.cs

Startup.cs 文件包含 Startup 类，负责配置服务和应用程序的请求管道。

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // 配置服务
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        // 配置请求管道
    }
}

3. 项目的配置文件介绍

ASP.NET Core 中文文档项目中包含多个配置文件，用于不同的配置需求。

appsettings.json

appsettings.json 文件是主要的配置文件，用于存储应用程序的配置设置。

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*"
}

launchSettings.json

launchSettings.json 文件用于配置开发环境中的启动设置。

{
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "WebApplication": {
      "commandName": "Project",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      },
      "applicationUrl": "https://localhost:5001;http://localhost:5000"
    }
  }
}

openpublishing.publish.config.json

openpublishing.publish.config.json 文件用于配置文档的发布设置。

{
  "documentSets": [
    {
      "source": "aspnetcore",
      "target": "output"
    }
  ]
}

通过这些配置文件，可以灵活地管理和配置 ASP.NET Core 应用程序和文档项目。