hugolib

package
v0.112.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 23, 2023 License: Apache-2.0 Imports: 89 Imported by: 84

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func DefaultConfig added in v0.112.0

func DefaultConfig() *allconfig.Config

DefaultConfig returns the default configuration.

func ExampleConfig added in v0.112.0

func ExampleConfig() (*allconfig.Config, error)

ExampleConfig returns the some example configuration for documentation.

Types

type BuildCfg

type BuildCfg struct {
	// Reset site state before build. Use to force full rebuilds.
	ResetState bool
	// Skip rendering. Useful for testing.
	SkipRender bool

	// This is a partial re-render of some selected pages. This means
	// we should skip most of the processing.
	PartialReRender bool

	// Set in server mode when the last build failed for some reason.
	ErrRecovery bool

	// Recently visited URLs. This is used for partial re-rendering.
	RecentlyVisited map[string]bool

	// Can be set to build only with a sub set of the content source.
	ContentInclusionFilter *glob.FilenameFilter

	// Set when the buildlock is already acquired (e.g. the archetype content builder).
	NoBuildLock bool
	// contains filtered or unexported fields
}

BuildCfg holds build options used to, as an example, skip the render step.

type ContentFactory added in v0.89.0

type ContentFactory struct {
	// contains filtered or unexported fields
}

ContentFactory creates content files from archetype templates.

func NewContentFactory added in v0.89.0

func NewContentFactory(h *HugoSites) ContentFactory

NewContentFactory creates a new ContentFactory for h.

func (ContentFactory) ApplyArchetypeFilename added in v0.95.0

func (f ContentFactory) ApplyArchetypeFilename(w io.Writer, p page.Page, archetypeKind, archetypeFilename string) error

ApplyArchetypeFilename archetypeFilename to w as a template using the given Page p as the foundation for the data context.

func (ContentFactory) ApplyArchetypeTemplate added in v0.95.0

func (f ContentFactory) ApplyArchetypeTemplate(w io.Writer, p page.Page, archetypeKind, templateSource string) error

ApplyArchetypeTemplate templateSource to w as a template using the given Page p as the foundation for the data context.

func (ContentFactory) CreateContentPlaceHolder added in v0.89.0

func (f ContentFactory) CreateContentPlaceHolder(filename string, force bool) (string, error)

CreateContentPlaceHolder creates a content placeholder file inside the best matching content directory.

func (ContentFactory) SectionFromFilename added in v0.89.0

func (f ContentFactory) SectionFromFilename(filename string) (string, error)

type HugoSites

type HugoSites struct {
	Sites []*Site

	Configs *allconfig.Configs

	*deps.Deps

	// Keeps track of bundle directories and symlinks to enable partial rebuilding.
	ContentChanges *contentChangeMap
	// contains filtered or unexported fields
}

HugoSites represents the sites to build. Each site represents a language.

func NewHugoSites added in v0.20.1

func NewHugoSites(cfg deps.DepsCfg) (*HugoSites, error)

NewHugoSites creates HugoSites from the given config.

func (*HugoSites) Build

func (h *HugoSites) Build(config BuildCfg, events ...fsnotify.Event) error

Build builds all sites. If filesystem events are provided, this is considered to be a potential partial rebuild.

func (*HugoSites) Data added in v0.55.0

func (h *HugoSites) Data() map[string]any

func (HugoSites) Done added in v0.55.0

func (f HugoSites) Done() <-chan bool

func (HugoSites) FatalError added in v0.55.0

func (f HugoSites) FatalError(err error)

FatalError error is used in some rare situations where it does not make sense to continue processing, to abort as soon as possible and log the error.

func (*HugoSites) GC added in v0.32.1

func (h *HugoSites) GC() (int, error)

GC requires a build first and must run on it's own. It is not thread safe.

func (*HugoSites) GetContentPage added in v0.25.1

func (h *HugoSites) GetContentPage(filename string) page.Page

GetContentPage finds a Page with content given the absolute filename. Returns nil if none found.

func (HugoSites) IncrContentRender added in v0.63.0

func (h HugoSites) IncrContentRender()

func (HugoSites) IncrPageRender added in v0.92.2

func (h HugoSites) IncrPageRender()

func (*HugoSites) LanguageSet added in v0.49.1

func (h *HugoSites) LanguageSet() map[string]int

TODO(bep) consolidate

func (*HugoSites) NumLogErrors added in v0.42.1

func (h *HugoSites) NumLogErrors() int

