mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-25 03:13:24 +00:00
e4d6ec94b5
In Hugo 0.90.0 we introduced remote support in `resources.Get`.
But with remote resources comes with a higher chance of failing a build (network issues, remote server down etc.).
Before this commit we always failed the build on any unexpected error.
This commit allows the user to check for any error (and potentially fall back to a default local resource):
```htmlbars
{{ $result := resources.Get "https://gohugo.io/img/hugo-logo.png" }}
{{ with $result }}
{{ if .Err }}
{{/* log the error, insert a default image etc. *}}
{{ else }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
{{ end }}
```
Note that the default behaviour is still to fail the build, but we will delay that error until you start using the `Resource`.
Fixes #9529
503 lines
8.2 KiB
Go
503 lines
8.2 KiB
Go
// Copyright 2019 The Hugo Authors. All rights reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
// Package page contains the core interfaces and types for the Page resource,
|
|
// a core component in Hugo.
|
|
package page
|
|
|
|
import (
|
|
"html/template"
|
|
"time"
|
|
|
|
"github.com/gohugoio/hugo/identity"
|
|
|
|
"github.com/gohugoio/hugo/hugofs/files"
|
|
"github.com/gohugoio/hugo/tpl"
|
|
|
|
"github.com/gohugoio/hugo/hugofs"
|
|
|
|
"github.com/bep/gitmap"
|
|
"github.com/gohugoio/hugo/navigation"
|
|
|
|
"github.com/gohugoio/hugo/common/hugo"
|
|
"github.com/gohugoio/hugo/common/maps"
|
|
"github.com/gohugoio/hugo/source"
|
|
|
|
"github.com/gohugoio/hugo/config"
|
|
"github.com/gohugoio/hugo/langs"
|
|
"github.com/gohugoio/hugo/media"
|
|
"github.com/gohugoio/hugo/related"
|
|
"github.com/gohugoio/hugo/resources/resource"
|
|
)
|
|
|
|
var (
|
|
NopPage Page = new(nopPage)
|
|
NilPage *nopPage
|
|
)
|
|
|
|
// PageNop implements Page, but does nothing.
|
|
type nopPage int
|
|
|
|
func (p *nopPage) Err() error {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Aliases() []string {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Sitemap() config.Sitemap {
|
|
return config.Sitemap{}
|
|
}
|
|
|
|
func (p *nopPage) Layout() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) RSSLink() template.URL {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Author() Author {
|
|
return Author{}
|
|
}
|
|
|
|
func (p *nopPage) Authors() AuthorList {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) AllTranslations() Pages {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) LanguagePrefix() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) AlternativeOutputFormats() OutputFormats {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) BaseFileName() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) BundleType() files.ContentClass {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Content() (interface{}, error) {
|
|
return "", nil
|
|
}
|
|
|
|
func (p *nopPage) ContentBaseName() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) CurrentSection() Page {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Data() interface{} {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Date() (t time.Time) {
|
|
return
|
|
}
|
|
|
|
func (p *nopPage) Description() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) RefFrom(argsm map[string]interface{}, source interface{}) (string, error) {
|
|
return "", nil
|
|
}
|
|
|
|
func (p *nopPage) RelRefFrom(argsm map[string]interface{}, source interface{}) (string, error) {
|
|
return "", nil
|
|
}
|
|
|
|
func (p *nopPage) Dir() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Draft() bool {
|
|
return false
|
|
}
|
|
|
|
func (p *nopPage) Eq(other interface{}) bool {
|
|
return p == other
|
|
}
|
|
|
|
func (p *nopPage) ExpiryDate() (t time.Time) {
|
|
return
|
|
}
|
|
|
|
func (p *nopPage) Ext() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Extension() string {
|
|
return ""
|
|
}
|
|
|
|
var nilFile *source.FileInfo
|
|
|
|
func (p *nopPage) File() source.File {
|
|
return nilFile
|
|
}
|
|
|
|
func (p *nopPage) FileInfo() hugofs.FileMetaInfo {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Filename() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) FirstSection() Page {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) FuzzyWordCount() int {
|
|
return 0
|
|
}
|
|
|
|
func (p *nopPage) GetPage(ref string) (Page, error) {
|
|
return nil, nil
|
|
}
|
|
|
|
func (p *nopPage) GetPageWithTemplateInfo(info tpl.Info, ref string) (Page, error) {
|
|
return nil, nil
|
|
}
|
|
|
|
func (p *nopPage) GetParam(key string) interface{} {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) GetTerms(taxonomy string) Pages {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) GitInfo() *gitmap.GitInfo {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) HasMenuCurrent(menuID string, me *navigation.MenuEntry) bool {
|
|
return false
|
|
}
|
|
|
|
func (p *nopPage) HasShortcode(name string) bool {
|
|
return false
|
|
}
|
|
|
|
func (p *nopPage) Hugo() (h hugo.Info) {
|
|
return
|
|
}
|
|
|
|
func (p *nopPage) InSection(other interface{}) (bool, error) {
|
|
return false, nil
|
|
}
|
|
|
|
func (p *nopPage) IsAncestor(other interface{}) (bool, error) {
|
|
return false, nil
|
|
}
|
|
|
|
func (p *nopPage) IsDescendant(other interface{}) (bool, error) {
|
|
return false, nil
|
|
}
|
|
|
|
func (p *nopPage) IsDraft() bool {
|
|
return false
|
|
}
|
|
|
|
func (p *nopPage) IsHome() bool {
|
|
return false
|
|
}
|
|
|
|
func (p *nopPage) IsMenuCurrent(menuID string, inme *navigation.MenuEntry) bool {
|
|
return false
|
|
}
|
|
|
|
func (p *nopPage) IsNode() bool {
|
|
return false
|
|
}
|
|
|
|
func (p *nopPage) IsPage() bool {
|
|
return false
|
|
}
|
|
|
|
func (p *nopPage) IsSection() bool {
|
|
return false
|
|
}
|
|
|
|
func (p *nopPage) IsTranslated() bool {
|
|
return false
|
|
}
|
|
|
|
func (p *nopPage) Keywords() []string {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Kind() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Lang() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Language() *langs.Language {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Lastmod() (t time.Time) {
|
|
return
|
|
}
|
|
|
|
func (p *nopPage) Len() int {
|
|
return 0
|
|
}
|
|
|
|
func (p *nopPage) LinkTitle() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) LogicalName() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) MediaType() (m media.Type) {
|
|
return
|
|
}
|
|
|
|
func (p *nopPage) Menus() (m navigation.PageMenus) {
|
|
return
|
|
}
|
|
|
|
func (p *nopPage) Name() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Next() Page {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) OutputFormats() OutputFormats {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Pages() Pages {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) RegularPages() Pages {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) RegularPagesRecursive() Pages {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Paginate(seq interface{}, options ...interface{}) (*Pager, error) {
|
|
return nil, nil
|
|
}
|
|
|
|
func (p *nopPage) Paginator(options ...interface{}) (*Pager, error) {
|
|
return nil, nil
|
|
}
|
|
|
|
func (p *nopPage) Param(key interface{}) (interface{}, error) {
|
|
return nil, nil
|
|
}
|
|
|
|
func (p *nopPage) Params() maps.Params {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Page() Page {
|
|
return p
|
|
}
|
|
|
|
func (p *nopPage) Parent() Page {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Path() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Permalink() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Plain() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) PlainWords() []string {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Prev() Page {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) PublishDate() (t time.Time) {
|
|
return
|
|
}
|
|
|
|
func (p *nopPage) PrevInSection() Page {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) NextInSection() Page {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) PrevPage() Page {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) NextPage() Page {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) RawContent() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) ReadingTime() int {
|
|
return 0
|
|
}
|
|
|
|
func (p *nopPage) Ref(argsm map[string]interface{}) (string, error) {
|
|
return "", nil
|
|
}
|
|
|
|
func (p *nopPage) RelPermalink() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) RelRef(argsm map[string]interface{}) (string, error) {
|
|
return "", nil
|
|
}
|
|
|
|
func (p *nopPage) Render(layout ...string) (template.HTML, error) {
|
|
return "", nil
|
|
}
|
|
|
|
func (p *nopPage) RenderString(args ...interface{}) (template.HTML, error) {
|
|
return "", nil
|
|
}
|
|
|
|
func (p *nopPage) ResourceType() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Resources() resource.Resources {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Scratch() *maps.Scratch {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) RelatedKeywords(cfg related.IndexConfig) ([]related.Keyword, error) {
|
|
return nil, nil
|
|
}
|
|
|
|
func (p *nopPage) Section() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Sections() Pages {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) SectionsEntries() []string {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) SectionsPath() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Site() Site {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Sites() Sites {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Slug() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) String() string {
|
|
return "nopPage"
|
|
}
|
|
|
|
func (p *nopPage) Summary() template.HTML {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) TableOfContents() template.HTML {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Title() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) TranslationBaseName() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) TranslationKey() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Translations() Pages {
|
|
return nil
|
|
}
|
|
|
|
func (p *nopPage) Truncated() bool {
|
|
return false
|
|
}
|
|
|
|
func (p *nopPage) Type() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) URL() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) UniqueID() string {
|
|
return ""
|
|
}
|
|
|
|
func (p *nopPage) Weight() int {
|
|
return 0
|
|
}
|
|
|
|
func (p *nopPage) WordCount() int {
|
|
return 0
|
|
}
|
|
|
|
func (p *nopPage) GetIdentity() identity.Identity {
|
|
return identity.NewPathIdentity("content", "foo/bar.md")
|
|
}
|