hugolib

package
v0.122.0 Latest Latest
Warning

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

 Go to latest Published: Jan 26, 2024 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 Test added in v0.120.0 

func Test(t testing.TB, files string) *IntegrationTestBuilder

Test is a convenience method to create a new IntegrationTestBuilder from some files and run a build.

func TestRunning added in v0.120.0 

func TestRunning(t testing.TB, files string) *IntegrationTestBuilder

TestRunning is a convenience method to create a new IntegrationTestBuilder from some files with Running set to true and run a build.

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 deprecated added in v0.92.2 

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

Deprecated: Use AssertFileExists instead but remember to prefix with "public/". I have had some surprises with this one, hence the deprecation.

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) AssertFileCount added in v0.116.0 

func (s *IntegrationTestBuilder) AssertFileCount(dirname string, expected int)

func (*IntegrationTestBuilder) AssertFileExists added in v0.120.4 

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

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 (s *IntegrationTestBuilder) Build() *IntegrationTestBuilder

func (*IntegrationTestBuilder) BuildE added in v0.92.2 

func (s *IntegrationTestBuilder) BuildE() (*IntegrationTestBuilder, error)

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) Init added in v0.116.0 

func (s *IntegrationTestBuilder) Init() *IntegrationTestBuilder

func (*IntegrationTestBuilder) LogString added in v0.115.0 

func (s *IntegrationTestBuilder) LogString() 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 logg.Level

	// 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() string

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 deprecated added in v0.112.0 

func (s *Site) DisqusShortname() string

Deprecated: Use .Site.Config.Services.Disqus.Shortname instead

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 deprecated added in v0.112.0 

func (s *Site) GoogleAnalytics() string

Deprecated: Use .Site.Config.Services.GoogleAnalytics.ID instead

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. Deprecated: use hugo.IsServer instead

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() template.URL

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.

Source Files

View all Source files

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
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.