func (*HugoSites) Pages

func (h *HugoSites) Pages() page.Pages

Pages returns all pages for all sites.

func (*HugoSites) PrintProcessingStats added in v0.32.1

func (h *HugoSites) PrintProcessingStats(w io.Writer)

func (*HugoSites) ShouldSkipFileChangeEvent added in v0.78.0

func (h *HugoSites) ShouldSkipFileChangeEvent(ev fsnotify.Event) bool

ShouldSkipFileChangeEvent allows skipping filesystem event early before the build is started.

type IntegrationTestBuilder added in v0.92.2

type IntegrationTestBuilder struct {
	*qt.C

	H *HugoSites

	Cfg IntegrationTestConfig

	GCCount int
	// contains filtered or unexported fields
}

IntegrationTestBuilder is a (partial) rewrite of sitesBuilder. The main problem with the "old" one was that it was that the test data was often a little hidden, so it became hard to look at a test and determine what it should do, especially coming back to the test after a year or so.

func NewIntegrationTestBuilder added in v0.92.2

func NewIntegrationTestBuilder(conf IntegrationTestConfig) *IntegrationTestBuilder

func (*IntegrationTestBuilder) AddFiles added in v0.92.2

func (s *IntegrationTestBuilder) AddFiles(filenameContent ...string) *IntegrationTestBuilder

func (*IntegrationTestBuilder) AssertBuildCountData added in v0.92.2

func (s *IntegrationTestBuilder) AssertBuildCountData(count int)

func (*IntegrationTestBuilder) AssertBuildCountGitInfo added in v0.92.2

func (s *IntegrationTestBuilder) AssertBuildCountGitInfo(count int)

func (*IntegrationTestBuilder) AssertBuildCountLayouts added in v0.92.2

func (s *IntegrationTestBuilder) AssertBuildCountLayouts(count int)

func (*IntegrationTestBuilder) AssertBuildCountTranslations added in v0.92.2

func (s *IntegrationTestBuilder) AssertBuildCountTranslations(count int)

func (*IntegrationTestBuilder) AssertDestinationExists added in v0.92.2

func (s *IntegrationTestBuilder) AssertDestinationExists(filename string, b bool)

func (*IntegrationTestBuilder) AssertFileContent added in v0.92.2

func (s *IntegrationTestBuilder) AssertFileContent(filename string, matches ...string)

func (*IntegrationTestBuilder) AssertFileContentExact added in v0.94.1

func (s *IntegrationTestBuilder) AssertFileContentExact(filename string, matches ...string)

func (*IntegrationTestBuilder) AssertIsFileError added in v0.92.2

func (s *IntegrationTestBuilder) AssertIsFileError(err error) herrors.FileError

func (*IntegrationTestBuilder) AssertLogContains added in v0.92.2

func (s *IntegrationTestBuilder) AssertLogContains(text string)

func (*IntegrationTestBuilder) AssertLogMatches added in v0.96.0

func (s *IntegrationTestBuilder) AssertLogMatches(expression string)

func (*IntegrationTestBuilder) AssertRenderCountContent added in v0.92.2

func (s *IntegrationTestBuilder) AssertRenderCountContent(count int)

func (*IntegrationTestBuilder) AssertRenderCountPage added in v0.92.2

func (s *IntegrationTestBuilder) AssertRenderCountPage(count int)

func (*IntegrationTestBuilder) Build added in v0.92.2

func (*IntegrationTestBuilder) BuildE added in v0.92.2

func (*IntegrationTestBuilder) EditFileReplace added in v0.92.2

func (s *IntegrationTestBuilder) EditFileReplace(filename string, replacementFunc func(s string) string) *IntegrationTestBuilder

func (*IntegrationTestBuilder) EditFiles added in v0.92.2

func (s *IntegrationTestBuilder) EditFiles(filenameContent ...string) *IntegrationTestBuilder

func (*IntegrationTestBuilder) FileContent added in v0.92.2

func (s *IntegrationTestBuilder) FileContent(filename string) string

func (*IntegrationTestBuilder) RemoveFiles added in v0.92.2

func (s *IntegrationTestBuilder) RemoveFiles(filenames ...string) *IntegrationTestBuilder

func (*IntegrationTestBuilder) RenameFile added in v0.92.2

func (s *IntegrationTestBuilder) RenameFile(old, new string) *IntegrationTestBuilder

type IntegrationTestConfig added in v0.92.2

