first

first は， SQL の limit キーワード  と似たような働きをします。 これは、配列を 先頭の N 個の要素だけにします。 入力として、配列と要素数を受け取ります。

first は、以下の 2 つの引数を取ります:

1. 要素数
2. 配列 または マップまたは構造体のスライス

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

注意: first 以外に、LIMIT を ‘0’ にすると空の配列を返します。

first と where を一緒に使用する

first と where を一緒に使うと、非常に強力です。 以下のスニペットは、メインセクション から投稿のリストを取得し、 title パラメータでソートし、そのリストの最初の 5 件だけを範囲指定します。

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