hugo/content/en/functions/after.md
Bjørn Erik Pedersen cb39847dee Squashed 'docs/' changes from a26d0e610..7297c1172
7297c1172 Add note about caching for Hugo Pipes.
c91be3403 minor markdown, capitalization and spelling fixes (#1183)
fd4a103bf Fix several 404 errors (#1162)
69378bc20 Update related.md
28c24e95f Add note on setting baseURL
7b1502c99 minor typo fix (#1180)
33abeb4fe Update related.md
4887563f6 Update js.md
ee5f1de2e Hugo 0.74.3
986ea0c8e releaser: Add release notes to /docs for release of 0.74.3
3299b44bd Fix Asciidoctor args
bcb950347 resources/js: Add option for setting bundle format
3f8324918 resources/js: Add es5 build target

git-subtree-dir: docs
git-subtree-split: 7297c1172754078511ac1c10ca0dfd4cab629506
2020-08-14 18:31:01 +02:00

2.1 KiB
Raw Blame History

title description godocref date publishdate lastmod categories menu keywords signature workson hugoversion relatedfuncs deprecated aliases
after `after` slices an array to only the items after the <em>N</em>th item. 2017-02-01 2017-02-01 2017-02-01
functions
docs
parent
functions
iteration
after INDEX COLLECTION
last
first
seq
false

The following shows after being used in conjunction with the slice function:

{{ $data := slice "one" "two" "three" "four" }}
{{ range after 2 $data }}
    {{ . }}
{{ end }}
→ ["three", "four"]

Example of after with first: 2nd4th Most Recent Articles

You can use after in combination with the first function and Hugo's powerful sorting methods. Let's assume you have a list page at example.com/articles. You have 10 articles, but you want your templating for the list/section page to show only two rows:

  1. The top row is titled "Featured" and shows only the most recently published article (i.e. by publishdate in the content files' front matter).
  2. The second row is titled "Recent Articles" and shows only the 2nd- to 4th-most recently published articles.

{{< code file="layouts/section/articles.html" download="articles.html" >}} {{ define "main" }}

Featured Article

{{ range first 1 .Pages.ByPublishDate.Reverse }}

{{.Title}}

{{.Description}}

{{ end }}

Recent Articles

{{ range first 3 (after 1 .Pages.ByPublishDate.Reverse) }}

{{.Title}}

{{.Description}}

{{ end }}
{{ end }} {{< /code >}}