type IntegrationTestConfig struct {
	T testing.TB

	// The files to use on txtar format, see
	// https://pkg.go.dev/golang.org/x/exp/cmd/txtar
	TxtarString string

	// COnfig to use as the base. We will also read the config from the txtar.
	BaseCfg config.Provider

	// Environment variables passed to the config loader.
	Environ []string

	// Whether to simulate server mode.
	Running bool

	// Will print the log buffer after the build
	Verbose bool

	LogLevel jww.Threshold

	// Whether it needs the real file system (e.g. for js.Build tests).
	NeedsOsFS bool

	// Whether to run GC after each build.
	RunGC bool

	// Do not remove the temp dir after the test.
	PrintAndKeepTempDir bool

	// Whether to run npm install before Build.
	NeedsNpmInstall bool

	WorkingDir string

	BuildCfg BuildCfg
}

type IntegrationTestDebugConfig added in v0.92.2

type IntegrationTestDebugConfig struct {
	Out io.Writer

	PrintDestinationFs bool
	PrintPagemap       bool

	PrefixDestinationFs string
	PrefixPagemap       string
}

type PageCollections

type PageCollections struct {
	// contains filtered or unexported fields
}

PageCollections contains the page collections for a site.

func (*PageCollections) AllPages

func (c *PageCollections) AllPages() page.Pages

AllPages returns all pages for all languages.

func (*PageCollections) AllRegularPages

func (c *PageCollections) AllRegularPages() page.Pages

AllRegularPages returns all regular pages for all languages.

func (*PageCollections) Pages

func (c *PageCollections) Pages() page.Pages

Pages returns all pages. This is for the current language only.

func (*PageCollections) RegularPages

func (c *PageCollections) RegularPages() page.Pages

RegularPages returns all the regular pages. This is for the current language only.

type Permalinker added in v0.20.1

type Permalinker interface {
	Permalink() string
	RelPermalink() string
}

Permalinker provides permalinks of both the relative and absolute kind.

type ShortcodeWithPage

type ShortcodeWithPage struct {
	Params        any
	Inner         template.HTML
	Page          page.Page
	Parent        *ShortcodeWithPage
	Name          string
	IsNamedParams bool

	// Zero-based ordinal in relation to its parent. If the parent is the page itself,
	// this ordinal will represent the position of this shortcode in the page content.
	Ordinal int
	// contains filtered or unexported fields
}

ShortcodeWithPage is the "." context in a shortcode template.

func (*ShortcodeWithPage) Get

func (scp *ShortcodeWithPage) Get(key any) any

Get is a convenience method to look up shortcode parameters by its key.

func (*ShortcodeWithPage) InnerDeindent added in v0.100.0

func (scp *ShortcodeWithPage) InnerDeindent() template.HTML

InnerDeindent returns the (potentially de-indented) inner content of the shortcode.

func (*ShortcodeWithPage) Position added in v0.54.0

func (scp *ShortcodeWithPage) Position() text.Position

Position returns this shortcode's detailed position. Note that this information may be expensive to calculate, so only use this in error situations.

func (*ShortcodeWithPage) Ref

func (scp *ShortcodeWithPage) Ref(args map[string]any) (string, error)

Ref is a shortcut to the Ref method on Page. It passes itself as a context to get better error messages.

func (*ShortcodeWithPage) RelRef

func (scp *ShortcodeWithPage) RelRef(args map[string]any) (string, error)

RelRef is a shortcut to the RelRef method on Page. It passes itself as a context to get better error messages.

func (*ShortcodeWithPage) Scratch

func (scp *ShortcodeWithPage) Scratch() *maps.Scratch

Scratch returns a scratch-pad scoped for this shortcode. This can be used as a temporary storage for variables, counters etc.

func (*ShortcodeWithPage) Site

func (scp *ShortcodeWithPage) Site() page.Site

Site returns information about the current site.

type Site

type Site struct {
	*deps.Deps

	// Page navigation.
	*PageCollections
	// contains filtered or unexported fields
}

func (*Site) Author added in v0.112.0

func (s *Site) Author() map[string]any

func (*Site) Authors added in v0.112.0

func (s *Site) Authors() page.AuthorList

func (*Site) BaseURL added in v0.112.0

func (s *Site) BaseURL() template.URL

Returns the BaseURL for this Site.

func (*Site) BuildDrafts added in v0.112.0

func (s *Site) BuildDrafts() bool

func (*Site) Config added in v0.112.0

func (s *Site) Config() page.SiteConfig

func (*Site) Copyright added in v0.112.0

