Fluid 开源项目使用教程

Fluid 开源项目使用教程

fluidFluid is an open-source .NET template engine based on the Liquid template language.项目地址:https://gitcode.com/gh_mirrors/fl/fluid

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

Fluid 项目的目录结构如下：

fluid/
├── src/
│   ├── Fluid.Core/
│   ├── Fluid.MvcViewEngine/
│   ├── Fluid.Tests/
│   └── Fluid.Web/
├── .gitignore
├── Fluid.sln
├── LICENSE
├── README.md
└── CONTRIBUTING.md

目录结构介绍

• src/: 包含项目的源代码。
  • Fluid.Core/: 核心库，提供 Fluid 模板引擎的基本功能。
  • Fluid.MvcViewEngine/: 用于 ASP.NET Core MVC 的视图引擎扩展。
  • Fluid.Tests/: 单元测试项目。
  • Fluid.Web/: 示例 Web 应用程序。
• .gitignore: Git 忽略文件配置。
• Fluid.sln: Visual Studio 解决方案文件。
• LICENSE: 项目许可证。
• README.md: 项目说明文档。
• CONTRIBUTING.md: 贡献指南。

2. 项目的启动文件介绍

在 Fluid.Web/ 目录下，主要的启动文件是 Program.cs 和 Startup.cs。

Program.cs

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;

namespace Fluid.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

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

namespace Fluid.Web
{
    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllersWithViews();
            services.AddFluid();
        }

        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            else
            {
                app.UseExceptionHandler("/Home/Error");
                app.UseHsts();
            }

            app.UseHttpsRedirection();
            app.UseStaticFiles();

            app.UseRouting();

            app.UseAuthorization();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllerRoute(
                    name: "default",
                    pattern: "{controller=Home}/{action=Index}/{id?}");
            });
        }
    }
}

3. 项目的配置文件介绍

在 Fluid.Web/ 目录下，主要的配置文件是 appsettings.json。

appsettings.json

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

配置文件介绍

• Logging: 配置日志级别。
  • Default: 默认日志级别。
  • Microsoft: Microsoft 命名空间下的日志级别。
  • Microsoft.Hosting.Lifetime: 主机生命周期日志级别。
• AllowedHosts: 允许访问的主机。

以上是 Fluid 开源项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用 Fluid 项目。

fluidFluid is an open-source .NET template engine based on the Liquid template language.项目地址:https://gitcode.com/gh_mirrors/fl/fluid