Orchard Core 文档翻译 （二）代码生成模板 Code Generation Templates

Code Generation Templates

翻译原文：https://www.cnblogs.com/Qbit/p/9746457.html转载请注明出处

Orchard Core Templates使用dotnet新模板配置从命令shell创建新网站，主题和模块。

有关dotnet new的更多信息，请访问：

https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-new

安装Orchard Cms模板

安装.NET Core SDK后，键入以下命令以安装用于创建Orchard Core Cms Web应用程序的模板。

dotnet new -i OrchardCore.Cms.Templates::1.0.0-beta2-*

这将使用最稳定的Orchard Core版本。 为了使用Orchard Core的最新dev分支，可以使用以下命令：

dotnet new -i OrchardCore.Cms.Templates::1.0.0-beta2-* --nuget-source https://www.myget.org/F/orchardcore-preview/api/v3/index.json

创建一个新网站

From Command Shell (automated way)

Generate an Orchard Cms Web Application

dotnet new occms   

使用此命令可以忽略日志记录：

dotnet new occms --nlog false

使用Visual Studio（手动方式）

启动Visual Studio，通过创建新的ASP.NET Core Web应用程序创建新的解决方案文件（.sln）：:

现在我们创建了一个新的Web应用程序，我们需要添加适当的依赖项，以便将这个新的Web应用程序作为Orchard Core应用程序进行定位。

原文：Now that we created a new Web Application we need to add proper dependencies so that this new Web Application be targetted as an Orchard Core application.

　　

请参阅 Adding Orchard Core Nuget Feed

最后，我们需要在Startup.cs文件中注册Orchard CMS服务，如下所示：

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.DependencyInjection;
 
namespace MyNewWebsite
{
    public class Startup
    {
        // This method gets called by the runtime. Use this method to add services to the container.
        // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddOrchardCms();
        }
 
        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
 
            app.UseOrchardCore();
        }
    }
}

创建一个新的module

New module from Command Shell (automated way)

Module commands

dotnet new ocmodule -n ModuleName.OrchardCore

dotnet new ocmodule -n ModuleName.OrchardCore --PartName TestPart
 
dotnet new ocmodule -n ModuleName.OrchardCore --PartName TestPart --AddPart true

New module from Visual Studio (manual way)

启动Visual Studio，打开Orchard Core解决方案文件（.sln），选择OrchardCore.Modules文件夹，右键单击并选择“添加 - >新项目”并创建一个新的.NET Standard Class Library：

为了将这个新类库标记为Orchard模块，我们现在需要引用OrchardCore.Module.Targets Nuget包。

See adding Orchard Core Nuget Feed

这些“* .Targets”Nuget包中的每一个都用于将类库标记为特定的Orchard Core功能。 OrchardCore.Module.Targets是我们现在感兴趣的。 我们将新的类库标记为模块，方法是将OrchardCore.Module.Targets添加为依赖项。 为此，您需要右键单击MyModule.OrchardCore项目并选择“Manage Nuget Packages”选项。 要在Nuget Package Manager中查找软件包，您需要选中“include prerelease”并确保您已选择我们之前添加的Orchard Core Feed。 找到它后，单击Version：Latest prerelease x.x.x.x旁边右侧面板上的Install按钮

 

完成后，您的新模块将如下所示

:

要让Orchard Core识别此模块，它现在需要一个Manifest.cs文件。 这是该文件的一个示例:

using OrchardCore.Modules.Manifest;
 
[assembly: Module(
    Name = "TemplateModule.OrchardCore",
    Author = "The Orchard Team",
    Website = "http://orchardproject.net",
    Version = "0.0.1",
    Description = "Template module."
)]

要启动此模块，我们现在需要将Startup.cs文件添加到新模块中。 以此文件为例:
OrchardCore.Templates.Module/Startup.cs

最后一步是将我们的新模块添加到OrchardCore.Cms.Web项目中作为参考，将其作为我们网站模块的一部分包含在内。 之后，您应该已准备好开始构建自定义模块。 你可以参考我们的 template module 例如，基本上通常需要什么。

原文：
For this module to start we now will need to add a Startup.cs file to our new module. See this file as an example:
OrchardCore.Templates.Module/Startup.cs
 
Last step is to add our new module to the OrchardCore.Cms.Web project as a reference for including it as part as our website modules. After that, you should be all set for starting building your custom module. You can refer to our template module for examples of what's basically needed normally.

　　

Create a new theme

New theme From Command Shell (automated way)

Theme commands

dotnet new octheme -n "ThemeName.OrchardCore"

New theme from Visual Studio (manual way)

应该是与模块相同的过程，但我们需要引用OrchardCore.Theme.Targets和Manifest.cs文件略有不同：

using OrchardCore.DisplayManagement.Manifest;
 
[assembly: Theme(
    Name = "TemplateTheme.OrchardCore",
    Author = "The Orchard Team",
    Website = "https://orchardproject.net",
    Version = "0.0.1",
    Description = "The TemplateTheme."
)]

Adding Orchard Core Nuget Feed

为了能够使用Visual Studio中的开发源，请打开Nuget Package Manager - > Package Manager Settings下的Tools菜单。 引用网址是 https://www.myget.org/F/orchardcore-preview/api/v3/index.json

NextPrevious