Deprecate .Page.Path when backed by a file

[bep]

This is preparing for a bigger 0.93.0 release which introduces a concept of a canonical content path.

The current implementation looks like this:

func (p *pageMeta) Path() string {
	if !p.File().IsZero() {
		return p.File().Path()
	}
	return p.SectionsPath()
}

I know there are many that uses .Path to construct links to the file on GitHub etc., and I suspect many implementations do not consider the case where the Page is not backed by a file.

In 0.92.0 you will get a deprecation WARNING if the Page is backed by a file with the advice of rewriting it to something ala:

{{ $path := "" }}
{{ with .File }}
  {{ $path = .Path }}
{{ else }}
  {{ $path = .Path }}
{{ end }}

[github-actions]

This issue has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.