Methods

Duration

Use these methods with time.Duration values.

Abs: Returns the absolute value of the given time.Duration value.
Hours: Returns the time.Duration value as a floating point number of hours.
Microseconds: Returns the time.Duration value as an integer microsecond count.
Milliseconds: Returns the time.Duration value as an integer millisecond count.
Minutes: Returns the time.Duration value as a floating point number of minutes.
Nanoseconds: Returns the time.Duration value as an integer nanosecond count.
Round: Returns the result of rounding DURATION1 to the nearest multiple of DURATION2.
Seconds: Returns the time.Duration value as a floating point number of seconds.
Truncate: Returns the result of rounding DURATION1 toward zero to a multiple of DURATION2.

Use these methods when ranging through menu entries.

ByName: Returns the given menu with its entries sorted by name.
ByWeight: Returns the given menu with its entries sorted by weight, then by name, then by identifier.
Limit: Returns the given menu, limited to the first N entries.
Reverse: Returns the given menu, reversing the sort order of its entries.

Use these methods in your menu templates.

Children: Returns a collection of child menu entries, if any, under the given menu entry.
HasChildren: Reports whether the given menu entry has child menu entries.
Identifier: Returns the identifier property of the given menu entry.
KeyName: Returns the identifier property of the given menu entry, falling back to its name property.
Menu: Returns the identifier of the menu that contains the given menu entry.
Name: Returns the name property of the given menu entry.
Page: Returns the Page object associated with the given menu entry.
Params: Returns the params property of the given menu entry.
Parent: Returns the parent property of the given menu entry.
Post: Returns the post property of the given menu entry.
Pre: Returns the pre property of the given menu entry.
Title: Returns the title property of the given menu entry.
URL: Returns the relative permalink of the page associated with the given menu entry, else its url property.
Weight: Returns the weight property of the given menu entry.

Resource

Use these methods with global, page, and remote Resource objects.

Colors: Applicable to images, returns a slice of the most dominant colors using a simple histogram method.
Content: Returns the content of the given resource.
Crop: Applicable to images, returns an image resource cropped to the given dimensions without resizing.
Data: Applicable to resources returned by the resources.GetRemote function, returns information from the HTTP response.
Err: Applicable to resources returned by the resources.GetRemote function, returns an error message if the HTTP request fails, else nil.
Exif: Applicable to JPEG and TIFF images, returns an EXIF object containing image metadata.
Fill: Applicable to images, returns an image resource cropped and resized to the given dimensions.
Filter: Applicable to images, applies one or more image filters to the given image resource.
Fit: Applicable to images, returns an image resource downscaled to fit the given dimensions while maintaining aspect ratio.
Height: Applicable to images, returns the height of the given resource.
MediaType: Returns a media type object for the given resource.
Name: Returns the name of the given resource as optionally defined in front matter, falling back to its file path.
Params: Returns a map of resource parameters as defined in front matter.
Permalink: Publishes the given resource and returns its permalink.
Process: Applicable to images, returns an image resource processed with the given specification.
Publish: Publishes the given resource.
RelPermalink: Publishes the given resource and returns its relative permalink.
Resize: Applicable to images, returns an image resource resized to the given width and/or height.
ResourceType: Returns the main type of the given resource's media type.
Title: Returns the title of the given resource as optionally defined in front matter, falling back to a relative path or hashed file name depending on resource type.
Width: Applicable to images, returns the width of the given resource.

Shortcode

Use these methods in your shortcode templates.

Get: Returns the value of the given parameter.
Inner: Returns the content between opening and closing shortcode tags, applicable when the shortcode call includes a closing tag.
InnerDeindent: Returns the content between opening and closing shortcode tags, with indentation removed, applicable when the shortcode call includes a closing tag.
IsNamedParams: Reports whether the shortcode call uses named parameters.
Name: Returns the shortcode file name, excluding the file extension.
Ordinal: Returns the zero-based ordinal of the shortcode in relation to its parent.
Page: Returns the Page object from which the shortcode was called.
Params: Returns a collection of the shortcode parameters.
Parent: Returns the parent shortcode context in nested shortcodes.
Position: Returns the filename and position from which the shortcode was called.
Ref: Returns the absolute URL of the page with the given path, language, and output format.
RelRef: Returns the relative URL of the page with the given path, language, and output format.
Scratch: Returns a "scratch pad" scoped to the shortcode to store and manipulate data.
Site: Returns the Site object.

Site

