Cache when not found in LookupLayout

Very visible when using the pprof mutex profiler. ```bash name old time/op new time/op delta Baseline-10 58.4ms ± 1% 51.6ms ± 0% -11.56% (p=0.029 n=4+4) name old alloc/op new alloc/op delta Baseline-10 64.3MB ± 0% 64.2MB ± 0% ~ (p=0.114 n=4+4) name old allocs/op new allocs/op delta Baseline-10 649k ± 0% 649k ± 0% ~ (p=0.229 n=4+4) ```
2026-08-31 10:42:38 +00:00 · 2022-07-13 14:49:00 +02:00
505 changed files with 6455 additions and 8011 deletions
@@ -1,114 +1,51 @@
-parameters:
-
-# v2: 11m.
 defaults: &defaults
-  resource_class: large
  docker:
-      - image: bepsays/ci-hugoreleaser:1.21900.20200
-environment: &buildenv
-      GOMODCACHE: /root/project/gomodcache
+      - image: bepsays/ci-goreleaser:1.1800.300
+  environment:
+    CGO_ENABLED: "0"
+
 version: 2
 jobs:
-  prepare_release:
-    <<: *defaults 
-    environment: &buildenv
-        GOMODCACHE: /root/project/gomodcache
+  build:
+    <<: *defaults
    steps:
-      - &remote-docker
-        setup_remote_docker: 
-          version: 20.10.14
-      - checkout: 
+      - checkout:
          path: hugo
-      - &git-config
-        run:
-           command: |
-            git config --global user.email "bjorn.erik.pedersen+hugoreleaser@gmail.com"
-            git config --global user.name "hugoreleaser"
      - run:
-          command: |
-            cd hugo
-            go mod download
-            go run -tags release main.go release --step 1
-      - save_cache:
-          key: git-sha-{{ .Revision }}
-          paths:
-            - hugo
-            - gomodcache
-  build_container1:
-    <<: [*defaults]
-    environment:
-      <<: [*buildenv]
+            command: |
+                git clone git@github.com:gohugoio/hugoDocs.git
+                cd hugo
+                go mod download
+                sleep 5
+                go mod verify
+      - persist_to_workspace:
+          root: .
+          paths: .
+  release:
+    <<: *defaults
    steps:
-      - &restore-cache
-        restore_cache:
-          key: git-sha-{{ .Revision }}
+      - attach_workspace:
+          at: /root/project
      - run:
-          no_output_timeout: 20m
-          command: |
-            mkdir -p /tmp/files/dist1
-            cd hugo
-            hugoreleaser build -paths "builds/container1/**" -workers 3 -dist /tmp/files/dist1 -chunks $CIRCLE_NODE_TOTAL -chunk-index $CIRCLE_NODE_INDEX
-      - &persist-workspace
-        persist_to_workspace:
-          root: /tmp/files
-          paths:
-            - dist1
-            - dist2
-    parallelism: 7
-  build_container2:
-    <<: [*defaults]
-    environment:
-        <<: [*buildenv]
-    docker:
-    - image: bepsays/ci-hugoreleaser-linux-arm64:1.21900.20200
-    steps:
-      - *restore-cache
-      - &attach-workspace
-        attach_workspace:
-          at: /tmp/workspace
-      - run:
-          command: |
-                  mkdir -p /tmp/files/dist2
-                  cd hugo
-                  hugoreleaser build -paths "builds/container2/**" -workers 1 -dist /tmp/files/dist2
-      - *persist-workspace
-  archive_and_release:
-    <<: [*defaults]
-    environment:
-        <<: [*buildenv]
-    steps:
-      - *restore-cache
-      - *attach-workspace
-      - *git-config
-      - run:
-          command: |
-            cp -a /tmp/workspace/dist1/. ./hugo/dist
-            cp -a /tmp/workspace/dist2/. ./hugo/dist
-      - run:
-          command: |
-            cd hugo
-            hugoreleaser archive
-            hugoreleaser release
-            go run -tags release main.go release --step 2
+            command: |
+                    cd hugo
+                    git config --global user.email "bjorn.erik.pedersen+hugoreleaser@gmail.com"
+                    git config --global user.name "hugoreleaser"
+                    go run -tags release main.go release -r ${CIRCLE_BRANCH}
+
 workflows:
  version: 2
  release:
      jobs:  
-        - prepare_release:
+        - build:
            filters:
              branches:
                only: /release-.*/
-        - build_container1:
+        - hold:
+            type: approval
            requires:
-            - prepare_release
-        - build_container2:
-            requires:
-            - prepare_release
-        - archive_and_release:
+              - build
+        - release:
            context: org-global
            requires:
-            - build_container1
-            - build_container2
-     
-  
-       
+              - hold
@@ -3,13 +3,8 @@ on:
  workflow_dispatch:
  schedule:
    - cron: '30 1 * * *'
-permissions:
-  contents: read
 jobs:
  stale:
-    permissions:
-      issues: write
-      pull-requests: write
    runs-on: ubuntu-latest
    steps:
      - uses: dessant/lock-threads@08e671be8ac8944d0e132aa71d0ae8ccfb347675
@@ -1,45 +1,30 @@
-on:
-  push:
-    branches: [ master ]
-  pull_request:
+on: [push, pull_request]
 name: Test
-env:
-    GOPROXY: https://proxy.golang.org
-    GO111MODULE: on
-    DART_SASS_VERSION: 1.56.2
-    DART_SASS_SHA_LINUX: 9e4f455f7b8619959d7878af2862383be58392eb963a14ff87cc512c03701e2a
-    DART_SASS_SHA_MACOS: 5992e979e2c30ec363f8e338822bb2b4443c74232b3340501a76180f5652cb09
-    DART_SASS_SHA_WINDOWS: 8d3d9117c54840e3e6a4919e43acf75ea52f28a64fc87a8e29d80ec72ee36cfb
 permissions:
  contents: read
 jobs:
  test:
+    env:
+      GOPROXY: https://proxy.golang.org
+      GO111MODULE: on
    strategy:
      matrix:
        # Note: We upgraded to Go 1.18 in Hugo v0.95.0
        # Go 1.18 had some breaking changes on the source level which means Hugo cannot be built
        # with older Go versions, but the improvements in Go 1.18 were too good to pass on (e.g. break and continue).
        # Note that you don't need Go (or Go 1.18) to run a pre-built binary.
