mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-07 20:30:36 -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
133 lines
3.1 KiB
Go
133 lines
3.1 KiB
Go
// Copyright 2017-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 source
|
|
|
|
import (
|
|
"os"
|
|
"path/filepath"
|
|
"regexp"
|
|
|
|
"github.com/spf13/afero"
|
|
|
|
"github.com/gohugoio/hugo/helpers"
|
|
"github.com/spf13/cast"
|
|
)
|
|
|
|
// SourceSpec abstracts language-specific file creation.
|
|
// TODO(bep) rename to Spec
|
|
type SourceSpec struct {
|
|
*helpers.PathSpec
|
|
|
|
Fs afero.Fs
|
|
|
|
// This is set if the ignoreFiles config is set.
|
|
ignoreFilesRe []*regexp.Regexp
|
|
|
|
Languages map[string]interface{}
|
|
DefaultContentLanguage string
|
|
DisabledLanguages map[string]bool
|
|
}
|
|
|
|
// NewSourceSpec initializes SourceSpec using languages the given filesystem and PathSpec.
|
|
func NewSourceSpec(ps *helpers.PathSpec, fs afero.Fs) *SourceSpec {
|
|
cfg := ps.Cfg
|
|
defaultLang := cfg.GetString("defaultContentLanguage")
|
|
languages := cfg.GetStringMap("languages")
|
|
|
|
disabledLangsSet := make(map[string]bool)
|
|
|
|
for _, disabledLang := range cfg.GetStringSlice("disableLanguages") {
|
|
disabledLangsSet[disabledLang] = true
|
|
}
|
|
|
|
if len(languages) == 0 {
|
|
l := helpers.NewDefaultLanguage(cfg)
|
|
languages[l.Lang] = l
|
|
defaultLang = l.Lang
|
|
}
|
|
|
|
ignoreFiles := cast.ToStringSlice(cfg.Get("ignoreFiles"))
|
|
var regexps []*regexp.Regexp
|
|
if len(ignoreFiles) > 0 {
|
|
for _, ignorePattern := range ignoreFiles {
|
|
re, err := regexp.Compile(ignorePattern)
|
|
if err != nil {
|
|
helpers.DistinctErrorLog.Printf("Invalid regexp %q in ignoreFiles: %s", ignorePattern, err)
|
|
} else {
|
|
regexps = append(regexps, re)
|
|
}
|
|
|
|
}
|
|
}
|
|
|
|
return &SourceSpec{ignoreFilesRe: regexps, PathSpec: ps, Fs: fs, Languages: languages, DefaultContentLanguage: defaultLang, DisabledLanguages: disabledLangsSet}
|
|
}
|
|
|
|
func (s *SourceSpec) IgnoreFile(filename string) bool {
|
|
if filename == "" {
|
|
if _, ok := s.Fs.(*afero.OsFs); ok {
|
|
return true
|
|
}
|
|
return false
|
|
}
|
|
|
|
base := filepath.Base(filename)
|
|
|
|
if len(base) > 0 {
|
|
first := base[0]
|
|
last := base[len(base)-1]
|
|
if first == '.' ||
|
|
first == '#' ||
|
|
last == '~' {
|
|
return true
|
|
}
|
|
}
|
|
|
|
if len(s.ignoreFilesRe) == 0 {
|
|
return false
|
|
}
|
|
|
|
for _, re := range s.ignoreFilesRe {
|
|
if re.MatchString(filename) {
|
|
return true
|
|
}
|
|
}
|
|
|
|
return false
|
|
}
|
|
|
|
func (s *SourceSpec) IsRegularSourceFile(filename string) (bool, error) {
|
|
fi, err := helpers.LstatIfPossible(s.Fs, filename)
|
|
if err != nil {
|
|
return false, err
|
|
}
|
|
|
|
if fi.IsDir() {
|
|
return false, nil
|
|
}
|
|
|
|
if fi.Mode()&os.ModeSymlink == os.ModeSymlink {
|
|
link, err := filepath.EvalSymlinks(filename)
|
|
fi, err = helpers.LstatIfPossible(s.Fs, link)
|
|
if err != nil {
|
|
return false, err
|
|
}
|
|
|
|
if fi.IsDir() {
|
|
return false, nil
|
|
}
|
|
}
|
|
|
|
return true, nil
|
|
}
|