hugo/content/functions/shuffle.md

title, description, godocref, date, publishdate, lastmod, tags, categories, menu, ns, signature, workson, hugoversion, relatedfuncs, deprecated, draft, aliases, needsexamples

title	description	godocref	date	publishdate	lastmod	tags	categories	menu	ns	signature	workson	hugoversion	relatedfuncs	deprecated	draft	aliases	needsexamples
shuffle	Returns a random permutation of a given array or slice.		2017-02-01	2017-02-01	2017-04-30	ordering	functions	docs parent functions		shuffle COLLECTION			seq	false	false		true

shuffle returns a random permutation of a given array or slice:

{{% code file="shuffle-input.html" %}}

<!-- Shuffled sequence = -->
<div>{{ shuffle (seq 1 5) }}</div>
<!-- Shuffled slice =  -->
<div>{{ shuffle (slice "foo" "bar" "buzz") }}</div>

{{% /code %}}

This example would return the following:

{{% output file="shuffle-output.html" %}}

<!-- Shuffled sequence =  -->
<div>2 5 3 1 4</div>
<!-- Shuffled slice =  -->
<div>buzz foo bar</div>

{{% /output %}}

This example also makes use of the slice and seq functions.