github.com/kovansky/hugo@v0.92.3-0.20220224232819-63076e4ff19f/hugolib/page__new.go (about)

     1  // Copyright 2019 The Hugo Authors. All rights reserved.
     2  //
     3  // Licensed under the Apache License, Version 2.0 (the "License");
     4  // you may not use this file except in compliance with the License.
     5  // You may obtain a copy of the License at
     6  // http://www.apache.org/licenses/LICENSE-2.0
     7  //
     8  // Unless required by applicable law or agreed to in writing, software
     9  // distributed under the License is distributed on an "AS IS" BASIS,
    10  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    11  // See the License for the specific language governing permissions and
    12  // limitations under the License.
    13  
    14  package hugolib
    15  
    16  import (
    17  	"html/template"
    18  	"strings"
    19  
    20  	"go.uber.org/atomic"
    21  
    22  	"github.com/gohugoio/hugo/common/hugo"
    23  
    24  	"github.com/gohugoio/hugo/common/maps"
    25  
    26  	"github.com/gohugoio/hugo/output"
    27  
    28  	"github.com/gohugoio/hugo/lazy"
    29  
    30  	"github.com/gohugoio/hugo/resources/page"
    31  )
    32  
    33  func newPageBase(metaProvider *pageMeta) (*pageState, error) {
    34  	if metaProvider.s == nil {
    35  		panic("must provide a Site")
    36  	}
    37  
    38  	s := metaProvider.s
    39  
    40  	ps := &pageState{
    41  		pageOutput:                        nopPageOutput,
    42  		pageOutputTemplateVariationsState: atomic.NewUint32(0),
    43  		pageCommon: &pageCommon{
    44  			FileProvider:            metaProvider,
    45  			AuthorProvider:          metaProvider,
    46  			Scratcher:               maps.NewScratcher(),
    47  			store:                   maps.NewScratch(),
    48  			Positioner:              page.NopPage,
    49  			InSectionPositioner:     page.NopPage,
    50  			ResourceMetaProvider:    metaProvider,
    51  			ResourceParamsProvider:  metaProvider,
    52  			PageMetaProvider:        metaProvider,
    53  			RelatedKeywordsProvider: metaProvider,
    54  			OutputFormatsProvider:   page.NopPage,
    55  			ResourceTypeProvider:    pageTypesProvider,
    56  			MediaTypeProvider:       pageTypesProvider,
    57  			RefProvider:             page.NopPage,
    58  			ShortcodeInfoProvider:   page.NopPage,
    59  			LanguageProvider:        s,
    60  			pagePages:               &pagePages{},
    61  
    62  			InternalDependencies: s,
    63  			init:                 lazy.New(),
    64  			m:                    metaProvider,
    65  			s:                    s,
    66  		},
    67  	}
    68  
    69  	siteAdapter := pageSiteAdapter{s: s, p: ps}
    70  
    71  	ps.pageMenus = &pageMenus{p: ps}
    72  	ps.PageMenusProvider = ps.pageMenus
    73  	ps.GetPageProvider = siteAdapter
    74  	ps.GitInfoProvider = ps
    75  	ps.TranslationsProvider = ps
    76  	ps.ResourceDataProvider = &pageData{pageState: ps}
    77  	ps.RawContentProvider = ps
    78  	ps.ChildCareProvider = ps
    79  	ps.TreeProvider = pageTree{p: ps}
    80  	ps.Eqer = ps
    81  	ps.TranslationKeyProvider = ps
    82  	ps.ShortcodeInfoProvider = ps
    83  	ps.AlternativeOutputFormatsProvider = ps
    84  
    85  	return ps, nil
    86  }
    87  
    88  func newPageBucket(p *pageState) *pagesMapBucket {
    89  	return &pagesMapBucket{owner: p, pagesMapBucketPages: &pagesMapBucketPages{}}
    90  }
    91  
    92  func newPageFromMeta(
    93  	n *contentNode,
    94  	parentBucket *pagesMapBucket,
    95  	meta map[string]interface{},
    96  	metaProvider *pageMeta) (*pageState, error) {
    97  	if metaProvider.f == nil {
    98  		metaProvider.f = page.NewZeroFile(metaProvider.s.LogDistinct)
    99  	}
   100  
   101  	ps, err := newPageBase(metaProvider)
   102  	if err != nil {
   103  		return nil, err
   104  	}
   105  
   106  	bucket := parentBucket
   107  
   108  	if ps.IsNode() {
   109  		ps.bucket = newPageBucket(ps)
   110  	}
   111  
   112  	if meta != nil || parentBucket != nil {
   113  		if err := metaProvider.setMetadata(bucket, ps, meta); err != nil {
   114  			return nil, ps.wrapError(err)
   115  		}
   116  	}
   117  
   118  	if err := metaProvider.applyDefaultValues(n); err != nil {
   119  		return nil, err
   120  	}
   121  
   122  	ps.init.Add(func() (interface{}, error) {
   123  		pp, err := newPagePaths(metaProvider.s, ps, metaProvider)
   124  		if err != nil {
   125  			return nil, err
   126  		}
   127  
   128  		makeOut := func(f output.Format, render bool) *pageOutput {
   129  			return newPageOutput(ps, pp, f, render)
   130  		}
   131  
   132  		shouldRenderPage := !ps.m.noRender()
   133  
   134  		if ps.m.standalone {
   135  			ps.pageOutput = makeOut(ps.m.outputFormats()[0], shouldRenderPage)
   136  		} else {
   137  			outputFormatsForPage := ps.m.outputFormats()
   138  
   139  			// Prepare output formats for all sites.
   140  			// We do this even if this page does not get rendered on
   141  			// its own. It may be referenced via .Site.GetPage and
   142  			// it will then need an output format.
   143  			ps.pageOutputs = make([]*pageOutput, len(ps.s.h.renderFormats))
   144  			created := make(map[string]*pageOutput)
   145  			for i, f := range ps.s.h.renderFormats {
   146  				po, found := created[f.Name]
   147  				if !found {
   148  					render := shouldRenderPage
   149  					if render {
   150  						_, render = outputFormatsForPage.GetByName(f.Name)
   151  					}
   152  					po = makeOut(f, render)
   153  					created[f.Name] = po
   154  				}
   155  				ps.pageOutputs[i] = po
   156  			}
   157  		}
   158  
   159  		if err := ps.initCommonProviders(pp); err != nil {
   160  			return nil, err
   161  		}
   162  
   163  		return nil, nil
   164  	})
   165  
   166  	return ps, err
   167  }
   168  
   169  // Used by the legacy 404, sitemap and robots.txt rendering
   170  func newPageStandalone(m *pageMeta, f output.Format) (*pageState, error) {
   171  	m.configuredOutputFormats = output.Formats{f}
   172  	m.standalone = true
   173  	p, err := newPageFromMeta(nil, nil, nil, m)
   174  	if err != nil {
   175  		return nil, err
   176  	}
   177  
   178  	if err := p.initPage(); err != nil {
   179  		return nil, err
   180  	}
   181  
   182  	return p, nil
   183  }
   184  
   185  type pageDeprecatedWarning struct {
   186  	p *pageState
   187  }
   188  
   189  func (p *pageDeprecatedWarning) IsDraft() bool          { return p.p.m.draft }
   190  func (p *pageDeprecatedWarning) Hugo() hugo.Info        { return p.p.s.Info.Hugo() }
   191  func (p *pageDeprecatedWarning) LanguagePrefix() string { return p.p.s.Info.LanguagePrefix }
   192  func (p *pageDeprecatedWarning) GetParam(key string) interface{} {
   193  	return p.p.m.params[strings.ToLower(key)]
   194  }
   195  
   196  func (p *pageDeprecatedWarning) RSSLink() template.URL {
   197  	f := p.p.OutputFormats().Get("RSS")
   198  	if f == nil {
   199  		return ""
   200  	}
   201  	return template.URL(f.Permalink())
   202  }
   203  
   204  func (p *pageDeprecatedWarning) URL() string {
   205  	if p.p.IsPage() && p.p.m.urlPaths.URL != "" {
   206  		// This is the url set in front matter
   207  		return p.p.m.urlPaths.URL
   208  	}
   209  	// Fall back to the relative permalink.
   210  	return p.p.RelPermalink()
   211  }