Deprecate the _internal/some-template construct

[bep]

In Hugo v0.146.0 we revised all things templates in Hugo. While we made it so {{ template "_internal/twitter_cards.html" . }} and similar still works, we have since removed it from the documentation. The Twitter cards example needs to be loaded using the partial func: {{ partial "twitter_cards.html" . }}

This issue is about deprecating the use of the _internal/ template namespace and eventually remove it.

[tastapod]

Will the _internal/alias.html template still be available? I'm using it for custom redirects and it rocks!

I just tried partial "alias.html" ... in v0.145 and it blew up with a partial not found error.

[bep]

Will the _internal/alias.html template still be available? I

Yes, but not as a partial. I have never thought about anyone using that template the way you do. I have gone to great length to make all of this backwards compatible, but I'm not adjusting the logic for your case. I suggest you copy the alias template into your theme/project.

That said, I guess you could do:

{{- template "alias.html" (dict "Permalink" .Params.target) -}}

And it would work (and keep on working).

[tastapod]

Oh cool, so it will be on the template search path? That's good enough for me 😄

[bep]

Oh cool, so it will be on the template search path? That's good enough for me 😄

Yes.

The main thing about this particular issue is to eventually remove the confusing _internal/ concept. We still have embedded/internal templates, but they don't have its own namespace.