Gopher
FUNCTIONS

first

Slices an array to only the first N elements.

Syntax

first LIMIT COLLECTION

first works in a similar manner to the limit keyword in SQL . It reduces the array to only the first N elements. It takes the array and number of elements as input.

first takes two arguments:

  1. number of elements
  2. array or slice of maps or structs
layout/_default/section.html

{{ range first 10 .Pages }}
    {{ .Render "summary" }}
{{ end }}

Note: Exclusive to first, LIMIT can be ‘0’ to return an empty array.

first and where Together  

Using first and where together can be very powerful. Below snippet gets a list of posts only from main sections , sorts it by the title parameter, and then ranges through only the first 5 posts in that list:

first-and-where-together.html

{{ range first 5 (where site.RegularPages "Type" "in" site.Params.mainSections).ByTitle }}
   {{ .Content }}
{{ end }}