// Copyright 2016 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 tplimpl import ( "errors" "html/template" "strings" texttemplate "text/template" "text/template/parse" ) // decl keeps track of the variable mappings, i.e. $mysite => .Site etc. type decl map[string]string var paramsPaths = [][]string{ {"Params"}, {"Site", "Params"}, // Site and Pag referenced from shortcodes {"Page", "Site", "Params"}, {"Page", "Params"}, {"Site", "Language", "Params"}, } type templateContext struct { decl decl visited map[string]bool lookupFn func(name string) *parse.Tree } func (c templateContext) getIfNotVisited(name string) *parse.Tree { if c.visited[name] { return nil } c.visited[name] = true return c.lookupFn(name) } func newTemplateContext(lookupFn func(name string) *parse.Tree) *templateContext { return &templateContext{lookupFn: lookupFn, decl: make(map[string]string), visited: make(map[string]bool)} } func createParseTreeLookup(templ *template.Template) func(nn string) *parse.Tree { return func(nn string) *parse.Tree { tt := templ.Lookup(nn) if tt != nil { return tt.Tree } return nil } } func applyTemplateTransformersToHMLTTemplate(templ *template.Template) error { return applyTemplateTransformers(templ.Tree, createParseTreeLookup(templ)) } func applyTemplateTransformersToTextTemplate(templ *texttemplate.Template) error { return applyTemplateTransformers(templ.Tree, func(nn string) *parse.Tree { tt := templ.Lookup(nn) if tt != nil { return tt.Tree } return nil }) } func applyTemplateTransformers(templ *parse.Tree, lookupFn func(name string) *parse.Tree) error { if templ == nil { return errors.New("expected template, but none provided") } c := newTemplateContext(lookupFn) c.paramsKeysToLower(templ.Root) return nil } func (c *templateContext) paramsKeysToLowerForNodes(nodes ...parse.Node) { for _, node := range nodes { c.paramsKeysToLower(node) } } func (c *templateContext) updateIdentsIfNeeded(idents []string) { index := c.decl.indexOfReplacementStart(idents) if index == -1 { return } for i := index; i < len(idents); i++ { idents[i] = strings.ToLower(idents[i]) } } // indexOfReplacementStart will return the index of where to start doing replacement, // -1 if none needed. func (d decl) indexOfReplacementStart(idents []string) int { l := len(idents) if l == 0 { return -1 } first := idents[0] firstIsVar := first[0] == '$' if l == 1 && !firstIsVar { // This can not be a Params.x return -1 } if !firstIsVar { found := false for _, paramsPath := range paramsPaths { if first == paramsPath[0] { found = true break } } if !found { return -1 } } var ( resolvedIdents []string replacements []string replaced []string ) // An Ident can start out as one of // [Params] [$blue] [$colors.Blue] // We need to resolve the variables, so // $blue => [Params Colors Blue] // etc. replacements = []string{idents[0]} // Loop until there are no more $vars to resolve. for i := 0; i < len(replacements); i++ { if i > 20 { // bail out return -1 } potentialVar := replacements[i] if potentialVar == "$" { continue } if potentialVar == "" || potentialVar[0] != '$' { // leave it as is replaced = append(replaced, strings.Split(potentialVar, ".")...) continue } replacement, ok := d[potentialVar] if !ok { // Temporary range vars. We do not care about those. return -1 } replacement = strings.TrimPrefix(replacement, ".") if replacement == "" { continue } if replacement[0] == '$' { // Needs further expansion replacements = append(replacements, strings.Split(replacement, ".")...) } else { replaced = append(replaced, strings.Split(replacement, ".")...) } } resolvedIdents = append(replaced, idents[1:]...) for _, paramPath := range paramsPaths { if index := indexOfFirstRealIdentAfterWords(resolvedIdents, idents, paramPath...); index != -1 { return index } } return -1 } func indexOfFirstRealIdentAfterWords(resolvedIdents, idents []string, words ...string) int { if !sliceStartsWith(resolvedIdents, words...) { return -1 } for i, ident := range idents { if ident == "" || ident[0] == '$' { continue } found := true for _, word := range words { if ident == word { found = false break } } if found { return i } } return -1 } func sliceStartsWith(slice []string, words ...string) bool { if len(slice) < len(words) { return false } for i, word := range words { if word != slice[i] { return false } } return true }