mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-21 20:46:30 -05:00
eb42774e58
A sample config: ```toml defaultContentLanguage = "en" defaultContentLanguageInSubdir = true [Languages] [Languages.en] weight = 10 title = "In English" languageName = "English" contentDir = "content/english" [Languages.nn] weight = 20 title = "På Norsk" languageName = "Norsk" contentDir = "content/norwegian" ``` The value of `contentDir` can be any valid path, even absolute path references. The only restriction is that the content dirs cannot overlap. The content files will be assigned a language by 1. The placement: `content/norwegian/post/my-post.md` will be read as Norwegian content. 2. The filename: `content/english/post/my-post.nn.md` will be read as Norwegian even if it lives in the English content folder. The content directories will be merged into a big virtual filesystem with one simple rule: The most specific language file will win. This means that if both `content/norwegian/post/my-post.md` and `content/english/post/my-post.nn.md` exists, they will be considered duplicates and the version inside `content/norwegian` will win. Note that translations will be automatically assigned by Hugo by the content file's relative placement, so `content/norwegian/post/my-post.md` will be a translation of `content/english/post/my-post.md`. If this does not work for you, you can connect the translations together by setting a `translationKey` in the content files' front matter. Fixes #4523 Fixes #4552 Fixes #4553
141 lines
3.5 KiB
Go
141 lines
3.5 KiB
Go
// Copyright 2016-present The Hugo Authors. All rights reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package hugolib
|
|
|
|
import (
|
|
"sync"
|
|
|
|
"sort"
|
|
|
|
"errors"
|
|
"fmt"
|
|
|
|
"github.com/gohugoio/hugo/config"
|
|
"github.com/gohugoio/hugo/helpers"
|
|
"github.com/spf13/cast"
|
|
)
|
|
|
|
// Multilingual manages the all languages used in a multilingual site.
|
|
type Multilingual struct {
|
|
Languages helpers.Languages
|
|
|
|
DefaultLang *helpers.Language
|
|
|
|
langMap map[string]*helpers.Language
|
|
langMapInit sync.Once
|
|
}
|
|
|
|
// Language returns the Language associated with the given string.
|
|
func (ml *Multilingual) Language(lang string) *helpers.Language {
|
|
ml.langMapInit.Do(func() {
|
|
ml.langMap = make(map[string]*helpers.Language)
|
|
for _, l := range ml.Languages {
|
|
ml.langMap[l.Lang] = l
|
|
}
|
|
})
|
|
return ml.langMap[lang]
|
|
}
|
|
|
|
func getLanguages(cfg config.Provider) helpers.Languages {
|
|
if cfg.IsSet("languagesSorted") {
|
|
return cfg.Get("languagesSorted").(helpers.Languages)
|
|
}
|
|
|
|
return helpers.Languages{helpers.NewDefaultLanguage(cfg)}
|
|
}
|
|
|
|
func newMultiLingualFromSites(cfg config.Provider, sites ...*Site) (*Multilingual, error) {
|
|
languages := make(helpers.Languages, len(sites))
|
|
|
|
for i, s := range sites {
|
|
if s.Language == nil {
|
|
return nil, errors.New("Missing language for site")
|
|
}
|
|
languages[i] = s.Language
|
|
}
|
|
|
|
defaultLang := cfg.GetString("defaultContentLanguage")
|
|
|
|
if defaultLang == "" {
|
|
defaultLang = "en"
|
|
}
|
|
|
|
return &Multilingual{Languages: languages, DefaultLang: helpers.NewLanguage(defaultLang, cfg)}, nil
|
|
|
|
}
|
|
|
|
func newMultiLingualForLanguage(language *helpers.Language) *Multilingual {
|
|
languages := helpers.Languages{language}
|
|
return &Multilingual{Languages: languages, DefaultLang: language}
|
|
}
|
|
func (ml *Multilingual) enabled() bool {
|
|
return len(ml.Languages) > 1
|
|
}
|
|
|
|
func (s *Site) multilingualEnabled() bool {
|
|
if s.owner == nil {
|
|
return false
|
|
}
|
|
return s.owner.multilingual != nil && s.owner.multilingual.enabled()
|
|
}
|
|
|
|
func toSortedLanguages(cfg config.Provider, l map[string]interface{}) (helpers.Languages, error) {
|
|
langs := make(helpers.Languages, len(l))
|
|
i := 0
|
|
|
|
for lang, langConf := range l {
|
|
langsMap, err := cast.ToStringMapE(langConf)
|
|
|
|
if err != nil {
|
|
return nil, fmt.Errorf("Language config is not a map: %T", langConf)
|
|
}
|
|
|
|
language := helpers.NewLanguage(lang, cfg)
|
|
|
|
for loki, v := range langsMap {
|
|
switch loki {
|
|
case "title":
|
|
language.Title = cast.ToString(v)
|
|
case "languagename":
|
|
language.LanguageName = cast.ToString(v)
|
|
case "weight":
|
|
language.Weight = cast.ToInt(v)
|
|
case "contentdir":
|
|
language.ContentDir = cast.ToString(v)
|
|
case "disabled":
|
|
language.Disabled = cast.ToBool(v)
|
|
case "params":
|
|
m := cast.ToStringMap(v)
|
|
// Needed for case insensitive fetching of params values
|
|
helpers.ToLowerMap(m)
|
|
for k, vv := range m {
|
|
language.SetParam(k, vv)
|
|
}
|
|
}
|
|
|
|
// Put all into the Params map
|
|
language.SetParam(loki, v)
|
|
|
|
// Also set it in the configuration map (for baseURL etc.)
|
|
language.Set(loki, v)
|
|
}
|
|
|
|
langs[i] = language
|
|
i++
|
|
}
|
|
|
|
sort.Sort(langs)
|
|
|
|
return langs, nil
|
|
}
|