hugo/docs/content/functions/shuffle.md

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

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

{{% 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.