-        go-version: [1.18.x,1.19.x]
+        go-version: [1.18.x]
        os: [ubuntu-latest, macos-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
-    - name: Checkout code
-      uses: actions/checkout@93ea575cb5d8a053eaa0ac8fa3b40d7e05a33cc8
    - name: Install Go
-      uses: actions/setup-go@268d8c0ca0432bb2cf416faae41297df9d262d7f
+      uses: actions/setup-go@37335c7bb261b353407cff977110895fa0b4f7d8
      with:
        go-version: ${{ matrix.go-version }}
-        check-latest: true
-        cache: true
-        cache-dependency-path: |
-          **/go.sum
-          **/go.mod
    - name: Install Ruby
-      uses: ruby/setup-ruby@ee2113536afb7f793eed4ce60e8d3b26db912da4
+      uses: actions/setup-ruby@5f29a1cd8dfebf420691c4c9a0e832e2fae5a526
      with:
-        ruby-version: '2.7' 
-        bundler-cache: true #
+        ruby-version: '2.7'
    - name: Install Python
      uses: actions/setup-python@3105fb18c05ddd93efea5f9e0bef7a03a6e9e7df
      with:
@@ -48,6 +33,8 @@ jobs:
      run: go install github.com/magefile/mage@07afc7d24f4d6d6442305d49552f04fbda5ccb3e
    - name: Install asciidoctor
      uses: reitzig/actions-asciidoctor@7570212ae20b63653481675fb1ff62d1073632b0
+    - name: Checkout code
+      uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f
    - name: Install docutils
      run: |
        pip install docutils
@@ -62,33 +49,29 @@ jobs:
        brew install pandoc
    - if: matrix.os == 'windows-latest'
      run: |
-        Choco-Install -PackageName pandoc
+        choco install pandoc
+        choco install mingw --version 10.2.0 --allow-downgrade
    - run: pandoc -v
-    - if: matrix.os == 'windows-latest'
-      run: |
-        Choco-Install -PackageName mingw -ArgumentList "--version","10.2.0","--allow-downgrade"
    - if: matrix.os == 'ubuntu-latest'
      name: Install dart-sass-embedded Linux
      run: |
-        echo "Install Dart Sass version ${DART_SASS_VERSION} ..."
-        curl -LJO "https://github.com/sass/dart-sass-embedded/releases/download/${DART_SASS_VERSION}/sass_embedded-${DART_SASS_VERSION}-linux-x64.tar.gz";
-        echo "${DART_SASS_SHA_LINUX}  sass_embedded-${DART_SASS_VERSION}-linux-x64.tar.gz" | sha256sum -c;
-        tar -xvf "sass_embedded-${DART_SASS_VERSION}-linux-x64.tar.gz";
+        curl -LJO https://github.com/sass/dart-sass-embedded/releases/download/1.0.0-beta.6/sass_embedded-1.0.0-beta.6-linux-x64.tar.gz;
+        echo "04fc1e5e28d29a4585a701941b6dace56771d94bfbe7f9e4db28d24417ceeec3  sass_embedded-1.0.0-beta.6-linux-x64.tar.gz" | sha256sum -c;
+        tar -xvf sass_embedded-1.0.0-beta.6-linux-x64.tar.gz;
        echo "$GITHUB_WORKSPACE/sass_embedded/" >> $GITHUB_PATH
    - if: matrix.os == 'macos-latest'
      name: Install dart-sass-embedded MacOS
      run: |
-        echo "Install Dart Sass version ${DART_SASS_VERSION} ..."
-        curl -LJO "https://github.com/sass/dart-sass-embedded/releases/download/${DART_SASS_VERSION}/sass_embedded-${DART_SASS_VERSION}-macos-x64.tar.gz";
-        echo "${DART_SASS_SHA_MACOS}  sass_embedded-${DART_SASS_VERSION}-macos-x64.tar.gz" | shasum -a 256 -c;
-        tar -xvf "sass_embedded-${DART_SASS_VERSION}-macos-x64.tar.gz";
+        curl -LJO https://github.com/sass/dart-sass-embedded/releases/download/1.0.0-beta.6/sass_embedded-1.0.0-beta.6-macos-x64.tar.gz;
+        echo "b3b984675a9b04aa22f6f2302dda4191b507ac2ca124467db2dfe7e58e72fbad  sass_embedded-1.0.0-beta.6-macos-x64.tar.gz" | shasum -a 256 -c;
+        tar -xvf sass_embedded-1.0.0-beta.6-macos-x64.tar.gz;
        echo "$GITHUB_WORKSPACE/sass_embedded/" >> $GITHUB_PATH
    - if: matrix.os == 'windows-latest'
      name: Install dart-sass-embedded Windows
      run: |
-        echo "Install Dart Sass version ${env:DART_SASS_VERSION} ..."
-        curl -LJO "https://github.com/sass/dart-sass-embedded/releases/download/${env:DART_SASS_VERSION}/sass_embedded-${env:DART_SASS_VERSION}-windows-x64.zip";
-        Expand-Archive -Path "sass_embedded-${env:DART_SASS_VERSION}-windows-x64.zip" -DestinationPath .;
+        curl -LJO https://github.com/sass/dart-sass-embedded/releases/download/1.0.0-beta.6/sass_embedded-1.0.0-beta.6-windows-x64.zip;
+        echo "6ae442129dbb3334bc21ef851261da6c0c1b560da790ca2e1350871d00ab816d  sass_embedded-1.0.0-beta.6-windows-x64.zip" | sha256sum -c;
+        unzip sass_embedded-1.0.0-beta.6-windows-x64.zip;
        echo  "$env:GITHUB_WORKSPACE/sass_embedded/" | Out-File -FilePath $Env:GITHUB_PATH -Encoding utf-8 -Append
    - name: Check
      run: |
@@ -2,7 +2,7 @@
 # Twitter:      https://twitter.com/gohugoio
 # Website:      https://gohugo.io/

-FROM golang:1.19-alpine AS build
+FROM golang:1.18-alpine AS build

 # Optionally set HUGO_BUILD_TAGS to "extended" or "nodeploy" when building like so:
 #   docker build --build-arg HUGO_BUILD_TAGS=extended .
@@ -26,7 +26,7 @@ RUN mage hugo && mage install

 # ---

-FROM alpine:3.16
+FROM alpine:3.12

 COPY --from=build /go/bin/hugo /usr/bin/hugo

@@ -186,7 +186,7 @@
      same "printed page" as the copyright notice for easier
      identification within third-party archives.

-   Copyright 2022 The Hugo Authors.
+   Copyright [yyyy] [name of copyright owner]

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
 <a href="https://gohugo.io/"><img src="https://raw.githubusercontent.com/gohugoio/gohugoioTheme/master/static/images/hugo-logo-wide.svg?sanitize=true" alt="Hugo" width="565"></a>

-A Fast and Flexible Static Site Generator built with love by [bep](https://github.com/bep), [spf13](https://spf13.com/) and [friends](https://github.com/gohugoio/hugo/graphs/contributors) in [Go](https://go.dev/).
+A Fast and Flexible Static Site Generator built with love by [bep](https://github.com/bep), [spf13](https://spf13.com/) and [friends](https://github.com/gohugoio/hugo/graphs/contributors) in [Go][].

 [Website](https://gohugo.io) |
 [Forum](https://discourse.gohugo.io) |
@@ -13,19 +13,9 @@ A Fast and Flexible Static Site Generator built with love by [bep](https://githu
 [![Tests on Linux, MacOS and Windows](https://github.com/gohugoio/hugo/workflows/Test/badge.svg)](https://github.com/gohugoio/hugo/actions?query=workflow%3ATest)
 [![Go Report Card](https://goreportcard.com/badge/github.com/gohugoio/hugo)](https://goreportcard.com/report/github.com/gohugoio/hugo)

-* [Overview](#overview)
-* [Banner Sponsors](#banner-sponsors)
-* [Supported Architectures](#supported-architectures)
-* [Choose How to Install](#choose-how-to-install)
-   * [Install Hugo as Your Site Generator (Binary Install)](#install-hugo-as-your-site-generator-binary-install)
-   * [Build and Install the Binary from Source (Using the Go toolchain)](#build-and-install-the-binary-from-source-using-the-go-toolchain)
-* [The Hugo Documentation](#the-hugo-documentation)
-* [Contributing to Hugo](#contributing-code-to-hugo)
-* [Dependencies](#dependencies)
-
 ## Overview

-Hugo is a static HTML and CSS website generator written in [Go](https://go.dev/).
+Hugo is a static HTML and CSS website generator written in [Go][].
 It is optimized for speed, ease of use, and configurability.
 Hugo takes a directory with content and templates and renders them into a full HTML website.

@@ -37,16 +27,7 @@ A good rule of thumb is that each piece of content renders in around 1 milliseco

 Hugo is designed to work well for any kind of website including blogs, tumbles, and docs.

-## Banner Sponsors
-<p>&nbsp;</p>
-<p float="left">
-  <a href="https://www.linode.com/?utm_campaign=hugosponsor&utm_medium=banner&utm_source=hugogithub" target="_blank"><img src="https://raw.githubusercontent.com/gohugoio/gohugoioTheme/master/static/images/sponsors/linode-logo_standard_light_medium.png" width="200" alt="Linode"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<a href="https://esolia.com/post/why-did-esolia-choose-hugo/?utm_campaign=hugosponsor&utm_medium=banner&utm_source=hugogithub" target="_blank"><img src="https://raw.githubusercontent.com/gohugoio/gohugoioTheme/master/static/images/sponsors/esolia-logo.svg?sanitize=true" width="200" alt="eSOLIA"></a>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://buttercms.com/hugo-cms/?utm_campaign=sponsorship&utm_medium=banner&utm_source=hugogithub" target="_blank"><img src="https://raw.githubusercontent.com/gohugoio/gohugoioTheme/master/static/images/sponsors/butter-dark.svg?sanitize=true" width="280" alt="ButterCMS"></a>
-</p>
-<p>&nbsp;</p>
-
-## Supported Architectures
+#### Supported Architectures

 Currently, we provide pre-built Hugo binaries for Windows, Linux, FreeBSD, NetBSD, DragonFly BSD, OpenBSD, macOS (Darwin), and [Android](https://gist.github.com/bep/a0d8a26cf6b4f8bc992729b8e50b480b) for x64, i386 and ARM architectures.

@@ -57,6 +38,7 @@ Hugo may also be compiled from source wherever the Go compiler tool chain can ru
 ## Choose How to Install

 If you want to use Hugo as your site generator, simply install the Hugo binaries.
+The Hugo binaries have no external dependencies.

 To contribute to the Hugo source code or documentation, you should [fork the Hugo GitHub project](https://github.com/gohugoio/hugo#fork-destination-box) and clone it to your local machine.

@@ -67,24 +49,31 @@ Building the binaries is an easy task for an experienced `go` getter.

 Use the [installation instructions in the Hugo documentation](https://gohugo.io/getting-started/installing/).

-### Build and Install the Binary from Source (Using the Go toolchain)
+### Build and Install the Binaries from Source (Advanced Install)

 #### Prerequisite Tools

+* [Git](https://git-scm.com/)
 * [Go (we test it with the last 2 major versions; but note that Hugo 0.95.0 only builds with >= Go 1.18.)](https://golang.org/dl/)

 #### Fetch from GitHub

-To fetch, build and install from the Github source:
+To fetch and build the source from GitHub:

 ```bash
-go install github.com/gohugoio/hugo@latest
+mkdir $HOME/src
+cd $HOME/src
+git clone https://github.com/gohugoio/hugo.git
+cd hugo
+go install
 ```

+**If you are a Windows user, substitute the `$HOME` environment variable above with `%USERPROFILE%`.**
+
 If you want to compile with Sass/SCSS support use `--tags extended` and make sure `CGO_ENABLED=1` is set in your go environment. If you don't want to have CGO enabled, you may use the following command to temporarily enable CGO only for hugo compilation:

 ```bash
-CGO_ENABLED=1 go install --tags extended github.com/gohugoio/hugo@latest
+CGO_ENABLED=1 go install --tags extended
 ```

 ## The Hugo Documentation
@@ -94,7 +83,7 @@ The Hugo documentation now lives in its own repository, see https://github.com/g
 ```bash
 git clone git@github.com:gohugoio/hugo.git
 ```
-## Contributing code to Hugo
+## Contributing to Hugo

 **Note  March 16th 2022:** We are currently very constrained on human resources to do code reviews, so we currently require any new Pull Requests to be limited to bug fixes closing an existing issue. Also, we have updated to Go 1.18, but we will currently not accept any generic rewrites, "interface{} to any" replacements and similar.

@@ -107,18 +96,34 @@ helping to manage issues, etc.

 The Hugo community and maintainers are [very active](https://github.com/gohugoio/hugo/pulse/monthly) and helpful, and the project benefits greatly from this activity.

-## Asking Support Questions
+### Asking Support Questions

 We have an active [discussion forum](https://discourse.gohugo.io) where users and developers can ask questions.
 Please don't use the GitHub issue tracker to ask questions.

-## Reporting Issues
+### Reporting Issues

 If you believe you have found a defect in Hugo or its documentation, use
 the GitHub issue tracker to report the problem to the Hugo maintainers.
 If you're not sure if it's a bug or not, start by asking in the [discussion forum](https://discourse.gohugo.io).
 When reporting the issue, please provide the version of Hugo in use (`hugo version`).

+### Submitting Patches
+
+The Hugo project welcomes all contributors and contributions regardless of skill or experience level.
+If you are interested in helping with the project, we will help you with your contribution.
+Hugo is a very active project with many contributions happening daily.
+
+We want to create the best possible product for our users and the best contribution experience for our developers,
+we have a set of guidelines which ensure that all contributions are acceptable.
+The guidelines are not intended as a filter or barrier to participation.
+If you are unfamiliar with the contribution process, the Hugo team will help you and teach you how to bring your contribution in accordance with the guidelines.
+
+For a complete guide to contributing code to Hugo, see the [Contribution Guide](CONTRIBUTING.md).
+
+[Go]: https://golang.org/
+[Hugo Documentation]: https://gohugo.io/overview/introduction/
+
 ## Dependencies

 Hugo stands on the shoulder of many great open source libraries.
@@ -240,3 +245,4 @@ google.golang.org/grpc="v1.46.0"
 google.golang.org/protobuf="v1.28.0"
 gopkg.in/yaml.v2="v2.4.0"
 ```
+
@@ -18,7 +18,6 @@ import (
 	"io"
 	"os"

-	"github.com/gohugoio/hugo/common/herrors"
 	"github.com/gohugoio/hugo/hugofs"

 	"github.com/spf13/afero"
@@ -37,7 +36,7 @@ func (c Caches) Prune() (int, error) {
 		counter += count

 		if err != nil {
-			if herrors.IsNotExist(err) {
+			if os.IsNotExist(err) {
 				continue
 			}
 			return counter, fmt.Errorf("failed to prune cache %q: %w", k, err)
@@ -77,7 +76,7 @@ func (c *Cache) Prune(force bool) (int, error) {
 				err = c.Fs.Remove(name)
 			}

-			if err != nil && !herrors.IsNotExist(err) {
+			if err != nil && !os.IsNotExist(err) {
 				return err
 			}

@@ -98,7 +97,7 @@ func (c *Cache) Prune(force bool) (int, error) {
 				counter++
 			}

-			if err != nil && !herrors.IsNotExist(err) {
+			if err != nil && !os.IsNotExist(err) {
 				return err
 			}

@@ -113,7 +112,7 @@ func (c *Cache) Prune(force bool) (int, error) {
 func (c *Cache) pruneRootDir(force bool) (int, error) {
 	info, err := c.Fs.Stat(c.pruneAllRootDir)
 	if err != nil {
-		if herrors.IsNotExist(err) {
+		if os.IsNotExist(err) {
 			return 0, nil
 		}
 		return 0, err
@@ -79,8 +79,8 @@ type commandeer struct {
 	changeDetector *fileChangeDetector

 	// We need to reuse these on server rebuilds.
+	// These 2 will be different if --renderStaticToDisk is set.
 	publishDirFs       afero.Fs
-	publishDirStaticFs afero.Fs
 	publishDirServerFs afero.Fs

 	h    *hugoBuilderCommon
@@ -170,7 +170,6 @@ func (c *commandeer) Set(key string, value any) {

 func (c *commandeer) initFs(fs *hugofs.Fs) error {
 	c.publishDirFs = fs.PublishDir
-	c.publishDirStaticFs = fs.PublishDirStatic
 	c.publishDirServerFs = fs.PublishDirServer
 	c.DepsCfg.Fs = fs

@@ -383,7 +382,7 @@ func (c *commandeer) loadConfig() error {

 	// Set some commonly used flags
 	c.doLiveReload = c.running && !c.Cfg.GetBool("disableLiveReload")
-	c.fastRenderMode = c.running && !c.Cfg.GetBool("disableFastRender")
+	c.fastRenderMode = c.doLiveReload && !c.Cfg.GetBool("disableFastRender")
 	c.showErrorInBrowser = c.doLiveReload && !c.Cfg.GetBool("disableBrowserError")

 	// This is potentially double work, but we need to do this one more time now
@@ -408,9 +407,6 @@ func (c *commandeer) loadConfig() error {

 	createMemFs := config.GetBool("renderToMemory")
 	c.renderStaticToDisk = config.GetBool("renderStaticToDisk")
-	// TODO(bep) we/I really need to look at the config set up, but to prevent changing too much
-	// we store away the original.
-	config.Set("publishDirOrig", config.GetString("publishDir"))

 	if createMemFs {
 		// Rendering to memoryFS, publish to Root regardless of publishDir.
@@ -430,7 +426,6 @@ func (c *commandeer) loadConfig() error {
 		if c.publishDirFs != nil {
 			// Need to reuse the destination on server rebuilds.
 			fs.PublishDir = c.publishDirFs
-			fs.PublishDirStatic = c.publishDirStaticFs
 			fs.PublishDirServer = c.publishDirServerFs
 		} else {
 			if c.renderStaticToDisk {
@@ -47,7 +47,7 @@ func TestExecute(t *testing.T) {
 		c.Assert(resp.Err, qt.IsNil)
 		result := resp.Result
 		c.Assert(len(result.Sites) == 1, qt.Equals, true)
-		c.Assert(len(result.Sites[0].RegularPages()) == 2, qt.Equals, true)
+		c.Assert(len(result.Sites[0].RegularPages()) == 1, qt.Equals, true)
 		c.Assert(result.Sites[0].Info.Params()["myparam"], qt.Equals, "paramproduction")
 	})

@@ -117,13 +117,11 @@ func TestExecute(t *testing.T) {

 func checkNewSiteInited(c *qt.C, basepath string) {
 	paths := []string{
-		filepath.Join(basepath, "archetypes"),
-		filepath.Join(basepath, "assets"),
-		filepath.Join(basepath, "content"),
-		filepath.Join(basepath, "data"),
 		filepath.Join(basepath, "layouts"),
+		filepath.Join(basepath, "content"),
+		filepath.Join(basepath, "archetypes"),
 		filepath.Join(basepath, "static"),
-		filepath.Join(basepath, "themes"),
+		filepath.Join(basepath, "data"),
 		filepath.Join(basepath, "config.toml"),
 	}

@@ -364,25 +362,11 @@ weight: 1

 Content

-`)
-
-	writeFile(t, filepath.Join(dir, contentDir, "hügö.md"), `
---
-weight: 2
---
-
-This is hügö.
-
 `)

 	writeFile(t, filepath.Join(dir, "layouts", "_default", "single.html"), `

-Single: {{ .Title }}|{{ .Content }}
-
-`)
-
-	writeFile(t, filepath.Join(dir, "layouts", "404.html"), `
-404: {{ .Title }}|Not Found.
+Single: {{ .Title }}

 `)

@@ -50,14 +50,6 @@ If you add the -v flag, you will get a full dependency list.
 					for _, dep := range deps {
 						jww.FEEDBACK.Printf("%s\n", dep)
 					}
-				} else {
-					// These are also included in the GetDependencyList above;
-					// always print these as these are most likely the most useful to know about.
-					deps := hugo.GetDependencyListNonGo()
-					for _, dep := range deps {
-						jww.FEEDBACK.Printf("%s\n", dep)
-					}
-
 				}

 				return nil
@@ -511,15 +511,12 @@ func (c *commandeer) build() error {
 		c.hugo().PrintProcessingStats(os.Stdout)
 		fmt.Println()

-		hugofs.WalkFilesystems(c.publishDirFs, func(fs afero.Fs) bool {
-			if dfs, ok := fs.(hugofs.DuplicatesReporter); ok {
-				dupes := dfs.ReportDuplicates()
-				if dupes != "" {
-					c.logger.Warnln("Duplicate target paths:", dupes)
-				}
+		if createCounter, ok := c.publishDirFs.(hugofs.DuplicatesReporter); ok {
+			dupes := createCounter.ReportDuplicates()
+			if dupes != "" {
+				c.logger.Warnln("Duplicate target paths:", dupes)
 			}
-			return false
-		})
+		}

 		unusedTemplates := c.hugo().Tmpl().(tpl.UnusedTemplatesProvider).UnusedTemplates()
 		for _, unusedTemplate := range unusedTemplates {
@@ -579,7 +576,7 @@ func (c *commandeer) serverBuild() error {

 func (c *commandeer) copyStatic() (map[string]uint64, error) {
 	m, err := c.doWithPublishDirs(c.copyStaticTo)
-	if err == nil || herrors.IsNotExist(err) {
+	if err == nil || os.IsNotExist(err) {
 		return m, nil
 	}
 	return m, err
@@ -653,7 +650,10 @@ func (c *commandeer) copyStaticTo(sourceFs *filesystems.SourceFilesystem) (uint6
 	syncer.NoChmod = c.Cfg.GetBool("noChmod")
 	syncer.ChmodFilter = chmodFilter
 	syncer.SrcFs = fs
-	syncer.DestFs = c.Fs.PublishDirStatic
+	syncer.DestFs = c.Fs.PublishDir
+	if c.renderStaticToDisk {
+		syncer.DestFs = c.Fs.PublishDirStatic
+	}
 	// Now that we are using a unionFs for the static directories
 	// We can effectively clean the publishDir on initial sync
 	syncer.Delete = c.Cfg.GetBool("cleanDestinationDir")
@@ -899,7 +899,7 @@ func (c *commandeer) newWatcher(pollIntervalStr string, dirList ...string) (*wat
 				}
 				unlock()
 			case err := <-watcher.Errors():
-				if err != nil && !herrors.IsNotExist(err) {
+				if err != nil && !os.IsNotExist(err) {
 					c.logger.Errorln("Error while watching:", err)
 				}
 			}
@@ -924,7 +924,6 @@ func (c *commandeer) printChangeDetected(typ string) {
 const (
 	configChangeConfig = "config file"
 	configChangeGoMod  = "go.mod file"
-	configChangeGoWork = "go work file"
 )

 func (c *commandeer) handleEvents(watcher *watcher.Batcher,
@@ -944,9 +943,6 @@ func (c *commandeer) handleEvents(watcher *watcher.Batcher,
 			if strings.Contains(ev.Name, "go.mod") {
 				configChangeType = configChangeGoMod
 			}
-			if strings.Contains(ev.Name, ".work") {
-				configChangeType = configChangeGoWork
-			}
 		}
 		if !isConfig {
 			// It may be one of the /config folders
@@ -32,7 +32,6 @@ var _ cmder = (*newCmd)(nil)
 type newCmd struct {
 	contentEditor string
 	contentType   string
-	force         bool

 	*baseBuilderCmd
 }
@@ -55,7 +54,6 @@ Ensure you run this within the root directory of your site.`,

 	cmd.Flags().StringVarP(&cc.contentType, "kind", "k", "", "content type to create")
 	cmd.Flags().StringVar(&cc.contentEditor, "editor", "", "edit new content with this editor, if provided")
-	cmd.Flags().BoolVarP(&cc.force, "force", "f", false, "overwrite file if it already exists")

 	cmd.AddCommand(b.newNewSiteCmd().getCommand())
 	cmd.AddCommand(b.newNewThemeCmd().getCommand())
@@ -82,7 +80,7 @@ func (n *newCmd) newContent(cmd *cobra.Command, args []string) error {
 		return newUserError("path needs to be provided")
 	}

-	return create.NewContent(c.hugo(), n.contentType, args[0], n.force)
+	return create.NewContent(c.hugo(), n.contentType, args[0])
 }

 func mkdir(x ...string) {
@@ -62,12 +62,11 @@ Use ` + "`hugo new [contentPath]`" + ` to create new content.`,
 func (n *newSiteCmd) doNewSite(fs *hugofs.Fs, basepath string, force bool) error {
 	archeTypePath := filepath.Join(basepath, "archetypes")
 	dirs := []string{
-		archeTypePath,
-		filepath.Join(basepath, "assets"),
-		filepath.Join(basepath, "content"),
-		filepath.Join(basepath, "data"),
 		filepath.Join(basepath, "layouts"),
+		filepath.Join(basepath, "content"),
+		archeTypePath,
 		filepath.Join(basepath, "static"),
+		filepath.Join(basepath, "data"),
 		filepath.Join(basepath, "themes"),
 	}

@@ -17,6 +17,8 @@
 package commands

 import (
+	"errors"
+
 	"github.com/gohugoio/hugo/config"
 	"github.com/gohugoio/hugo/releaser"
 	"github.com/spf13/cobra"
@@ -27,9 +29,10 @@ var _ cmder = (*releaseCommandeer)(nil)
 type releaseCommandeer struct {
 	cmd *cobra.Command

-	step     int
-	skipPush bool
-	try      bool
+	version string
+
+	skipPublish bool
+	try         bool
 }

 func createReleaser() cmder {
@@ -47,9 +50,9 @@ func createReleaser() cmder {
 		return r.release()
 	}

-	r.cmd.PersistentFlags().BoolVarP(&r.skipPush, "skip-push", "", false, "skip pushing to remote")
-	r.cmd.PersistentFlags().BoolVarP(&r.try, "try", "", false, "no changes")
-	r.cmd.PersistentFlags().IntVarP(&r.step, "step", "", 0, "step to run (1: set new version 2: prepare next dev version)")
+	r.cmd.PersistentFlags().StringVarP(&r.version, "rel", "r", "", "new release version, i.e. 0.25.1")
+	r.cmd.PersistentFlags().BoolVarP(&r.skipPublish, "skip-publish", "", false, "skip all publishing pipes of the release")
+	r.cmd.PersistentFlags().BoolVarP(&r.try, "try", "", false, "simulate a release, i.e. no changes")

 	return r
 }
@@ -62,10 +65,8 @@ func (c *releaseCommandeer) flagsToConfig(cfg config.Provider) {
 }

 func (r *releaseCommandeer) release() error {
-	rel, err := releaser.New(r.skipPush, r.try, r.step)
-	if err != nil {
-		return err
+	if r.version == "" {
+		return errors.New("must set the --rel flag to the relevant version number")
 	}
-
-	return rel.Run()
+	return releaser.New(r.version, r.skipPublish, r.try).Run()
 }
@@ -400,31 +400,24 @@ func (f *fileServer) createEndpoint(i int) (*http.ServeMux, net.Listener, string
 			}

 			// Ignore any query params for the operations below.
-			requestURI, _ := url.PathUnescape(strings.TrimSuffix(r.RequestURI, "?"+r.URL.RawQuery))
+			requestURI := strings.TrimSuffix(r.RequestURI, "?"+r.URL.RawQuery)

 			for _, header := range f.c.serverConfig.MatchHeaders(requestURI) {
 				w.Header().Set(header.Key, header.Value)
 			}

 			if redirect := f.c.serverConfig.MatchRedirect(requestURI); !redirect.IsZero() {
-				// fullName := filepath.Join(dir, filepath.FromSlash(path.Clean("/"+name)))
 				doRedirect := true
 				// This matches Netlify's behaviour and is needed for SPA behaviour.
 				// See https://docs.netlify.com/routing/redirects/rewrites-proxies/
 				if !redirect.Force {
 					path := filepath.Clean(strings.TrimPrefix(requestURI, u.Path))
-					if root != "" {
-						path = filepath.Join(root, path)
-					}
-					fs := f.c.publishDirServerFs
-
-					fi, err := fs.Stat(path)
-
+					fi, err := f.c.hugo().BaseFs.PublishFs.Stat(path)
 					if err == nil {
 						if fi.IsDir() {
 							// There will be overlapping directories, so we
 							// need to check for a file.
-							_, err = fs.Stat(filepath.Join(path, "index.html"))
+							_, err = f.c.hugo().BaseFs.PublishFs.Stat(filepath.Join(path, "index.html"))
 							doRedirect = err != nil
 						} else {
 							doRedirect = false
@@ -433,28 +426,15 @@ func (f *fileServer) createEndpoint(i int) (*http.ServeMux, net.Listener, string
 				}

 				if doRedirect {
-					switch redirect.Status {
-					case 404:
-						w.WriteHeader(404)
-						file, err := fs.Open(strings.TrimPrefix(redirect.To, u.Path))
-						if err == nil {
-							defer file.Close()
-							io.Copy(w, file)
-						} else {
-							fmt.Fprintln(w, "<h1>Page Not Found</h1>")
-						}
-						return
-					case 200:
+					if redirect.Status == 200 {
 						if r2 := f.rewriteRequest(r, strings.TrimPrefix(redirect.To, u.Path)); r2 != nil {
 							requestURI = redirect.To
 							r = r2
 						}
-						fallthrough
-					default:
+					} else {
 						w.Header().Set("Content-Type", "")
 						http.Redirect(w, r, redirect.To, redirect.Status)
 						return
-
 					}
 				}

@@ -25,7 +25,6 @@ import (

 	"github.com/gohugoio/hugo/config"
 	"github.com/gohugoio/hugo/helpers"
-	"github.com/gohugoio/hugo/htesting"
 	"golang.org/x/net/context"
 	"golang.org/x/sync/errgroup"

@@ -42,98 +41,12 @@ func TestServerPanicOnConfigError(t *testing.T) {
 linenos='table'
 `

-	r := runServerTest(c,
-		serverTestOptions{
-			config: config,
-		},
-	)
+	r := runServerTest(c, 0, config)

 	c.Assert(r.err, qt.IsNotNil)
 	c.Assert(r.err.Error(), qt.Contains, "cannot parse 'Highlight.LineNos' as bool:")
 }

-func TestServer404(t *testing.T) {
-	c := qt.New(t)
-
-	r := runServerTest(c,
-		serverTestOptions{
-			pathsToGet:  []string{"this/does/not/exist"},
-			getNumHomes: 1,
-		},
-	)
-
-	c.Assert(r.err, qt.IsNil)
-	pr := r.pathsResults["this/does/not/exist"]
-	c.Assert(pr.statusCode, qt.Equals, http.StatusNotFound)
-	c.Assert(pr.body, qt.Contains, "404: 404 Page not found|Not Found.")
-}
-
-func TestServerPathEncodingIssues(t *testing.T) {
-	c := qt.New(t)
-
-	// Issue 10287
-	c.Run("Unicode paths", func(c *qt.C) {
-		r := runServerTest(c,
-			serverTestOptions{
-				pathsToGet:  []string{"hügö/"},
-				getNumHomes: 1,
-			},
-		)
-
-		c.Assert(r.err, qt.IsNil)
-		c.Assert(r.pathsResults["hügö/"].body, qt.Contains, "This is hügö")
-	})
-
-	// Issue 10314
-	c.Run("Windows multilingual 404", func(c *qt.C) {
-		config := `
-baseURL = 'https://example.org/'
-title = 'Hugo Forum Topic #40568'
-
-defaultContentLanguageInSubdir = true
-
-[languages.en]
-contentDir = 'content/en'
-languageCode = 'en-US'
-languageName = 'English'
-weight = 1
-
-[languages.es]
-contentDir = 'content/es'
-languageCode = 'es-ES'
-languageName = 'Espanol'
-weight = 2
-
-[server]
-[[server.redirects]]
-from = '/en/**'
-to = '/en/404.html'
-status = 404
-
-[[server.redirects]]
-from = '/es/**'
-to = '/es/404.html'
-status = 404
-`
-		r := runServerTest(c,
-			serverTestOptions{
-				config:      config,
-				pathsToGet:  []string{"en/this/does/not/exist", "es/this/does/not/exist"},
-				getNumHomes: 1,
-			},
-		)
-
-		c.Assert(r.err, qt.IsNil)
-		pr1 := r.pathsResults["en/this/does/not/exist"]
-		pr2 := r.pathsResults["es/this/does/not/exist"]
-		c.Assert(pr1.statusCode, qt.Equals, http.StatusNotFound)
-		c.Assert(pr2.statusCode, qt.Equals, http.StatusNotFound)
-		c.Assert(pr1.body, qt.Contains, "404: 404 Page not found|Not Found.")
-		c.Assert(pr2.body, qt.Contains, "404: 404 Page not found|Not Found.")
-
-	})
-
-}
 func TestServerFlags(t *testing.T) {
 	c := qt.New(t)

@@ -168,13 +81,7 @@ baseURL="https://example.org"
 				args = strings.Split(test.flag, "=")
 			}

-			opts := serverTestOptions{
-				config:      config,
-				args:        args,
-				getNumHomes: 1,
-			}
-
-			r := runServerTest(c, opts)
+			r := runServerTest(c, 1, config, args...)

 			test.assert(c, r)

@@ -185,10 +92,6 @@ baseURL="https://example.org"
 }

 func TestServerBugs(t *testing.T) {
-	// TODO(bep) this is flaky on Windows on GH Actions.
-	if htesting.IsGitHubAction() && runtime.GOOS == "windows" {
-		t.Skip("skipping on windows")
-	}
 	c := qt.New(t)

 	for _, test := range []struct {
@@ -198,10 +101,6 @@ func TestServerBugs(t *testing.T) {
 		numservers int
 		assert     func(c *qt.C, r serverTestResult)
 	}{
-		{"PostProcess, memory", "", "", 1, func(c *qt.C, r serverTestResult) {
-			c.Assert(r.err, qt.IsNil)
-			c.Assert(r.homesContent[0], qt.Contains, "PostProcess: /foo.min.css")
-		}},
 		// Issue 9788
 		{"PostProcess, memory", "", "", 1, func(c *qt.C, r serverTestResult) {
 			c.Assert(r.err, qt.IsNil)
@@ -241,18 +140,7 @@ baseURL="https://example.org"
 			if test.flag != "" {
 				args = strings.Split(test.flag, "=")
 			}
-
-			opts := serverTestOptions{
-				config:      test.config,
-				getNumHomes: test.numservers,
-				pathsToGet:  []string{"this/does/not/exist"},
-				args:        args,
-			}
-
-			r := runServerTest(c, opts)
-			pr := r.pathsResults["this/does/not/exist"]
-			c.Assert(pr.statusCode, qt.Equals, http.StatusNotFound)
-			c.Assert(pr.body, qt.Contains, "404: 404 Page not found|Not Found.")
+			r := runServerTest(c, test.numservers, test.config, args...)
 			test.assert(c, r)

 		})
@@ -264,29 +152,11 @@ baseURL="https://example.org"
 type serverTestResult struct {
 	err            error
 	homesContent   []string
-	content404     string
 	publicDirnames map[string]bool
-	pathsResults   map[string]pathResult
 }

-type pathResult struct {
-	statusCode int
-	body       string
-}
-
-type serverTestOptions struct {
-	getNumHomes int
-	config      string
-	pathsToGet  []string
-	args        []string
-}
-
-func runServerTest(c *qt.C, opts serverTestOptions) serverTestResult {
-	dir := createSimpleTestSite(c, testSiteConfig{configTOML: opts.config})
-	result := serverTestResult{
-		publicDirnames: make(map[string]bool),
-		pathsResults:   make(map[string]pathResult),
-	}
+func runServerTest(c *qt.C, getNumHomes int, config string, args ...string) (result serverTestResult) {
+	dir := createSimpleTestSite(c, testSiteConfig{configTOML: config})

 	sp, err := helpers.FindAvailablePort()
 	c.Assert(err, qt.IsNil)
@@ -302,7 +172,7 @@ func runServerTest(c *qt.C, opts serverTestOptions) serverTestResult {
 	scmd := b.newServerCmdSignaled(stop)

 	cmd := scmd.getCommand()
-	args := append([]string{"-s=" + dir, fmt.Sprintf("-p=%d", port)}, opts.args...)
+	args = append([]string{"-s=" + dir, fmt.Sprintf("-p=%d", port)}, args...)
 	cmd.SetArgs(args)

 	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
@@ -314,20 +184,16 @@ func runServerTest(c *qt.C, opts serverTestOptions) serverTestResult {
 		return err
 	})

-	if opts.getNumHomes > 0 {
+	if getNumHomes > 0 {
 		// Esp. on slow CI machines, we need to wait a little before the web
 		// server is ready.
-		wait := 567 * time.Millisecond
-		if os.Getenv("CI") != "" {
-			wait = 2 * time.Second
-		}
-		time.Sleep(wait)
-		result.homesContent = make([]string, opts.getNumHomes)
-		for i := 0; i < opts.getNumHomes; i++ {
+		time.Sleep(567 * time.Millisecond)
+		result.homesContent = make([]string, getNumHomes)
+		for i := 0; i < getNumHomes; i++ {
 			func() {
 				resp, err := http.Get(fmt.Sprintf("http://localhost:%d/", port+i))
-				c.Assert(err, qt.IsNil)
-				c.Assert(resp.StatusCode, qt.Equals, http.StatusOK)
+				c.Check(err, qt.IsNil)
+				c.Check(resp.StatusCode, qt.Equals, http.StatusOK)
 				if err == nil {
 					defer resp.Body.Close()
 					result.homesContent[i] = helpers.ReaderToString(resp.Body)
@@ -336,22 +202,6 @@ func runServerTest(c *qt.C, opts serverTestOptions) serverTestResult {
 		}
 	}

-	for _, path := range opts.pathsToGet {
-		func() {
-			resp, err := http.Get(fmt.Sprintf("http://localhost:%d/%s", port, path))
-			c.Assert(err, qt.IsNil)
-			pr := pathResult{
-				statusCode: resp.StatusCode,
-			}
-
-			if err == nil {
-				defer resp.Body.Close()
-				pr.body = helpers.ReaderToString(resp.Body)
-			}
-			result.pathsResults[path] = pr
-		}()
-	}
-
 	time.Sleep(1 * time.Second)

 	select {
@@ -360,14 +210,15 @@ func runServerTest(c *qt.C, opts serverTestOptions) serverTestResult {
 	}

 	pubFiles, err := os.ReadDir(filepath.Join(dir, "public"))
-	c.Assert(err, qt.IsNil)
+	c.Check(err, qt.IsNil)
+	result.publicDirnames = make(map[string]bool)
 	for _, f := range pubFiles {
 		result.publicDirnames[f.Name()] = true
 	}

 	result.err = wg.Wait()

-	return result
+	return

 }

@@ -14,9 +14,9 @@
 package commands

 import (
+	"os"
 	"path/filepath"

-	"github.com/gohugoio/hugo/common/herrors"
 	"github.com/gohugoio/hugo/hugolib/filesystems"

 	"github.com/fsnotify/fsnotify"
@@ -95,7 +95,7 @@ func (s *staticSyncer) syncsStaticEvents(staticEvents []fsnotify.Event) error {
 			// the source of that static file. In this case Hugo will incorrectly remove that file
 			// from the published directory.
 			if ev.Op&fsnotify.Rename == fsnotify.Rename || ev.Op&fsnotify.Remove == fsnotify.Remove {
-				if _, err := sourceFs.Fs.Stat(relPath); herrors.IsNotExist(err) {
+				if _, err := sourceFs.Fs.Stat(relPath); os.IsNotExist(err) {
 					// If file doesn't exist in any static dir, remove it
 					logger.Println("File no longer exists in static dir, removing", relPath)
 					_ = c.Fs.PublishDirStatic.RemoveAll(relPath)
@@ -1,4 +1,4 @@
-// Copyright 2022 The Hugo Authors. All rights reserved.
+// Copyright 2018 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.
@@ -19,7 +19,6 @@ import (
 	"errors"
 	"fmt"
 	"io"
-	"os"
 	"runtime"
 	"runtime/debug"
 	"strconv"
@@ -39,8 +38,7 @@ type ErrorSender interface {

 // Recover is a helper function that can be used to capture panics.
 // Put this at the top of a method/function that crashes in a template:
-//
-//	defer herrors.Recover()
+//     defer herrors.Recover()
 func Recover(args ...any) {
 	if r := recover(); r != nil {
 		fmt.Println("ERR:", r)
@@ -71,18 +69,3 @@ func Must(err error) {
 		panic(err)
 	}
 }
-
-// IsNotExist returns true if the error is a file not found error.
-// Unlike os.IsNotExist, this also considers wrapped errors.
-func IsNotExist(err error) bool {
-	if os.IsNotExist(err) {
-		return true
-	}
-
-	// os.IsNotExist does not consider wrapped errors.
-	if os.IsNotExist(errors.Unwrap(err)) {
-		return true
-	}
-
-	return false
-}
@@ -1,36 +0,0 @@
-// Copyright 2022 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 herrors
-
-import (
-	"fmt"
-	"testing"
-
-	qt "github.com/frankban/quicktest"
-	"github.com/spf13/afero"
-)
-
-func TestIsNotExist(t *testing.T) {
-	c := qt.New(t)
-
-	c.Assert(IsNotExist(afero.ErrFileNotFound), qt.Equals, true)
-	c.Assert(IsNotExist(afero.ErrFileExists), qt.Equals, false)
-	c.Assert(IsNotExist(afero.ErrDestinationExists), qt.Equals, false)
-	c.Assert(IsNotExist(nil), qt.Equals, false)
-
-	c.Assert(IsNotExist(fmt.Errorf("foo")), qt.Equals, false)
-
-	// os.IsNotExist returns false for wrapped errors.
-	c.Assert(IsNotExist(fmt.Errorf("foo: %w", afero.ErrFileNotFound)), qt.Equals, true)
-}
@@ -16,6 +16,8 @@ package hugio
 import (
 	"fmt"
 	"io"
+	"io/ioutil"
+	"os"
 	"path/filepath"

 	"github.com/spf13/afero"
@@ -51,7 +53,7 @@ func CopyFile(fs afero.Fs, from, to string) error {

 // CopyDir copies a directory.
 func CopyDir(fs afero.Fs, from, to string, shouldCopy func(filename string) bool) error {
-	fi, err := fs.Stat(from)
+	fi, err := os.Stat(from)
 	if err != nil {
 		return err
 	}
@@ -65,7 +67,7 @@ func CopyDir(fs afero.Fs, from, to string, shouldCopy func(filename string) bool
 		return err
 	}

-	entries, _ := afero.ReadDir(fs, from)
+	entries, _ := ioutil.ReadDir(from)
 	for _, entry := range entries {
 		fromFilename := filepath.Join(from, entry.Name())
 		toFilename := filepath.Join(to, entry.Name())
@@ -1,57 +0,0 @@
-// Copyright 2022 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 hugio
-
-import (
-	"bytes"
-)
-
-// HasBytesWriter is a writer that will set Match to true if the given pattern
-// is found in the stream.
-type HasBytesWriter struct {
-	Match   bool
-	Pattern []byte
-
-	i    int
-	done bool
-	buff []byte
-}
-
-func (h *HasBytesWriter) Write(p []byte) (n int, err error) {
-	if h.done {
-		return len(p), nil
-	}
-
-	if len(h.buff) == 0 {
-		h.buff = make([]byte, len(h.Pattern)*2)
-	}
-
-	for i := range p {
-		h.buff[h.i] = p[i]
-		h.i++
-		if h.i == len(h.buff) {
-			// Shift left.
-			copy(h.buff, h.buff[len(h.buff)/2:])
-			h.i = len(h.buff) / 2
-		}
-
-		if bytes.Contains(h.buff, h.Pattern) {
-			h.Match = true
-			h.done = true
-			return len(p), nil
-		}
-	}
-
-	return len(p), nil
-}
@@ -1,64 +0,0 @@
-// Copyright 2022 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 hugio
-
-import (
-	"bytes"
-	"fmt"
-	"io"
-	"math/rand"
-	"strings"
-	"testing"
-	"time"
-
-	qt "github.com/frankban/quicktest"
-)
-
-func TestHasBytesWriter(t *testing.T) {
-	r := rand.New(rand.NewSource(time.Now().UnixNano()))
-
-	c := qt.New((t))
-
-	neww := func() (*HasBytesWriter, io.Writer) {
-		var b bytes.Buffer
-
-		h := &HasBytesWriter{
-			Pattern: []byte("__foo"),
-		}
-		return h, io.MultiWriter(&b, h)
-	}
-
-	rndStr := func() string {
-		return strings.Repeat("ab cfo", r.Intn(33))
-	}
-
-	for i := 0; i < 22; i++ {
-		h, w := neww()
-		fmt.Fprintf(w, rndStr()+"abc __foobar"+rndStr())
-		c.Assert(h.Match, qt.Equals, true)
-
-		h, w = neww()
-		fmt.Fprintf(w, rndStr()+"abc __f")
-		fmt.Fprintf(w, "oo bar"+rndStr())
-		c.Assert(h.Match, qt.Equals, true)
-
-		h, w = neww()
-		fmt.Fprintf(w, rndStr()+"abc __moo bar")
-		c.Assert(h.Match, qt.Equals, false)
-	}
-
-	h, w := neww()
-	fmt.Fprintf(w, "__foo")
-	c.Assert(h.Match, qt.Equals, true)
-}
@@ -34,7 +34,7 @@ type multiWriteCloser struct {
 func (m multiWriteCloser) Close() error {
 	var err error
 	for _, c := range m.closers {
-		if closeErr := c.Close(); closeErr != nil {
+		if closeErr := c.Close(); err != nil {
 			err = closeErr
 		}
 	}
@@ -24,8 +24,6 @@ import (
 	"sync"
 	"time"

-	"github.com/bep/godartsass"
-	"github.com/gohugoio/hugo/common/hexec"
 	"github.com/gohugoio/hugo/hugofs/files"

 	"github.com/spf13/afero"
@@ -70,7 +68,7 @@ func (i Info) Version() VersionString {

 // Generator a Hugo meta generator HTML tag.
 func (i Info) Generator() template.HTML {
-	return template.HTML(fmt.Sprintf(`<meta name="generator" content="Hugo %s">`, CurrentVersion.String()))
+	return template.HTML(fmt.Sprintf(`<meta name="generator" content="Hugo %s" />`, CurrentVersion.String()))
 }

 func (i Info) IsProduction() bool {
@@ -126,8 +124,6 @@ func GetExecEnviron(workDir string, cfg config.Provider, fs afero.Fs) []string {
 	config.SetEnvVars(&env, "HUGO_ENVIRONMENT", cfg.GetString("environment"))
 	config.SetEnvVars(&env, "HUGO_ENV", cfg.GetString("environment"))

-	config.SetEnvVars(&env, "HUGO_PUBLISHDIR", filepath.Join(workDir, cfg.GetString("publishDirOrig")))
-
 	if fs != nil {
 		fis, err := afero.ReadDir(fs, files.FolderJSConfig)
 		if err == nil {
@@ -188,15 +184,24 @@ func getBuildInfo() *buildInfo {
 	return bInfo
 }

-func formatDep(path, version string) string {
-	return fmt.Sprintf("%s=%q", path, version)
-}
-
 // GetDependencyList returns a sorted dependency list on the format package="version".
 // It includes both Go dependencies and (a manually maintained) list of C(++) dependencies.
 func GetDependencyList() []string {
 	var deps []string

+	formatDep := func(path, version string) string {
+		return fmt.Sprintf("%s=%q", path, version)
+	}
+
+	if IsExtended {
+		deps = append(
+			deps,
+			// TODO(bep) consider adding a DepsNonGo() method to these upstream projects.
+			formatDep("github.com/sass/libsass", "3.6.5"),
+			formatDep("github.com/webmproject/libwebp", "v1.2.0"),
+		)
+	}
+
 	bi := getBuildInfo()
 	if bi == nil {
 		return deps
@@ -206,36 +211,11 @@ func GetDependencyList() []string {
 		deps = append(deps, formatDep(dep.Path, dep.Version))
 	}

-	deps = append(deps, GetDependencyListNonGo()...)
-
 	sort.Strings(deps)

 	return deps
 }

-// GetDependencyListNonGo returns a list of non-Go dependencies.
-func GetDependencyListNonGo() []string {
-	var deps []string
-
-	if IsExtended {
-		deps = append(
-			deps,
-			formatDep("github.com/sass/libsass", "3.6.5"),
-			formatDep("github.com/webmproject/libwebp", "v1.2.4"),
-		)
-	}
-
-	if dartSass := dartSassVersion(); dartSass.ProtocolVersion != "" {
-		const dartSassPath = "github.com/sass/dart-sass-embedded"
-		deps = append(deps,
-			formatDep(dartSassPath+"/protocol", dartSass.ProtocolVersion),
-			formatDep(dartSassPath+"/compiler", dartSass.CompilerVersion),
-			formatDep(dartSassPath+"/implementation", dartSass.ImplementationVersion),
-		)
-	}
-	return deps
-}
-
 // IsRunningAsTest reports whether we are running as a test.
 func IsRunningAsTest() bool {
 	for _, arg := range os.Args {
@@ -269,13 +249,3 @@ type Dependency struct {
 	// Replaced by this dependency.
 	Replace *Dependency
 }
-
-func dartSassVersion() godartsass.DartSassVersion {
-	// This is also duplicated in the dartsass package.
-	const dartSassEmbeddedBinaryName = "dart-sass-embedded"
-	if !hexec.InPath(dartSassEmbeddedBinaryName) {
-		return godartsass.DartSassVersion{}
-	}
-	v, _ := godartsass.Version(dartSassEmbeddedBinaryName)
-	return v
-}
@@ -17,7 +17,7 @@ package hugo
 // This should be the only one.
 var CurrentVersion = Version{
 	Major:      0,
-	Minor:      109,
+	Minor:      102,
 	PatchLevel: 0,
-	Suffix:     "",
+	Suffix:     "-DEV",
 }
@@ -180,15 +180,10 @@ type Headers struct {
 }

 type Redirect struct {
-	From string
-	To   string
-
-	// HTTP status code to use for the redirect.
-	// A status code of 200 will trigger a URL rewrite.
+	From   string
+	To     string
 	Status int
-
-	// Forcode redirect, even if original request path exists.
-	Force bool
+	Force  bool
 }

 func (r Redirect) IsZero() bool {
@@ -205,31 +200,16 @@ func DecodeServer(cfg Provider) (*Server, error) {
 	_ = mapstructure.WeakDecode(m, s)

 	for i, redir := range s.Redirects {
-		// Get it in line with the Hugo server for OK responses.
-		// We currently treat the 404 as a special case, they are always "ugly", so keep them as is.
-		if redir.Status != 404 {
-			redir.To = strings.TrimSuffix(redir.To, "index.html")
-			if !strings.HasPrefix(redir.To, "https") && !strings.HasSuffix(redir.To, "/") {
-				// There are some tricky infinite loop situations when dealing
-				// when the target does not have a trailing slash.
-				// This can certainly be handled better, but not time for that now.
-				return nil, fmt.Errorf("unsupported redirect to value %q in server config; currently this must be either a remote destination or a local folder, e.g. \"/blog/\" or \"/blog/index.html\"", redir.To)
-			}
+		// Get it in line with the Hugo server.
+		redir.To = strings.TrimSuffix(redir.To, "index.html")
+		if !strings.HasPrefix(redir.To, "https") && !strings.HasSuffix(redir.To, "/") {
+			// There are some tricky infinite loop situations when dealing
+			// when the target does not have a trailing slash.
+			// This can certainly be handled better, but not time for that now.
+			return nil, fmt.Errorf("unsupported redirect to value %q in server config; currently this must be either a remote destination or a local folder, e.g. \"/blog/\" or \"/blog/index.html\"", redir.To)
 		}
 		s.Redirects[i] = redir
 	}

-	if len(s.Redirects) == 0 {
-		// Set up a default redirect for 404s.
-		s.Redirects = []Redirect{
-			{
-				From:   "**",
-				To:     "/404.html",
-				Status: 404,
-			},
-		}
-
-	}
-
 	return s, nil
 }
@@ -42,10 +42,10 @@ var DefaultConfig = Config{
 		),
 		// These have been tested to work with Hugo's external programs
 		// on Windows, Linux and MacOS.
-		OsEnv: NewWhitelist("(?i)^((HTTPS?|NO)_PROXY|PATH(EXT)?|APPDATA|TE?MP|TERM)$"),
+		OsEnv: NewWhitelist("(?i)^(PATH|PATHEXT|APPDATA|TMP|TEMP|TERM)$"),
 	},
 	Funcs: Funcs{
-		Getenv: NewWhitelist("^HUGO_", "^CI$"),
+		Getenv: NewWhitelist("^HUGO_"),
 	},
 	HTTP: HTTP{
 		URLs:    NewWhitelist(".*"),
@@ -140,7 +140,7 @@ func TestToTOML(t *testing.T) {
 	got := DefaultConfig.ToTOML()

 	c.Assert(got, qt.Equals,
-		"[security]\n  enableInlineShortcodes = false\n\n  [security.exec]\n    allow = ['^dart-sass-embedded$', '^go$', '^npx$', '^postcss$']\n    osEnv = ['(?i)^((HTTPS?|NO)_PROXY|PATH(EXT)?|APPDATA|TE?MP|TERM)$']\n\n  [security.funcs]\n    getenv = ['^HUGO_', '^CI$']\n\n  [security.http]\n    methods = ['(?i)GET|POST']\n    urls = ['.*']",
+		"[security]\n  enableInlineShortcodes = false\n  [security.exec]\n    allow = ['^dart-sass-embedded$', '^go$', '^npx$', '^postcss$']\n    osEnv = ['(?i)^(PATH|PATHEXT|APPDATA|TMP|TEMP|TERM)$']\n\n  [security.funcs]\n    getenv = ['^HUGO_']\n\n  [security.http]\n    methods = ['(?i)GET|POST']\n    urls = ['.*']",
 	)
 }

@@ -52,7 +52,7 @@ draft: true

 // NewContent creates a new content file in h (or a full bundle if the archetype is a directory)
 // in targetPath.
-func NewContent(h *hugolib.HugoSites, kind, targetPath string, force bool) error {
+func NewContent(h *hugolib.HugoSites, kind, targetPath string) error {
 	if h.BaseFs.Content.Dirs == nil {
 		return errors.New("no existing content directory configured for this project")
 	}
@@ -76,7 +76,6 @@ func NewContent(h *hugolib.HugoSites, kind, targetPath string, force bool) error

 		kind:       kind,
 		targetPath: targetPath,
-		force:      force,
 	}

 	ext := paths.Ext(targetPath)
@@ -133,7 +132,6 @@ type contentBuilder struct {
 	kind              string
 	isDir             bool
 	dirMap            archetypeMap
-	force             bool
 }

 func (b *contentBuilder) buildDir() error {
@@ -147,7 +145,7 @@ func (b *contentBuilder) buildDir() error {

 	for _, fi := range b.dirMap.contentFiles {
 		targetFilename := filepath.Join(b.targetPath, strings.TrimPrefix(fi.Meta().Path, b.archetypeFilename))
-		abs, err := b.cf.CreateContentPlaceHolder(targetFilename, b.force)
+		abs, err := b.cf.CreateContentPlaceHolder(targetFilename)
 		if err != nil {
 			return err
 		}
@@ -220,7 +218,7 @@ func (b *contentBuilder) buildDir() error {
 }

 func (b *contentBuilder) buildFile() (string, error) {
-	contentPlaceholderAbsFilename, err := b.cf.CreateContentPlaceHolder(b.targetPath, b.force)
+	contentPlaceholderAbsFilename, err := b.cf.CreateContentPlaceHolder(b.targetPath)
 	if err != nil {
 		return "", err
 	}
@@ -82,7 +82,7 @@ func TestNewContentFromFile(t *testing.T) {
 			cfg, fs := newTestCfg(c, mm)
 			h, err := hugolib.NewHugoSites(deps.DepsCfg{Cfg: cfg, Fs: fs})
 			c.Assert(err, qt.IsNil)
-			err = create.NewContent(h, cas.kind, cas.path, false)
+			err = create.NewContent(h, cas.kind, cas.path)

 			if b, ok := cas.expected.(bool); ok && !b {
 				if !b {
@@ -145,7 +145,7 @@ i18n: {{ T "hugo" }}
 	c.Assert(err, qt.IsNil)
 	c.Assert(len(h.Sites), qt.Equals, 2)

-	c.Assert(create.NewContent(h, "my-bundle", "post/my-post", false), qt.IsNil)
+	c.Assert(create.NewContent(h, "my-bundle", "post/my-post"), qt.IsNil)

 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-post/resources/hugo1.json")), `hugo1: {{ printf "no template handling in here" }}`)
 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-post/resources/hugo2.xml")), `hugo2: {{ printf "no template handling in here" }}`)
@@ -157,7 +157,7 @@ i18n: {{ T "hugo" }}

 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-post/pages/bio.md")), `File: bio.md`, `Site Lang: en`, `Name: Bio`)

-	c.Assert(create.NewContent(h, "my-theme-bundle", "post/my-theme-post", false), qt.IsNil)
+	c.Assert(create.NewContent(h, "my-theme-bundle", "post/my-theme-post"), qt.IsNil)
 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-theme-post/index.md")), `File: index.md`, `Site Lang: en`, `Name: My Theme Post`, `i18n: Hugo Rocks!`)
 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-theme-post/resources/hugo1.json")), `hugo1: {{ printf "no template handling in here" }}`)
 }
@@ -187,19 +187,19 @@ site RegularPages: {{ len site.RegularPages  }}
 	c.Assert(err, qt.IsNil)
 	c.Assert(len(h.Sites), qt.Equals, 2)

-	c.Assert(create.NewContent(h, "my-bundle", "post/my-post", false), qt.IsNil)
+	c.Assert(create.NewContent(h, "my-bundle", "post/my-post"), qt.IsNil)
 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-post/index.md")), `site RegularPages: 10`)

 	// Default bundle archetype
-	c.Assert(create.NewContent(h, "", "post/my-post2", false), qt.IsNil)
+	c.Assert(create.NewContent(h, "", "post/my-post2"), qt.IsNil)
 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-post2/index.md")), `default archetype index.md`)

 	// Regular file with bundle kind.
-	c.Assert(create.NewContent(h, "my-bundle", "post/foo.md", false), qt.IsNil)
+	c.Assert(create.NewContent(h, "my-bundle", "post/foo.md"), qt.IsNil)
 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/foo.md")), `draft: true`)

 	// Regular files should fall back to the default archetype (we have no regular file archetype).
-	c.Assert(create.NewContent(h, "my-bundle", "mypage.md", false), qt.IsNil)
+	c.Assert(create.NewContent(h, "my-bundle", "mypage.md"), qt.IsNil)
 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "mypage.md")), `draft: true`)

 }
@@ -237,7 +237,7 @@ i18n: {{ T "hugo" }}
 	c.Assert(err, qt.IsNil)
 	c.Assert(len(h.Sites), qt.Equals, 2)

-	c.Assert(create.NewContent(h, "my-bundle", "post/my-post", false), qt.IsNil)
+	c.Assert(create.NewContent(h, "my-bundle", "post/my-post"), qt.IsNil)

 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-post/resources/hugo1.json")), `hugo1: {{ printf "no template handling in here" }}`)
 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-post/resources/hugo2.xml")), `hugo2: {{ printf "no template handling in here" }}`)
@@ -247,38 +247,11 @@ i18n: {{ T "hugo" }}

 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-post/pages/bio.md")), `File: bio.md`, `Name: Bio`)

-	c.Assert(create.NewContent(h, "my-theme-bundle", "post/my-theme-post", false), qt.IsNil)
+	c.Assert(create.NewContent(h, "my-theme-bundle", "post/my-theme-post"), qt.IsNil)
 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-theme-post/index.md")), `File: index.md`, `Name: My Theme Post`, `i18n: Hugo Rocks!`)
 	cContains(c, readFileFromFs(t, fs.Source, filepath.Join("content", "post/my-theme-post/resources/hugo1.json")), `hugo1: {{ printf "no template handling in here" }}`)
 }

-func TestNewContentForce(t *testing.T) {
-	mm := afero.NewMemMapFs()
-	c := qt.New(t)
-
-	archetypeDir := filepath.Join("archetypes", "my-bundle")
-	c.Assert(mm.MkdirAll(archetypeDir, 0o755), qt.IsNil)
-	c.Assert(afero.WriteFile(mm, filepath.Join(archetypeDir, "index.md"), []byte(""), 0o755), qt.IsNil)
-	c.Assert(afero.WriteFile(mm, filepath.Join(archetypeDir, "index.nn.md"), []byte(""), 0o755), qt.IsNil)
-
-	c.Assert(initFs(mm), qt.IsNil)
-	cfg, fs := newTestCfg(c, mm)
-
-	h, err := hugolib.NewHugoSites(deps.DepsCfg{Cfg: cfg, Fs: fs})
-	c.Assert(err, qt.IsNil)
-	c.Assert(len(h.Sites), qt.Equals, 2)
-
-	// from file
-	c.Assert(create.NewContent(h, "post", "post/my-post.md", false), qt.IsNil)
-	c.Assert(create.NewContent(h, "post", "post/my-post.md", false), qt.IsNotNil)
-	c.Assert(create.NewContent(h, "post", "post/my-post.md", true), qt.IsNil)
-
-	// from dir
-	c.Assert(create.NewContent(h, "my-bundle", "post/my-post", false), qt.IsNil)
-	c.Assert(create.NewContent(h, "my-bundle", "post/my-post", false), qt.IsNotNil)
-	c.Assert(create.NewContent(h, "my-bundle", "post/my-post", true), qt.IsNil)
-}
-
 func initFs(fs afero.Fs) error {
 	perm := os.FileMode(0o755)
 	var err error
@@ -2,8 +2,6 @@ package deps

 import (
 	"fmt"
-	"path/filepath"
-	"strings"
 	"sync"
 	"sync/atomic"
 	"time"
@@ -18,7 +16,6 @@ import (
 	"github.com/gohugoio/hugo/langs"
 	"github.com/gohugoio/hugo/media"
 	"github.com/gohugoio/hugo/resources/page"
-	"github.com/gohugoio/hugo/resources/postpub"

 	"github.com/gohugoio/hugo/metrics"
 	"github.com/gohugoio/hugo/output"
@@ -81,10 +78,6 @@ type Deps struct {
 	// All the output formats available for the current site.
 	OutputFormatsConfig output.Formats

-	// FilenameHasPostProcessPrefix is a set of filenames in /public that
-	// contains a post-processing prefix.
-	FilenameHasPostProcessPrefix []string
-
 	templateProvider ResourceProvider
 	WithTemplate     func(templ tpl.TemplateManager) error `json:"-"`

@@ -209,7 +202,6 @@ func New(cfg DepsCfg) (*Deps, error) {
 	var (
 		logger = cfg.Logger
 		fs     = cfg.Fs
-		d      *Deps
 	)

 	if cfg.TemplateProvider == nil {
@@ -247,32 +239,6 @@ func New(cfg DepsCfg) (*Deps, error) {
 	}
 	execHelper := hexec.New(securityConfig)

-	var filenameHasPostProcessPrefixMu sync.Mutex
-	hashBytesReceiverFunc := func(name string, match bool) {
-		if !match {
-			return
-		}
-		filenameHasPostProcessPrefixMu.Lock()
-		d.FilenameHasPostProcessPrefix = append(d.FilenameHasPostProcessPrefix, name)
-		filenameHasPostProcessPrefixMu.Unlock()
-	}
-
-	// Skip binary files.
-	hashBytesSHouldCheck := func(name string) bool {
-		ext := strings.TrimPrefix(filepath.Ext(name), ".")
-		mime, _, found := cfg.MediaTypes.GetBySuffix(ext)
-		if !found {
-			return false
-		}
-		switch mime.MainType {
-		case "text", "application":
-			return true
-		default:
-			return false
-		}
-	}
-	fs.PublishDir = hugofs.NewHasBytesReceiver(fs.PublishDir, hashBytesSHouldCheck, hashBytesReceiverFunc, []byte(postpub.PostProcessPrefix))
-
 	ps, err := helpers.NewPathSpec(fs, cfg.Language, logger)
 	if err != nil {
 		return nil, fmt.Errorf("create PathSpec: %w", err)
@@ -308,7 +274,7 @@ func New(cfg DepsCfg) (*Deps, error) {

 	logDistinct := helpers.NewDistinctLogger(logger)

-	d = &Deps{
+	d := &Deps{
 		Fs:                      fs,
 		Log:                     ignorableLogger,
 		LogDistinct:             logDistinct,
@@ -34,7 +34,6 @@
    "brlink",
    "Brotli",
    "Browsersync",
-    "canonicalization",
    "canonify",
    "Catmull",
    "Catwoman",
@@ -62,8 +61,6 @@
    "datatable",
    "DATOCMS",
    "debugconfig",
-    "defang",
-    "Deindent",
    "DELIM",
    "dhersam",
    "digitalcraftsman",
@@ -75,21 +72,17 @@
    "DRING",
    "Eiqc",
    "Eliott",
-    "embeddable",
    "Emojify",
    "Enwrite",
    "eopkg",
    "eparis",
    "errorf",
    "erroridf",
-    "esbuild",
    "Evernote",
-    "Exif",
    "exitwp",
    "expirydate",
    "Feminella",
    "firstpost",
-    "Flickr",
    "Formspree",
    "fpath",
    "Francia",
@@ -98,12 +91,10 @@
    "funcs",
    "funcsig",
    "Garen",
-    "Garuda",
    "gcloud",
    "Getenv",
    "getjson",
    "getpage",
-    "Gitee",
    "Gmfc",
    "Goel",
    "Gohugo",
@@ -115,7 +106,6 @@
    "govendor",
    "Gowans",
    "Grayscale",
-    "Gregor",
    "Gruber",
    "gtag",
    "gvfs",
@@ -151,12 +141,10 @@
    "Joomla",
    "JRBR",
    "jsonify",
-    "Karmada",
    "katex",
    "keycdn",
    "KEYVALS",
    "kubernetes",
-    "Kubuntu",
    "Lanczos",
    "langformatnumber",
    "lastmod",
@@ -164,7 +152,6 @@
    "linktitle",
    "Lipi",
    "lrwxr",
-    "Lubuntu",
    "maingo",
    "markdownified",
    "markdownify",
@@ -201,7 +188,6 @@
    "newparam",
    "Nichlas",
    "Nikhil",
-    "Nikola",
    "Njjy",
    "nlist",
    "nobr",
@@ -235,7 +221,6 @@
    "Poupin",
    "prerender",
    "println",
-    "Pritchard",
    "publishdate",
    "Pygments",
    "qref",
@@ -264,7 +249,6 @@
    "safejs",
    "Samsa",
    "schemaorg",
-    "setx",
    "Shekhar",
    "Shortcode",
    "Shortcodes",
@@ -273,9 +257,7 @@
    "Sindre",
    "sitemapindex",
    "sitemapxml",
-    "slugorfilename",
    "Smartcrop",
-    "Sobre",
    "Sprintf",
    "Startseite",
    "strconv",
@@ -296,7 +278,6 @@
    "Tknx",
    "TLDR",
    "TMPDIR",
-    "toclevels",
    "TOCSS",
    "todos",
    "tojson",
@@ -307,8 +288,6 @@
    "toyaml",
    "twitteruser",
    "Unmarshal",
-    "unpublishdate",
-    "Unsharp",
    "urlize",
    "urlset",
    "utimestamp",
@@ -322,19 +301,15 @@
    "wibble",
    "wordcount",
    "workson",
-    "Wowchemy",
    "wpxr",
    "Xbaabbab",
-    "Xubuntu",
    "xvzf",
    "yoyoyo",
-    "yunbox",
    "Zgotmpl",
-    "Zorin",
    "zzbbaabb",
    "مدونتي"
  ],
-  "language": "en,en-US,de,fr",
+  "language": "en,en-GB,en-US,de,fr",
  "allowCompoundWords": true,
  "files": [
    "**/*.md"
@@ -356,6 +331,5 @@
    "**/news/*",
    "**/showcase/*"
  ],
-  "useGitignore": true,
-  "enabled": true
+  "useGitignore": true
 }
@@ -17,6 +17,6 @@ markComment: >
  If you still think this is important, please tell us why.

  This issue will automatically be closed in the near future if no further activity occurs. Thank you for all your contributions.
-
+  
 # Comment to post when closing a stale issue. Set to `false` to disable
 closeComment: false
@@ -1,26 +0,0 @@
-name: "CodeQL"
-
-on:
-  schedule:
-    - cron: "0 0 1 * *"
-
-jobs:
-  analyze:
-    name: Analyze
-    runs-on: ubuntu-latest
-    permissions:
-      actions: read
-      contents: read
-      security-events: write
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-
-      - name: Initialize CodeQL
-        uses: github/codeql-action/init@v2
-        with:
-          languages: "javascript"
-
-      - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v2
@@ -1,4 +1,4 @@
-name: "Check spelling"
+name: 'Check spelling'
 on: # rebuild any PRs and main branch changes
  push:
    branches-ignore:
@@ -15,7 +15,6 @@ jobs:
      - uses: actions/checkout@v3
      - uses: streetsidesoftware/cspell-action@v2
        with:
-          check_dot_files: false
-          incremental_files_only: true
          inline: warning
          strict: false
+          incremental_files_only: true
@@ -1,41 +0,0 @@
-name: Super Linter
-
-on:
-  workflow_dispatch:
-
-permissions:
-  contents: read #  to fetch code (actions/checkout)
-
-jobs:
-  build:
-    permissions:
-      contents: read #  to fetch code (actions/checkout)
-      statuses: write #  to mark status of each linter run (github/super-linter/slim)
-
-    name: Lint Code Base
-    runs-on: ubuntu-latest
-    if: ${{ github.actor != 'dependabot[bot]' }}
-
-    steps:
-      - name: Checkout Code
-        uses: actions/checkout@v3
-
-      - name: Lint Code Base
-        uses: github/super-linter/slim@v4
-        env:
-          DEFAULT_BRANCH: master
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          IGNORE_GITIGNORED_FILES: true
-          LINTER_RULES_PATH: /
-          LOG_LEVEL: NOTICE
-          MARKDOWN_CONFIG_FILE: .markdownlint.yaml
-          SUPPRESS_POSSUM: true
-          VALIDATE_CSS: false
-          VALIDATE_EDITORCONFIG: false
-          VALIDATE_GITLEAKS: false
-          VALIDATE_HTML: false
-          VALIDATE_JAVASCRIPT_STANDARD: false
-          VALIDATE_JSCPD: false
-          VALIDATE_NATURAL_LANGUAGE: false
-          VALIDATE_SHELL_SHFMT: false
-          VALIDATE_XML: false
@@ -1,7 +1,6 @@
 /.idea
 /.vscode
 /public
-/dist
 node_modules
 nohup.out
 .DS_Store
@@ -1,24 +1,4 @@
 # https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md

-MD002: false
-MD003: false
-MD004: false
-MD007: false
-MD012:
-  maximum: 2
-MD013: false
-MD014: false
-MD022: false
-MD024: false
-MD031: false
-MD032: false
-MD033: false
-MD034: false
-MD036: false
-MD037: false
-MD038: false
-MD041: false
-MD046: false
-MD049: false
-MD050: false
-MD053: false
+MD013: false  # Line length
+MD033: false  # Inline HTML
@@ -1,6 +0,0 @@
-**/commands/**
-**/functions/**
-**/news/**
-**/showcase/**
-**/zh/**
-**/license.md
@@ -1,3 +0,0 @@
-**/news/**
-**/showcase/**
-**/zh/**
@@ -1,7 +1,6 @@
 {
  "recommendations": [
-    "DavidAnson.vscode-markdownlint",
    "EditorConfig.EditorConfig",
-    "streetsidesoftware.code-spell-checker"
+    "esbenp.prettier-vscode",
  ]
 }
@@ -7,11 +7,11 @@ Documentation site for [Hugo](https://github.com/gohugoio/hugo), the very fast a

 ## Contributing

-We welcome contributions to Hugo of any kind including documentation, suggestions, bug reports, pull requests etc. Also check out our [contribution guide](https://gohugo.io/contribute/documentation/). We would love to hear from you.
+We welcome contributions to Hugo of any kind including documentation, suggestions, bug reports, pull requests etc. Also check out our [contribution guide](https://gohugo.io/contribute/documentation/). We would love to hear from you. 

-Note that this repository contains solely the documentation for Hugo. For contributions that aren't documentation-related please refer to the [hugo](https://github.com/gohugoio/hugo) repository.
+Note that this repository contains solely the documentation for Hugo. For contributions that aren't documentation-related please refer to the [hugo](https://github.com/gohugoio/hugo) repository. 

-*Pull requests shall **only** contain changes to the actual documentation. However, changes on the codebase of Hugo **and** the documentation shall be a single, atomic pull request in the [hugo](https://github.com/gohugoio/hugo) repository.*
+*Pull requests shall **only** contain changes to the actual documentation. However, changes on the code base of Hugo **and** the documentation shall be a single, atomic pull request in the [hugo](https://github.com/gohugoio/hugo) repository.*

 Spelling fixes are most welcomed, and if you want to contribute longer sections to the documentation, it would be great if you had the following criteria in mind when writing:

@@ -54,7 +54,7 @@ pre {
 }

@media (--breakpoint-large) {
-  .full-width
+  .full-width, pre.expand:hover
  {
  /*width: 100vw;
  position: relative;
@@ -1,4 +1,4 @@
-/* From https://www.cssfontstack.com */
+/* From http://cssfontstack.com */
 code, .code, pre code, .highlight pre  {
  font-family: 'inconsolata',Menlo,Monaco,'Courier New',monospace;
 }
@@ -0,0 +1,11 @@
+/* modified from:*/
+@import 'highlight.js/styles/atom-one-light.css';
+
+/* hljs-template-variable covers the handlebars templating*/
+.hljs-template-variable {
+  color: var(--primary-color);
+}
+
+.hljs-attr {
+  color: var(--accent-color-light);
+}
@@ -1,10 +1,12 @@
-require('typeface-muli');
+require("typeface-muli")
 import styles from './css/main.css';
-import './js/clipboardjs.js';
-import './js/docsearch.js';
-import './js/lazysizes.js';
-import './js/menutoggle.js';
-import './js/scrolldir.js';
-import './js/smoothscroll.js';
-import './js/tabs.js';
-import './js/nojs.js';
+import './js/clipboardjs.js'
+import './js/codeblocks.js'
+import './js/docsearch.js'
+import './js/hljs.js'
+import './js/lazysizes.js'
+import './js/menutoggle.js'
+import './js/scrolldir.js'
+import './js/smoothscroll.js'
+import './js/tabs.js'
+import './js/nojs.js'
@@ -0,0 +1,10 @@
+let article = document.getElementById('prose')
+
+if (article) {
+  let codeBlocks = article.getElementsByTagName('code')
+    for (let [key, codeBlock] of Object.entries(codeBlocks)){
+    var widthDif = codeBlock.scrollWidth - codeBlock.clientWidth
+    if (widthDif > 0)
+      codeBlock.parentNode.classList.add('expand')
+  }
+}
@@ -1,8 +1,7 @@
 var docsearch = require('docsearch.js/dist/cdn/docsearch.js');
 docsearch({
-	appId: 'D1BPLZHGYQ',
-	apiKey: '6df94e1e5d55d258c56f60d974d10314',
-	indexName: 'hugodocs',
-	inputSelector: '#search-input',
-	debug: true, // Set debug to true if you want to inspect the dropdown
+  apiKey: '167e7998590aebda7f9fedcf86bc4a55',
+  indexName: 'hugodocs',
+  inputSelector: '#search-input',
+  debug: true // Set debug to true if you want to inspect the dropdown
 });
@@ -0,0 +1,19 @@
+var hljs = require('highlight.js/lib/highlight.js');
+
+hljs.registerLanguage('bash', require('highlight.js/lib/languages/bash'));
+hljs.registerLanguage('css', require('highlight.js/lib/languages/css'));
+hljs.registerLanguage('markdown', require('highlight.js/lib/languages/markdown'));
+hljs.registerLanguage('diff', require('highlight.js/lib/languages/diff'));
+// hljs.registerLanguage('go', require('highlight.js/lib/languages/go'));
+hljs.registerLanguage('javascript', require('highlight.js/lib/languages/javascript'));
+hljs.registerLanguage('json', require('highlight.js/lib/languages/json'));
+hljs.registerLanguage('yaml', require('highlight.js/lib/languages/yaml'));
+hljs.registerLanguage('xml', require('highlight.js/lib/languages/xml'));
+hljs.registerLanguage('html', require('highlight.js/lib/languages/handlebars'));
+
+hljs.registerLanguage("go", function(e) {
+  var t = { keyword: "code output note warning break default func interface select case map struct chan else goto package switch const fallthrough if range end type continue for import return var go defer bool byte complex64 complex128 float32 float64 int8 int16 int32 int64 string uint8 uint16 uint32 uint64 int uint uintptr rune id autoplay Get", literal: "file download copy true false iota nil Pages with", built_in: "append cap close complex highlight copy imag len make new panic print println real recover delete Site Data tweet youtube ref relref vimeo instagram gist figure innershortcode" };
+  return { aliases: ["golang","hugo"], k: t, i: "</", c: [e.CLCM, e.CBCM, { cN: "string", v: [e.QSM, { b: "'", e: "[^\\\\]'" }, { b: "`", e: "`" }] }, { cN: "number", v: [{ b: e.CNR + "[dflsi]", r: 1 }, e.CNM] }, { b: /:=/ }, { cN: "function", bK: "func", e: /\s*\{/, eE: !0, c: [e.TM, { cN: "params", b: /\(/, e: /\)/, k: t, i: /["']/ }] }] }
+});
+
+hljs.initHighlightingOnLoad();
@@ -4083,7 +4083,7 @@ img { max-width: 100%; }
    max-width: 30em;
  }
  .measure-wide-l {
-    max-width: 34em;
+    max-width: 40em;
  }
  .measure-narrow-l {
    max-width: 20em;
@@ -4768,6 +4768,11 @@ h6:hover .header-link {
  padding: 0;
  margin: 0;
 }
+pre, .pre  {
+  overflow-x: auto;
+  overflow-y: hidden;
+  overflow:   scroll;
+}
 code {
    padding: 0.2em;
    margin: 0;
@@ -4775,7 +4780,7 @@ code {
    background-color: rgba(27, 31, 35, .05);
    border-radius: 3px;
 }
-pre code {
+pre  code {
  display: block;
  padding: 1.5em 1.5em;
  font-size: .875rem;
@@ -4809,7 +4814,7 @@ pre {
  content: "Copied"
 }
@media screen and (min-width: 60em) {
-  .full-width
+  .full-width, pre.expand:hover
  {
  /*width: 100vw;
  position: relative;
@@ -4987,7 +4992,7 @@ dd {
    font-size: calc(0.70833rem + 0.83333vw);
  }
 }
-/* From https://www.cssfontstack.com */
+/* From http://cssfontstack.com */
 code, .code, pre code, .highlight pre  {
  font-family: 'inconsolata',Menlo,Monaco,'Courier New',monospace;
 }
@@ -1,22 +1,19 @@
 [[banners]]
-    name         = "Linode"
-    link         = "https://www.linode.com/"
-    logo         = "/images/sponsors/linode-logo_standard_light_medium.png"
-    utm_campaign = "hugosponsor"
+name = "Linode"
+link = "https://www.linode.com/"
+logo = "/images/sponsors/linode-logo_standard_light_medium.png"
+copy = ""

 [[banners]]
-    name         = "eSolia"
-    link         = "https://esolia.com/post/why-did-esolia-choose-hugo/"
-    logo         = "/images/sponsors/esolia-logo.svg"
-    utm_campaign = "hugosponsor"
+name = "eSolia"
+link = "https://esolia.com/post/why-did-esolia-choose-hugo/"
+logo = "/images/sponsors/esolia-logo.svg"
+copy = ""
+

 [[banners]]
-    name         = "ButterCMS"
-    link         = "https://buttercms.com/hugo-cms/"
-    logo         = "/images/sponsors/butter-light.svg"
-    utm_campaign = "sponsorship"
-    bgcolor      = "#131A3E"
-
-    #hugohome
-    #hugofooter
-    #hugogithub
+name = "Brave"
+link = "https://brave.com/"
+logo = "/images/sponsors/brave-logo.svg"
+bgcolor = "#5A2FA1"
+copy = ""
@@ -70,6 +70,14 @@
  {{ partial "hooks/before-body-end" . }}
  

+  {{ if .Page.Store.Get "hasMermaid" }}
+  <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
+  <script>
+    mermaid.initialize({ startOnLoad: true });
+  </script>
+{{ end }}
+
+
 </body>

 </html>
@@ -1,41 +1,38 @@
-{{ $classes_box := "ba b--dark-gray bg-light-gray br3 flex flex-column flex-wrap items-center justify-center ph3 pv4 mb4 w-100 w-30-l " }}
-{{ $gtag := .gtag | default "unknown" }}
-{{ $classes_box := "ba b--dark-gray bg-light-gray br3 flex flex-column flex-wrap items-center justify-center ph3 pv4 mb4 w-100 w-30-l " }}
-{{ $gtag := .gtag | default "unknown" }}
-{{ $utmSource := cond (eq $gtag "footer") "hugofooter" "hugohome" }}
+{{$classes_box := "ba b--dark-gray bg-light-gray br3 flex flex-column flex-wrap items-center justify-center ph3 pv4 mb4 w-100 w-30-l "}}
+{{$gtag := .gtag | default "unknown" }}
 {{ with .cx.Site.Data.sponsors }}
-  <section
-    class="{{ $.classes_section | default "bg-primary-color-dark b--dark-gray bb bt ph5 pv4 w-100" }}">
-    <div class="center mw9">
+  <section class="{{ $.classes_section | default "bg-primary-color-dark b--dark-gray bb bt ph5 pv4 w-100"}}">
+    <div class="center mw9"> 
      <h3 class="b f3 mv0 light-gray">Hugo Sponsors</h3>
      <div class="flex-ns flex-wrap center justify-between pt3">
        {{ range .banners }}
-          <div
-            class="{{ $classes_box }} o-100"
-            {{ with .bgcolor }}style="background-color: {{ . }};"{{ end }}>
-            {{ $url := printf "%s?%s" .link (querify "utm_source" $utmSource "utm_medium" "banner" "utm_campaign" (.utm_campaign | default "hugosponsor")) | safeURL }}
-            {{ if eq (getenv "HUGO_ENV") "production" | or (eq $.cx.Site.Params.env "production") }}
-              {{ $gtagID := printf "Sponsor %s %s" .name $gtag | title }}
-              <a
-                href="{{ $url }}"
-                onclick="trackOutboundLink({{ printf "'%s', '%s'" $gtagID $url | safeJS }});"
-                class="grow">
-                <img
-                  src="{{ .logo }}"
-                  alt="Logo for {{ .name }}"
-                  class="img h3 center" />
-              </a>
-            {{ else }}
-              <a href="{{ $url }}" class="grow">
-                <img
-                  src="{{ .logo }}"
-                  alt="Logo for {{ .name }}"
-                  class="img h3 center"
-              /></a>
-            {{ end }}
-          </div>
-        {{ end }}
+          {{ $banner := . }}
+          {{if .logo}}
+            <div class="{{$classes_box}} o-100"{{ with .bgcolor }} style="background-color: {{ . }};"{{ end}}>
+              {{with .link -}}
+                {{ $url := printf "%s?%s" . (querify "utm_source" "homepage" "utm_medium" "banner" "utm_campaign" "hugosponsor") | safeURL }}
+                {{ if eq (getenv "HUGO_ENV") "production" | or (eq $.cx.Site.Params.env "production")  }}
+                   {{ $gtagID := printf "Sponsor %s %s" $banner.name $gtag | title }}
+                   <a href="{{ $url }}" onclick="trackOutboundLink({{ printf "'%s', '%s'" $gtagID $url | safeJS }});" class="grow">
+                {{ else }}
+                   <a href="{{ $url }}" class="grow">
+                {{ end }}
+              {{- end}}
+              <img src="{{ .logo }}" alt="Logo for {{ .name }}" class="img h3 center" />
+              {{with .link}}</a>{{end}}
+              {{with .copy}}
+                <p class="center lh-copy gray mv1 tc {{$.classes_copy | default "f5 w-70-ns"}}">
+                  {{- . -}}
+                </p>
+              {{end}}
+            </div>
+          {{else}}
+            <div class="{{$classes_box}} o-10">
+              <p class="b black tc">Your Logo Here</p>
+            </div>
+          {{end}}
+        {{end}}
      </div>
    </div>
  </section>
-{{ end }}
+{{end}}
@@ -41,7 +41,7 @@

    <img src="/images/gopher-side_color.svg" alt="" class="absolute-l bottom-0 dn db-l h4 right-0 z-999"/>

-    <div class="bg-primary-color-dark bottom-0 left-0 right-0 dn-l fixed pb3 ph3 pt3 w-100 z-2">
+    <div class="bg-primary-color-dark bottom-0 left-0 right-0 dn-l fixed pb3 ph3 pt3 w-100">
      {{- partial "nav-mobile.html" . -}}
    </div>

@@ -3,7 +3,14 @@
  "version": "1.1.0",
  "description": "Default Theme for Hugo Sites",
  "main": "index.js",
-  "repository": "",
+  "homepage": "https://gohugo.io/",
+  "bugs": {
+    "url": "https://github.com/gohugoio/gohugoioTheme/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gohugoio/gohugoioTheme.git"
+  },
  "author": "budparr",
  "license": "MIT",
  "scripts": {
@@ -14,13 +21,14 @@
  "devDependencies": {
    "clean-webpack-plugin": "^1.0.0",
    "clipboard": "^2.0.4",
-    "css-loader": "^1.0.1",
+    "css-loader": "^4.3.0",
    "docsearch.js": "^2.6.1",
    "file-loader": "^2.0.0",
    "glob-all": "^3.1.0",
-    "lazysizes": "^5.3.2",
+    "highlight.js": "^9.13.1",
+    "lazysizes": "^5.2.1",
    "mini-css-extract-plugin": "^0.4.4",
-    "postcss": "^7.0.5",
+    "postcss": "^7.0.36",
    "postcss-cssnext": "^3.1.0",
    "postcss-import": "^12.0.1",
    "postcss-loader": "^3.0.0",
@@ -28,7 +36,8 @@
    "scrolldir": "^1.4.0",
    "tachyons": "^4.7.0",
    "typeface-muli": "0.0.54",
-    "webpack": "^4.25.1",
+    "webpack": "^4.44.1",
    "webpack-command": "^0.4.2"
-  }
+  },
+  "dependencies": {}
 }
@@ -1,3 +0,0 @@
-<svg width="158" height="160" viewBox="0 0 158 160" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M4.32 103V27.64H17.664V54.616C18.752 54.04 20 53.56 21.408 53.176C22.816 52.728 24.192 52.376 25.536 52.12C26.88 51.864 28.192 51.672 29.472 51.544C30.816 51.352 32.032 51.256 33.12 51.256C35.872 51.256 38.24 51.704 40.224 52.6C42.272 53.432 43.904 54.584 45.12 56.056C46.336 57.464 47.296 59.32 48 61.624C48.704 63.928 49.152 66.328 49.344 68.824C49.6 71.32 49.728 74.296 49.728 77.752C49.728 86.008 48.448 92.376 45.888 96.856C43.328 101.336 39.072 103.576 33.12 103.576C30.368 103.576 27.584 103 24.768 101.848C21.952 100.696 19.616 99.352 17.76 97.816L15.36 103H4.32ZM17.76 88.984C21.024 91.032 24.992 92.056 29.664 92.056C31.136 92.056 32.352 91.64 33.312 90.808C34.272 89.912 35.008 88.376 35.52 86.2C36.032 83.96 36.288 80.984 36.288 77.272C36.288 73.048 36 69.784 35.424 67.48C34.912 65.176 34.208 63.672 33.312 62.968C32.416 62.2 31.2 61.816 29.664 61.816C27.296 61.816 25.152 61.976 23.232 62.296C21.312 62.552 19.488 63.032 17.76 63.736V88.984ZM56.8958 77.272C56.8958 72.856 57.1518 69.176 57.6638 66.232C58.2398 63.224 59.0398 60.76 60.0638 58.84C61.0878 56.856 62.5278 55.352 64.3838 54.328C66.2398 53.304 68.2878 52.6 70.5278 52.216C72.8318 51.832 75.7118 51.64 79.1678 51.64C81.4718 51.64 83.4238 51.704 85.0238 51.832C86.6238 51.896 88.2238 52.088 89.8238 52.408C91.4878 52.664 92.8318 53.08 93.8558 53.656C94.8798 54.168 95.8718 54.904 96.8318 55.864C97.7918 56.76 98.5278 57.88 99.0398 59.224C99.6158 60.504 100.032 62.072 100.288 63.928C100.608 65.72 100.768 67.8 100.768 70.168C100.768 74.648 99.5838 77.912 97.2158 79.96C94.8478 82.008 91.2958 83.032 86.5598 83.032H70.3358C70.3358 85.976 70.7518 88.184 71.5838 89.656C72.4798 91.064 73.5678 91.928 74.8478 92.248C76.1918 92.568 78.2718 92.728 81.0878 92.728C88.9598 92.728 95.1998 92.376 99.8078 91.672V100.792C95.0078 102.584 86.3038 103.48 73.6958 103.48C70.4318 103.48 67.7118 103 65.5358 102.04C63.4238 101.08 61.7278 99.512 60.4478 97.336C59.1678 95.16 58.2398 92.472 57.6638 89.272C57.1518 86.072 56.8958 82.072 56.8958 77.272ZM70.3358 73.336H83.1038C85.9198 73.336 87.3278 72.056 87.3278 69.496C87.3278 66.296 86.8798 64.248 85.9838 63.352C85.1518 62.392 83.1358 61.912 79.9358 61.912C77.8878 61.912 76.3518 62.008 75.3278 62.2C74.3678 62.328 73.4078 62.776 72.4478 63.544C71.5518 64.248 70.9438 65.368 70.6238 66.904C70.3678 68.44 70.2718 70.584 70.3358 73.336ZM108.101 128.92V52.024H119.141L121.445 57.112C123.301 55.64 125.637 54.328 128.453 53.176C131.333 52.024 134.149 51.448 136.901 51.448C139.397 51.448 141.573 51.864 143.429 52.696C145.349 53.528 146.917 54.68 148.133 56.152C149.413 57.624 150.469 59.448 151.301 61.624C152.133 63.8 152.709 66.168 153.029 68.728C153.349 71.288 153.509 74.136 153.509 77.272C153.509 79.896 153.413 82.264 153.221 84.376C153.093 86.488 152.805 88.6 152.357 90.712C151.909 92.76 151.269 94.552 150.437 96.088C149.669 97.624 148.677 99 147.461 100.216C146.309 101.368 144.837 102.264 143.045 102.904C141.253 103.48 139.205 103.768 136.901 103.768C134.597 103.768 132.005 103.48 129.125 102.904C126.245 102.264 123.685 101.464 121.445 100.504V128.92H108.101ZM121.445 91.288C124.773 92.568 128.773 93.208 133.445 93.208C134.981 93.208 136.197 92.856 137.093 92.152C137.989 91.384 138.693 89.848 139.205 87.544C139.781 85.24 140.069 82.008 140.069 77.848C140.069 72.344 139.525 68.504 138.437 66.328C137.349 64.088 135.685 62.968 133.445 62.968C128.709 62.968 124.709 63.992 121.445 66.04V91.288Z" fill="white"/>
-</svg>
@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 402 58"><g fill="#231F20"><path d="M24.6 23c.4 0 .7-.1 1-.2l10-5.4c1-.5 1.3-1.8.8-2.8-.5-1-1.8-1.3-2.8-.8l-9.9 5.4c-1 .3-1.5 1.3-1.3 2.3.3 1 1.3 1.7 2.3 1.5h-.1zM39.8 30.9c.3 0 .7-.1 1-.3L56.7 22c.6-.3 1-1 1-1.7 0-.8-.3-1.5-.9-1.8-.7-.4-1.4-.4-2.1-.1L38.8 27c-.9.4-1.5 1.4-1.2 2.4.2 1 1.2 1.6 2.2 1.5z"/><path d="M81 19.6c-.4-1.2-1.3-2.2-2.4-2.7L61.4 7.7c-2.8-1.4-6.1-1.4-9 0l-1.4.7L39.1 2C36.3.6 33 .6 30.1 2L2.5 16.9c-1.4.6-2.3 1.9-2.5 3.4v15.2c0 .8.4 1.5 1.1 1.8l35 19c2.8 1.4 6.2 1.4 9 0L80 37.1c.7-.3 1.1-1 1.1-1.8v-15c0-.2-.1-.5-.1-.7zm-76.5.9L32 5.6c1.6-.7 3.5-.7 5.2 0L51 13l3.3-1.8c1.7-.7 3.6-.7 5.2 0l17.1 9.2.2.1-.2.1-33.4 18c-1.7.8-3.6.8-5.2 0l-33.5-18-.2-.1h.2zm38.6 32.2c-1.6.7-3.5.7-5.1 0L4.1 34.3v-9.2L36 42.3c2.8 1.4 6.2 1.4 9 0l32-17.2v9L43.1 52.7zM115.7 10.2h18.2c8.7 0 13.1 3.1 13.1 9.1 0 1.9-.5 3.7-1.6 5.2s-2.6 2.6-4.3 3.2c2.2.4 4.2 1.5 5.7 3.1s2.2 3.6 2.2 5.7c0 3.8-1.4 6.7-4.1 8.7-2.7 2-6.6 3-11.8 3h-17.5v-5.4l1.8-.2c.4 0 .8-.2 1.1-.5.2-.4.3-.9.3-1.3V16.1l-3.1-.3v-5.6zm13.1 6.4v9h2.7c3.5 0 5.3-1.6 5.3-4.8 0-2.8-1.7-4.2-5.1-4.2h-2.9zm0 15.1v9.9h3.7c3.8 0 5.8-1.8 5.8-5.2 0-3.1-1.9-4.7-5.7-4.7h-3.8zM180.7 19v22c0 .5 0 .9.3 1.3.2.3.6.4 1 .5l1.5.1v5.2h-11.7v-3.6h-.2c-1.7 3-4.5 4.4-8.5 4.4-3.1 0-5.3-.8-6.8-2.3-1.4-1.6-2.1-4-2.1-7.3V26.2c0-.4-.1-.8-.4-1.1-.2-.3-.6-.5-1-.5l-1.6-.2V19H164v18.4c-.1 1.1.1 2.2.6 3.1.6.8 1.6 1.1 2.5 1 1.1.1 2.2-.4 2.9-1.2.7-1 1.1-2.2 1-3.4V26.3c0-.5-.1-.9-.3-1.3-.3-.3-.7-.4-1.1-.4l-1.3-.2V19h12.4zM198.9 12.3V19h8.1c2.5-1.1 4.3-3.4 5.5-6.7h5.3V19h6.9l-.5 6.3h-6.4v12.3c-.1 1.1.2 2.2.7 3.2.4.5 1.3.8 2.7.8 1.2 0 2.5-.3 3.6-.8l1.4 6.3c-2.5 1.3-5.2 1.9-7.9 1.8-1.3 0-2.5-.1-3.8-.3-.9-.2-1.8-.4-2.7-.8-.7-.3-1.3-.8-1.8-1.4-.4-.5-.8-1-1.1-1.6-.3-.6-.5-1.3-.6-2-.1-.6-.2-1.3-.3-2V25.3h-9v12.3c-.1 1 .1 2.1.6 3.1.5.7 1.4 1.1 2.3 1 1.1 0 2.2-.3 3.2-.8l1.7 6.2c-2.3 1.2-4.9 1.9-7.5 1.8-3.7 0-6.4-.9-7.9-2.6-1.5-1.7-2.3-4.2-2.3-7.6V25.3h-3.9l.8-5.5c3.6-.8 6.2-3.3 7.6-7.4l5.3-.1zM242.7 18.2c2.7-.1 5.3.6 7.5 2.2 2 1.6 3 4.1 2.8 6.6 0 6.9-5.3 10.2-16 10 .1 1.3.7 2.6 1.7 3.5 1.2 1 2.7 1.4 4.2 1.4 2.6-.1 5.2-.9 7.4-2.3l2.6 6.3c-.5.4-1 .7-1.6.9-1.3.6-2.6 1-4 1.4-1.9.5-3.8.7-5.7.7-4.9 0-8.5-1.3-10.8-4-2.3-2.6-3.5-6.2-3.5-10.7-.1-4.1 1.3-8.2 4-11.4 2.7-3 6.5-4.6 11.4-4.6zm2 9.3c0-.7-.2-1.4-.7-1.9-.5-.5-1.2-.7-1.9-.6-1.4 0-2.8.6-3.6 1.8-1 1.3-1.6 2.9-1.6 4.6 5.2.2 7.7-1.2 7.7-3.9h.1zM272.5 25.5c-1.1 0-2.1.5-2.7 1.3-.7.9-1.1 2.1-1 3.3v12.5l5.1.3v5.3h-18.1V43l1.9-.2c.4.1.8-.1 1.1-.4.2-.4.3-.9.3-1.4V26.2c0-.4-.1-.8-.3-1.2-.3-.3-.6-.4-1-.4l-2-.2V19H268v4.4h.1c.7-1.4 1.7-2.7 3-3.6 1.6-1.1 3.5-1.7 5.4-1.6 1.9-.1 3.7.2 5.4.9v11.3l-7.6.4v-3.9c0-.7-.2-1.1-.5-1.2-.4-.1-.9-.2-1.3-.2zM308.7 17.5c-1.2-.3-2.3-.4-3.4-.4-6.1 0-9.2 3.9-9.2 11.8 0 3.8.8 6.8 2.3 9 1.5 2.2 3.9 3.3 7.1 3.4 1.1 0 2.1-.1 3.2-.4.6-.2 1-.8 1-1.5v-3.7l7.3.4v10.5c-3.8 1.7-7.9 2.5-12.1 2.3-6.1 0-10.8-1.6-14.1-4.9-3.3-3.3-5-8.1-5-14.5 0-3.2.5-6.4 1.6-9.4.9-2.5 2.4-4.6 4.4-6.3 1.8-1.4 3.8-2.5 6-3.3 2.2-.7 4.6-1 6.9-1 4.2-.1 8.3.7 12.2 2.4v10l-7.4.4V19c0-.9-.3-1.4-.8-1.5zM323.6 10.2h14.6l7.5 24.8h.2l7.7-24.7h14.6v5.4l-1.8.2c-.5 0-.9.2-1.2.5-.3.4-.4.9-.3 1.3l1.9 24.8 2.9.1v5.6h-15.3v-5.5l1.8-.2c.4.1.8-.1 1-.4.2-.4.3-.9.2-1.3l-.9-16.1h-.1l-7.2 23.5h-7.1l-7-23.1h-.2l-1 17.3 2.8.2v5.6h-15.3v-5.5l1.8-.2c.5 0 .9-.2 1.2-.5.2-.4.4-.9.4-1.4l2-24.6-3.2-.2v-5.6zM385.5 41.6c3.5 0 5.3-1.4 5.3-4.2 0-1.1-.5-2.2-1.4-2.8-1.4-.8-2.9-1.4-4.5-1.8-1.3-.3-2.7-.8-4-1.3-1.2-.5-2.3-1.2-3.4-1.9-1.2-.9-2.2-2-2.8-3.3-.6-1.5-1-3.2-1-4.8-.1-3.4 1.4-6.7 4-8.8 2.7-2.1 6.2-3.1 10.6-3.1 4-.2 8 .6 11.7 2.2v9.3l-7.4.5v-2.9c0-.8-.3-1.3-.8-1.4-1.1-.3-2.2-.4-3.3-.4-1.1 0-2.2.3-3.1.8-.8.6-1.3 1.6-1.2 2.6-.1 1.1.5 2.2 1.4 2.8 1.5.9 3.1 1.6 4.8 2 1.4.4 2.5.8 3.3 1.1.9.4 1.9.8 2.8 1.3 1 .5 1.9 1.2 2.6 2 .7.9 1.2 1.8 1.6 2.9.5 1.3.7 2.6.7 4 .2 3.6-1.3 7-4.1 9.3-2.7 2.2-6.4 3.3-11.2 3.3-4.3.1-8.6-.7-12.6-2.3v-9.8l7.5-.5v3.2c0 .9.3 1.4.9 1.6 1.1.2 2.3.4 3.6.4z"/></g></svg>
@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 402 58"><g fill="#fff"><path d="M24.6 23c.4 0 .7-.1 1-.2l10-5.4c1-.5 1.3-1.8.8-2.8-.5-1-1.8-1.3-2.8-.8l-9.9 5.4c-1 .3-1.5 1.3-1.3 2.3.3 1 1.3 1.7 2.3 1.5h-.1zM39.8 30.9c.3 0 .7-.1 1-.3L56.7 22c.6-.3 1-1 1-1.7 0-.8-.3-1.5-.9-1.8-.7-.4-1.4-.4-2.1-.1L38.8 27c-.9.4-1.5 1.4-1.2 2.4.2 1 1.2 1.6 2.2 1.5z"/><path d="M81 19.6c-.4-1.2-1.3-2.2-2.4-2.7L61.4 7.7c-2.8-1.4-6.1-1.4-9 0l-1.4.7L39.1 2C36.3.6 33 .6 30.1 2L2.5 16.9c-1.4.6-2.3 1.9-2.5 3.4v15.2c0 .8.4 1.5 1.1 1.8l35 19c2.8 1.4 6.2 1.4 9 0L80 37.1c.7-.3 1.1-1 1.1-1.8v-15c0-.2-.1-.5-.1-.7zm-76.5.9L32 5.6c1.6-.7 3.5-.7 5.2 0L51 13l3.3-1.8c1.7-.7 3.6-.7 5.2 0l17.1 9.2.2.1-.2.1-33.4 18c-1.7.8-3.6.8-5.2 0l-33.5-18-.2-.1h.2zm38.6 32.2c-1.6.7-3.5.7-5.1 0L4.1 34.3v-9.2L36 42.3c2.8 1.4 6.2 1.4 9 0l32-17.2v9L43.1 52.7zM115.7 10.2h18.2c8.7 0 13.1 3.1 13.1 9.1 0 1.9-.5 3.7-1.6 5.2s-2.6 2.6-4.3 3.2c2.2.4 4.2 1.5 5.7 3.1s2.2 3.6 2.2 5.7c0 3.8-1.4 6.7-4.1 8.7-2.7 2-6.6 3-11.8 3h-17.5v-5.4l1.8-.2c.4 0 .8-.2 1.1-.5.2-.4.3-.9.3-1.3V16.1l-3.1-.3v-5.6zm13.1 6.4v9h2.7c3.5 0 5.3-1.6 5.3-4.8 0-2.8-1.7-4.2-5.1-4.2h-2.9zm0 15.1v9.9h3.7c3.8 0 5.8-1.8 5.8-5.2 0-3.1-1.9-4.7-5.7-4.7h-3.8zM180.7 19v22c0 .5 0 .9.3 1.3.2.3.6.4 1 .5l1.5.1v5.2h-11.7v-3.6h-.2c-1.7 3-4.5 4.4-8.5 4.4-3.1 0-5.3-.8-6.8-2.3-1.4-1.6-2.1-4-2.1-7.3V26.2c0-.4-.1-.8-.4-1.1-.2-.3-.6-.5-1-.5l-1.6-.2V19H164v18.4c-.1 1.1.1 2.2.6 3.1.6.8 1.6 1.1 2.5 1 1.1.1 2.2-.4 2.9-1.2.7-1 1.1-2.2 1-3.4V26.3c0-.5-.1-.9-.3-1.3-.3-.3-.7-.4-1.1-.4l-1.3-.2V19h12.4zM198.9 12.3V19h8.1c2.5-1.1 4.3-3.4 5.5-6.7h5.3V19h6.9l-.5 6.3h-6.4v12.3c-.1 1.1.2 2.2.7 3.2.4.5 1.3.8 2.7.8 1.2 0 2.5-.3 3.6-.8l1.4 6.3c-2.5 1.3-5.2 1.9-7.9 1.8-1.3 0-2.5-.1-3.8-.3-.9-.2-1.8-.4-2.7-.8-.7-.3-1.3-.8-1.8-1.4-.4-.5-.8-1-1.1-1.6-.3-.6-.5-1.3-.6-2-.1-.6-.2-1.3-.3-2V25.3h-9v12.3c-.1 1 .1 2.1.6 3.1.5.7 1.4 1.1 2.3 1 1.1 0 2.2-.3 3.2-.8l1.7 6.2c-2.3 1.2-4.9 1.9-7.5 1.8-3.7 0-6.4-.9-7.9-2.6-1.5-1.7-2.3-4.2-2.3-7.6V25.3h-3.9l.8-5.5c3.6-.8 6.2-3.3 7.6-7.4l5.3-.1zM242.7 18.2c2.7-.1 5.3.6 7.5 2.2 2 1.6 3 4.1 2.8 6.6 0 6.9-5.3 10.2-16 10 .1 1.3.7 2.6 1.7 3.5 1.2 1 2.7 1.4 4.2 1.4 2.6-.1 5.2-.9 7.4-2.3l2.6 6.3c-.5.4-1 .7-1.6.9-1.3.6-2.6 1-4 1.4-1.9.5-3.8.7-5.7.7-4.9 0-8.5-1.3-10.8-4-2.3-2.6-3.5-6.2-3.5-10.7-.1-4.1 1.3-8.2 4-11.4 2.7-3 6.5-4.6 11.4-4.6zm2 9.3c0-.7-.2-1.4-.7-1.9-.5-.5-1.2-.7-1.9-.6-1.4 0-2.8.6-3.6 1.8-1 1.3-1.6 2.9-1.6 4.6 5.2.2 7.7-1.2 7.7-3.9h.1zM272.5 25.5c-1.1 0-2.1.5-2.7 1.3-.7.9-1.1 2.1-1 3.3v12.5l5.1.3v5.3h-18.1V43l1.9-.2c.4.1.8-.1 1.1-.4.2-.4.3-.9.3-1.4V26.2c0-.4-.1-.8-.3-1.2-.3-.3-.6-.4-1-.4l-2-.2V19H268v4.4h.1c.7-1.4 1.7-2.7 3-3.6 1.6-1.1 3.5-1.7 5.4-1.6 1.9-.1 3.7.2 5.4.9v11.3l-7.6.4v-3.9c0-.7-.2-1.1-.5-1.2-.4-.1-.9-.2-1.3-.2zM308.7 17.5c-1.2-.3-2.3-.4-3.4-.4-6.1 0-9.2 3.9-9.2 11.8 0 3.8.8 6.8 2.3 9 1.5 2.2 3.9 3.3 7.1 3.4 1.1 0 2.1-.1 3.2-.4.6-.2 1-.8 1-1.5v-3.7l7.3.4v10.5c-3.8 1.7-7.9 2.5-12.1 2.3-6.1 0-10.8-1.6-14.1-4.9-3.3-3.3-5-8.1-5-14.5 0-3.2.5-6.4 1.6-9.4.9-2.5 2.4-4.6 4.4-6.3 1.8-1.4 3.8-2.5 6-3.3 2.2-.7 4.6-1 6.9-1 4.2-.1 8.3.7 12.2 2.4v10l-7.4.4V19c0-.9-.3-1.4-.8-1.5zM323.6 10.2h14.6l7.5 24.8h.2l7.7-24.7h14.6v5.4l-1.8.2c-.5 0-.9.2-1.2.5-.3.4-.4.9-.3 1.3l1.9 24.8 2.9.1v5.6h-15.3v-5.5l1.8-.2c.4.1.8-.1 1-.4.2-.4.3-.9.2-1.3l-.9-16.1h-.1l-7.2 23.5h-7.1l-7-23.1h-.2l-1 17.3 2.8.2v5.6h-15.3v-5.5l1.8-.2c.5 0 .9-.2 1.2-.5.2-.4.4-.9.4-1.4l2-24.6-3.2-.2v-5.6zM385.5 41.6c3.5 0 5.3-1.4 5.3-4.2 0-1.1-.5-2.2-1.4-2.8-1.4-.8-2.9-1.4-4.5-1.8-1.3-.3-2.7-.8-4-1.3-1.2-.5-2.3-1.2-3.4-1.9-1.2-.9-2.2-2-2.8-3.3-.6-1.5-1-3.2-1-4.8-.1-3.4 1.4-6.7 4-8.8 2.7-2.1 6.2-3.1 10.6-3.1 4-.2 8 .6 11.7 2.2v9.3l-7.4.5v-2.9c0-.8-.3-1.3-.8-1.4-1.1-.3-2.2-.4-3.3-.4-1.1 0-2.2.3-3.1.8-.8.6-1.3 1.6-1.2 2.6-.1 1.1.5 2.2 1.4 2.8 1.5.9 3.1 1.6 4.8 2 1.4.4 2.5.8 3.3 1.1.9.4 1.9.8 2.8 1.3 1 .5 1.9 1.2 2.6 2 .7.9 1.2 1.8 1.6 2.9.5 1.3.7 2.6.7 4 .2 3.6-1.3 7-4.1 9.3-2.7 2.2-6.4 3.3-11.2 3.3-4.3.1-8.6-.7-12.6-2.3v-9.8l7.5-.5v3.2c0 .9.3 1.4.9 1.6 1.1.2 2.3.4 3.6.4z"/></g></svg>
@@ -1 +1 @@
-# github.com/gohugoio/gohugoioTheme v0.0.0-20221217122332-1c1752ad8f14
+# github.com/gohugoio/gohugoioTheme v0.0.0-20220228085601-7cfbda06d135
@@ -1,12 +1,16 @@
 ---
 linktitle: ""
 description: ""
+publishdate: ""
+lastmod: ""
 categories: [functions]
 tags: []
 ns: ""
 signature: []
+workson: []
 hugoversion: ""
 aliases: []
 relatedfuncs: []
 toc: false
+deprecated: false
 ---
@@ -0,0 +1,80 @@
+baseURL = "https://gohugo.io/"
+paginate =  100
+defaultContentLanguage = "en"
+enableEmoji = true
+timeZone = "Europe/Oslo"
+# Set the unicode character used for the "return" link in page footnotes.
+footnotereturnlinkcontents = "↩"
+languageCode = "en-us"
+title = "Hugo"
+
+ ignoreErrors = ["error-remote-getjson", "error-missing-instagram-accesstoken"]
+
+
+googleAnalytics = "UA-7131036-4"
+
+pluralizeListTitles = false
+
+# We do redirects via Netlify's _redirects file, generated by Hugo (see "outputs" below).
+disableAliases = true
+
+[minify]
+  [minify.tdewolff]
+    [minify.tdewolff.css]
+    [minify.tdewolff.html]
+      keepWhitespace = true
+
+[module]
+  [module.hugoVersion]
+    min = "0.56.0"
+  [[module.imports]]
+    path = "github.com/gohugoio/gohugoioTheme"
+
+[outputs]
+home = [ "HTML", "RSS", "REDIR", "HEADERS" ]
+section = [ "HTML", "RSS"]
+
+[mediaTypes]
+[mediaTypes."text/netlify"]
+delimiter = ""
+
+[outputFormats]
+[outputFormats.REDIR]
+mediatype = "text/netlify"
+baseName = "_redirects"
+isPlainText = true
+notAlternative = true
+[outputFormats.HEADERS]
+mediatype = "text/netlify"
+baseName = "_headers"
+isPlainText = true
+notAlternative = true
+
+[related]
+
+threshold = 80
+includeNewer = true
+toLower = false
+
+[[related.indices]]
+name = "keywords"
+weight = 100
+[[related.indices]]
+name  = "date"
+weight = 10
+pattern = "2006"
+
+[social]
+twitter = "GoHugoIO"
+
+
+[imaging]
+# See https://github.com/disintegration/imaging
+# CatmullRom is a sharp bicubic filter which should fit the docs site well with its many screenshots.
+# Note that you can also set this per image processing.
+resampleFilter = "CatmullRom"
+
+# Default JPEG quality setting. Default is 75.
+quality = 75
+
+anchor = "smart"
@@ -1,28 +1,19 @@
 baseURL = "https://gohugo.io/"
+paginate = 100
 defaultContentLanguage = "en"
 enableEmoji = true
-googleAnalytics = "UA-7131036-4"
-ignoreErrors = ["error-remote-getjson", "error-missing-instagram-accesstoken"]
+# Set the unicode character used for the "return" link in page footnotes.
+footnotereturnlinkcontents = "↩"
 languageCode = "en-us"
-paginate = 100
-pluralizeListTitles = false
-timeZone = "Europe/Oslo"
 title = "Hugo"

+googleAnalytics = "UA-7131036-4"
+
+pluralizeListTitles = false
+
 # We do redirects via Netlify's _redirects file, generated by Hugo (see "outputs" below).
 disableAliases = true

-[minify]
-[minify.tdewolff]
-[minify.tdewolff.html]
-keepWhitespace = true
-
-[module]
-[module.hugoVersion]
-min = "0.56.0"
-[[module.imports]]
-path = "github.com/gohugoio/gohugoioTheme"
-
 [outputs]
 home = [ "HTML", "RSS", "REDIR", "HEADERS" ]
 section = [ "HTML", "RSS"]
@@ -57,10 +48,13 @@ maxAge = "1440h"
 dir = ":resourceDir/_gen"
 maxAge = -1

+
 [related]
+
 threshold = 80
 includeNewer = true
 toLower = false
+
 [[related.indices]]
 name = "keywords"
 weight = 100
@@ -72,13 +66,25 @@ pattern = "2006"
 [social]
 twitter = "GoHugoIO"

+
+# MARKDOWN
+## Configuration for BlackFriday markdown parser: https://github.com/russross/blackfriday
+[blackfriday]
+plainIDAnchors = true
+# See https://github.com/gohugoio/hugo/issues/2424
+hrefTargetBlank = false
+angledQuotes = false
+latexDashes = true
+
 [imaging]
 # See https://github.com/disintegration/imaging
 # CatmullRom is a sharp bicubic filter which should fit the docs site well with its many screenshots.
 # Note that you can also set this per image processing.
 resampleFilter = "CatmullRom"
+
 # Default JPEG quality setting. Default is 75.
 quality = 75
+
 anchor = "smart"

 [taxonomies]
@@ -1,102 +1,114 @@
 [[docs]]
  name = "About Hugo"
-  weight = 10
+  weight = 1
  identifier = "about"
  url = "/about/"

-[[docs]]
-  name = "Installation"
-  weight = 20
-  identifier = "installation"
-  url = "/installation/"
-
 [[docs]]
  name = "Getting Started"
-  weight = 30
+  weight = 5
  identifier = "getting-started"
  url = "/getting-started/"

 [[docs]]
  name = "Hugo Modules"
-  weight = 40
+  weight = 15
  identifier = "modules"
  post = "break"
  url = "/hugo-modules/"

-# Core menus
+# Core Menus

 [[docs]]
  name = "Content Management"
-  weight = 50
+  weight = 20
  identifier = "content-management"
  post = "expanded"
  url = "/content-management/"

 [[docs]]
  name = "Templates"
-  weight = 60
+  weight = 25
  identifier = "templates"
+
  url = "/templates/"

 [[docs]]
  name = "Functions"
-  weight = 70
+  weight = 30
  identifier = "functions"
  url = "/functions/"

 [[docs]]
  name = "Variables"
-  weight = 80
+  weight = 35
  identifier = "variables"
  url = "/variables/"
-
 [[docs]]
  name = "Hugo Pipes"
-  weight = 90
+  weight = 36
  identifier = "pipes"
  url = "/hugo-pipes/"
-
 [[docs]]
  name = "CLI"
-  weight = 100
+  weight = 40
  post = "break"
  identifier = "commands"
  url = "/commands/"

-# Low level items
+
+
+# LOW LEVEL ITEMS
+

 [[docs]]
  name = "Troubleshooting"
-  weight = 110
+  weight = 60
  identifier = "troubleshooting"
  url = "/troubleshooting/"

 [[docs]]
  name = "Tools"
-  weight = 120
+  weight = 70
  identifier = "tools"
  url = "/tools/"

 [[docs]]
  name = "Hosting & Deployment"
-  weight = 130
+  weight = 80
  identifier = "hosting-and-deployment"
  url = "/hosting-and-deployment/"

 [[docs]]
  name = "Contribute"
-  weight = 140
+  weight = 100
  post = "break"
  identifier = "contribute"
  url = "/contribute/"

+#[[docs]]
+#  name = "Tags"
+#  weight = 120
+#  identifier = "tags"
+#  url = "/tags/"
+
+
+# [[docs]]
+#   name = "Categories"
+#   weight = 140
+#   identifier = "categories"
+#   url = "/categories/"
+
 ######## QUICKLINKS

-[[quicklinks]]
-  name = "Fundamentals"
-  weight = 1
-  identifier = "fundamentals"
-  url = "/tags/fundamentals/"
+  [[quicklinks]]
+    name = "Fundamentals"
+    weight = 1
+    identifier = "fundamentals"
+    url = "/tags/fundamentals/"
+
+
+

 ######## GLOBAL ITEMS TO BE SHARED WITH THE HUGO SITES

@@ -106,37 +118,37 @@
    identifier = "news"
    url = "/news/"

-[[global]]
-  name = "Docs"
-  weight = 5
-  identifier = "docs"
-  url = "/documentation/"
+  [[global]]
+    name = "Docs"
+    weight = 5
+    identifier = "docs"
+    url = "/documentation/"

-[[global]]
-  name = "Themes"
-  weight = 10
-  identifier = "themes"
-  url = "https://themes.gohugo.io/"
+  [[global]]
+    name = "Themes"
+    weight = 10
+    identifier = "themes"
+    url = "https://themes.gohugo.io/"

-[[global]]
-  name = "Showcase"
-  weight = 20
-  identifier = "showcase"
-  url = "/showcase/"
+    [[global]]
+      name = "Showcase"
+      weight = 20
+      identifier = "showcase"
+      url = "/showcase/"

-# Anything with a weight > 100 gets an external icon
+  # Anything with a weight > 100 gets an external icon
+  [[global]]
+    name = "Community"
+    weight = 150
+    icon = true
+    identifier = "community"
+    post = "external"
+    url = "https://discourse.gohugo.io/"

-[[global]]
-  name = "Community"
-  weight = 150
-  icon = true
-  identifier = "community"
-  post = "external"
-  url = "https://discourse.gohugo.io/"

-[[global]]
-  name = "GitHub"
-  weight = 200
-  identifier = "github"
-  post = "external"
-  url = "https://github.com/gohugoio/hugo"
+  [[global]]
+    name = "GitHub"
+    weight = 200
+    identifier = "github"
+    post = "external"
+    url = "https://github.com/gohugoio/hugo"
@@ -1,6 +1,6 @@
 # Config for production

-# This is turned off in development as it is relatively slow.
+# This is turned off in development as it is relatively slow. 
 # This is needed to get accurate lastMod and Git commit info
 # on the docs pages.
 enableGitInfo = true
@@ -27,13 +27,14 @@ This has many benefits. The most noticeable is performance. HTTP servers are *ve

 ## More on Static Site Generators

-* ["An Introduction to Static Site Generators", David Walsh]
+* ["An Introduction to Static Site Generators", David Walsh][]
 * ["Hugo vs. WordPress page load speed comparison: Hugo leaves WordPress in its dust", GettingThingsTech][hugovwordpress]
-* ["Static Site Generators", O'Reilly]
-* [StaticGen: Top Open-Source Static Site Generators (GitHub Stars)]
-* ["Top 10 Static Website Generators", Netlify blog]
+* ["Static Site Generators", O'Reilly][]
+* [StaticGen: Top Open-Source Static Site Generators (GitHub Stars)][]
+* ["Top 10 Static Website Generators", Netlify blog][]
 * ["The Resurgence of Static", dotCMS][dotcms]

+
 ["An Introduction to Static Site Generators", David Walsh]: https://davidwalsh.name/introduction-static-site-generators
 ["Static Site Generators", O'Reilly]: https://github.com/gohugoio/hugoDocs/files/1242701/static-site-generators.pdf
 ["Top 10 Static Website Generators", Netlify blog]: https://www.netlify.com/blog/2016/05/02/top-ten-static-website-generators/
@@ -17,42 +17,43 @@ toc: true

 ## General

-* [Extremely fast] build times (&lt; 1 ms per page)
+* [Extremely fast][] build times (&lt; 1 ms per page)
 * Completely cross platform, with [easy installation][install] on macOS, Linux, Windows, and more
-* Renders changes on the fly with [LiveReload] as you develop
-* [Powerful theming]
+* Renders changes on the fly with [LiveReload][] as you develop
+* [Powerful theming][]
 * [Host your site anywhere][hostanywhere]

 ## Organization

-* Straightforward [organization for your projects], including website sections
-* Customizable [URLs]
-* Support for configurable [taxonomies], including categories and tags
-* [Sort content] as you desire through powerful template [functions]
-* Automatic [table of contents] generation
-* [Dynamic menu] creation
-* [Pretty URLs] support
-* [Permalink] pattern support
-* Redirects via [aliases]
+* Straightforward [organization for your projects][], including website sections
+* Customizable [URLs][]
+* Support for configurable [taxonomies][], including categories and tags
+* [Sort content][] as you desire through powerful template [functions][]
+* Automatic [table of contents][] generation
+* [Dynamic menu][] creation
+* [Pretty URLs][] support
+* [Permalink][] pattern support
+* Redirects via [aliases][]

 ## Content

-* Native Markdown and Emacs Org-Mode support, as well as other languages via *external helpers* (see [supported formats])
-* TOML, YAML, and JSON metadata support in [front matter]
-* Customizable [homepage]
-* Multiple [content types]
-* Automatic and user defined [content summaries]
-* [Shortcodes] to enable rich content inside of Markdown
+* Native Markdown and Emacs Org-Mode support, as well as other languages via *external helpers* (see [supported formats][])
+* TOML, YAML, and JSON metadata support in [front matter][]
+* Customizable [homepage][]
+* Multiple [content types][]
+* Automatic and user defined [content summaries][]
+* [Shortcodes][] to enable rich content inside of Markdown
 * ["Minutes to Read"][pagevars] functionality
 * ["WordCount"][pagevars] functionality

 ## Additional Features

-* Integrated [Disqus] comment support
-* Integrated [Google Analytics] support
-* Automatic [RSS] creation
-* Support for [Go] HTML templates
-* [Syntax highlighting] powered by [Chroma]
+* Integrated [Disqus][] comment support
+* Integrated [Google Analytics][] support
+* Automatic [RSS][] creation
+* Support for [Go][] HTML templates
+* [Syntax highlighting][] powered by [Chroma][]
+

 [aliases]: /content-management/urls/#aliases
 [Chroma]: https://github.com/alecthomas/chroma
@@ -63,11 +64,11 @@ toc: true
 [Extremely fast]: https://github.com/bep/hugo-benchmark
 [front matter]: /content-management/front-matter/
 [functions]: /functions/
-[Go]: https://pkg.go.dev/html/template
+[Go]: https://golang.org/pkg/html/template/
 [Google Analytics]: https://google-analytics.com/
 [homepage]: /templates/homepage/
 [hostanywhere]: /hosting-and-deployment/
-[install]: /installation/
+[install]: /getting-started/installing/
 [LiveReload]: /getting-started/usage/
 [organization for your projects]: /getting-started/directory-structure/
 [pagevars]: /variables/page/
@@ -16,6 +16,7 @@ aliases: [/privacy/,/gdpr/]
 toc: true
 ---

+
 General Data Protection Regulation ([GDPR](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation)) is a regulation in EU law on data protection and privacy for all individuals within the European Union and the European Economic Area. It became enforceable on 25 May 2018.

 **Hugo is a static site generator. By using Hugo you are already standing on very solid ground. Static HTML files on disk are much easier to reason about compared to server and database driven web sites.**
@@ -94,7 +95,6 @@ useSessionStorage
 {{% warning %}}
 `useSessionStorage` is not supported when using Google Analytics v4 (gtag.js).
 {{% /warning %}}
-
 ### Instagram

 simple
@@ -116,7 +116,8 @@ enableDNT
 simple
 : If simple mode is enabled, a static and no-JS version of a tweet will be built.

-**Note:** If you use the _simple mode_ for Twitter, you may want to disable the inline styles provided by Hugo:
+
+**Note:** If you use the _simple mode_ for Twitter, you may want to disable the inlines styles provided by Hugo:

 {{< code-toggle file="config">}}
 [services]
@@ -136,3 +137,4 @@ enableDNT

 simple
 : If simple mode is enabled, the video thumbnail is fetched from Vimeo's servers and it is overlayed with a play button. If the user clicks to play the video, it will open in a new tab directly on Vimeo's website.
+
@@ -10,6 +10,7 @@ menu:
    weight: 4
 weight: 5
 sections_weight: 5
+draft: false
 aliases: [/security/]
 toc: true
 ---
@@ -27,8 +28,11 @@ But when developing and building your site, the runtime is the `hugo` executable
 * User-defined components have read-only access to the filesystem.
 * We shell out to some external binaries to support [Asciidoctor](/content-management/formats/#list-of-content-formats) and similar, but those binaries and their flags are predefined and disabled by default (see [Security Policy](#security-policy)). General functions to run arbitrary external OS commands have been [discussed](https://github.com/gohugoio/hugo/issues/796), but not implemented because of security concerns.

+
 ## Security Policy

+{{< new-in "0.91.0" >}}
+
 Hugo has a built-in security policy that restricts access to [os/exec](https://pkg.go.dev/os/exec), remote communication and similar.

 The default configuration is listed below. Any build using features not in the allow list of the security policy will fail with a detailed message about what needs to be done. Most of these settings are allow lists (string or slice, [Regular Expressions](https://pkg.go.dev/regexp) or `none` which matches nothing).
@@ -37,7 +41,7 @@ The default configuration is listed below. Any build using features not in the a

 Note that these and other config settings in Hugo can be overridden by the OS environment. If you want to block all remote HTTP fetching of data:

-```txt
+```
 HUGO_SECURITY_HTTP_URLS=none hugo
 ```

@@ -53,7 +57,7 @@ These are the security threats as defined by [OWASP](https://en.wikipedia.org/wi

 For HTML output, this is the core security model:

-<https://pkg.go.dev/html/template#hdr-Security_Model>
+https://golang.org/pkg/html/template/#hdr-Security_Model

 In short:

@@ -17,9 +17,9 @@ aliases: [/overview/introduction/,/about/why-i-built-hugo/]
 toc: true
 ---

-Hugo is a general-purpose website framework. Technically speaking, Hugo is a [static site generator]. Unlike systems that dynamically build a page with each visitor request, Hugo builds pages when you create or update your content. Since websites are viewed far more often than they are edited, Hugo is designed to provide an optimal viewing experience for your website's end users and an ideal writing experience for website authors.
+Hugo is a general-purpose website framework. Technically speaking, Hugo is a [static site generator][]. Unlike systems that dynamically build a page with each visitor request, Hugo builds pages when you create or update your content. Since websites are viewed far more often than they are edited, Hugo is designed to provide an optimal viewing experience for your website's end users and an ideal writing experience for website authors.

-Websites built with Hugo are extremely fast and secure. Hugo sites can be hosted anywhere, including [Netlify], [Heroku], [GoDaddy], [DreamHost], [GitHub Pages], [GitLab Pages], [Surge], [Firebase], [Google Cloud Storage], [Amazon S3], [Rackspace], [Azure], and [CloudFront] and work well with CDNs. Hugo sites run without the need for a database or dependencies on expensive runtimes like Ruby, Python, or PHP.
+Websites built with Hugo are extremely fast and secure. Hugo sites can be hosted anywhere, including [Netlify][], [Heroku][], [GoDaddy][], [DreamHost][], [GitHub Pages][], [GitLab Pages][], [Surge][], [Firebase][], [Google Cloud Storage][], [Amazon S3][], [Rackspace][], [Azure][], and [CloudFront][] and work well with CDNs. Hugo sites run without the need for a database or dependencies on expensive runtimes like Ruby, Python, or PHP.

 We think of Hugo as the ideal website creation tool with nearly instant build times, able to rebuild whenever a change is made.

@@ -47,7 +47,7 @@ Hugo is for people building a blog, a company site, a portfolio site, documentat
 [Firebase]: https://firebase.google.com/docs/hosting/ "Firebase static hosting"
 [GitHub Pages]: https://pages.github.com/
 [GitLab Pages]: https://about.gitlab.com/features/pages/
-[Go language]: https://go.dev/
+[Go language]: https://golang.org/
 [GoDaddy]: https://www.godaddy.com/ "GoDaddy.com Hosting"
 [Google Cloud Storage]: https://cloud.google.com/storage/
 [Heroku]: https://www.heroku.com/
@@ -26,7 +26,7 @@ To load completions for every new session, execute once:

 #### macOS:

-	hugo completion bash > $(brew --prefix)/etc/bash_completion.d/hugo
+	hugo completion bash > /usr/local/etc/bash_completion.d/hugo

 You will need to start a new shell for this setup to take effect.

@@ -16,10 +16,6 @@ to enable it.  You can execute the following once:

 	echo "autoload -U compinit; compinit" >> ~/.zshrc

-To load completions in your current shell session:
-
-	source <(hugo completion zsh); compdef _hugo hugo
-
 To load completions for every new session, execute once:

 #### Linux:
@@ -28,7 +24,7 @@ To load completions for every new session, execute once:

 #### macOS:

-	hugo completion zsh > $(brew --prefix)/share/zsh/site-functions/_hugo
+	hugo completion zsh > /usr/local/share/zsh/site-functions/_hugo

 You will need to start a new shell for this setup to take effect.

@@ -18,25 +18,25 @@ hugo config [flags]
 ### Options

 ```
-      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
-  -e, --environment string         build environment
-  -h, --help                       help for config
-      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
-  -s, --source string              filesystem path to read files relative from
-      --themesDir string           filesystem path to themes directory
+  -h, --help   help for config
 ```

 ### Options inherited from parent commands

 ```
-      --config string      config file (default is path/config.yaml|json|toml)
-      --configDir string   config dir (default "config")
-      --debug              debug output
-      --log                enable Logging
-      --logFile string     log File path (if set, logging enabled automatically)
-      --quiet              build in quiet mode
-  -v, --verbose            verbose output
-      --verboseLog         verbose logging
+      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
+      --config string              config file (default is path/config.yaml|json|toml)
+      --configDir string           config dir (default "config")
+      --debug                      debug output
+  -e, --environment string         build environment
+      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
+      --log                        enable Logging
+      --logFile string             log File path (if set, logging enabled automatically)
+      --quiet                      build in quiet mode
+  -s, --source string              filesystem path to read files relative from
+      --themesDir string           filesystem path to themes directory
+  -v, --verbose                    verbose output
+      --verboseLog                 verbose logging
 ```

 ### SEE ALSO
@@ -16,27 +16,27 @@ See convert's subcommands toJSON, toTOML and toYAML for more information.
 ### Options

 ```
-      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
-  -e, --environment string         build environment
-  -h, --help                       help for convert
-      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
-  -o, --output string              filesystem path to write files to
-  -s, --source string              filesystem path to read files relative from
-      --themesDir string           filesystem path to themes directory
-      --unsafe                     enable less safe operations, please backup first
+  -h, --help            help for convert
+  -o, --output string   filesystem path to write files to
+      --unsafe          enable less safe operations, please backup first
 ```

 ### Options inherited from parent commands

 ```
-      --config string      config file (default is path/config.yaml|json|toml)
-      --configDir string   config dir (default "config")
-      --debug              debug output
-      --log                enable Logging
-      --logFile string     log File path (if set, logging enabled automatically)
-      --quiet              build in quiet mode
-  -v, --verbose            verbose output
-      --verboseLog         verbose logging
+      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
+      --config string              config file (default is path/config.yaml|json|toml)
+      --configDir string           config dir (default "config")
+      --debug                      debug output
+  -e, --environment string         build environment
+      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
+      --log                        enable Logging
+      --logFile string             log File path (if set, logging enabled automatically)
+      --quiet                      build in quiet mode
+  -s, --source string              filesystem path to read files relative from
+      --themesDir string           filesystem path to themes directory
+  -v, --verbose                    verbose output
+      --verboseLog                 verbose logging
 ```

 ### SEE ALSO
@@ -22,31 +22,31 @@ hugo deploy [flags]
 ### Options

 ```
-      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
-      --confirm                    ask for confirmation before making changes to the target
-      --dryRun                     dry run
-  -e, --environment string         build environment
-      --force                      force upload of all files
-  -h, --help                       help for deploy
-      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
-      --invalidateCDN              invalidate the CDN cache listed in the deployment target (default true)
-      --maxDeletes int             maximum # of files to delete, or -1 to disable (default 256)
-  -s, --source string              filesystem path to read files relative from
-      --target string              target deployment from deployments section in config file; defaults to the first one
-      --themesDir string           filesystem path to themes directory
+      --confirm          ask for confirmation before making changes to the target
+      --dryRun           dry run
+      --force            force upload of all files
+  -h, --help             help for deploy
+      --invalidateCDN    invalidate the CDN cache listed in the deployment target (default true)
+      --maxDeletes int   maximum # of files to delete, or -1 to disable (default 256)
+      --target string    target deployment from deployments section in config file; defaults to the first one
 ```

 ### Options inherited from parent commands

 ```
-      --config string      config file (default is path/config.yaml|json|toml)
-      --configDir string   config dir (default "config")
-      --debug              debug output
-      --log                enable Logging
-      --logFile string     log File path (if set, logging enabled automatically)
-      --quiet              build in quiet mode
-  -v, --verbose            verbose output
-      --verboseLog         verbose logging
+      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
+      --config string              config file (default is path/config.yaml|json|toml)
+      --configDir string           config dir (default "config")
+      --debug                      debug output
+  -e, --environment string         build environment
+      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
+      --log                        enable Logging
+      --logFile string             log File path (if set, logging enabled automatically)
+      --quiet                      build in quiet mode
+  -s, --source string              filesystem path to read files relative from
+      --themesDir string           filesystem path to themes directory
+  -v, --verbose                    verbose output
+      --verboseLog                 verbose logging
 ```

 ### SEE ALSO
@@ -16,25 +16,25 @@ List requires a subcommand, e.g. `hugo list drafts`.
 ### Options

 ```
-      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
-  -e, --environment string         build environment
-  -h, --help                       help for list
-      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
-  -s, --source string              filesystem path to read files relative from
-      --themesDir string           filesystem path to themes directory
+  -h, --help   help for list
 ```

 ### Options inherited from parent commands

 ```
-      --config string      config file (default is path/config.yaml|json|toml)
-      --configDir string   config dir (default "config")
-      --debug              debug output
-      --log                enable Logging
-      --logFile string     log File path (if set, logging enabled automatically)
-      --quiet              build in quiet mode
-  -v, --verbose            verbose output
-      --verboseLog         verbose logging
+      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
+      --config string              config file (default is path/config.yaml|json|toml)
+      --configDir string           config dir (default "config")
+      --debug                      debug output
+  -e, --environment string         build environment
+      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
+      --log                        enable Logging
+      --logFile string             log File path (if set, logging enabled automatically)
+      --quiet                      build in quiet mode
+  -s, --source string              filesystem path to read files relative from
+      --themesDir string           filesystem path to themes directory
+  -v, --verbose                    verbose output
+      --verboseLog                 verbose logging
 ```

 ### SEE ALSO
@@ -26,53 +26,53 @@ See https://gohugo.io/hugo-modules/ for more information.
 ### Options

 ```
-  -b, --baseURL string             hostname (and path) to the root, e.g. https://spf13.com/
-  -D, --buildDrafts                include content marked as draft
-  -E, --buildExpired               include expired content
-  -F, --buildFuture                include content with publishdate in the future
-      --cacheDir string            filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
-      --cleanDestinationDir        remove files from destination not found in static directories
-      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
-  -c, --contentDir string          filesystem path to content directory
-  -d, --destination string         filesystem path to write files to
-      --disableKinds strings       disable different kind of pages (home, RSS etc.)
-      --enableGitInfo              add Git revision, date, author, and CODEOWNERS info to the pages
-  -e, --environment string         build environment
-      --forceSyncStatic            copy all files when static is changed.
-      --gc                         enable to run some cleanup tasks (remove unused cache files) after the build
-  -h, --help                       help for mod
-      --ignoreCache                ignores the cache directory
-      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
-  -l, --layoutDir string           filesystem path to layout directory
-      --minify                     minify any supported output format (HTML, XML etc.)
-      --noBuildLock                don't create .hugo_build.lock file
-      --noChmod                    don't sync permission mode of files
-      --noTimes                    don't sync modification time of files
-      --panicOnWarning             panic on first WARNING log
-      --poll string                set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
-      --printI18nWarnings          print missing translations
-      --printMemoryUsage           print memory usage to screen at intervals
-      --printPathWarnings          print warnings on duplicate target paths etc.
-      --printUnusedTemplates       print warnings on unused templates.
-  -s, --source string              filesystem path to read files relative from
-      --templateMetrics            display metrics about template executions
-      --templateMetricsHints       calculate some improvement hints when combined with --templateMetrics
-  -t, --theme strings              themes to use (located in /themes/THEMENAME/)
-      --themesDir string           filesystem path to themes directory
-      --trace file                 write trace to file (not useful in general)
+  -b, --baseURL string         hostname (and path) to the root, e.g. https://spf13.com/
+  -D, --buildDrafts            include content marked as draft
+  -E, --buildExpired           include expired content
+  -F, --buildFuture            include content with publishdate in the future
+      --cacheDir string        filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+      --cleanDestinationDir    remove files from destination not found in static directories
+  -c, --contentDir string      filesystem path to content directory
+  -d, --destination string     filesystem path to write files to
+      --disableKinds strings   disable different kind of pages (home, RSS etc.)
+      --enableGitInfo          add Git revision, date, author, and CODEOWNERS info to the pages
+      --forceSyncStatic        copy all files when static is changed.
+      --gc                     enable to run some cleanup tasks (remove unused cache files) after the build
+  -h, --help                   help for mod
+      --ignoreCache            ignores the cache directory
+  -l, --layoutDir string       filesystem path to layout directory
+      --minify                 minify any supported output format (HTML, XML etc.)
+      --noBuildLock            don't create .hugo_build.lock file
+      --noChmod                don't sync permission mode of files
+      --noTimes                don't sync modification time of files
+      --panicOnWarning         panic on first WARNING log
+      --poll string            set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
+      --printI18nWarnings      print missing translations
+      --printMemoryUsage       print memory usage to screen at intervals
+      --printPathWarnings      print warnings on duplicate target paths etc.
+      --printUnusedTemplates   print warnings on unused templates.
+      --templateMetrics        display metrics about template executions
+      --templateMetricsHints   calculate some improvement hints when combined with --templateMetrics
+  -t, --theme strings          themes to use (located in /themes/THEMENAME/)
+      --trace file             write trace to file (not useful in general)
 ```

 ### Options inherited from parent commands

 ```
-      --config string      config file (default is path/config.yaml|json|toml)
-      --configDir string   config dir (default "config")
-      --debug              debug output
-      --log                enable Logging
-      --logFile string     log File path (if set, logging enabled automatically)
-      --quiet              build in quiet mode
-  -v, --verbose            verbose output
-      --verboseLog         verbose logging
+      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
+      --config string              config file (default is path/config.yaml|json|toml)
+      --configDir string           config dir (default "config")
+      --debug                      debug output
+  -e, --environment string         build environment
+      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
+      --log                        enable Logging
+      --logFile string             log File path (if set, logging enabled automatically)
+      --quiet                      build in quiet mode
+  -s, --source string              filesystem path to read files relative from
+      --themesDir string           filesystem path to themes directory
+  -v, --verbose                    verbose output
+      --verboseLog                 verbose logging
 ```

 ### SEE ALSO
@@ -25,56 +25,55 @@ hugo new [path] [flags]
 ### Options

 ```
-  -b, --baseURL string             hostname (and path) to the root, e.g. https://spf13.com/
-  -D, --buildDrafts                include content marked as draft
-  -E, --buildExpired               include expired content
-  -F, --buildFuture                include content with publishdate in the future
-      --cacheDir string            filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
-      --cleanDestinationDir        remove files from destination not found in static directories
-      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
-  -c, --contentDir string          filesystem path to content directory
-  -d, --destination string         filesystem path to write files to
-      --disableKinds strings       disable different kind of pages (home, RSS etc.)
-      --editor string              edit new content with this editor, if provided
-      --enableGitInfo              add Git revision, date, author, and CODEOWNERS info to the pages
-  -e, --environment string         build environment
-  -f, --force                      overwrite file if it already exists
-      --forceSyncStatic            copy all files when static is changed.
-      --gc                         enable to run some cleanup tasks (remove unused cache files) after the build
-  -h, --help                       help for new
-      --ignoreCache                ignores the cache directory
-      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
-  -k, --kind string                content type to create
-  -l, --layoutDir string           filesystem path to layout directory
-      --minify                     minify any supported output format (HTML, XML etc.)
-      --noBuildLock                don't create .hugo_build.lock file
-      --noChmod                    don't sync permission mode of files
-      --noTimes                    don't sync modification time of files
-      --panicOnWarning             panic on first WARNING log
-      --poll string                set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
-      --printI18nWarnings          print missing translations
-      --printMemoryUsage           print memory usage to screen at intervals
-      --printPathWarnings          print warnings on duplicate target paths etc.
-      --printUnusedTemplates       print warnings on unused templates.
-  -s, --source string              filesystem path to read files relative from
-      --templateMetrics            display metrics about template executions
-      --templateMetricsHints       calculate some improvement hints when combined with --templateMetrics
-  -t, --theme strings              themes to use (located in /themes/THEMENAME/)
-      --themesDir string           filesystem path to themes directory
-      --trace file                 write trace to file (not useful in general)
+  -b, --baseURL string         hostname (and path) to the root, e.g. https://spf13.com/
+  -D, --buildDrafts            include content marked as draft
+  -E, --buildExpired           include expired content
+  -F, --buildFuture            include content with publishdate in the future
+      --cacheDir string        filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+      --cleanDestinationDir    remove files from destination not found in static directories
+  -c, --contentDir string      filesystem path to content directory
+  -d, --destination string     filesystem path to write files to
+      --disableKinds strings   disable different kind of pages (home, RSS etc.)
+      --editor string          edit new content with this editor, if provided
+      --enableGitInfo          add Git revision, date, author, and CODEOWNERS info to the pages
+      --forceSyncStatic        copy all files when static is changed.
+      --gc                     enable to run some cleanup tasks (remove unused cache files) after the build
+  -h, --help                   help for new
+      --ignoreCache            ignores the cache directory
+  -k, --kind string            content type to create
+  -l, --layoutDir string       filesystem path to layout directory
+      --minify                 minify any supported output format (HTML, XML etc.)
+      --noBuildLock            don't create .hugo_build.lock file
+      --noChmod                don't sync permission mode of files
+      --noTimes                don't sync modification time of files
+      --panicOnWarning         panic on first WARNING log
+      --poll string            set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
+      --printI18nWarnings      print missing translations
+      --printMemoryUsage       print memory usage to screen at intervals
+      --printPathWarnings      print warnings on duplicate target paths etc.
+      --printUnusedTemplates   print warnings on unused templates.
+      --templateMetrics        display metrics about template executions
+      --templateMetricsHints   calculate some improvement hints when combined with --templateMetrics
+  -t, --theme strings          themes to use (located in /themes/THEMENAME/)
+      --trace file             write trace to file (not useful in general)
 ```

 ### Options inherited from parent commands

 ```
-      --config string      config file (default is path/config.yaml|json|toml)
-      --configDir string   config dir (default "config")
-      --debug              debug output
-      --log                enable Logging
-      --logFile string     log File path (if set, logging enabled automatically)
-      --quiet              build in quiet mode
-  -v, --verbose            verbose output
-      --verboseLog         verbose logging
+      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
+      --config string              config file (default is path/config.yaml|json|toml)
+      --configDir string           config dir (default "config")
+      --debug                      debug output
+  -e, --environment string         build environment
+      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
+      --log                        enable Logging
+      --logFile string             log File path (if set, logging enabled automatically)
+      --quiet                      build in quiet mode
+  -s, --source string              filesystem path to read files relative from
+      --themesDir string           filesystem path to themes directory
+  -v, --verbose                    verbose output
+      --verboseLog                 verbose logging
 ```

 ### SEE ALSO
@@ -20,27 +20,27 @@ hugo new site [path] [flags]
 ### Options

 ```
-      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
-  -e, --environment string         build environment
-      --force                      init inside non-empty directory
-  -f, --format string              config file format (default "toml")
-  -h, --help                       help for site
-      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
-  -s, --source string              filesystem path to read files relative from
-      --themesDir string           filesystem path to themes directory
+      --force           init inside non-empty directory
+  -f, --format string   config file format (default "toml")
+  -h, --help            help for site
 ```

 ### Options inherited from parent commands

 ```
-      --config string      config file (default is path/config.yaml|json|toml)
-      --configDir string   config dir (default "config")
-      --debug              debug output
-      --log                enable Logging
-      --logFile string     log File path (if set, logging enabled automatically)
-      --quiet              build in quiet mode
-  -v, --verbose            verbose output
-      --verboseLog         verbose logging
+      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
+      --config string              config file (default is path/config.yaml|json|toml)
+      --configDir string           config dir (default "config")
+      --debug                      debug output
+  -e, --environment string         build environment
+      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
+      --log                        enable Logging
+      --logFile string             log File path (if set, logging enabled automatically)
+      --quiet                      build in quiet mode
+  -s, --source string              filesystem path to read files relative from
+      --themesDir string           filesystem path to themes directory
+  -v, --verbose                    verbose output
+      --verboseLog                 verbose logging
 ```

 ### SEE ALSO
@@ -21,25 +21,25 @@ hugo new theme [name] [flags]
 ### Options

 ```
-      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
-  -e, --environment string         build environment
-  -h, --help                       help for theme
-      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
-  -s, --source string              filesystem path to read files relative from
-      --themesDir string           filesystem path to themes directory
+  -h, --help   help for theme
 ```

 ### Options inherited from parent commands

 ```
-      --config string      config file (default is path/config.yaml|json|toml)
-      --configDir string   config dir (default "config")
-      --debug              debug output
-      --log                enable Logging
-      --logFile string     log File path (if set, logging enabled automatically)
-      --quiet              build in quiet mode
-  -v, --verbose            verbose output
-      --verboseLog         verbose logging
+      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
+      --config string              config file (default is path/config.yaml|json|toml)
+      --configDir string           config dir (default "config")
+      --debug                      debug output
+  -e, --environment string         build environment
+      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
+      --log                        enable Logging
+      --logFile string             log File path (if set, logging enabled automatically)
+      --quiet                      build in quiet mode
+  -s, --source string              filesystem path to read files relative from
+      --themesDir string           filesystem path to themes directory
+  -v, --verbose                    verbose output
+      --verboseLog                 verbose logging
 ```

 ### SEE ALSO
@@ -29,67 +29,67 @@ hugo server [flags]
 ### Options

 ```
-      --appendPort                 append port to baseURL (default true)
-  -b, --baseURL string             hostname (and path) to the root, e.g. https://spf13.com/
-      --bind string                interface to which the server will bind (default "127.0.0.1")
-  -D, --buildDrafts                include content marked as draft
-  -E, --buildExpired               include expired content
-  -F, --buildFuture                include content with publishdate in the future
-      --cacheDir string            filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
-      --cleanDestinationDir        remove files from destination not found in static directories
-      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
-  -c, --contentDir string          filesystem path to content directory
-  -d, --destination string         filesystem path to write files to
-      --disableBrowserError        do not show build errors in the browser
-      --disableFastRender          enables full re-renders on changes
-      --disableKinds strings       disable different kind of pages (home, RSS etc.)
-      --disableLiveReload          watch without enabling live browser reload on rebuild
-      --enableGitInfo              add Git revision, date, author, and CODEOWNERS info to the pages
-  -e, --environment string         build environment
-      --forceSyncStatic            copy all files when static is changed.
-      --gc                         enable to run some cleanup tasks (remove unused cache files) after the build
-  -h, --help                       help for server
-      --ignoreCache                ignores the cache directory
-      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
-  -l, --layoutDir string           filesystem path to layout directory
-      --liveReloadPort int         port for live reloading (i.e. 443 in HTTPS proxy situations) (default -1)
-      --meminterval string         interval to poll memory usage (requires --memstats), valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". (default "100ms")
-      --memstats string            log memory usage to this file
-      --minify                     minify any supported output format (HTML, XML etc.)
-      --navigateToChanged          navigate to changed content file on live browser reload
-      --noBuildLock                don't create .hugo_build.lock file
-      --noChmod                    don't sync permission mode of files
-      --noHTTPCache                prevent HTTP caching
-      --noTimes                    don't sync modification time of files
-      --panicOnWarning             panic on first WARNING log
-      --poll string                set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
-  -p, --port int                   port on which the server will listen (default 1313)
-      --printI18nWarnings          print missing translations
-      --printMemoryUsage           print memory usage to screen at intervals
-      --printPathWarnings          print warnings on duplicate target paths etc.
-      --printUnusedTemplates       print warnings on unused templates.
-      --renderStaticToDisk         serve static files from disk and dynamic files from memory
-      --renderToDisk               serve all files from disk (default is from memory)
-  -s, --source string              filesystem path to read files relative from
-      --templateMetrics            display metrics about template executions
-      --templateMetricsHints       calculate some improvement hints when combined with --templateMetrics
-  -t, --theme strings              themes to use (located in /themes/THEMENAME/)
-      --themesDir string           filesystem path to themes directory
-      --trace file                 write trace to file (not useful in general)
-  -w, --watch                      watch filesystem for changes and recreate as needed (default true)
+      --appendPort             append port to baseURL (default true)
+  -b, --baseURL string         hostname (and path) to the root, e.g. https://spf13.com/
+      --bind string            interface to which the server will bind (default "127.0.0.1")
+  -D, --buildDrafts            include content marked as draft
+  -E, --buildExpired           include expired content
+  -F, --buildFuture            include content with publishdate in the future
+      --cacheDir string        filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+      --cleanDestinationDir    remove files from destination not found in static directories
+  -c, --contentDir string      filesystem path to content directory
+  -d, --destination string     filesystem path to write files to
+      --disableBrowserError    do not show build errors in the browser
+      --disableFastRender      enables full re-renders on changes
+      --disableKinds strings   disable different kind of pages (home, RSS etc.)
+      --disableLiveReload      watch without enabling live browser reload on rebuild
+      --enableGitInfo          add Git revision, date, author, and CODEOWNERS info to the pages
+      --forceSyncStatic        copy all files when static is changed.
+      --gc                     enable to run some cleanup tasks (remove unused cache files) after the build
+  -h, --help                   help for server
+      --ignoreCache            ignores the cache directory
+  -l, --layoutDir string       filesystem path to layout directory
+      --liveReloadPort int     port for live reloading (i.e. 443 in HTTPS proxy situations) (default -1)
+      --meminterval string     interval to poll memory usage (requires --memstats), valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". (default "100ms")
+      --memstats string        log memory usage to this file
+      --minify                 minify any supported output format (HTML, XML etc.)
+      --navigateToChanged      navigate to changed content file on live browser reload
+      --noBuildLock            don't create .hugo_build.lock file
+      --noChmod                don't sync permission mode of files
+      --noHTTPCache            prevent HTTP caching
+      --noTimes                don't sync modification time of files
+      --panicOnWarning         panic on first WARNING log
+      --poll string            set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
+  -p, --port int               port on which the server will listen (default 1313)
+      --printI18nWarnings      print missing translations
+      --printMemoryUsage       print memory usage to screen at intervals
+      --printPathWarnings      print warnings on duplicate target paths etc.
+      --printUnusedTemplates   print warnings on unused templates.
+      --renderStaticToDisk     serve static files from disk and dynamic files from memory
+      --renderToDisk           serve all files from disk (default is from memory)
+      --templateMetrics        display metrics about template executions
+      --templateMetricsHints   calculate some improvement hints when combined with --templateMetrics
+  -t, --theme strings          themes to use (located in /themes/THEMENAME/)
+      --trace file             write trace to file (not useful in general)
+  -w, --watch                  watch filesystem for changes and recreate as needed (default true)
 ```

 ### Options inherited from parent commands

 ```
-      --config string      config file (default is path/config.yaml|json|toml)
-      --configDir string   config dir (default "config")
-      --debug              debug output
-      --log                enable Logging
-      --logFile string     log File path (if set, logging enabled automatically)
-      --quiet              build in quiet mode
-  -v, --verbose            verbose output
-      --verboseLog         verbose logging
+      --clock string               set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
+      --config string              config file (default is path/config.yaml|json|toml)
+      --configDir string           config dir (default "config")
+      --debug                      debug output
+  -e, --environment string         build environment
+      --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
+      --log                        enable Logging
+      --logFile string             log File path (if set, logging enabled automatically)
+      --quiet                      build in quiet mode
+  -s, --source string              filesystem path to read files relative from
+      --themesDir string           filesystem path to themes directory
+  -v, --verbose                    verbose output
+      --verboseLog                 verbose logging
 ```

 ### SEE ALSO
@@ -1,16 +1,20 @@
 ---
 title: Content Management
-linkTitle: Content Management Overview
+linktitle: Content Management Overview
 description: Hugo makes managing large static sites easy with support for archetypes, content types, menus, cross references, summaries, and more.
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
 menu:
  docs:
-    parent: content-management
-    weight: 10
+    parent: "content-management"
+    weight: 1
 keywords: [source, organization]
 categories: [content management]
-toc: false
-weight: 10
+weight: 01	#rem
+draft: false
 aliases: [/content/,/content/organization]
+toc: false
 ---

 A static site generator needs to extend beyond front matter and a couple of templates to be both scalable and *manageable*. Hugo was designed with not only developers in mind, but also content managers and authors.
@@ -1,22 +1,25 @@
 ---
 title: Archetypes
-linkTitle: Archetypes
+linktitle: Archetypes
 description: Archetypes are templates used when creating new content.
+date: 2017-02-01
+publishdate: 2017-02-01
 keywords: [archetypes,generators,metadata,front matter]
-categories: [content management]
+categories: ["content management"]
 menu:
  docs:
-    parent: content-management
-    weight: 140
+    parent: "content-management"
+    weight: 70
  quicklinks:
-toc: true
-weight: 140
+weight: 70	#rem
+draft: false
 aliases: [/content/archetypes/]
+toc: true
 ---

 ## What are Archetypes?

-**Archetypes** are content template files in the [archetypes directory] of your project that contain preconfigured [front matter] and possibly also a content disposition for your website's [content types]. These will be used when you run `hugo new`.
+**Archetypes** are content template files in the [archetypes directory][] of your project that contain preconfigured [front matter][] and possibly also a content disposition for your website's [content types][]. These will be used when you run `hugo new`.


 The `hugo new` uses the `content-section` to find the most suitable archetype template in your project. If your project does not contain any archetype files, it will also look in the theme.
@@ -66,6 +69,7 @@ It will create a new newsletter type of content file based on the archetype temp

 The above _newsletter type archetype_ illustrates the possibilities: The full Hugo `.Site` and all of Hugo&#39;s template funcs can be used in the archetype file.

+
 ## Directory based archetypes

 Since Hugo `0.49` you can use complete directories as archetype templates. Given this archetype directory:
@@ -86,6 +90,8 @@ hugo new --kind post-bundle posts/my-post

 Will create a new folder in `/content/posts/my-post` with the same set of files as in the `post-bundle` archetypes folder. All content files (`index.md` etc.) can contain template logic, and will receive the correct `.Site` for the content's language.

+
+
 [archetypes directory]: /getting-started/directory-structure/
 [content types]: /content-management/types/
 [front matter]: /content-management/front-matter/
@@ -1,16 +1,19 @@
 ---
 title: Build Options
-linkTitle: Build Options
+linktitle: Build Options
 description: Build options help define how Hugo must treat a given page when building the site.
+date: 2020-03-02
+publishdate: 2020-03-02
 keywords: [build,content,front matter, page resources]
-categories: [content management]
+categories: ["content management"]
 menu:
  docs:
-    parent: content-management
-    weight: 70
-toc: true
-weight: 70
+    parent: "content-management"
+    weight: 31
+weight: 31	#rem
+draft: false
 aliases: [/content/build-options/]
+toc: true
 ---

 They are stored in a reserved Front Matter object named `_build` with the following defaults:
@@ -23,10 +26,9 @@ _build:
 {{< /code-toggle >}}

 #### render
-
 If `always`, the page will be treated as a published page, holding its dedicated output files (`index.html`, etc...) and permalink.

-We extended this property from a boolean to an enum in Hugo 0.76.0. Valid values are:
+{{< new-in "0.76.0" >}} We extended this property from a boolean to an enum in Hugo 0.76.0. Valid values are:

 never
 : The page will not be included in any page collection.
@@ -50,13 +52,13 @@ always (default)
 : The page will be included in all page collections, e.g. `site.RegularPages`, `$page.Pages`.

 local
-: The page will be included in any _local_ page collection, e.g. `$page.RegularPages`, `$page.Pages`. One use case for this would be to create fully navigable, but headless content sections.
+: The page will be included in any _local_ page collection, e.g. `$page.RegularPages`, `$page.Pages`. One use case for this would be to create fully navigable, but headless content sections. {{< new-in "0.68.0" >}}

 If true, the page will be treated as part of the project's collections and, when appropriate, returned by Hugo's listing methods (`.Pages`, `.RegularPages` etc...).

 #### publishResources

-If set to true the [Bundle's Resources]({{< relref "content-management/page-bundles" >}}) will be published.
+If set to true the [Bundle's Resources]({{< relref "content-management/page-bundles" >}}) will be published. 
 Setting this to false will still publish Resources on demand (when a resource's `.Permalink` or `.RelPermalink` is invoked from the templates) but will skip the others.

 {{% note %}}
@@ -68,7 +70,6 @@ Any page, regardless of their build options, will always be available using the
 ### Illustrative use cases

 #### Not publishing a page
-
 Project needs a "Who We Are" content file for Front Matter and body to be used by the homepage but nowhere else.

 ```yaml
@@ -1,16 +1,20 @@
 ---
 title: Comments
-linkTitle: Comments
+linktitle: Comments
 description: Hugo ships with an internal Disqus template, but this isn't the only commenting system that will work with your new Hugo website.
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-03-09
 keywords: [sections,content,organization]
 categories: [project organization, fundamentals]
 menu:
  docs:
-    parent: content-management
-    weight: 220
-toc: true
-weight: 220
+    parent: "content-management"
+    weight: 140
+weight: 140	#rem
+draft: false
 aliases: [/extras/comments/]
+toc: true
 ---

 Hugo ships with support for [Disqus](https://disqus.com/), a third-party service that provides comment and community capabilities to websites via JavaScript.
@@ -29,7 +33,7 @@ Disqus comments require you set a single value in your [site's configuration fil
 disqusShortname = "yourDisqusShortname"
 {{</ code-toggle >}}

-For many websites, this is enough configuration. However, you also have the option to set the following in the [front matter] of a single content file:
+For many websites, this is enough configuration. However, you also have the option to set the following in the [front matter][] of a single content file:

 * `disqus_identifier`
 * `disqus_title`
@@ -39,7 +43,7 @@ For many websites, this is enough configuration. However, you also have the opti

 Disqus has its own [internal template](https://gohugo.io/templates/internal/#disqus) available, to render it add the following code where you want comments to appear:

-```go-html-template
+```
 {{ template "_internal/disqus.html" . }}
 ```

@@ -52,12 +56,11 @@ These are some alternatives to Disqus:
 * [Graph Comment](https://graphcomment.com/)
 * [Hyvor Talk](https://talk.hyvor.com/) (Available as a service)
 * [IntenseDebate](https://intensedebate.com/)
-* [Isso](https://isso-comments.de/) (Self-hosted, Python) ([tutorial][issotutorial])
+* [Isso](https://posativ.org/isso/) (Self-hosted, Python) ([tutorial][issotutorial])
 * [Muut](https://muut.com/)
 * [Remark42](https://remark42.com/) (Open source, Golang, Easy to run docker)
-* [ReplyBox](https://getreplybox.com/)
 * [Staticman](https://staticman.net/)
-* [Talkyard](https://blog-comments.talkyard.io/) (Open source, & serverless hosting)
+* [Talkyard](https://www.talkyard.io/blog-comments) (Open source, & serverless hosting)
 * [Utterances](https://utteranc.es/) (Open source, GitHub comments widget built on GitHub issues)

 [configuration]: /getting-started/configuration/
@@ -1,49 +1,31 @@
 ---
 title: Links and Cross References
-linkTitle: Links and Cross References
 description: Shortcodes for creating links to documents.
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-03-31
 categories: [content management]
 keywords: ["cross references","references", "anchors", "urls"]
 menu:
  docs:
-    parent: content-management
-    weight: 170
-toc: true
-weight: 170
+    parent: "content-management"
+    weight: 100
+weight: 100	#rem
 aliases: [/extras/crossreferences/]
+toc: true
 ---

 The `ref` and `relref` shortcodes display the absolute and relative permalinks to a document, respectively.

-## Use of `ref` and `relref`
+## Use `ref` and `relref`

-The `ref` and `relref` shortcodes require a single parameter: the path to a content document, with or without a file extension, with or without an anchor. Paths without a leading `/` are first resolved relative to the current page, then to the remainder of the site.
-
-```
-.
-└── content
-    ├── about
-    |   ├── _index.md
-    |   └── credits.md
-    ├── pages
-    |   ├── document1.md
-    |   └── document2.md    // has anchor #anchor
-    ├── products
-    |   └── index.md
-    └── blog
-        └── my-post.md
-```
-
-The pages can be referenced as follows:
-
-
-```text
-{{</* ref "document2" */>}}             // <- From pages/document1.md, relative path
-{{</* ref "document2#anchor" */>}}      
-{{</* ref "document2.md" */>}}          
-{{</* ref "document2.md#anchor" */>}}   
-{{</* ref "#anchor" */>}}               // <- From pages/document2.md
-{{</* ref "/blog/my-post" */>}}         // <- From anywhere, absolute path
+```go-html-template
+{{</* ref "document" */>}}
+{{</* ref "document#anchor" */>}}
+{{</* ref "document.md" */>}}
+{{</* ref "document.md#anchor" */>}}
+{{</* ref "#anchor" */>}}
+{{</* ref "/blog/my-post" */>}}
 {{</* ref "/blog/my-post.md" */>}}
 {{</* relref "document" */>}}
 {{</* relref "document.md" */>}}
@@ -51,23 +33,16 @@ The pages can be referenced as follows:
 {{</* relref "/blog/my-post.md" */>}}
 ```

-index.md can be reference either by its path or by its containing folder without the ending `/`. \_index.md can be referenced only by its containing folder:
-
-```text
-{{</* ref "/about" */>}}             // <- References /about/_index.md
-{{</* ref "/about/_index" */>}}      //    Raises REF_NOT_FOUND error
-{{</* ref "/about/credits.md" */>}}  // <- References /about/credits.md
-
-{{</* ref "/products" */>}}          // <- References /products/index.md
-{{</* ref "/products/index" */>}}    // <- References /products/index.md
-```
-
 To generate a hyperlink using `ref` or `relref` in markdown:

-```text
-[About]({{</* ref "/about" */>}} "About Us")
+```md
+[About]({{</* ref "/page/about" */>}} "About Us")
 ```

+The `ref` and `relref` shortcodes require a single parameter: the path to a content document, with or without a file extension, with or without an anchor.
+
+**Paths without a leading `/` are first resolved relative to the current page, then to the remainder of the site.
+
 Hugo emits an error or warning if a document cannot be uniquely resolved. The error behavior is configurable; see below.

 ### Link to another language version
@@ -141,7 +116,7 @@ produces this HTML:

 The behavior can, since Hugo 0.45, be configured in `config.toml`:

-refLinksErrorLevel ("ERROR")
+refLinksErrorLevel ("ERROR") 
 : When using `ref` or `relref` to resolve page links and a link cannot resolved, it will be logged with this log level. Valid values are `ERROR` (default) or `WARNING`. Any `ERROR` will fail the build (`exit -1`).

 refLinksNotFoundURL
@@ -1,23 +1,25 @@
 ---
 title: Diagrams
-LinkTitle: Diagrams
-description: Use fenced code blocks and markdown render hooks to display diagrams.
+date: 2022-02-20
 categories: [content management]
 keywords: [diagrams,drawing]
 menu:
  docs:
-    parent: content-management
-    weight: 50
+    parent: "content-management"
+    weight: 22
+weight: 22
 toc: true
-weight: 50
 ---
+
+
 {{< new-in "0.93.0" >}}

+
 ## GoAT Diagrams (Ascii)

-Hugo supports [GoAT](https://github.com/bep/goat) natively. This means that this code block:
+Hugo! supports [GoAT](https://github.com/bep/goat) natively. This means that this code block:

-````txt
+````
 ```goat
      .               .                .               .--- 1          .-- 1     / 1
     / \              |                |           .---+            .-+         +
@@ -43,9 +45,14 @@ Will be rendered as:
     1   2 3   4    1   2   3   4    1   2   3   4         '--- 4          '-- 4     \ 4
 ```

+
+
+
+
 ## Mermaid Diagrams

-Hugo currently does not provide default templates for Mermaid diagrams. But you can easily add your own. One way to do it would be to create `layouts/_default/_markup/render-codeblock-mermaid.html`:
+Hugo currently does not provide default templates for Mermaid diagrams. But you can easily add your own. One way to do it would be to create ` layouts/_default/_markup/render-codeblock-mermaid.html`:
+

 ```go-html-template
 <div class="mermaid">
@@ -54,7 +61,7 @@ Hugo currently does not provide default templates for Mermaid diagrams. But you
 {{ .Page.Store.Set "hasMermaid" true }}
 ```

-And then include this snippet at the bottom of the content template (**Note**: below `.Content` as the render hook is not processed until `.Content` is executed):
+And then include this snippet at the bottom of the content template (below `.Content`):

 ```go-html-template
 {{ if .Page.Store.Get "hasMermaid" }}
@@ -81,6 +88,8 @@ sequenceDiagram
    Bob-->>John: Jolly good!
 ```

+
+
 ## Goat Ascii Diagram Examples

 ### Graphics
@@ -151,7 +160,7 @@ sequenceDiagram

 ### File tree

-Created from <https://arthursonzogni.com/Diagon/#Tree>
+Created from https://arthursonzogni.com/Diagon/#Tree

 ```goat  { width=300  color="orange" }
 ───Linux─┬─Android
@@ -167,7 +176,7 @@ Created from <https://arthursonzogni.com/Diagon/#Tree>

 ### Sequence Diagram

-<https://arthursonzogni.com/Diagon/#Sequence>
+https://arthursonzogni.com/Diagon/#Sequence

 ```goat { class="w-40" }
 ┌─────┐       ┌───┐
@@ -188,7 +197,7 @@ Created from <https://arthursonzogni.com/Diagon/#Tree>

 ### Flowchart

-<https://arthursonzogni.com/Diagon/#Flowchart>
+https://arthursonzogni.com/Diagon/#Flowchart

 ```goat
   _________________                                                              
@@ -234,7 +243,7 @@ Created from <https://arthursonzogni.com/Diagon/#Tree>

 ### Table

-<https://arthursonzogni.com/Diagon/#Table>
+https://arthursonzogni.com/Diagon/#Table

 ```goat { class="w-80 dark-blue" }
 ┌────────────────────────────────────────────────┐
@@ -263,3 +272,6 @@ Created from <https://arthursonzogni.com/Diagon/#Tree>
 │LITERAL    = """" character { character } """" .│
 └────────────────────────────────────────────────┘
 ```
+
+
+
@@ -1,16 +1,19 @@
 ---
 title: Content Formats
-linkTitle: Content Formats
+linktitle: Content Formats
 description: Both HTML and Markdown are supported content formats.
+date: 2017-01-10
+publishdate: 2017-01-10
 categories: [content management]
 keywords: [markdown,asciidoc,pandoc,content format]
 menu:
  docs:
-    parent: content-management
-    weight: 40
-toc: true
-weight: 40
+    parent: "content-management"
+    weight: 20
+weight: 20	#rem
+draft: false
 aliases: [/content/markdown-extras/,/content/supported-formats/,/doc/supported-formats/]
+toc: true
 ---

 You can put any file type into your `/content` directories, but Hugo uses the `markup` front matter value if set or the file extension (see `Markup identifiers` in the table below) to determine if the markup needs to be processed, e.g.:
@@ -25,7 +28,7 @@ The current list of content formats in Hugo:

 | Name  | Markup identifiers | Comment |
 | ------------- | ------------- |-------------|
-| Goldmark  | md, markdown, goldmark  |Note that you can set the default handler of `md` and `markdown` to something else, see [Configure Markup](/getting-started/configuration-markup/).|
+| Goldmark  | md, markdown, goldmark  |Note that you can set the default handler of `md` and `markdown` to something else, see [Configure Markup](/getting-started/configuration-markup/).{{< new-in "0.60.0" >}} |
 |Emacs Org-Mode|org|See [go-org](https://github.com/niklasfasching/go-org).|
 |AsciiDoc|asciidocext, adoc, ad|Needs [Asciidoctor][ascii] installed.|
 |RST|rst|Needs [RST](https://docutils.sourceforge.io/rst.html) installed.|
@@ -52,13 +55,13 @@ Because additional formats are external commands, generation performance will re

 ### External Helper AsciiDoc

-[AsciiDoc](https://github.com/asciidoc/asciidoc) implementation EOLs in Jan 2020 and is no longer supported.
-AsciiDoc development is being continued under [Asciidoctor](https://github.com/asciidoctor). The format AsciiDoc
+[AsciiDoc](https://github.com/asciidoc/asciidoc) implementation EOLs in Jan 2020 and is no longer supported. 
+AsciiDoc development is being continued under [Asciidoctor](https://github.com/asciidoctor). The format AsciiDoc 
 remains of course. Please continue with the implementation Asciidoctor.

 ### External Helper Asciidoctor

-The Asciidoctor community offers a wide set of tools for the AsciiDoc format that can be installed additionally to Hugo.
+The Asciidoctor community offers a wide set of tools for the AsciiDoc format that can be installed additionally to Hugo. 
 [See the Asciidoctor docs for installation instructions](https://asciidoctor.org/docs/install-toolchain/). Make sure that also all
 optional extensions like `asciidoctor-diagram` or `asciidoctor-html5s` are installed if required.

@@ -97,7 +100,7 @@ Notice that for security concerns only extensions that do not have path separato

 Example of how to set extensions and attributes:

-```yml
+```
 [markup.asciidocExt]
    extensions = ["asciidoctor-html5s", "asciidoctor-diagram"]
    workingFolderCurrent = true
@@ -106,10 +109,10 @@ Example of how to set extensions and attributes:
        my-attribute-name = "my value"
 ```

-In a complex Asciidoctor environment it is sometimes helpful to debug the exact call to your external helper with all
+In a complex Asciidoctor environment it is sometimes helpful to debug the exact call to your external helper with all 
 parameters. Run Hugo with `-v`. You will get an output like

-```txt
+```
 INFO 2019/12/22 09:08:48 Rendering book-as-pdf.adoc with C:\Ruby26-x64\bin\asciidoctor.bat using asciidoc args [--no-header-footer -r asciidoctor-html5s -b html5s -r asciidoctor-diagram --base-dir D:\prototypes\hugo_asciidoc_ddd\docs -a outdir=D:\prototypes\hugo_asciidoc_ddd\build -] ...
 ```

@@ -1,20 +1,23 @@
 ---
 title: Front Matter
-linkTitle: Front Matter
+linktitle:
 description: Hugo allows you to add front matter in yaml, toml, or json to your content files.
+date: 2017-01-09
+publishdate: 2017-01-09
 lastmod: 2017-02-24
 categories: [content management]
 keywords: ["front matter", "yaml", "toml", "json", "metadata", "archetypes"]
 menu:
  docs:
-    parent: content-management
-    weight: 60
-toc: true
-weight: 60
+    parent: "content-management"
+    weight: 30
+weight: 30	#rem
+draft: false
 aliases: [/content/front-matter/]
+toc: true
 ---

-**Front matter** allows you to keep metadata attached to an instance of a [content type]---i.e., embedded inside a content file---and is one of the many features that gives Hugo its strength.
+**Front matter** allows you to keep metadata attached to an instance of a [content type][]---i.e., embedded inside a content file---and is one of the many features that gives Hugo its strength.

 {{< youtube Yh2xKRJGff4 >}}

@@ -65,7 +68,7 @@ cascade
 : a map of Front Matter keys whose values are passed down to the page's descendants unless overwritten by self or a closer ancestor's cascade. See [Front Matter Cascade](#front-matter-cascade) for details.

 date
-: the datetime assigned to this page. This is usually fetched from the `date` field in front matter, but this behavior is configurable.
+: the datetime assigned to this page. This is usually fetched from the `date` field in front matter, but this behaviour is configurable.

 description
 : the description for the content.
@@ -122,7 +125,7 @@ title
 : the title for the content.

 type
-: the type of the content; this value will be automatically derived from the directory (i.e., the [section]) if not specified in front matter.
+: the type of the content; this value will be automatically derived from the directory (i.e., the [section][]) if not specified in front matter.

 url
 : the full path to the content from the web root. It makes no assumptions about the path of the content file. See [URL Management](/content-management/urls/#set-url-in-front-matter).
@@ -134,7 +137,7 @@ weight
 : used for [ordering your content in lists][ordering]. Lower weight gets higher precedence. So content with lower weight will come first. If set, weights should be non-zero, as 0 is interpreted as an *unset* weight.

 \<taxonomies\>
-: field name of the *plural* form of the index. See `tags` and `categories` in the above front matter examples. *Note that the plural form of user-defined taxonomies cannot be the same as any of the predefined front matter variables.*
+: field name of the *plural* form of the index. See `tags` and `categories` in the above front matter examples. _Note that the plural form of user-defined taxonomies cannot be the same as any of the predefined front matter variables._

 {{% note "Hugo's Default URL Destinations" %}}
 If neither `slug` nor `url` is present and [permalinks are not configured otherwise in your site `config` file](/content-management/urls/#permalinks), Hugo will use the filename of your content to create the output URL. See [Content Organization](/content-management/organization) for an explanation of paths in Hugo and [URL Management](/content-management/urls/) for ways to customize Hugo's default behaviors.
@@ -144,7 +147,7 @@ If neither `slug` nor `url` is present and [permalinks are not configured otherw

 You can add fields to your front matter arbitrarily to meet your needs. These user-defined key-values are placed into a single `.Params` variable for use in your templates.

-The following fields can be accessed via `.Params.include_toc` and `.Params.show_comments`, respectively. The [Variables] section provides more information on using Hugo's page- and site-level variables in your templates.
+The following fields can be accessed via `.Params.include_toc` and `.Params.show_comments`, respectively. The [Variables][] section provides more information on using Hugo's page- and site-level variables in your templates.

 {{< code-toggle copy="false" >}}
 include_toc: true
@@ -157,7 +160,9 @@ Any node or section can pass down to descendants a set of Front Matter values as

 ### Target Specific Pages

-The `cascade` block can be a slice with a optional `_target` keyword, allowing for multiple `cascade` values targeting different page sets.
+{{< new-in "0.76.0" >}}
+
+Since Hugo 0.76 the `cascade` block can be a slice with a optional `_target` keyword, allowing for multiple `cascade` values targeting different page sets.

 {{< code-toggle copy="false" >}}
 title ="Blog"
@@ -176,7 +181,7 @@ kind="section"
 Keywords available for `_target`:

 path
-: A [Glob](https://github.com/gobwas/glob) pattern matching the content path below /content. Expects Unix-styled slashes. Note that this is the virtual path, so it starts at the mount root. The matching supports double-asterisks so you can match for patterns like `/blog/*/**` to match anything from the third level and down.
+: A [Glob](https://github.com/gobwas/glob) pattern matching the content path below /content. Expects Unix-styled slashes. Note that this is the virtual path, so it starts at the mount root. The matching support double-asterisks so you can match for patterns like `/blog/*/**` to match anything from the third level and down.

 kind
 : A Glob pattern matching the Page's Kind(s), e.g. "{home,section}".
@@ -187,7 +192,7 @@ lang
 environment
 : A Glob pattern matching the build environment, e.g. "{production,development}"

-Any of the above can be omitted.
+Any of the above can be omitted. 

 ### Example

@@ -201,9 +206,11 @@ cascade:

 With the above example the Blog section page and its descendants will return `images/typewriter.jpg` when `.Params.banner` is invoked unless:

- Said descendant has its own `banner` value set
+- Said descendant has its own `banner` value set 
 - Or a closer ancestor node has its own `cascade.banner` value set.

+
+
 ## Order Content Through Front Matter

 You can assign content-specific `weight` in the front matter of your content. These values are especially useful for [ordering][ordering] in list views. You can use `weight` for ordering of content and the convention of [`<TAXONOMY>_weight`][taxweight] for ordering content within a taxonomy. See [Ordering and Grouping Hugo Lists][lists] to see how `weight` can be used to organize your content in list views.
@@ -214,9 +221,9 @@ It's possible to set some options for Markdown rendering in a content's front ma

 ## Front Matter Format Specs

- [TOML Spec][toml]
- [YAML Spec][yaml]
- [JSON Spec][json]
+* [TOML Spec][toml]
+* [YAML Spec][yaml]
+* [JSON Spec][json]

 [variables]: /variables/
 [aliases]: /content-management/urls/#aliases
@@ -1,15 +1,16 @@
 ---
-title: Image Processing
-linkTitle: Image Processing
-description: Resize, crop, rotate, filter, and convert images.
-categories: [content management]
+title: "Image Processing"
+description: "Resize, crop, rotate, filter, and convert images."
+date: 2018-01-24T13:10:00-05:00
+categories: ["content management"]
 keywords: [resources, images]
+weight: 4004
+draft: false
+toc: true
 menu:
  docs:
-    parent: content-management
-    weight: 90
-toc: true
-weight: 90
+    parent: "content-management"
+    weight: 32
 ---
 ## Image Resources

@@ -27,6 +28,12 @@ content/
        └── sunset.jpg    <-- page resource
 ```

+To access an image as a page resource:
+
+```go-html-template
+{{ $image := .Resources.GetMatch "sunset.jpg" }}
+```
+
 ### Global Resources

 A global resource is a file:
@@ -83,10 +90,10 @@ Example 3: A more concise way to skip image rendering if the resource is not fou

 ## Image Processing Methods

-The `image` resource implements the  [`Resize`], [`Fit`], [`Fill`], [`Crop`], [`Filter`], [`Colors`] and [`Exif`] methods.
+The `image` resource implements the  `Resize`, `Fit`, `Fill`, `Crop`, `Filter`, and `Exif` methods.

 {{% note %}}
-Metadata (Exif, IPTC, XMP, etc.) is not preserved during image transformation. Use the [`Exif`] method with the _original_ image to extract Exif metadata from JPEG or TIFF images.
+Metadata (Exif, IPTC, XMP, etc.) is not preserved during image transformation. Use the`Exif` method with the _original_ image to extract Exif metadata from JPEG or TIFF images.
 {{% /note %}}

 ### Resize
@@ -152,24 +159,11 @@ Sometimes it can be useful to create the filter chain once and then reuse it.
 {{ $image2 := $image2.Filter $filters }}
 ```

-### Colors
-
-{{< new-in "0.104.0" >}}
-
-`.Colors` returns a slice of hex strings with the dominant colors in the image using a simple histogram method.
-
-```go-html-template
-{{ $colors := $image.Colors }}
-```
-
-This method is fast, but if you also scale down your images, it would be good for performance to extract the colors from the scaled down image.
-
-
 ### Exif

 Provides an [Exif] object containing image metadata.

-You may access Exif data in JPEG and TIFF images. To prevent errors when processing images without Exif data, wrap the access in a [`with`] statement.
+You may access Exif data in JPEG and TIFF images. To prevent errors when processing images without Exif data, wrap the access in a `with` statement.

 ```go-html-template
 {{ with $image.Exif }}
@@ -215,11 +209,11 @@ You may also access Exif fields individually, using the [`lang.FormatNumber`] fu

 ## Image Processing Options

-The [`Resize`], [`Fit`], [`Fill`], and [`Crop`] methods accept a space-separated, case-insensitive list of options. The order of the options within the list is irrelevant.
+The `Resize`, `Fit`, `Fill`, and `Crop` methods accept a space-separated, case-insensitive list of options. The order of the options within the list is irrelevant.

 ### Dimensions

-With the [`Resize`] method you must specify width, height, or both. The [`Fit`], [`Fill`], and [`Crop`] methods require both width and height. All dimensions are in pixels.
+With the `Resize` method you must specify width, height, or both. The `Fit`, `Fill`, and `Crop` methods require both width and height. All dimensions are in pixels.

 ```go-html-template
 {{ $image := $image.Resize "600x" }}
@@ -254,9 +248,9 @@ In the example above, on the second line, we have reversed width and height to r

 ### Anchor

-When using the [`Crop`] or [`Fill`] method, the _anchor_ determines the placement of the crop box. You may specify `TopLeft`, `Top`, `TopRight`, `Left`, `Center`,`Right`, `BottomLeft`, `Bottom`, `BottomRight`, or `Smart`.
+When using the `Crop` or `Fill` method, the _anchor_ determines the placement of the crop box. You may specify `TopLeft`, `Top`, `TopRight`, `Left`, `Center`,`Right`, `BottomLeft`, `Bottom`, `BottomRight`, or `Smart`.

-The default value is `Smart`, which uses [Smartcrop] image analysis to determine the optimal placement of the crop box. You may override the default value in the [site configuration].
+The default value is `Smart`, which uses [Smartcrop] image analysis to determine the optimal placement of the crop box. You may override the default value in the [site configuration](#processing-options).

 For example, if you have a 400x200 image with a bird in the upper left quadrant, you can create a 200x100 thumbnail containing the bird:

@@ -264,7 +258,7 @@ For example, if you have a 400x200 image with a bird in the upper left quadrant,
 {{ $image.Crop "200x100 TopLeft" }}
 ```

-If you apply [rotation](#rotation) when using the [`Crop`] or [`Fill`] method, specify the anchor relative to the rotated image.
+If you apply rotation when using the `Crop` or `Fill` method, specify the anchor relative to the rotated image.

 ### Target Format

@@ -288,7 +282,7 @@ To convert an image without scaling, use the dimensions of the original image:

 Applicable to JPEG and WebP images, the `q` value determines the quality of the converted image. Higher values produce better quality images, while lower values produce smaller files. Set this value to a whole number between 1 and 100, inclusive.

-The default value is 75. You may override the default value in the [site configuration].
+The default value is 75. You may override the default value in the [site configuration](#processing-options).

 ```go-html-template
 {{ $image.Resize "600x webp q50" }}
@@ -298,7 +292,7 @@ The default value is 75. You may override the default value in the [site configu

 <!-- Specifies a libwebp preset, not a libwebp image hint. -->

-Applicable to WebP images, this option corresponds to a set of predefined encoding parameters.
+Applicable to WebP images, this option corresponds to a set of pre-defined encoding parameters.

 Value|Example
 :--|:--
@@ -308,7 +302,7 @@ Value|Example
 `picture`|Indoor photograph such as a portrait
 `text`|Image that is primarily text

-The default value is `photo`. You may override the default value in the [site configuration].
+The default value is `photo`. You may override the default value in the [site configuration](#processing-options).

 ```go-html-template
 {{ $image.Resize "600x webp picture" }}
@@ -320,7 +314,7 @@ When converting an image from a format that supports transparency (e.g., PNG) to

 Use either a 3-digit or a 6-digit hexadecimal color code (e.g., `#00f` or `#0000ff`).

-The default value is `#ffffff` (white). You may override the default value in the [site configuration].
+The default value is `#ffffff` (white). You may override the default value in the [site configuration](#processing-options).

 ```go-html-template
 {{ $image.Resize "600x jpg #b31280" }}
@@ -339,7 +333,7 @@ Filter|Description
 `Linear`|Bilinear resampling filter, produces smooth output, faster than cubic filters
 `NearestNeighbor`|Fastest resampling filter, no antialiasing

-The default value is `Box`. You may override the default value in the [site configuration].
+The default value is `Box`. You may override the default value in the [site configuration](#processing-options).

 ```go-html-template
 {{ $image.Resize "600x400 Lanczos" }}
@@ -366,10 +360,10 @@ _The photo of the sunset used in the examples below is Copyright [Bjørn Erik Pe
 This is the shortcode used to generate the examples above:

 {{< code file="layouts/shortcodes/imgproc.html" >}}
-{{< readfile file="layouts/shortcodes/imgproc.html" >}}
+{{< readfile file="layouts/shortcodes/imgproc.html" >}}  
 {{< /code >}}

-Call the shortcode from your Markdown like this:
+Call the shortcode from your markdown like this:

 ```go-html-template
 {{</* imgproc sunset Resize "300x" /*/>}}
@@ -466,12 +460,3 @@ hugo --gc
 [page bundle]: {{< relref "content-management/page-bundles" >}}
 [Smartcrop]: <https://github.com/muesli/smartcrop#smartcrop>
 [time.Format]: {{< relref "functions/dateformat" >}}
-[`Colors`]: #colors
-[`Crop`]: #crop
-[`Exif`]: #exif
-[`Fill`]: #fill
-[`Filter`]: #filter
-[`Fit`]: #fit
-[`Resize`]: #resize
-[site configuration]: #processing-options
-[`with`]: /functions/with/
@@ -1,16 +1,20 @@
 ---
 title: Menus
-linkTitle: Menus
+linktitle: Menus
 description: Hugo has a simple yet powerful menu system.
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-03-31
 categories: [content management]
 keywords: [menus]
+draft: false
 menu:
  docs:
-    parent: content-management
-    weight: 190
-toc: true
-weight: 190
+    parent: "content-management"
+    weight: 120
+weight: 120
 aliases: [/extras/menus/]
+toc: true
 ---

 {{% note "Lazy Blogger"%}}
@@ -65,7 +69,7 @@ menu:

 ## Add Non-content Entries to a Menu

-You can also add entries to menus that aren’t attached to a piece of content. This takes place in your Hugo project's [`config` file][config] (see [Menu Entry Properties][me-props] for full details of available variables).
+You can also add entries to menus that aren’t attached to a piece of content. This takes place in your Hugo project's [`config` file][config].

 Here’s an example snippet pulled from a configuration file:

@@ -1,16 +1,20 @@
 ---
 title: Multilingual Mode
-linkTitle: Multilingual
+linktitle: Multilingual
 description: Hugo supports the creation of websites with multiple languages side by side.
+date: 2017-01-10
+publishdate: 2017-01-10
+lastmod: 2017-01-10
 categories: [content management]
 keywords: [multilingual,i18n, internationalization]
 menu:
  docs:
-    parent: content-management
-    weight: 230
-toc: true
-weight: 230
+    parent: "content-management"
+    weight: 150
+weight: 150	#rem
+draft: false
 aliases: [/content/multilingual/,/tutorials/create-a-multilingual-site/]
+toc: true
 ---

 You should define the available languages in a `languages` section in your site configuration.
@@ -56,7 +60,7 @@ weight = 3

 Anything not defined in a `languages` block will fall back to the global value for that key (e.g., `copyright` for the English `en` language). This also works for `params`, as demonstrated with `help` above: You will get the value `Aide` in French and `Help` in all the languages without this parameter set.

-With the configuration above, all content, sitemap, RSS feeds, pagination,
+With the configuration above, all content, sitemap, RSS feeds, paginations,
 and taxonomy pages will be rendered below `/` in English (your default content language) and then below `/fr` in French.

 When working with front matter `Params` in [single page templates], omit the `params` in the key for the translation.
@@ -220,9 +224,13 @@ slug: "a-propos"

 At render, Hugo will build both `/about/` and `/fr/a-propos/` while maintaining their translation linking.

+{{% note %}}
+If using `url`, remember to include the language part as well: `/fr/compagnie/a-propos/`.
+{{%/ note %}}
+
 ### Page Bundles

-To avoid the burden of having to duplicate files, each Page Bundle inherits the resources of its linked translated pages' bundles except for the content files (Markdown files, HTML files etc...).
+To avoid the burden of having to duplicate files, each Page Bundle inherits the resources of its linked translated pages' bundles except for the content files (markdown files, html files etc...).

 Therefore, from within a template, the page will have access to the files from all linked pages' bundles.

@@ -327,13 +335,13 @@ This article has 101 words.

 ### Query a singular/plural translation

-In other to meet singular/plural requirement, you must pass a dictionary (map) with a numeric `.Count` property to the `i18n` function. The below example uses `.ReadingTime` variable which has a built-in `.Count` property.
+In order to meet singular/plural requirement, you must pass a dictionary (map) with a numeric `.Count` property to the `i18n` function. The below example uses `.ReadingTime` variable which has a built-in `.Count` property.

 ```go-html-template
 {{ i18n "readingTime" .ReadingTime }}
 ```

-The function will read `.Count` from `.ReadingTime` and evaluate whether the number is singular (`one`) or plural (`other`). After that, it will pass to `readingTime` id in `i18n/en-US.toml` file:
+The function will read `.Count` from `.ReadingTime` and evaluate where the number is singular (`one`) or plural (`other`). After that, it will pass to `readingTime` id:

 {{< code-toggle file="i18n/en-US" >}}
 [readingTime]
@@ -341,7 +349,7 @@ one = "One minute to read"
 other = "{{.Count}} minutes to read"
 {{< /code-toggle >}}

-Assuming `.ReadingTime.Count` in the context has value is 525600. The result will be:
+Assume `.ReadingTime.Count` in the context has value of 525600. The result will be:

 ```text
 525600 minutes to read
@@ -353,7 +361,7 @@ If `.ReadingTime.Count` in the context has value is 1. The result is:
 One minute to read
 ```

-In case you need to pass a custom data: (`(dict "Count" numeric_value_only)` is minimum requirement)
+In case you need to pass custom data: (`(dict "Count" 25)` is minimum requirement)

 ```go-html-template
 {{ i18n "readingTime" (dict "Count" 25 "FirstArgument" true "SecondArgument" false "Etc" "so on, so far") }}
@@ -364,7 +372,7 @@ In case you need to pass a custom data: (`(dict "Count" numeric_value_only)` is
 The following localization examples assume your site's primary language is English, with translations to French and German.

 {{< code-toggle file="config" >}}
-defaultContentLanguage = 'en'
+defaultContentLang = 'en'

 [languages]
 [languages.en]
@@ -499,40 +507,6 @@ The rendering of the main navigation works as usual. `.Site.Menus` will just con
 </ul>
 ```

-### Dynamically localizing menus with i18n
-
-While customizing menus per language is useful, your config file can become hard to maintain if you have a lot of languages
-
-If your menus are the same in all languages (ie. if the only thing that changes is the translated name) you can use the `.Identifier` as a translation key for the menu name:
-
-{{< code-toggle file="config" >}}
-[[menu.main]]
-name = "About me"
-url = "about"
-weight = 1
-identifier = "about"
-{{< /code-toggle >}}
-
-You now need to specify the translations for the menu keys in the i18n files:
-
-{{< code file="i18n/pt.toml" >}}
-[about]
-other="Sobre mim"
-{{< /code >}}
-
-And do the appropriate changes in the menu code to use the `i18n` tag with the `.Identifier` as a key. You will also note that here we are using a `default` to fall back to `.Name`, in case the `.Identifier` key is also not present in the language specified in the `defaultContentLanguage` configuration.
-
-{{< code file="layouts/partials/menu.html" >}}
-<ul>
-    {{- $currentPage := . -}}
-    {{ range .Site.Menus.main -}}
-    <li class="{{ if $currentPage.IsMenuCurrent "main" . }}active{{ end }}">
-        <a href="{{ .URL | absLangURL }}">{{ i18n .Identifier | default .Name}}</a>
-    </li>
-    {{- end }}
-</ul>
-{{< /code >}}
-
 ## Missing Translations

 If a string does not have a translation for the current language, Hugo will use the value from the default language. If no default value is set, an empty string will be shown.
@@ -561,23 +535,6 @@ To support Multilingual mode in your themes, some considerations must be taken f

 If there is more than one language defined, the `LanguagePrefix` variable will equal `/en` (or whatever your `CurrentLanguage` is). If not enabled, it will be an empty string (and is therefore harmless for single-language Hugo websites).

-
-## Generate multilingual content with `hugo new`
-
-If you organize content with translations in the same directory:
-
-```text
-hugo new post/test.en.md
-hugo new post/test.de.md
-```
-
-If you organize content with translations in different directories:
-
-```text
-hugo new content/en/post/test.md
-hugo new content/de/post/test.md
-```
-
 [abslangurl]: /functions/abslangurl
 [config]: /getting-started/configuration/
 [contenttemplate]: /templates/single-page-templates/
@@ -1,16 +1,20 @@
 ---
 title: Content Organization
-linkTitle: Organization
+linktitle: Organization
 description: Hugo assumes that the same structure that works to organize your source content is used to organize the rendered site.
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
 categories: [content management,fundamentals]
 keywords: [sections,content,organization,bundle,resources]
 menu:
  docs:
-    parent: content-management
-    weight: 20
-toc: true
-weight: 20
+    parent: "content-management"
+    weight: 10
+weight: 10	#rem
+draft: false
 aliases: [/content/sections/]
+toc: true
 ---

 ## Page Bundles
@@ -31,13 +35,14 @@ The bundle documentation is a **work in progress**. We will publish more compreh

 ## Organization of Content Source

+
 In Hugo, your content should be organized in a manner that reflects the rendered website.

-While Hugo supports content nested at any level, the top levels (i.e. `content/<DIRECTORIES>`) are special in Hugo and are considered the content type used to determine layouts etc. To read more about sections, including how to nest them, see [sections].
+While Hugo supports content nested at any level, the top levels (i.e. `content/<DIRECTORIES>`) are special in Hugo and are considered the content type used to determine layouts etc. To read more about sections, including how to nest them, see [sections][].

 Without any additional configuration, the following will automatically work:

-```txt
+```
 .
 └── content
    └── about
@@ -59,7 +64,7 @@ The following demonstrates the relationships between your content organization a

 ### Index Pages: `_index.md`

-`_index.md` has a special role in Hugo. It allows you to add front matter and content to your [list templates][lists]. These templates include those for [section templates], [taxonomy templates], [taxonomy terms templates], and your [homepage template].
+`_index.md` has a special role in Hugo. It allows you to add front matter and content to your [list templates][lists]. These templates include those for [section templates][], [taxonomy templates][], [taxonomy terms templates][], and your [homepage template][].

 {{% note %}}
 **Tip:** You can get a reference to the content and metadata in `_index.md` using the [`.Site.GetPage` function](/functions/getpage/).
@@ -68,7 +73,7 @@ The following demonstrates the relationships between your content organization a
 You can create one `_index.md` for your homepage and one in each of your content sections, taxonomies, and taxonomy terms. The following shows typical placement of an `_index.md` that would contain content and front matter for a `posts` section list page on a Hugo website:


-```txt
+```
 .         url
 .       ⊢--^-⊣
 .        path    slug
@@ -80,7 +85,7 @@ content/posts/_index.md

 At build, this will output to the following destination with the associated values:

-```txt
+```

                     url ("/posts/")
                    ⊢-^-⊣
@@ -99,7 +104,7 @@ The [sections] can be nested as deeply as you want. The important thing to under
 Single content files in each of your sections will be rendered as [single page templates][singles]. Here is an example of a single `post` within `posts`:


-```txt
+```
                   path ("posts/my-first-hugo-post.md")
 .       ⊢-----------^------------⊣
 .      section        slug
@@ -109,7 +114,7 @@ content/posts/my-first-hugo-post.md

 When Hugo builds your site, the content will be output to the following destination:

-```txt
+```

                               url ("/posts/my-first-hugo-post/")
                   ⊢------------^----------⊣
@@ -175,7 +180,7 @@ slug: "new-post"

 This will render to the following destination according to Hugo's default behavior:

-```txt
+```
 example.com/posts/new-post/
 ```

@@ -212,7 +217,7 @@ url: /blog/new-url/

 Assuming your `baseURL` is [configured][config] to `https://example.com`, the addition of `url` to the front matter will make `old-url.md` render to the following destination:

-```txt
+```
 https://example.com/blog/new-url/
 ```

@@ -1,17 +1,16 @@
 ---
-title: Page Bundles
-linkTitle: Page Bundles
-description: Content organization using Page Bundles
-linkTitle: Page Bundles
-keywords: [page, bundle, leaf, branch]
-categories: [content management]
+title : "Page Bundles"
+description : "Content organization using Page Bundles"
+date : 2018-01-24T13:09:00-05:00
+linktitle : "Page Bundles"
+keywords : ["page", "bundle", "leaf", "branch"]
+categories : ["content management"]
+toc : true
 menu :
  docs:
-    identifier: "page-bundles"
-    parent: "content-management"
-    weight: 30
-toc: true
-weight: 30
+    identifier : "page-bundles"
+    parent : "content-management"
+    weight : 11
 ---

 Page Bundles are a way to group [Page Resources](/content-management/page-resources/).
@@ -24,8 +23,8 @@ A Page Bundle can be one of:
 |                                     | Leaf Bundle                                              | Branch Bundle                                                                                                                                                                                                      |
 |-------------------------------------|----------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------  |
 | Usage                               | Collection of content and attachments for single pages   | Collection of attachments for section pages (home page, section, taxonomy terms, taxonomy list)                                                                                                                    |
-| Index filename                     | `index.md` [^fn:1]                                       | `_index.md` [^fn:1]                                                                                                                                                                                                |
-| Allowed Resources                   | Page and non-page (like images, PDF, etc.) types         | Only non-page (like images, PDF, etc.) types                                                                                                                                                                       |
+| Index file name                     | `index.md` [^fn:1]                                       | `_index.md` [^fn:1]                                                                                                                                                                                                |
+| Allowed Resources                   | Page and non-page (like images, pdf, etc.) types         | Only non-page (like images, pdf, etc.) types                                                                                                                                                                       |
 | Where can the Resources live?       | At any directory level within the leaf bundle directory. | Only in the directory level **of** the branch bundle directory i.e. the directory containing the `_index.md` ([ref](https://discourse.gohugo.io/t/question-about-content-folder-structure/11822/4?u=kaushalmodi)). |
 | Layout type                         | `single`                                                 | `list`                                                                                                                                                                                                             |
 | Nesting                             | Does not allow nesting of more bundles under it          | Allows nesting of leaf or branch bundles under it                                                                                                                                                                  |
@@ -65,27 +64,26 @@ content/
 In the above example `content/` directory, there are four leaf
 bundles:

-`about`
+about
 : This leaf bundle is at the root level (directly under
    `content` directory) and has only the `index.md`.

-`my-post`
+my-post
 : This leaf bundle has the `index.md`, two other content
    Markdown files and two image files.

- image1, image2:
-These images are page resources of `my-post`
+image1
+: This image is a page resource of `my-post`
    and only available in `my-post/index.md` resources.

- content1, content2:
-These content files are page resources of `my-post`
+image2
+: This image is a page resource of `my-post`
    and only available in `my-post/index.md` resources.
-    They will **not** be rendered as individual pages.

-`my-other-post`
+my-other-post
 : This leaf bundle has only the `index.md`.

-`another-leaf-bundle`
+another-leaf-bundle
 : This leaf bundle is nested under couple of
    directories. This bundle also has only the `index.md`.

@@ -100,8 +98,8 @@ as long as it is not inside another **leaf** bundle.
 A headless bundle is a bundle that is configured to not get published
 anywhere:

- It will have no `Permalink` and no rendered HTML in `public/`.
- It will not be part of `.Site.RegularPages`, etc.
+-   It will have no `Permalink` and no rendered HTML in `public/`.
+-   It will not be part of `.Site.RegularPages`, etc.

 But you can get it by `.Site.GetPage`. Here is an example:

@@ -122,9 +120,9 @@ _In this example, we are assuming the `some-headless-bundle` to be a headless
 Explanation of the above example:

 1. Get the `some-headless-bundle` Page "object".
-2. Collect a _slice_ of resources in this _Page Bundle_ that matches
+2. Collect a *slice* of resources in this *Page Bundle* that matches
   `"author*"` using `.Resources.Match`.
-3. Loop through that _slice_ of nested pages, and output their `.Title` and
+3. Loop through that *slice* of nested pages, and output their `.Title` and
   `.Content`.

 ---
@@ -138,8 +136,9 @@ headless = true

 There are many use cases of such headless page bundles:

- Shared media galleries
- Reusable page content "snippets"
+-   Shared media galleries
+-   Reusable page content "snippets"
+

 ## Branch Bundles {#branch-bundles}

@@ -1,15 +1,17 @@
 ---
-title: Page Resources
-linkTitle: Page Resources
-description: Page resources -- images, other pages, documents, etc. -- have page-relative URLs and their own metadata.
-categories: [content management]
+title : "Page Resources"
+description : "Page resources -- images, other pages, documents, etc. -- have page-relative URLs and their own metadata."
+date: 2018-01-24
+categories: ["content management"]
 keywords: [bundle,content,resources]
+weight: 4003
+draft: false
+toc: true
+linktitle: "Page Resources"
 menu:
  docs:
-    parent: content-management
-    weight: 80
-toc: true
-weight: 80
+    parent: "content-management"
+    weight: 31
 ---
 Page resources are only accessible from [page bundles]({{< relref
 "/content-management/page-bundles" >}}), those directories with `index.md` or
@@ -43,6 +45,8 @@ content
 ResourceType
 : The main type of the resource's [Media Type](/templates/output-formats/#media-types). For example, a file of MIME type `image/jpeg` has the ResourceType `image`. A `Page` will have `ResourceType` with value `page`.

+{{< new-in "0.80.0" >}} Note that we in Hugo `v0.80.0` fixed a bug where non-image resources (e.g. video) would return the MIME sub type, e.g. `json`.
+
 Name
 : Default value is the filename (relative to the owning page). Can be set in front matter.

@@ -86,17 +90,16 @@ MediaType.Suffixes
 : A slice of possible suffixes for the resource's MIME type.

 ## Methods
-
 ByType
 : Returns the page resources of the given type.

-```go-html-template
+```go
 {{ .Resources.ByType "image" }}
 ```
 Match
 : Returns all the page resources (as a slice) whose `Name` matches the given Glob pattern ([examples](https://github.com/gobwas/glob/blob/master/readme.md)). The matching is case-insensitive.

-```go-html-template
+```go
 {{ .Resources.Match "images/*" }}
 ```

@@ -104,7 +107,6 @@ GetMatch
 : Same as `Match` but will return the first match.

 ### Pattern Matching
-
 ```go
 // Using Match/GetMatch to find this images/sunset.jpg ?
 .Resources.Match "images/sun*" ✅
@@ -129,7 +131,7 @@ name
 : Sets the value returned in `Name`.

 {{% warning %}}
-The methods `Match`, `Get` and `GetMatch` use `Name` to match the resources.
+The methods `Match` and `GetMatch` use `Name` to match the resources.
 {{%/ warning %}}

 title
@@ -138,7 +140,8 @@ title
 params
 : A map of custom key/values.

-### Resources metadata example
+
+###  Resources metadata example

 {{< code-toggle copy="false">}}
 title: Application
@@ -1,22 +1,25 @@
 ---
 title: Related Content
-linkTitle: Related Content
 description: List related content in "See Also" sections.
+date: 2017-09-05
 categories: [content management]
 keywords: [content]
 menu:
  docs:
-    parent: content-management
-    weight: 110
-toc: true
-weight: 110
+    parent: "content-management"
+    weight: 40
+weight: 30
+draft: false
 aliases: [/content/related/,/related/]
+toc: true
 ---

+
 Hugo uses a set of factors to identify a page's related content based on Front Matter parameters. This can be tuned to the desired set of indices and parameters or left to Hugo's default [Related Content configuration](#configure-related-content).

 ## List Related Content

+
 To list up to 5 related pages (which share the same _date_ or _keyword_ parameters) is as simple as including something similar to this partial in your single page template:

 {{< code file="layouts/partials/related.html" >}}
@@ -24,9 +27,9 @@ To list up to 5 related pages (which share the same _date_ or _keyword_ paramete
 {{ with $related }}
 <h3>See Also</h3>
 <ul>
- {{ range . }}
- <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
- {{ end }}
+	{{ range . }}
+	<li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+	{{ end }}
 </ul>
 {{ end }}
 {{< /code >}}
@@ -36,28 +39,25 @@ To list up to 5 related pages (which share the same _date_ or _keyword_ paramete
 Here is the list of "Related" methods available on a page collection such `.RegularPages`.

 #### .Related PAGE
-
 Returns a collection of pages related the given one.

-```go-html-template
+```
 {{ $related := site.RegularPages.Related . }}
 ```

 #### .RelatedIndices PAGE INDICE1 [INDICE2 ...]
-
 Returns a collection of pages related to a given one restricted to a list of indices.

-```go-html-template
+```
 {{ $related := site.RegularPages.RelatedIndices . "tags" "date" }}
 ```

 #### .RelatedTo KEYVALS [KEYVALS2 ...]
-
 Returns a collection of pages related together by a set of indices and their match.

 In order to build those set and pass them as argument, one must use the `keyVals` function where the first argument would be the `indice` and the consecutive ones its potential `matches`.

-```go-html-template
+```
 {{ $related := site.RegularPages.RelatedTo ( keyVals "tags" "hugo" "rocks")  ( keyVals "date" .Date ) }}
 ```

@@ -66,7 +66,6 @@ Read [this blog article](https://regisphilibert.com/blog/2018/04/hugo-optmized-r
 {{% /note %}}

 ## Configure Related Content
-
 Hugo provides a sensible default configuration of Related Content, but you can fine-tune this in your configuration, on the global or language level if needed.

 ### Default configuration
@@ -1,7 +1,7 @@
 ---
 title: Content Sections
-linkTitle: Sections
-description: Hugo generates a **section tree** that matches your content.
+linktitle: Sections
+description: "Hugo generates a **section tree** that matches your content."
 date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
@@ -9,11 +9,12 @@ categories: [content management]
 keywords: [lists,sections,content types,organization]
 menu:
  docs:
-    parent: content-management
-    weight: 120
-toc: true
-weight: 120
+    parent: "content-management"
+    weight: 50
+weight: 50	#rem
+draft: false
 aliases: [/content/sections/]
+toc: true
 ---

 A **Section** is a collection of pages that gets defined based on the
@@ -63,16 +64,19 @@ If you need a specific template for a sub-section, you need to adjust either the
 With the available [section variables and methods](#section-page-variables-and-methods) you can build powerful navigation. One common example would be a partial to show Breadcrumb navigation:

 {{< code file="layouts/partials/breadcrumb.html" download="breadcrumb.html" >}}
-<ol class="nav navbar-nav">
-<ul>
-{{- range .Ancestors.Reverse }}
-<li><a href="{{ .Permalink }}">{{ .Title }}</a></li>
-{{- end }}
-<li class="active" aria-current="page">
-<a href="{{ .Permalink }}">{{ .Title }}</a>
-</li>
-</ul>
+<ol  class="nav navbar-nav">
+  {{ template "breadcrumbnav" (dict "p1" . "p2" .) }}
 </ol>
+{{ define "breadcrumbnav" }}
+{{ if .p1.Parent }}
+{{ template "breadcrumbnav" (dict "p1" .p1.Parent "p2" .p2 )  }}
+{{ else if not .p1.IsHome }}
+{{ template "breadcrumbnav" (dict "p1" .p1.Site.Home "p2" .p2 )  }}
+{{ end }}
+<li{{ if eq .p1 .p2 }} class="active"{{ end }}>
+  <a href="{{ .p1.Permalink }}">{{ .p1.Title }}</a>
+</li>
+{{ end }}
 {{< /code >}}

 ## Section Page Variables and Methods
@@ -83,11 +87,11 @@ Also see [Page Variables](/variables/page/).

 ## Content Section Lists

-Hugo will automatically create a page for each *root section* that lists all the content in that section. See the documentation on [section templates] for details on customizing the way these pages are rendered.
+Hugo will automatically create pages for each *root section* that list all of the content in that section. See the documentation on [section templates][] for details on customizing the way these pages are rendered.

 ## Content *Section* vs Content *Type*

-By default, everything created within a section will use the [content `type`][content type] that matches the *root section* name. For example, Hugo will assume that `posts/post-1.md` has a `posts` content `type`. If you are using an [archetype] for your `posts` section, Hugo will generate front matter according to what it finds in `archetypes/posts.md`.
+By default, everything created within a section will use the [content `type`][content type] that matches the *root section* name. For example, Hugo will assume that `posts/post-1.md` has a `posts` content `type`. If you are using an [archetype][] for your `posts` section, Hugo will generate front matter according to what it finds in `archetypes/posts.md`.

 [archetype]: /content-management/archetypes/
 [content type]: /content-management/types/
--- a/Show More
+++ b/Show More
				`@@ -1 +0,0 @@`
				<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 402 58"><g fill="#231F20"><path d="M24.6 23c.4 0 .7-.1 1-.2l10-5.4c1-.5 1.3-1.8.8-2.8-.5-1-1.8-1.3-2.8-.8l-9.9 5.4c-1 .3-1.5 1.3-1.3 2.3.3 1 1.3 1.7 2.3 1.5h-.1zM39.8 30.9c.3 0 .7-.1 1-.3L56.7 22c.6-.3 1-1 1-1.7 0-.8-.3-1.5-.9-1.8-.7-.4-1.4-.4-2.1-.1L38.8 27c-.9.4-1.5 1.4-1.2 2.4.2 1 1.2 1.6 2.2 1.5z"/><path d="M81 19.6c-.4-1.2-1.3-2.2-2.4-2.7L61.4 7.7c-2.8-1.4-6.1-1.4-9 0l-1.4.7L39.1 2C36.3.6 33 .6 30.1 2L2.5 16.9c-1.4.6-2.3 1.9-2.5 3.4v15.2c0 .8.4 1.5 1.1 1.8l35 19c2.8 1.4 6.2 1.4 9 0L80 37.1c.7-.3 1.1-1 1.1-1.8v-15c0-.2-.1-.5-.1-.7zm-76.5.9L32 5.6c1.6-.7 3.5-.7 5.2 0L51 13l3.3-1.8c1.7-.7 3.6-.7 5.2 0l17.1 9.2.2.1-.2.1-33.4 18c-1.7.8-3.6.8-5.2 0l-33.5-18-.2-.1h.2zm38.6 32.2c-1.6.7-3.5.7-5.1 0L4.1 34.3v-9.2L36 42.3c2.8 1.4 6.2 1.4 9 0l32-17.2v9L43.1 52.7zM115.7 10.2h18.2c8.7 0 13.1 3.1 13.1 9.1 0 1.9-.5 3.7-1.6 5.2s-2.6 2.6-4.3 3.2c2.2.4 4.2 1.5 5.7 3.1s2.2 3.6 2.2 5.7c0 3.8-1.4 6.7-4.1 8.7-2.7 2-6.6 3-11.8 3h-17.5v-5.4l1.8-.2c.4 0 .8-.2 1.1-.5.2-.4.3-.9.3-1.3V16.1l-3.1-.3v-5.6zm13.1 6.4v9h2.7c3.5 0 5.3-1.6 5.3-4.8 0-2.8-1.7-4.2-5.1-4.2h-2.9zm0 15.1v9.9h3.7c3.8 0 5.8-1.8 5.8-5.2 0-3.1-1.9-4.7-5.7-4.7h-3.8zM180.7 19v22c0 .5 0 .9.3 1.3.2.3.6.4 1 .5l1.5.1v5.2h-11.7v-3.6h-.2c-1.7 3-4.5 4.4-8.5 4.4-3.1 0-5.3-.8-6.8-2.3-1.4-1.6-2.1-4-2.1-7.3V26.2c0-.4-.1-.8-.4-1.1-.2-.3-.6-.5-1-.5l-1.6-.2V19H164v18.4c-.1 1.1.1 2.2.6 3.1.6.8 1.6 1.1 2.5 1 1.1.1 2.2-.4 2.9-1.2.7-1 1.1-2.2 1-3.4V26.3c0-.5-.1-.9-.3-1.3-.3-.3-.7-.4-1.1-.4l-1.3-.2V19h12.4zM198.9 12.3V19h8.1c2.5-1.1 4.3-3.4 5.5-6.7h5.3V19h6.9l-.5 6.3h-6.4v12.3c-.1 1.1.2 2.2.7 3.2.4.5 1.3.8 2.7.8 1.2 0 2.5-.3 3.6-.8l1.4 6.3c-2.5 1.3-5.2 1.9-7.9 1.8-1.3 0-2.5-.1-3.8-.3-.9-.2-1.8-.4-2.7-.8-.7-.3-1.3-.8-1.8-1.4-.4-.5-.8-1-1.1-1.6-.3-.6-.5-1.3-.6-2-.1-.6-.2-1.3-.3-2V25.3h-9v12.3c-.1 1 .1 2.1.6 3.1.5.7 1.4 1.1 2.3 1 1.1 0 2.2-.3 3.2-.8l1.7 6.2c-2.3 1.2-4.9 1.9-7.5 1.8-3.7 0-6.4-.9-7.9-2.6-1.5-1.7-2.3-4.2-2.3-7.6V25.3h-3.9l.8-5.5c3.6-.8 6.2-3.3 7.6-7.4l5.3-.1zM242.7 18.2c2.7-.1 5.3.6 7.5 2.2 2 1.6 3 4.1 2.8 6.6 0 6.9-5.3 10.2-16 10 .1 1.3.7 2.6 1.7 3.5 1.2 1 2.7 1.4 4.2 1.4 2.6-.1 5.2-.9 7.4-2.3l2.6 6.3c-.5.4-1 .7-1.6.9-1.3.6-2.6 1-4 1.4-1.9.5-3.8.7-5.7.7-4.9 0-8.5-1.3-10.8-4-2.3-2.6-3.5-6.2-3.5-10.7-.1-4.1 1.3-8.2 4-11.4 2.7-3 6.5-4.6 11.4-4.6zm2 9.3c0-.7-.2-1.4-.7-1.9-.5-.5-1.2-.7-1.9-.6-1.4 0-2.8.6-3.6 1.8-1 1.3-1.6 2.9-1.6 4.6 5.2.2 7.7-1.2 7.7-3.9h.1zM272.5 25.5c-1.1 0-2.1.5-2.7 1.3-.7.9-1.1 2.1-1 3.3v12.5l5.1.3v5.3h-18.1V43l1.9-.2c.4.1.8-.1 1.1-.4.2-.4.3-.9.3-1.4V26.2c0-.4-.1-.8-.3-1.2-.3-.3-.6-.4-1-.4l-2-.2V19H268v4.4h.1c.7-1.4 1.7-2.7 3-3.6 1.6-1.1 3.5-1.7 5.4-1.6 1.9-.1 3.7.2 5.4.9v11.3l-7.6.4v-3.9c0-.7-.2-1.1-.5-1.2-.4-.1-.9-.2-1.3-.2zM308.7 17.5c-1.2-.3-2.3-.4-3.4-.4-6.1 0-9.2 3.9-9.2 11.8 0 3.8.8 6.8 2.3 9 1.5 2.2 3.9 3.3 7.1 3.4 1.1 0 2.1-.1 3.2-.4.6-.2 1-.8 1-1.5v-3.7l7.3.4v10.5c-3.8 1.7-7.9 2.5-12.1 2.3-6.1 0-10.8-1.6-14.1-4.9-3.3-3.3-5-8.1-5-14.5 0-3.2.5-6.4 1.6-9.4.9-2.5 2.4-4.6 4.4-6.3 1.8-1.4 3.8-2.5 6-3.3 2.2-.7 4.6-1 6.9-1 4.2-.1 8.3.7 12.2 2.4v10l-7.4.4V19c0-.9-.3-1.4-.8-1.5zM323.6 10.2h14.6l7.5 24.8h.2l7.7-24.7h14.6v5.4l-1.8.2c-.5 0-.9.2-1.2.5-.3.4-.4.9-.3 1.3l1.9 24.8 2.9.1v5.6h-15.3v-5.5l1.8-.2c.4.1.8-.1 1-.4.2-.4.3-.9.2-1.3l-.9-16.1h-.1l-7.2 23.5h-7.1l-7-23.1h-.2l-1 17.3 2.8.2v5.6h-15.3v-5.5l1.8-.2c.5 0 .9-.2 1.2-.5.2-.4.4-.9.4-1.4l2-24.6-3.2-.2v-5.6zM385.5 41.6c3.5 0 5.3-1.4 5.3-4.2 0-1.1-.5-2.2-1.4-2.8-1.4-.8-2.9-1.4-4.5-1.8-1.3-.3-2.7-.8-4-1.3-1.2-.5-2.3-1.2-3.4-1.9-1.2-.9-2.2-2-2.8-3.3-.6-1.5-1-3.2-1-4.8-.1-3.4 1.4-6.7 4-8.8 2.7-2.1 6.2-3.1 10.6-3.1 4-.2 8 .6 11.7 2.2v9.3l-7.4.5v-2.9c0-.8-.3-1.3-.8-1.4-1.1-.3-2.2-.4-3.3-.4-1.1 0-2.2.3-3.1.8-.8.6-1.3 1.6-1.2 2.6-.1 1.1.5 2.2 1.4 2.8 1.5.9 3.1 1.6 4.8 2 1.4.4 2.5.8 3.3 1.1.9.4 1.9.8 2.8 1.3 1 .5 1.9 1.2 2.6 2 .7.9 1.2 1.8 1.6 2.9.5 1.3.7 2.6.7 4 .2 3.6-1.3 7-4.1 9.3-2.7 2.2-6.4 3.3-11.2 3.3-4.3.1-8.6-.7-12.6-2.3v-9.8l7.5-.5v3.2c0 .9.3 1.4.9 1.6 1.1.2 2.3.4 3.6.4z"/></g></svg>