func (s *Site) Copyright() string

func (*Site) Current added in v0.112.0

func (s *Site) Current() page.Site

Returns Site currently rendering.

func (*Site) Data

func (s *Site) Data() map[string]any

Returns a map of all the data inside /data.

func (*Site) Debug added in v0.112.0

func (s *Site) Debug()

func (*Site) DisqusShortname added in v0.112.0

func (s *Site) DisqusShortname() string

TODO(bep): deprecate.

func (*Site) GetIdentity added in v0.112.0

func (s *Site) GetIdentity() identity.Identity

Returns the identity of this site. This is for internal use only.

func (*Site) GetPage added in v0.112.0

func (s *Site) GetPage(ref ...string) (page.Page, error)

GetPage looks up a page of a given type for the given ref. In Hugo <= 0.44 you had to add Page Kind (section, home) etc. as the first argument and then either a unix styled path (with or without a leading slash)) or path elements separated. When we now remove the Kind from this API, we need to make the transition as painless as possible for existing sites. Most sites will use {{ .Site.GetPage "section" "my/section" }}, i.e. 2 arguments, so we test for that.

func (*Site) GetPageWithTemplateInfo added in v0.112.0

func (s *Site) GetPageWithTemplateInfo(info tpl.Info, ref ...string) (page.Page, error)

func (*Site) GetRelatedDocsHandler added in v0.55.0

func (s *Site) GetRelatedDocsHandler() *page.RelatedDocsHandler

func (*Site) GoogleAnalytics added in v0.112.0

func (s *Site) GoogleAnalytics() string

TODO(bep): deprecate.

func (*Site) Home added in v0.112.0

func (s *Site) Home() page.Page

Home is a shortcut to the home page, equivalent to .Site.GetPage "home".

func (*Site) HomeAbsURL added in v0.112.0

func (s *Site) HomeAbsURL() string

HomeAbsURL is a convenience method giving the absolute URL to the home page.

func (*Site) Hugo added in v0.112.0

func (s *Site) Hugo() hugo.HugoInfo

Returns a struct with some information about the build.

func (*Site) IsMultiLingual added in v0.112.0

func (s *Site) IsMultiLingual() bool

func (*Site) IsServer added in v0.112.0

func (s *Site) IsServer() bool

Returns true if we're running in a server.

func (*Site) Language

func (s *Site) Language() *langs.Language

func (*Site) LanguageCode added in v0.112.0

func (s *Site) LanguageCode() string

func (*Site) LanguagePrefix added in v0.112.0

func (s *Site) LanguagePrefix() string

func (*Site) Languages added in v0.112.0

func (s *Site) Languages() langs.Languages

func (*Site) LastChange added in v0.112.0

func (s *Site) LastChange() time.Time

Returns the last modification date of the content.

func (*Site) MainSections added in v0.112.0

func (s *Site) MainSections() []string

MainSections returns the list of main sections.

func (*Site) Menus

func (s *Site) Menus() navigation.Menus

func (*Site) Param added in v0.112.0

func (s *Site) Param(key any) (any, error)

func (*Site) Params added in v0.112.0

func (s *Site) Params() maps.Params

Returns the Params configured for this site.

func (s *Site) RSSLink() string

func (*Site) RegisterMediaTypes added in v0.20.1

func (s *Site) RegisterMediaTypes()

RegisterMediaTypes will register the Site's media types in the mime package, so it will behave correctly with Hugo's built-in server.

func (*Site) Sections

func (s *Site) Sections() page.Pages

Sections returns the top level sections.

func (*Site) ServerPort added in v0.112.0

func (s *Site) ServerPort() int

Returns the server port.

func (*Site) Site added in v0.112.0

func (s *Site) Site() page.Site

func (*Site) SitemapAbsURL added in v0.112.0

func (s *Site) SitemapAbsURL() string

SitemapAbsURL is a convenience method giving the absolute URL to the sitemap.

func (*Site) Sites added in v0.112.0

func (s *Site) Sites() page.Sites

Returns all Sites for all languages.

func (*Site) Social added in v0.112.0

func (s *Site) Social() map[string]string

func (*Site) Taxonomies

func (s *Site) Taxonomies() page.TaxonomyList

func (*Site) Title added in v0.112.0

func (s *Site) Title() string

Returns the configured title for this Site.

Directories

Path Synopsis
Package filesystems provides the fine grained file systems used by Hugo.
Package filesystems provides the fine grained file systems used by Hugo.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL