hugo/content/en/functions/lang.Merge.md at 5070ba6c9e6c492deade3c30cfe769b9dbf7151d

mirror of https://github.com/gohugoio/hugo.git synced 2024-11-14 20:37:55 -05:00

Bjørn Erik Pedersen b9bd35d72e Squashed 'docs/' content from commit fdea5430f

git-subtree-dir: docs
git-subtree-split: fdea5430f89dfd849d39212abdf5ace0a4763e5a

2019-10-21 10:22:28 +02:00

title

description

godocref

workson

date

categories

keywords

toc

signature

workson

hugoversion

relatedfuncs

deprecated

draft

aliases

comments

lang.Merge

Merge missing translations from other languages.

2018-03-16

functions

multilingual

docs

parent
functions

false

lang.Merge FROM TO

false

As an example:

{{ $pages := .Site.RegularPages | lang.Merge $frSite.RegularPages | lang.Merge $enSite.RegularPages }}

Will "fill in the gaps" in the current site with, from left to right, content from the French site, and lastly the English.

A more practical example is to fill in the missing translations from the other languages:

{{ $pages := .Site.RegularPages }}
{{ range .Site.Home.Translations }}
{{ $pages = $pages | lang.Merge .Site.RegularPages }}
{{ end }}

{{% note %}} Note that the slightly ugly .Scratch construct will not be needed once this is fixed: https://github.com/golang/go/issues/10608 {{% /note %}}