diff options
author | Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com> | 2018-11-07 08:52:41 +0100 |
---|---|---|
committer | Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com> | 2018-11-07 10:38:58 +0100 |
commit | ddcb402859b50193bfd6d8b752b568d26d14f603 (patch) | |
tree | 69d25fb7631b7f47512c250dba5465149955db60 /docs/content/en/functions | |
parent | 3a44920e79ef86003555d8a4860c29257b2914f0 (diff) |
docs: Document complement
Closes https://github.com/gohugoio/hugoDocs/issues/658
Diffstat (limited to 'docs/content/en/functions')
-rw-r--r-- | docs/content/en/functions/complement.md | 29 | ||||
-rw-r--r-- | docs/content/en/functions/intersect.md | 2 |
2 files changed, 30 insertions, 1 deletions
diff --git a/docs/content/en/functions/complement.md b/docs/content/en/functions/complement.md new file mode 100644 index 000000000..461227789 --- /dev/null +++ b/docs/content/en/functions/complement.md @@ -0,0 +1,29 @@ +--- +title: "complement" +description: "`collections.Complement` (alias `complement`) gives the elements of a collection that are not in any of the others." +date: 2018-11-07 +categories: [functions] +menu: + docs: + parent: "functions" +keywords: [collections,intersect,union] +signature: ["COLLECTION | complement COLLECTION [COLLECTION]..." ] +hugoversion: "0.51" +aliases: [] +--- + +Example: + +```go-html-template +{{ $pages := .Site.RegularPages | first 50 }} +{{ $news := where $pages "Type" "news" | first 5 }} +{{ $blog := where $pages "Type" "blog" | first 5 }} +{{ $other := $pages | complement $news $blog | first 10 }} +``` + +The above is an imaginary use case for the home page where you want to display different page listings in sections/boxes on different places on the page: 5 from `news`, 5 from the `blog` and then 10 of the pages not shown in the other listings, to _complement_ them. + + + + + diff --git a/docs/content/en/functions/intersect.md b/docs/content/en/functions/intersect.md index 6d2efacbc..53f26d950 100644 --- a/docs/content/en/functions/intersect.md +++ b/docs/content/en/functions/intersect.md @@ -10,7 +10,7 @@ categories: [functions] menu: docs: parent: "functions" -keywords: [] +keywords: [collections,intersect,union,complement,symdiff] signature: ["intersect SET1 SET2"] workson: [] hugoversion: |