math.Counter

Increments and returns a global counter.

Syntax

math.Counter

Returns

uint64

The counter is global for both monolingual and multilingual sites, and its initial value for each build is 1.

{{ warnf "single.html called %d times" math.Counter }}

WARN  single.html called 1 times
WARN  single.html called 2 times
WARN  single.html called 3 times

Use this function to:

Create unique warnings as shown above; the warnf function suppresses duplicate messages
Create unique target paths for the resources.FromString function where the target path is also the cache key

Due to concurrency, the value returned in a given template for a given page will vary from one build to the next. You cannot use this function to assign a static id to each page.

Last updated: February 17, 2025 : all: Change shortcode usage and design to prevent invalid HTML (0fca8ef25)

Improve this page