Hello,

I understand that customising existing templates is possible by using the /Templates/ folder at the root of a project. This permits overriding the generated code for templates that already exist.

But does it support adding completely new .cshtml files (e.g.: the 'DanGenerator' folder in the first screenshot, with the 'DanController.cshtml' and 'DanView.cshtml' files) and then using those?

I'm having trouble figuring this out, and there's a few unanswered Stack Overflow questions pertaining to this.
However the documentation in this GitHub repository seems to be concerned only with scaffolding entire project templates.

These screenshots depict what I'm aiming to achieve:

Thank you for your help.

Kind regards,
Daniel

Both links in the README are 404, and I can't find the files anywhere in the repo.

Has the installation process for dotnet new3 changed?

Is there a way to make a parameter defaultValue conditional/based on an expression?

I want to have

		"fileToRename": {
			"type": "parameter",
			"datatype": "string",
                        "defaultValue": "if(boolParam) then TheSpecialFile.txt else TheFile.txt",
			"replaces": "TheFile.txt",
			"fileRename": "TheFile.txt"
		},

Creates a solution file:

dotnet new sln

From looking at the source this also supports other args. I can't find where dotnet new sln is:

dotnet new sln add -MyProject

Can you make a template that can act as just a generator for files? Or like the above you would need something like a COnsole app to invoke from.

I would like to create a dotnet new for generating classes and others.

See dotnet/templating#1213 (comment)

We should add a sample showing how coalesce works.

The first samples (basic, etc) is a copy of aspnet web template.
While is good, there are lot of useless files, is really hard to understand what's needed for THE TEMPLATE, and what's there just because is an aspnet core app.

These are the first templates you read, and are really complex.

Is possibile to use normal (hello world) console app an lib there too?

I'm looking to use dotnet new to help template both old VS solutions and new dotnet type projects.

See also: VS Solution File

When manipulating an .sln for inclusion of OPTIONAL projects (i.e. giving the user the option for sub projects such as Foo.Data/Foo.Data.csproj) the .sln file would need its references updated/omitted.

In yeoman/npm

In yeoman/npm this is handled with inline code.

	GlobalSection(ProjectConfigurationPlatforms) = postSolution<% for(var project in projects) { %>
		{<%= projects[project].projectGuid %>}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
		{<%= projects[project].projectGuid %>}.Debug|Any CPU.Build.0 = Debug|Any CPU
		{<%= projects[project].projectGuid %>}.Release|Any CPU.ActiveCfg = Release|Any CPU
		{<%= projects[project].projectGuid %>}.Release|Any CPU.Build.0 = Release|Any CPU<% } %>

Some examples at https://github.com/dotnet/templating/blob/rel/vs2017/3-Preview2/template_feed/Microsoft.DotNet.Web.ProjectTemplates.2.0/content/StarterWeb-CSharp/.template.config/template.json#L66

We should have a sample demonstrating how to use onlyIf

We have https://github.com/ligershark/sidewafflev2, but what are the tangible steps for packaging up a group of templates as a template pack for Visual Studio 2017?

Please provide an example of how the templates can be installed using VSIX and integrated/used from within VisualStudio 2017 & 2019; file->new project etc. including adding templates to the ASP.NET Core Web Application dialog

We should have a sample showing how to create computed symbols and then use those in files for replacments.

Related: dotnet/templating#905

All postActions.actionId Guids should be documented to make it easy for people to find what they are looking for. 👍

Edit: Just found the page. Would be great if we could link to https://github.com/dotnet/templating/wiki/Post-Action-Registry from the template.json documentation under the actionId heading (I know it is currently under postActions).

I would like to be able to include optional nuget packages based on parameters, but can't figure out how to do that

I'm not aware of any documentation and/or samples on how to package up a group of templates as a nupkg (though we do have documentation on actually installing from a nupkg in the dotnet/templating README).

We should create a sample which shows how to create an extra project as an option. For example; a class library with an optional unit test project. Or a web front end with an optional web api backend.

Hi,

Would you be able to provide an example of turning off safe namespace e.g. stopping replacing '.' with '_'?

Thanks!

Is possibile to create package the template in lot of ways (nuget, nuspec, csproj, prj)

The best one i know atm is doing just with a .proj (any extension is ok), like https://github.com/fable-compiler/Fable/blob/master/src/templates/simple/Fable.Template.proj

