mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-26 06:12:55 +00:00
597e418cb0
The main motivation of this commit is to add a `page.Page` interface to replace the very file-oriented `hugolib.Page` struct. This is all a preparation step for issue #5074, "pages from other data sources". But this also fixes a set of annoying limitations, especially related to custom output formats, and shortcodes. Most notable changes: * The inner content of shortcodes using the `{{%` as the outer-most delimiter will now be sent to the content renderer, e.g. Blackfriday. This means that any markdown will partake in the global ToC and footnote context etc. * The Custom Output formats are now "fully virtualized". This removes many of the current limitations. * The taxonomy list type now has a reference to the `Page` object. This improves the taxonomy template `.Title` situation and make common template constructs much simpler. See #5074 Fixes #5763 Fixes #5758 Fixes #5090 Fixes #5204 Fixes #4695 Fixes #5607 Fixes #5707 Fixes #5719 Fixes #3113 Fixes #5706 Fixes #5767 Fixes #5723 Fixes #5769 Fixes #5770 Fixes #5771 Fixes #5759 Fixes #5776 Fixes #5777 Fixes #5778
223 lines
6.2 KiB
Go
223 lines
6.2 KiB
Go
// Copyright 2019 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 (
|
|
"strings"
|
|
"testing"
|
|
|
|
"fmt"
|
|
|
|
"github.com/gohugoio/hugo/resources/page"
|
|
|
|
"github.com/gohugoio/hugo/deps"
|
|
"github.com/spf13/afero"
|
|
|
|
"github.com/gohugoio/hugo/helpers"
|
|
"github.com/gohugoio/hugo/hugofs"
|
|
"github.com/stretchr/testify/require"
|
|
)
|
|
|
|
func TestDisableKindsNoneDisabled(t *testing.T) {
|
|
t.Parallel()
|
|
doTestDisableKinds(t)
|
|
}
|
|
|
|
func TestDisableKindsSomeDisabled(t *testing.T) {
|
|
t.Parallel()
|
|
doTestDisableKinds(t, page.KindSection, kind404)
|
|
}
|
|
|
|
func TestDisableKindsOneDisabled(t *testing.T) {
|
|
t.Parallel()
|
|
for _, kind := range allKinds {
|
|
if kind == page.KindPage {
|
|
// Turning off regular page generation have some side-effects
|
|
// not handled by the assertions below (no sections), so
|
|
// skip that for now.
|
|
continue
|
|
}
|
|
doTestDisableKinds(t, kind)
|
|
}
|
|
}
|
|
|
|
func TestDisableKindsAllDisabled(t *testing.T) {
|
|
t.Parallel()
|
|
doTestDisableKinds(t, allKinds...)
|
|
}
|
|
|
|
func doTestDisableKinds(t *testing.T, disabled ...string) {
|
|
siteConfigTemplate := `
|
|
baseURL = "http://example.com/blog"
|
|
enableRobotsTXT = true
|
|
disableKinds = %s
|
|
|
|
paginate = 1
|
|
defaultContentLanguage = "en"
|
|
|
|
[Taxonomies]
|
|
tag = "tags"
|
|
category = "categories"
|
|
`
|
|
|
|
pageTemplate := `---
|
|
title: "%s"
|
|
tags:
|
|
%s
|
|
categories:
|
|
- Hugo
|
|
---
|
|
# Doc
|
|
`
|
|
|
|
mf := afero.NewMemMapFs()
|
|
|
|
disabledStr := "[]"
|
|
|
|
if len(disabled) > 0 {
|
|
disabledStr = strings.Replace(fmt.Sprintf("%#v", disabled), "[]string{", "[", -1)
|
|
disabledStr = strings.Replace(disabledStr, "}", "]", -1)
|
|
}
|
|
|
|
siteConfig := fmt.Sprintf(siteConfigTemplate, disabledStr)
|
|
writeToFs(t, mf, "config.toml", siteConfig)
|
|
|
|
cfg, err := LoadConfigDefault(mf)
|
|
require.NoError(t, err)
|
|
|
|
fs := hugofs.NewFrom(mf, cfg)
|
|
th := testHelper{cfg, fs, t}
|
|
|
|
writeSource(t, fs, "layouts/index.html", "Home|{{ .Title }}|{{ .Content }}")
|
|
writeSource(t, fs, "layouts/_default/single.html", "Single|{{ .Title }}|{{ .Content }}")
|
|
writeSource(t, fs, "layouts/_default/list.html", "List|{{ .Title }}|{{ .Content }}")
|
|
writeSource(t, fs, "layouts/_default/terms.html", "Terms List|{{ .Title }}|{{ .Content }}")
|
|
writeSource(t, fs, "layouts/404.html", "Page Not Found")
|
|
|
|
writeSource(t, fs, "content/sect/p1.md", fmt.Sprintf(pageTemplate, "P1", "- tag1"))
|
|
|
|
writeNewContentFile(t, fs.Source, "Category Terms", "2017-01-01", "content/categories/_index.md", 10)
|
|
writeNewContentFile(t, fs.Source, "Tag1 List", "2017-01-01", "content/tags/tag1/_index.md", 10)
|
|
|
|
h, err := NewHugoSites(deps.DepsCfg{Fs: fs, Cfg: cfg})
|
|
|
|
require.NoError(t, err)
|
|
require.Len(t, h.Sites, 1)
|
|
|
|
err = h.Build(BuildCfg{})
|
|
|
|
require.NoError(t, err)
|
|
|
|
assertDisabledKinds(th, h.Sites[0], disabled...)
|
|
|
|
}
|
|
|
|
func assertDisabledKinds(th testHelper, s *Site, disabled ...string) {
|
|
assertDisabledKind(th,
|
|
func(isDisabled bool) bool {
|
|
if isDisabled {
|
|
return len(s.RegularPages()) == 0
|
|
}
|
|
return len(s.RegularPages()) > 0
|
|
}, disabled, page.KindPage, "public/sect/p1/index.html", "Single|P1")
|
|
assertDisabledKind(th,
|
|
func(isDisabled bool) bool {
|
|
p := s.getPage(page.KindHome)
|
|
if isDisabled {
|
|
return p == nil
|
|
}
|
|
return p != nil
|
|
}, disabled, page.KindHome, "public/index.html", "Home")
|
|
assertDisabledKind(th,
|
|
func(isDisabled bool) bool {
|
|
p := s.getPage(page.KindSection, "sect")
|
|
if isDisabled {
|
|
return p == nil
|
|
}
|
|
return p != nil
|
|
}, disabled, page.KindSection, "public/sect/index.html", "Sects")
|
|
assertDisabledKind(th,
|
|
func(isDisabled bool) bool {
|
|
p := s.getPage(page.KindTaxonomy, "tags", "tag1")
|
|
|
|
if isDisabled {
|
|
return p == nil
|
|
}
|
|
return p != nil
|
|
|
|
}, disabled, page.KindTaxonomy, "public/tags/tag1/index.html", "Tag1")
|
|
assertDisabledKind(th,
|
|
func(isDisabled bool) bool {
|
|
p := s.getPage(page.KindTaxonomyTerm, "tags")
|
|
if isDisabled {
|
|
return p == nil
|
|
}
|
|
return p != nil
|
|
|
|
}, disabled, page.KindTaxonomyTerm, "public/tags/index.html", "Tags")
|
|
assertDisabledKind(th,
|
|
func(isDisabled bool) bool {
|
|
p := s.getPage(page.KindTaxonomyTerm, "categories")
|
|
|
|
if isDisabled {
|
|
return p == nil
|
|
}
|
|
return p != nil
|
|
|
|
}, disabled, page.KindTaxonomyTerm, "public/categories/index.html", "Category Terms")
|
|
assertDisabledKind(th,
|
|
func(isDisabled bool) bool {
|
|
p := s.getPage(page.KindTaxonomy, "categories", "hugo")
|
|
if isDisabled {
|
|
return p == nil
|
|
}
|
|
return p != nil
|
|
|
|
}, disabled, page.KindTaxonomy, "public/categories/hugo/index.html", "Hugo")
|
|
// The below have no page in any collection.
|
|
assertDisabledKind(th, func(isDisabled bool) bool { return true }, disabled, kindRSS, "public/index.xml", "<link>")
|
|
assertDisabledKind(th, func(isDisabled bool) bool { return true }, disabled, kindSitemap, "public/sitemap.xml", "sitemap")
|
|
assertDisabledKind(th, func(isDisabled bool) bool { return true }, disabled, kindRobotsTXT, "public/robots.txt", "User-agent")
|
|
assertDisabledKind(th, func(isDisabled bool) bool { return true }, disabled, kind404, "public/404.html", "Page Not Found")
|
|
}
|
|
|
|
func assertDisabledKind(th testHelper, kindAssert func(bool) bool, disabled []string, kind, path, matcher string) {
|
|
isDisabled := stringSliceContains(kind, disabled...)
|
|
require.True(th.T, kindAssert(isDisabled), fmt.Sprintf("%s: %t", kind, isDisabled))
|
|
|
|
if kind == kindRSS && !isDisabled {
|
|
// If the home page is also disabled, there is not RSS to look for.
|
|
if stringSliceContains(page.KindHome, disabled...) {
|
|
isDisabled = true
|
|
}
|
|
}
|
|
|
|
if isDisabled {
|
|
// Path should not exist
|
|
fileExists, err := helpers.Exists(path, th.Fs.Destination)
|
|
require.False(th.T, fileExists)
|
|
require.NoError(th.T, err)
|
|
|
|
} else {
|
|
th.assertFileContent(path, matcher)
|
|
}
|
|
}
|
|
|
|
func stringSliceContains(k string, values ...string) bool {
|
|
for _, v := range values {
|
|
if k == v {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|