Use these methods with Site objects. A multilingual project will have two or more sites, one for each language.

AllPages: Returns a collection of all pages in all languages.
BaseURL: Returns the base URL as defined in the site configuration.
BuildDrafts: Reports whether the current build includes draft pages.
Config: Returns a subset of the site configuration.
Copyright: Returns the copyright notice as defined in the site configuration.
Data: Returns a data structure composed from the files in the data directory.
DisqusShortname: Returns the Disqus shortname as defined in the site configuration.
GetPage: Returns a Page object from the given path.
GoogleAnalytics: Returns the Google Analytics tracking ID as defined in the site configuration.
Home: Returns the home Page object for the given site.
IsDevelopment: Reports whether the current running environment is “development”.
IsMultiLingual: Reports whether there are two or more configured languages.
IsServer: Reports whether the built-in development server is running.
Language: Returns the language object for the given site.
LanguagePrefix: Returns the URL language prefix, if any, for the given site.
Languages: Returns a collection of language objects for all sites, ordered by language weight.
LastChange: Returns the last modification date of site content.
Lastmod: Returns the last modification date of site content.
MainSections: Returns a slice of the main section names as defined in the site configuration, falling back to the top level section with the most pages.
Menus: Returns a collection of menu objects for the given site.
Pages: Returns a collection of all pages.
Param: Returns the site parameter with the given key.
Params: Returns a map of custom parameters as defined in the site configuration.
RegularPages: Returns a collection of all regular pages.
Sections: Returns a collection of first level section pages.
Sites: Returns a collection of all Site objects, one for each language, ordered by default content language then by language weight.
Taxonomies: Returns a data structure containing the site's taxonomy objects, the terms within each taxonomy object, and the pages to which the terms are assigned.
Title: Returns the title as defined in the site configuration.

Taxonomy

Use these methods with Taxonomy objects.

Alphabetical: Returns an ordered taxonomy, sorted alphabetically by term.
ByCount: Returns an ordered taxonomy, sorted by the number of pages associated with each term.
Count: Returns the number of number of weighted pages to which the given term has been assigned.
Get: Returns a slice of weighted pages to which the given term has been assigned.
Page: Returns the taxonomy page or nil if the taxonomy has no terms.

Time

Use these methods with time.Time values.

Add: Returns the given time plus the given duration.
AddDate: Returns the time corresponding to adding the given number of years, months, and days to the given time.Time value.
After: Reports whether TIME1 is after TIME2.
Before: Reports whether TIME1 is before TIME2.
Day: Returns the day of the month of the given time.Time value.
Equal: Reports whether TIME1 is equal to TIME2.
Format: Returns a textual representation of the time.Time value formatted according to the layout string.
Hour: Returns the hour within the day of the given time.Time value, in the range [0, 23].
IsDST: Reports whether the given time.Time value is in Daylight Savings Time.
IsZero: Reports whether the given time.Time value represents the zero time instant, January 1, year 1, 00:00:00 UTC.
Local: Returns the given time.Time value with the location set to local time.
Minute: Returns the minute offset within the hour of the given time.Time value, in the range [0, 59].
Month: Returns the month of the year of the given time.Time value.
Nanosecond: Returns the nanosecond offset within the second of the given time.Time value, in the range [0, 999999999].
Round: Returns the result of rounding TIME to the nearest multiple of DURATION since January 1, 0001, 00:00:00 UTC.
Second: Returns the second offset within the minute of the given time.Time value, in the range [0, 59].
Sub: Returns the duration computed by subtracting TIME2 from TIME1.
Truncate: Returns the result of rounding TIME down to a multiple of DURATION since January 1, 0001, 00:00:00 UTC.
Unix: Returns the given time.Time value expressed as the number of seconds elapsed since January 1, 1970 UTC.
UnixMicro: Returns the given time.Time value expressed as the number of microseconds elapsed since January 1, 1970 UTC.
UnixMilli: Returns the given time.Time value expressed as the number of milliseconds elapsed since January 1, 1970 UTC.
UnixNano: Returns the given time.Time value expressed as the number of nanoseconds elapsed since January 1, 1970 UTC.
UTC: Returns the given time.Time value with the location set to UTC.
Weekday: Returns the day of the week of the given time.Time value.
Year: Returns the year of the given time.Time value.
YearDay: Returns the day of the year of the given time.Time value, in the range [1, 365] for non-leap years, and [1, 366] in leap years.

Methods

Duration

Menu

Menu entry

Page

Pages