so like Fable.Template.proj (note the .proj extension, neutral, not csproj, so doesnt mess with compiler targets)

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>

    <!-- fill some nuget package props (optional) -->
    <Description>Simple Fable App</Description>
    <Authors>Alfonso Garcia-Caro</Authors>
    <!-- fill nuget package version (optional) -->
    <Version>0.2.1</Version>

    <!-- this is a package -->
    <PackageType>Template</PackageType>

    <!-- cruft need to avoid building and making dotnet sdk happy -->
    <PackProjectInputFile>$(MSBuildProjectFullPath)</PackProjectInputFile>
    <NoBuild>true</NoBuild>
    <IncludeBuildOutput>false</IncludeBuildOutput>
    <TargetFramework>netstandard1.0</TargetFramework>
    <DisableImplicitFrameworkReferences>true</DisableImplicitFrameworkReferences>

  </PropertyGroup>
  <PropertyGroup>
    <!-- simple way to exclude things (optional but nice) -->
    <ExcludeFromPackage>
        Content/node_modules/**/*;
        Content/packages/**/*;
        Content/public/bundle.js*;
        Content/bin/**/*;
        Content/obj/**/*;
    </ExcludeFromPackage>
</PropertyGroup>
  <ItemGroup>
    <Content Include="Content/**/*" Exclude="$(ExcludeFromPackage)" >
        <PackagePath>Content\</PackagePath>
    </Content>
  </ItemGroup>
</Project>

Problem

I need to be able to optionally add/remove NuGet packages from a project based on a symbol's value. I would love if we had a sample that accomplished this, as I think it's a somewhat-common ask of a templating engine.

Potential Solutions

Outside of having multiple packages.config, what is a sufficient solution? You can't really markup a packages.config with symbols if you want the project to still be able to restore NuGets when opened.

Add a sample showing how to rename a file

Is it possible for a template parameter value to have a regex validation attached to prevent/validate the values supplied; an or display a validation error if/when the value supplied violates the regex condition?

If so can you please point towards references/samples?

Add a few samples showing Value Forms

Hi,

I'm creating a template with 2 projects (src and test) and would like to publish this as a nuget package.
I understand that it is easy modifying the .csproj adding the nuget config, but what about the whole solution directory?

Here is how my template base folder looks like:

src (webapi project)
terraform
tests (xunit project)
.dockerignore
.editorconfig
.gitignore
.template.config
azure-pipelines-pr.yml
azure-pipelines.yml
MySolution.sln
README.md

1. Clone the repo
2. cd dotnet-template-samples/01-basic-template/MyProject.Con
3. dotnet new -i .

Fails to install the template, just gives me about a hundred lines of warnings like:

Restoring packages for /Users/user1/.templateengine/dotnetcli/v2.0.3/scratch/restore.csproj...
/usr/local/share/dotnet/sdk/2.0.3/NuGet.targets(102,5): warning : The folder '/usr/local/share/dotnet/sdk/NuGetFallbackFolder/.tools' contains an invalid version. [/Users/user1/.templateengine/dotnetcli/v2.0.3/scratch/restore.csproj]

and then at the end it gives me the error:

/Users/user1/.templateengine/dotnetcli/v2.0.3/scratch/restore.csproj : error NU1101: Unable to find package .. No packages exist with this id in source(s): /usr/local/share/dotnet/sdk/NuGetFallbackFolder, nuget.org
  Generating MSBuild file /Users/user1/.templateengine/dotnetcli/v2.0.3/scratch/obj/restore.csproj.nuget.g.props.
  Generating MSBuild file /Users/user1/.templateengine/dotnetcli/v2.0.3/scratch/obj/restore.csproj.nuget.g.targets.
  Restore failed in 596.09 ms for /Users/user1/.templateengine/dotnetcli/v2.0.3/scratch/restore.csproj.

This repros on both Windows and macOS for me.

compy386:MyProject.Con user1$ dotnet --info
.NET Command Line Tools (2.0.3)

Product Information:
 Version:            2.0.3
 Commit SHA-1 hash:  eb1d5ee318

Runtime Environment:
 OS Name:     Mac OS X
 OS Version:  10.12
 OS Platform: Darwin
 RID:         osx.10.12-x64
 Base Path:   /usr/local/share/dotnet/sdk/2.0.3/

Microsoft .NET Core Shared Framework Host

  Version  : 2.0.3
  Build    : a9190d4a75f4a982ae4b4fa8d1a24526566c69df

I want to prefix my namespace with some custom namespaces e.g. Template.MyProject (where Template is automatically replaced with the project name) when created with the name Test and with parameter "namespacePrefix" being CompanyName, the project would be Test.MyProject but the namespace would be CompanyName.Test.MyProject

Create a template which is https://github.com/dotnet/dotnet-template-samples/tree/master/05-multi-project plus a solution file.

Since the unit test is optional this will also show optional content in the .sln file.

See #20 (comment)

We should update the templates to use the same naming patterns.

Add primaryOutputs to all templates

We should create a folder that has a bunch of files and we demonstrate replacements.
This is to support the doc found at https://github.com/dotnet/templating/wiki/Reference-for-comment-syntax

See dotnet/templating#1238 for details.