From: Bjørn Erik Pedersen Date: Tue, 3 Aug 2021 09:52:57 +0000 (+0200) Subject: Merge commit 'bd77f6e1c99e04a476f0b1bb4e44569134e02399' into release-0.87.0 X-Git-Tag: v0.87.0~3^2~3 X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=093498352;p=brevno-suite%2Fhugo Merge commit 'bd77f6e1c99e04a476f0b1bb4e44569134e02399' into release-0.87.0 --- 0934983529824d819ceaf98df33b30abee7659bc diff --cc docs/config.toml index 8c6480681,000000000..7888579fe mode 100644,000000..100644 --- a/docs/config.toml +++ b/docs/config.toml @@@ -1,73 -1,0 +1,79 @@@ +baseURL = "https://gohugo.io/" +paginate = 100 +defaultContentLanguage = "en" +enableEmoji = true +# 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" diff --cc docs/content/en/functions/adddate.md index 4c5807f71,000000000..5037beb02 mode 100644,000000..100644 --- a/docs/content/en/functions/adddate.md +++ b/docs/content/en/functions/adddate.md @@@ -1,52 -1,0 +1,52 @@@ +--- +title: .AddDate +description: Returns the time corresponding to adding the given number of years, months, and days passed to the function. +godocref: https://golang.org/pkg/time/#Time.AddDate +date: 2017-02-01 +publishdate: 2017-02-01 +lastmod: 2017-02-01 +categories: [functions] +menu: + docs: + parent: "functions" +keywords: [dates,time] +signature: [".AddDate YEARS MONTHS DAYS"] +workson: [times] +hugoversion: +relatedfuncs: [now] +deprecated: false +aliases: [] +--- + + +The `AddDate` function takes three arguments in logical order of `years`, `months`, and `days`. + +## Example: Randomized Tweets from the Last 2 Years + +Let's assume you have a file at `data/tweets.toml` that contains a list of Tweets to display on your site's homepage. The file is filled with `[[tweet]]` blocks; e.g.--- + +{{< code-toggle file="data/tweets" >}} +[[tweet]] +name = "Steve Francia" +twitter_handle = "@spf13" +quote = "I'm creator of Hugo. #metadocreference" +link = "https://twitter.com/spf13" +date = "2017-01-07T00:00:00Z" +{{< /code-toggle >}} + - Let's assume you want to grab Tweets from the last two years and present them in a random order. In conjunction with the [`where`](/functions/where/) and [`now`](/functions/now/) functions, you can limit our range to the last two years via `now.AddDate -2 0 0`, which represents a point in time 2 years, 0 days, and 0 hours before the time of your last site build. ++Let's assume you want to grab Tweets from the last two years and present them in a random order. In conjunction with the [`where`](/functions/where/) and [`now`](/functions/now/) functions, you can limit our range to the last two years via `now.AddDate -2 0 0`, which represents a point in time 2 years, 0 months, and 0 days before the time of your last site build. + +{{< code file="partials/templates/random-tweets.html" download="tweets.html" >}} +{{ range where $.Site.Data.tweets.tweet "date" "ge" (now.AddDate -2 0 0) | shuffle }} +
+
+

+ {{ .quote | safeHTML }} +

+ — {{ .name }} ({{ .twitter_handle }}) + {{ dateFormat "January 2, 2006" .date }} + +
+
+{{ end }} +{{< /code >}} diff --cc docs/content/en/getting-started/configuration.md index 8c0dbfa31,000000000..b7fc9e63c mode 100644,000000..100644 --- a/docs/content/en/getting-started/configuration.md +++ b/docs/content/en/getting-started/configuration.md @@@ -1,617 -1,0 +1,620 @@@ +--- +title: Configure Hugo +linktitle: Configuration +description: How to configure your Hugo site. +date: 2013-07-01 +publishdate: 2017-01-02 +lastmod: 2017-03-05 +categories: [getting started,fundamentals] +keywords: [configuration,toml,yaml,json] +menu: + docs: + parent: "getting-started" + weight: 60 +weight: 60 +sections_weight: 60 +draft: false +aliases: [/overview/source-directory/,/overview/configuration/] +toc: true +--- + + +## Configuration File + +Hugo uses the `config.toml`, `config.yaml`, or `config.json` (if found in the +site root) as the default site config file. + +The user can choose to override that default with one or more site config files +using the command line `--config` switch. + +Examples: + +``` +hugo --config debugconfig.toml +hugo --config a.toml,b.toml,c.toml +``` + +{{% note %}} +Multiple site config files can be specified as a comma-separated string to the `--config` switch. +{{% /note %}} + +{{< todo >}}TODO: distinct config.toml and others (the root object files){{< /todo >}} + +## Configuration Directory + +In addition to using a single site config file, one can use the `configDir` directory (default to `config/`) to maintain easier organization and environment specific settings. + +- Each file represents a configuration root object, such as `params.toml` for `[Params]`, `menu(s).toml` for `[Menu]`, `languages.toml` for `[Languages]` etc... +- Each file's content must be top-level, for example: + +{{< code-toggle file="config" >}} +[Params] + foo = "bar" +{{< /code-toggle >}} + +{{< code-toggle file="params" >}} +foo = "bar" +{{< /code-toggle >}} + +- Each directory holds a group of files containing settings unique to an environment. +- Files can be localized to become language specific. + + +``` +├── config +│ ├── _default +│ │ ├── config.toml +│ │ ├── languages.toml +│ │ ├── menus.en.toml +│ │ ├── menus.zh.toml +│ │ └── params.toml +│ ├── production +│ │ ├── config.toml +│ │ └── params.toml +│ └── staging +│ ├── config.toml +│ └── params.toml +``` + +Considering the structure above, when running `hugo --environment staging`, Hugo will use every settings from `config/_default` and merge `staging`'s on top of those. +{{% note %}} +Default environments are __development__ with `hugo server` and __production__ with `hugo`. +{{%/ note %}} + +## Merge Configuration from Themes + +{{< new-in "0.84.0" >}} The configuration merge described below was improved in Hugo 0.84.0 and made fully configurable. The big change/improvement was that we now, by default, do deep merging of `params` maps from themes. + +The configuration value for `_merge` can be one of: + +none +: No merge. + +shallow +: Only add values for new keys. + +deep +: Add values for new keys, merge existing. + +Note that you don't need to be so verbose as in the default setup below; a `_merge` value higher up will be inherited if not set. + +{{< code-toggle config="mergeStrategy" skipHeader=true />}} + +## All Configuration Settings + +The following is the full list of Hugo-defined variables with their default +value in parentheses. Users may choose to override those values in their site +config file(s). + +archetypeDir ("archetypes") +: The directory where Hugo finds archetype files (content templates). {{% module-mounts-note %}} + +assetDir ("assets") +: The directory where Hugo finds asset files used in [Hugo Pipes](/hugo-pipes/). {{% module-mounts-note %}} + +baseURL +: Hostname (and path) to the root, e.g. https://bep.is/ + +blackfriday +: See [Configure Blackfriday](/getting-started/configuration-markup#blackfriday) + +build +: See [Configure Build](#configure-build) + +buildDrafts (false) +: Include drafts when building. + +buildExpired (false) +: Include content already expired. + +buildFuture (false) +: Include content with publishdate in the future. + +caches +: See [Configure File Caches](#configure-file-caches) + ++cascade {{< new-in "0.86.0" >}} ++: Pass down down default configuration values (front matter) to pages in the content tree. The options in site config is the same as in page front matter, see [Front Matter Cascade](/content-management/front-matter#front-matter-cascade). ++ +canonifyURLs (false) +: Enable to turn relative URLs into absolute. + +contentDir ("content") +: The directory from where Hugo reads content files. {{% module-mounts-note %}} + +dataDir ("data") +: The directory from where Hugo reads data files. {{% module-mounts-note %}} + +defaultContentLanguage ("en") +: Content without language indicator will default to this language. + +defaultContentLanguageInSubdir (false) +: Render the default content language in subdir, e.g. `content/en/`. The site root `/` will then redirect to `/en/`. + +disableAliases (false) +: Will disable generation of alias redirects. Note that even if `disableAliases` is set, the aliases themselves are preserved on the page. The motivation with this is to be able to generate 301 redirects in an `.htaccess`, a Netlify `_redirects` file or similar using a custom output format. + +disableHugoGeneratorInject (false) +: Hugo will, by default, inject a generator meta tag in the HTML head on the _home page only_. You can turn it off, but we would really appreciate if you don't, as this is a good way to watch Hugo's popularity on the rise. + +disableKinds ([]) +: Enable disabling of all pages of the specified *Kinds*. Allowed values in this list: `"page"`, `"home"`, `"section"`, `"taxonomy"`, `"term"`, `"RSS"`, `"sitemap"`, `"robotsTXT"`, `"404"`. + +disableLiveReload (false) +: Disable automatic live reloading of browser window. + +disablePathToLower (false) +: Do not convert the url/path to lowercase. + +enableEmoji (false) +: Enable Emoji emoticons support for page content; see the [Emoji Cheat Sheet](https://www.webpagefx.com/tools/emoji-cheat-sheet/). + +enableGitInfo (false) +: Enable `.GitInfo` object for each page (if the Hugo site is versioned by Git). This will then update the `Lastmod` parameter for each page using the last git commit date for that content file. + +enableInlineShortcodes (false) +: Enable inline shortcode support. See [Inline Shortcodes](/templates/shortcode-templates/#inline-shortcodes). + +enableMissingTranslationPlaceholders (false) +: Show a placeholder instead of the default value or an empty string if a translation is missing. + +enableRobotsTXT (false) +: Enable generation of `robots.txt` file. + +frontmatter + +: See [Front matter Configuration](#configure-front-matter). + +footnoteAnchorPrefix ("") +: Prefix for footnote anchors. + +footnoteReturnLinkContents ("") +: Text to display for footnote return links. + +googleAnalytics ("") +: Google Analytics tracking ID. + +hasCJKLanguage (false) +: If true, auto-detect Chinese/Japanese/Korean Languages in the content. This will make `.Summary` and `.WordCount` behave correctly for CJK languages. + +imaging +: See [Image Processing Config](/content-management/image-processing/#image-processing-config). + +languages +: See [Configure Languages](/content-management/multilingual/#configure-languages). + +languageCode ("") +: The site's language code. It is used in the default [RSS template](/templates/rss/#configure-rss) and can be useful for [multi-lingual sites](/content-management/multilingual/#configure-multilingual-multihost). + +languageName ("") +: The site's language name. + +disableLanguages +: See [Disable a Language](/content-management/multilingual/#disable-a-language) + +layoutDir ("layouts") +: The directory from where Hugo reads layouts (templates). + +log (false) +: Enable logging. + +logFile ("") +: Log File path (if set, logging enabled automatically). + +markup +: See [Configure Markup](/getting-started/configuration-markup).{{< new-in "0.60.0" >}} + +mediaTypes +See [Configure Media Types](/templates/output-formats/#media-types). + +menu +: See [Add Non-content Entries to a Menu](/content-management/menus/#add-non-content-entries-to-a-menu). + +minify +: See [Configure Minify](#configure-minify) + +module +: Module config see [Module Config](/hugo-modules/configuration/).{{< new-in "0.56.0" >}} + +newContentEditor ("") +: The editor to use when creating new content. + +noChmod (false) +: Don't sync permission mode of files. + +noTimes (false) +: Don't sync modification time of files. + +outputFormats +See [Configure Output Formats](#configure-additional-output-formats). + +paginate (10) +: Default number of elements per page in [pagination](/templates/pagination/). + +paginatePath ("page") +: The path element used during pagination (https://example.com/page/2). + +permalinks +: See [Content Management](/content-management/urls/#permalinks). + +pluralizeListTitles (true) +: Pluralize titles in lists. + +publishDir ("public") +: The directory to where Hugo will write the final static site (the HTML files etc.). + +related +: See [Related Content](/content-management/related/#configure-related-content).{{< new-in "0.27" >}} + +relativeURLs (false) +: Enable this to make all relative URLs relative to content root. Note that this does not affect absolute URLs. + +refLinksErrorLevel ("ERROR") +: When using `ref` or `relref` to resolve page links and a link cannot resolved, it will be logged with this logg level. Valid values are `ERROR` (default) or `WARNING`. Any `ERROR` will fail the build (`exit -1`). + +refLinksNotFoundURL +: URL to be used as a placeholder when a page reference cannot be found in `ref` or `relref`. Is used as-is. + +rssLimit (unlimited) +: Maximum number of items in the RSS feed. + +sectionPagesMenu ("") +: See ["Section Menu for Lazy Bloggers"](/templates/menu-templates/#section-menu-for-lazy-bloggers). + +sitemap +: Default [sitemap configuration](/templates/sitemap-template/#configure-sitemapxml). + +staticDir ("static") +: A directory or a list of directories from where Hugo reads [static files][static-files]. {{% module-mounts-note %}} + +summaryLength (70) +: The length of text in words to show in a [`.Summary`](/content-management/summaries/#hugo-defined-automatic-summary-splitting). + +taxonomies +: See [Configure Taxonomies](/content-management/taxonomies#configure-taxonomies). + +theme ("") +: Theme to use (located by default in `/themes/THEMENAME/`). + +themesDir ("themes") +: The directory where Hugo reads the themes from. + +timeout (10000) +: Timeout for generating page contents, in milliseconds (defaults to 10 seconds). *Note:* this is used to bail out of recursive content generation, if your pages are slow to generate (e.g., because they require large image processing or depend on remote contents) you might need to raise this limit. + +timeZone {{< new-in "0.87.0" >}} +: The time zone (or location), e.g. `Europe/Oslo`, used to parse front matter dates without such information and in the [`time` function](/functions/time/). The list of valid values may be system dependent, but should include `UTC`, `Local`, and any location in the [IANA Time Zone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). + +title ("") +: Site title. + +titleCaseStyle ("AP") +: See [Configure Title Case](#configure-title-case) + +uglyURLs (false) +: When enabled, creates URL of the form `/filename.html` instead of `/filename/`. + +verbose (false) +: Enable verbose output. + +verboseLog (false) +: Enable verbose logging. + +watch (false) +: Watch filesystem for changes and recreate as needed. + +{{% note %}} +If you are developing your site on a \*nix machine, here is a handy shortcut for finding a configuration option from the command line: +``` +cd ~/sites/yourhugosite +hugo config | grep emoji +``` + +which shows output like + +``` +enableemoji: true +``` +{{% /note %}} + +## Configure Build + +{{< new-in "0.66.0" >}} + +The `build` configuration section contains global build-related configuration options. + +{{< code-toggle file="config">}} +[build] +useResourceCacheWhen="fallback" +writeStats = false +noJSConfigInAssets = false +{{< /code-toggle >}} + + +useResourceCacheWhen +: When to use the cached resources in `/resources/_gen` for PostCSS and ToCSS. Valid values are `never`, `always` and `fallback`. The last value means that the cache will be tried if PostCSS/extended version is not available. + +writeStats {{< new-in "0.69.0" >}} +: When enabled, a file named `hugo_stats.json` will be written to your project root with some aggregated data about the build, e.g. list of HTML entities published to be used to do [CSS pruning](/hugo-pipes/postprocess/#css-purging-with-postcss). If you're only using this for the production build, you should consider placing it below [config/production](/getting-started/configuration/#configuration-directory). It's also worth mentioning that, due to the nature of the partial server builds, new HTML entities will be added when you add or change them while the server is running, but the old values will not be removed until you restart the server or run a regular `hugo` build. + +**Note** that the prime use case for this is purging of unused CSS; it is build for speed and there may be false positives (e.g. elements that isn't really a HTML element). + +noJSConfigInAssets {{< new-in "0.78.0" >}} +: Turn off writing a `jsconfig.json` into your `/assets` folder with mapping of imports from running [js.Build](https://gohugo.io/hugo-pipes/js). This file is intended to help with intellisense/navigation inside code editors such as [VS Code](https://code.visualstudio.com/). Note that if you do not use `js.Build`, no file will be written. + +## Configure Server + +{{< new-in "0.67.0" >}} + +This is only relevant when running `hugo server`, and it allows to set HTTP headers during development, which allows you to test out your Content Security Policy and similar. The configuration format matches [Netlify's](https://docs.netlify.com/routing/headers/#syntax-for-the-netlify-configuration-file) with slighly more powerful [Glob matching](https://github.com/gobwas/glob): + + +{{< code-toggle file="config">}} +[server] +[[server.headers]] +for = "/**.html" + +[server.headers.values] +X-Frame-Options = "DENY" +X-XSS-Protection = "1; mode=block" +X-Content-Type-Options = "nosniff" +Referrer-Policy = "strict-origin-when-cross-origin" +Content-Security-Policy = "script-src localhost:1313" +{{< /code-toggle >}} + +Since this is is "development only", it may make sense to put it below the `development` environment: + + +{{< code-toggle file="config/development/server">}} +[[headers]] +for = "/**.html" + +[headers.values] +X-Frame-Options = "DENY" +X-XSS-Protection = "1; mode=block" +X-Content-Type-Options = "nosniff" +Referrer-Policy = "strict-origin-when-cross-origin" +Content-Security-Policy = "script-src localhost:1313" +{{< /code-toggle >}} + + +{{< new-in "0.72.0" >}} + +You can also specify simple redirects rules for the server. The syntax is again similar to Netlify's. + +Note that a `status` code of 200 will trigger a [URL rewrite](https://docs.netlify.com/routing/redirects/rewrites-proxies/), which is what you want in SPA situations, e.g: + +{{< code-toggle file="config/development/server">}} +[[redirects]] +from = "/myspa/**" +to = "/myspa/" +status = 200 +force = false +{{< /code-toggle >}} + +{{< new-in "0.76.0" >}} Setting `force=true` will make a redirect even if there is existing content in the path. Note that before Hugo 0.76 `force` was the default behaviour, but this is inline with how Netlify does it. + +## Configure Title Case + +Set `titleCaseStyle` to specify the title style used by the [title](/functions/title/) template function and the automatic section titles in Hugo. It defaults to [AP Stylebook](https://www.apstylebook.com/) for title casing, but you can also set it to `Chicago` or `Go` (every word starts with a capital letter). + +## Configuration Environment Variables + +HUGO_NUMWORKERMULTIPLIER +: Can be set to increase or reduce the number of workers used in parallel processing in Hugo. If not set, the number of logical CPUs will be used. + +## Configuration Lookup Order + +Similar to the template [lookup order][], Hugo has a default set of rules for searching for a configuration file in the root of your website's source directory as a default behavior: + +1. `./config.toml` +2. `./config.yaml` +3. `./config.json` + +In your `config` file, you can direct Hugo as to how you want your website rendered, control your website's menus, and arbitrarily define site-wide parameters specific to your project. + + +## Example Configuration + +The following is a typical example of a configuration file. The values nested under `params:` will populate the [`.Site.Params`][] variable for use in [templates][]: + +{{< code-toggle file="config">}} +baseURL: "https://yoursite.example.com/" +title: "My Hugo Site" +footnoteReturnLinkContents: "↩" +permalinks: + posts: /:year/:month/:title/ +params: + Subtitle: "Hugo is Absurdly Fast!" + AuthorName: "Jon Doe" + GitHubUser: "spf13" + ListOfFoo: + - "foo1" + - "foo2" + SidebarRecentLimit: 5 +{{< /code-toggle >}} + +## Configure with Environment Variables + +In addition to the 3 config options already mentioned, configuration key-values can be defined through operating system environment variables. + +For example, the following command will effectively set a website's title on Unix-like systems: + +``` +$ env HUGO_TITLE="Some Title" hugo +``` + +This is really useful if you use a service such as Netlify to deploy your site. Look at the Hugo docs [Netlify configuration file](https://github.com/gohugoio/hugoDocs/blob/master/netlify.toml) for an example. + +{{% note "Setting Environment Variables" %}} +Names must be prefixed with `HUGO_` and the configuration key must be set in uppercase when setting operating system environment variables. + +To set config params, prefix the name with `HUGO_PARAMS_` +{{% /note %}} + +{{< new-in "0.79.0" >}} If you are using snake_cased variable names, the above will not work, so since Hugo 0.79.0 Hugo determines the delimiter to use by the first character after `HUGO`. This allows you to define environment variables on the form `HUGOxPARAMSxAPI_KEY=abcdefgh`, using any [allowed](https://stackoverflow.com/questions/2821043/allowed-characters-in-linux-environment-variable-names#:~:text=So%20names%20may%20contain%20any,not%20begin%20with%20a%20digit.) delimiter. + +{{< todo >}} +Test and document setting params via JSON env var. +{{< /todo >}} + +## Ignore Content and Data Files when Rendering + +To exclude specific files from the content and data directories when rendering your site, set `ignoreFiles` to one or more regular expressions. + +For example, to ignore content and data files ending with `.foo` and `.boo`: + +{{< code-toggle >}} +ignoreFiles = [ "\\.foo$","\\.boo$"] +{{< /code-toggle >}} + +## Configure Front Matter + +### Configure Dates + +Dates are important in Hugo, and you can configure how Hugo assigns dates to your content pages. You do this by adding a `frontmatter` section to your `config.toml`. + + +The default configuration is: + +{{< code-toggle file="config" >}} +[frontmatter] +date = ["date", "publishDate", "lastmod"] +lastmod = [":git", "lastmod", "date", "publishDate"] +publishDate = ["publishDate", "date"] +expiryDate = ["expiryDate"] +{{< /code-toggle >}} + +If you, as an example, have a non-standard date parameter in some of your content, you can override the setting for `date`: + +{{< code-toggle file="config" >}} +[frontmatter] +date = ["myDate", ":default"] +{{< /code-toggle >}} + +The `:default` is a shortcut to the default settings. The above will set `.Date` to the date value in `myDate` if present, if not we will look in `date`,`publishDate`, `lastmod` and pick the first valid date. + +In the list to the right, values starting with ":" are date handlers with a special meaning (see below). The others are just names of date parameters (case insensitive) in your front matter configuration. Also note that Hugo have some built-in aliases to the above: `lastmod` => `modified`, `publishDate` => `pubdate`, `published` and `expiryDate` => `unpublishdate`. With that, as an example, using `pubDate` as a date in front matter, will, by default, be assigned to `.PublishDate`. + +The special date handlers are: + + +`:fileModTime` +: Fetches the date from the content file's last modification timestamp. + +An example: + +{{< code-toggle file="config" >}} +[frontmatter] +lastmod = ["lastmod", ":fileModTime", ":default"] +{{< /code-toggle >}} + + +The above will try first to extract the value for `.Lastmod` starting with the `lastmod` front matter parameter, then the content file's modification timestamp. The last, `:default` should not be needed here, but Hugo will finally look for a valid date in `:git`, `date` and then `publishDate`. + + +`:filename` +: Fetches the date from the content file's filename. For example, `2018-02-22-mypage.md` will extract the date `2018-02-22`. Also, if `slug` is not set, `mypage` will be used as the value for `.Slug`. + +An example: + +{{< code-toggle file="config" >}} +[frontmatter] +date = [":filename", ":default"] +{{< /code-toggle >}} + +The above will try first to extract the value for `.Date` from the filename, then it will look in front matter parameters `date`, `publishDate` and lastly `lastmod`. + + +`:git` +: This is the Git author date for the last revision of this content file. This will only be set if `--enableGitInfo` is set or `enableGitInfo = true` is set in site config. + +## Configure Additional Output Formats + +Hugo v0.20 introduced the ability to render your content to multiple output formats (e.g., to JSON, AMP html, or CSV). See [Output Formats][] for information on how to add these values to your Hugo project's configuration file. + +## Configure Minify + +{{< new-in "0.68.0" >}} + +Default configuration: + +{{< code-toggle config="minify" />}} + +## Configure File Caches + +Since Hugo 0.52 you can configure more than just the `cacheDir`. This is the default configuration: + +{{< code-toggle >}} +[caches] +[caches.getjson] +dir = ":cacheDir/:project" +maxAge = -1 +[caches.getcsv] +dir = ":cacheDir/:project" +maxAge = -1 +[caches.images] +dir = ":resourceDir/_gen" +maxAge = -1 +[caches.assets] +dir = ":resourceDir/_gen" +maxAge = -1 +[caches.modules] +dir = ":cacheDir/modules" +maxAge = -1 +{{< /code-toggle >}} + +You can override any of these cache settings in your own `config.toml`. + +### The keywords explained + +`:cacheDir` +: This is the value of the `cacheDir` config option if set (can also be set via OS env variable `HUGO_CACHEDIR`). It will fall back to `/opt/build/cache/hugo_cache/` on Netlify, or a `hugo_cache` directory below the OS temp dir for the others. This means that if you run your builds on Netlify, all caches configured with `:cacheDir` will be saved and restored on the next build. For other CI vendors, please read their documentation. For an CircleCI example, see [this configuration](https://github.com/bep/hugo-sass-test/blob/6c3960a8f4b90e8938228688bc49bdcdd6b2d99e/.circleci/config.yml). + +`:project` +: The base directory name of the current Hugo project. This means that, in its default setting, every project will have separated file caches, which means that when you do `hugo --gc` you will not touch files related to other Hugo projects running on the same PC. + +`:resourceDir` +: This is the value of the `resourceDir` config option. + +maxAge +: This is the duration before a cache entry will be evicted, -1 means forever and 0 effectively turns that particular cache off. Uses Go's `time.Duration`, so valid values are `"10s"` (10 seconds), `"10m"` (10 minutes) and `"10h"` (10 hours). + +dir +: The absolute path to where the files for this cache will be stored. Allowed starting placeholders are `:cacheDir` and `:resourceDir` (see above). + +## Configuration Format Specs + +* [TOML Spec][toml] +* [YAML Spec][yaml] +* [JSON Spec][json] + +[`.Site.Params`]: /variables/site/ +[directory structure]: /getting-started/directory-structure +[json]: https://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf "Specification for JSON, JavaScript Object Notation" +[lookup order]: /templates/lookup-order/ +[Output Formats]: /templates/output-formats/ +[templates]: /templates/ +[toml]: https://github.com/toml-lang/toml +[yaml]: https://yaml.org/spec/ +[static-files]: /content-management/static-files/ diff --cc docs/content/en/news/0.86.0-relnotes/featured.png index 000000000,000000000..e9967e864 new file mode 100644 Binary files differ diff --cc docs/content/en/news/0.86.0-relnotes/index.md index a36f86de0,000000000..4b717ed7c mode 100644,000000..100644 --- a/docs/content/en/news/0.86.0-relnotes/index.md +++ b/docs/content/en/news/0.86.0-relnotes/index.md @@@ -1,61 -1,0 +1,56 @@@ + +--- +date: 2021-07-21 - title: "0.86.0" - description: "0.86.0" ++title: "Hugo 0.86.0: Cascade in Config" ++description: "Hugo 0.86.0 adds cascade keyword to site config, much improved \"active menu item\" logic for section pages, and more." +categories: ["Releases"] +--- + - This is release is a set of smaller fixes and improvements. Some of the more noteable: ++This release is a set of smaller fixes and improvements. Some of the more notable: + +You can now have a top level [cascade](https://gohugo.io/content-management/front-matter#front-matter-cascade) (or one per language, if needed) section in your site configuration (e.g. `config.toml`). This way you can control default front matter values from outside of the content files. + - Hugo's [Menu system](https://gohugo.io/content-management/menus/) works good, but hasn't been particulary easy to set the active menu state for section pages without a menu defintion. We have had the option [Section Menu for Lazy Bloggers](https://gohugo.io/templates/menu-templates/#section-menu-for-lazy-bloggers). That helped for the common case, but we have now made it behave more sensible out of the box: `$section.HasMenuCurrent` will now always return true for any descendant of that section. To support this for menu defintions in the site config, we have added a new `pageRef` option on [MenuEntry](https://gohugo.io/variables/menus/#menu-entry-variables): ++Hugo's [Menu system](https://gohugo.io/content-management/menus/) works well, but hasn't been particularly easy to set the active menu state for section pages without a menu definition. We have had the option [Section Menu for Lazy Bloggers](https://gohugo.io/templates/menu-templates/#section-menu-for-lazy-bloggers). That helped for the common case, but we have now made it behave more sensible out of the box: `$page.HasMenuCurrent $sectionMenuEntry` will now always return true for any descendant of that section. To support this for menu definitions in the site config, we have added a new `pageRef` option on [MenuEntry](https://gohugo.io/variables/menus/#menu-entry-variables): + +```toml +[[menus.main]] +pageRef = "blog" +# When pageRef is set, setting `url` is optional; it will be used as a fallback if the page is not found. +url = "/blog" +``` + +Set `pageRef` to a value that [site.GetPage](https://gohugo.io/functions/getpage/) understands, and the menu entry will be correctly connected to the page. + +This release represents **14 contributions by 2 contributors** to the main Hugo code base. +Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs), +which has received **1 contributions by 1 contributors**. + +Hugo now has: + +* 53005+ [stars](https://github.com/gohugoio/hugo/stargazers) +* 431+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors) +* 370+ [themes](http://themes.gohugo.io/) + +## Enhancements + +### Other + +* Simplify "active menu" logic for section menus [d831d2fc](https://github.com/gohugoio/hugo/commit/d831d2fce8198fb814ea4d3d8c311db5c388d04c) [@bep](https://github.com/bep) [#8776](https://github.com/gohugoio/hugo/issues/8776) +* Make keepWhitespace = true default for HTML [c19f65f9](https://github.com/gohugoio/hugo/commit/c19f65f956739ab76c38222d48a3e461525e31af) [@bep](https://github.com/bep) [#8771](https://github.com/gohugoio/hugo/issues/8771) +* Make FileMeta a struct [022c4795](https://github.com/gohugoio/hugo/commit/022c4795510306e08a4aba31504ca382d41c7fac) [@bep](https://github.com/bep) [#8749](https://github.com/gohugoio/hugo/issues/8749) +* Add tabindex="0" to default
 wrapper [f27e5424](https://github.com/gohugoio/hugo/commit/f27e542442d19436f1428cc22bb03aca398d37a7) [@rhymes](https://github.com/rhymes) [#7194](https://github.com/gohugoio/hugo/issues/7194)
 +* Rename/reorder the hook methods [80566481](https://github.com/gohugoio/hugo/commit/805664818d0e1f95a3474271c2db3e5f49db26ba) [@bep](https://github.com/bep) [#8755](https://github.com/gohugoio/hugo/issues/8755)
 +* Support auto links in render hook [ee3d2bb1](https://github.com/gohugoio/hugo/commit/ee3d2bb1d3974584f47cde7c973fbd1ae1f512b6) [@bep](https://github.com/bep) [#8755](https://github.com/gohugoio/hugo/issues/8755)
 +* Adjust a test helper [eb2a5003](https://github.com/gohugoio/hugo/commit/eb2a500367780b07d67c301ce7c866e6b67aa687) [@bep](https://github.com/bep) 
 +* Add config.cascade [5cb52c23](https://github.com/gohugoio/hugo/commit/5cb52c23150032b3fdb211a095745c512369b463) [@bep](https://github.com/bep) [#8741](https://github.com/gohugoio/hugo/issues/8741)
 +* Regenerate image golden testdata [30eea391](https://github.com/gohugoio/hugo/commit/30eea3915b67f72611a3b2f4547146d4c6a96864) [@bep](https://github.com/bep) [#8729](https://github.com/gohugoio/hugo/issues/8729)
 +
 +## Fixes
 +
 +### Other
 +
 +* Fix panic on invalid config in "hugo mod get" and similar [351ed0f5](https://github.com/gohugoio/hugo/commit/351ed0f569f96aff29b03925bf5154d80a164e00) [@bep](https://github.com/bep) [#8773](https://github.com/gohugoio/hugo/issues/8773)
 +* Fix Params case handling for menu items defined in site config [634481ba](https://github.com/gohugoio/hugo/commit/634481ba8cfcd865ba0d8811d8834f6af45663d7) [@bep](https://github.com/bep) [#8775](https://github.com/gohugoio/hugo/issues/8775)
 +* Fix default values when loading from config dir [ae6cf93c](https://github.com/gohugoio/hugo/commit/ae6cf93c84c3584b111f4b9fa3fb4e3f63d37915) [@bep](https://github.com/bep) [#8763](https://github.com/gohugoio/hugo/issues/8763)
 +* Fix the deprecation error/warn log levels [a70da2b7](https://github.com/gohugoio/hugo/commit/a70da2b74a6af0834cce9668cdb6acdb1c86a4c0) [@bep](https://github.com/bep) 
 +* Fix transparency problem when converting 32-bit images to WebP [8f40f34c](https://github.com/gohugoio/hugo/commit/8f40f34cd10a98598bb822ec633fd5d0ea64b612) [@bep](https://github.com/bep) [#8729](https://github.com/gohugoio/hugo/issues/8729)
- 
- 
- 
- 
- 
diff --cc docs/content/en/news/0.86.1-relnotes/index.md
index 4c1926388,000000000..5b0d5a6b5
mode 100644,000000..100644
--- a/docs/content/en/news/0.86.1-relnotes/index.md
+++ b/docs/content/en/news/0.86.1-relnotes/index.md
@@@ -1,19 -1,0 +1,19 @@@
 +
 +---
 +date: 2021-07-30
- title: "Hugo 0.86.1: A couple of Bug Fixes"
- description: "This version fixes a couple of bugs introduced in 0.86.0."
++title: "Hugo 0.86.1: One Bug Fix"
++description: "This version fixes a of bug introduced in 0.86.0."
 +categories: ["Releases"]
 +images:
 +- images/blog/hugo-bug-poster.png
 +
 +---
 +
 +	
 +
 +This is a bug-fix release with one important fix.
 +
 +* config: Fix a potential deadlock in config reading [94b616bd](https://github.com/gohugoio/hugo/commit/94b616bdfad177daa99f5e87535943f509198f6f) [@bep](https://github.com/bep) [#8791](https://github.com/gohugoio/hugo/issues/8791)
 +
 +
 +
diff --cc docs/netlify.toml
index 0d6198c70,000000000..3a37a3bdf
mode 100644,000000..100644
--- a/docs/netlify.toml
+++ b/docs/netlify.toml
@@@ -1,31 -1,0 +1,31 @@@
 +[build]
 +publish = "public"
 +command = "hugo --gc --minify"
 +
 +[context.production.environment]
- HUGO_VERSION = "0.85.0"
++HUGO_VERSION = "0.86.1"
 +HUGO_ENV = "production"
 +HUGO_ENABLEGITINFO = "true"
 +
 +[context.split1]
 +command = "hugo --gc --minify --enableGitInfo"
 +
 +[context.split1.environment]
- HUGO_VERSION = "0.85.0"
++HUGO_VERSION = "0.86.1"
 +HUGO_ENV = "production"
 +
 +[context.deploy-preview]
 +command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL"
 +
 +[context.deploy-preview.environment]
- HUGO_VERSION = "0.85.0"
++HUGO_VERSION = "0.86.1"
 +
 +[context.branch-deploy]
 +command = "hugo --gc --minify -b $DEPLOY_PRIME_URL"
 +
 +[context.branch-deploy.environment]
- HUGO_VERSION = "0.85.0"
++HUGO_VERSION = "0.86.1"
 +
 +[context.next.environment]
 +HUGO_ENABLEGITINFO = "true"
 +
diff --cc docs/resources/_gen/images/content-management/organization/1-featured-content-bundles_hu911524202ff4753624ea0b303cf97415_34394_300x0_resize_catmullrom_3.png
index 000000000,000000000..239ea0e51
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_480x0_resize_catmullrom_3.png
index 000000000,000000000..ee2d0024c
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_480x0_resize_catmullrom_3.png
index 000000000,000000000..e7ace9b9b
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_480x0_resize_catmullrom_3.png
index 000000000,000000000..9820d9c41
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_480x0_resize_catmullrom_3.png
index 000000000,000000000..22c8ba28f
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.37-relnotes/featured-hugo-37-poster_hue9685d25c387d657b0640498bf6a10ee_186693_480x0_resize_catmullrom_3.png
index 000000000,000000000..a1b57b6b7
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.38-relnotes/featured-poster_hudf8012d38ef42d46a6cab1b31156bf3a_69978_480x0_resize_catmullrom_3.png
index 000000000,000000000..3783ab2b4
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.39-relnotes/featured-hugo-39-poster_hu3261e6e65defb4edf9f0fce20bf5f60d_217215_480x0_resize_catmullrom_3.png
index 000000000,000000000..5cbbd0216
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.40-relnotes/featured-hugo-40-poster_hu20c69e2a166f65e329d8fbabe8d2cc58_69238_480x0_resize_catmullrom_3.png
index 000000000,000000000..a40afd2ed
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.41-relnotes/featured-hugo-41-poster_hud81cd208cb270af61610509ee199ae20_67955_480x0_resize_catmullrom_3.png
index 000000000,000000000..8f45f20a8
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.42-relnotes/featured-hugo-42-poster_hue0604c0846526b6d2f8ba376edd013b6_74852_480x0_resize_catmullrom_3.png
index 000000000,000000000..2b6d9dfd4
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.43-relnotes/featured-hugo-43-poster_hu3948fe44e4a966d8149b4bf077395057_78299_480x0_resize_catmullrom_3.png
index 000000000,000000000..6fe5416eb
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.44-relnotes/featured-hugo-44-poster_hu6505d1982bab71bfe9c6c7adcedfd7f7_77631_480x0_resize_catmullrom_3.png
index 000000000,000000000..7d528fe92
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.45-relnotes/featured-hugo-45-poster_huea79995576e3b93a3041ae824a391758_66863_480x0_resize_catmullrom_3.png
index 000000000,000000000..83dd2cba8
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.46-relnotes/featured-hugo-46-poster_hue04c7655caa254a1835311c9409185d8_68614_480x0_resize_catmullrom_3.png
index 000000000,000000000..f2324824b
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.47-relnotes/featured-hugo-47-poster_hud3879b84908b49d38ac2cd1416f654ff_88288_480x0_resize_catmullrom_3.png
index 000000000,000000000..18db19eb1
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.48-relnotes/featured-hugo-48-poster_hub95348423e80ff144dfee01d64fb9889_95358_480x0_resize_catmullrom_3.png
index 000000000,000000000..a62946943
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.49-relnotes/featured-hugo-49-poster_hud9cdb0f9aa2ec95d28fc3f49c81e7940_66352_480x0_resize_catmullrom_3.png
index 000000000,000000000..227a0dc1d
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.50-relnotes/featured-hugo-50-poster_hudcbbb9a5a0079d08447101e6cfae6e40_227240_480x0_resize_catmullrom_3.png
index 000000000,000000000..e6b3efaf2
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.51-relnotes/featured-hugo-51-poster_hu25ab021d1365edeedf46d92fdb888ccf_117678_480x0_resize_catmullrom_3.png
index 000000000,000000000..69d490e29
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.52-relnotes/featured-hugo-52-poster_hu7f2ed09038efabda07872a275a935ada_336810_480x0_resize_catmullrom_3.png
index 000000000,000000000..f9f107efe
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.53-relnotes/featured-hugo-53-poster_hu3f68fc193ad172155ee35a0be89133bf_110427_480x0_resize_catmullrom_3.png
index 000000000,000000000..a0341e81a
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.54.0-relnotes/featured-hugo-54.0-poster_hufa0b7b755124a76fe71c5c70a25724c2_59805_480x0_resize_catmullrom_3.png
index 000000000,000000000..31f1ba53f
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.55.0-relnotes/featured_hu9474666a09966109e944f93e1ecf78c0_1221797_480x0_resize_catmullrom_3.png
index 000000000,000000000..74c125bfb
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.56.0-relnotes/featured_hu76d57fb58ef6e72ac104a624bd5458e5_254587_480x0_resize_catmullrom_3.png
index 000000000,000000000..a47d07a18
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.57.0-relnotes/hugo-57-poster-featured_hua5036d4cd45a91afa541ffaa7522c907_45223_480x0_resize_catmullrom_3.png
index 000000000,000000000..46c365c5a
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.58.0-relnotes/hugo58-featured_hu773ef1300245c62235b6a2b3c71a3170_23413_480x0_resize_catmullrom_3.png
index 000000000,000000000..66d08990b
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.59.0-relnotes/hugo-59-poster-featured_hu0512b47f4576de23e973436cd11d5f9b_78054_480x0_resize_catmullrom_3.png
index 000000000,000000000..8652b7382
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.60.0-relnotes/poster-featured_hu88aba11293facef11feec48164ba6c3f_31907_480x0_resize_catmullrom_3.png
index 000000000,000000000..bca6dc8a8
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.60.1-relnotes/featured-061_hu55b86d71cf1e6f4fec276be0fe0d3e6e_28841_480x0_resize_catmullrom_3.png
index 000000000,000000000..61d552d8c
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.61.0-relnotes/hugo-61-featured_huc7cf44fd2ae7c41ccbb87bf5c4aa169c_79929_480x0_resize_catmullrom_3.png
index 000000000,000000000..d864309b4
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.62.0-relnotes/hugo-62-poster-featured_huf77b5f9bdd21b9dd639f52807d87fae9_105390_480x0_resize_catmullrom_3.png
index 000000000,000000000..d9c31fc3d
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.63.0-relnotes/featured-063_hu5954e4b26e8962f5849de8f2cf549c9d_212246_480x0_resize_catmullrom_3.png
index 000000000,000000000..54bd6b75d
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.64.0-relnotes/hugo-64-poster-featured_hub9938cc6c413edc5157bada64ca77fbc_69464_480x0_resize_catmullrom_3.png
index 000000000,000000000..111591c90
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.65.0-relnotes/hugo-65-poster-featured_hu2a74c431783b3f7931799f8c38dbf3fd_115945_480x0_resize_catmullrom_3.png
index 000000000,000000000..614e0316d
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.66.0-relnotes/hugo-66-poster-featured_hu4d3a62a6d2ad42dd03e2a3723d4914a5_75588_480x0_resize_catmullrom_3.png
index 000000000,000000000..abe222e8d
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.66.0-relnotes/hugo-66-poster-featured_hu4d3a62a6d2ad42dd03e2a3723d4914a5_75588_640x0_resize_catmullrom_3.png
index 000000000,000000000..2dcb46d0b
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.67.0-relnotes/hugo-67-poster-featured_hub9adb3c2f94f651d39a760315e4e42f9_79436_480x0_resize_catmullrom_3.png
index 000000000,000000000..f4ae0d2a7
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.67.0-relnotes/hugo-67-poster-featured_hub9adb3c2f94f651d39a760315e4e42f9_79436_640x0_resize_catmullrom_3.png
index 000000000,000000000..b07acd596
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.68.0-relnotes/hugo-68-featured_hubf411be7de0d7016f242fc7f0c46d71c_65337_480x0_resize_catmullrom_3.png
index 000000000,000000000..e7b24c5d1
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.68.0-relnotes/hugo-68-featured_hubf411be7de0d7016f242fc7f0c46d71c_65337_640x0_resize_catmullrom_3.png
index 000000000,000000000..841ea678d
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.69.0-relnotes/hugo-69-easter-featured_hu1e6bcfa5c2c3547379b657838d335c52_398560_480x0_resize_catmullrom_3.png
index 000000000,000000000..584ddd455
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.69.0-relnotes/hugo-69-easter-featured_hu1e6bcfa5c2c3547379b657838d335c52_398560_640x0_resize_catmullrom_3.png
index 000000000,000000000..cd1853027
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.70.0-relnotes/hugo-70-featured_hu7e53232ad438751d3345bfcf581a92c2_65533_480x0_resize_catmullrom_3.png
index 000000000,000000000..5dd268c9f
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.70.0-relnotes/hugo-70-featured_hu7e53232ad438751d3345bfcf581a92c2_65533_640x0_resize_catmullrom_3.png
index 000000000,000000000..d74203e0e
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.71.0-relnotes/hugo-71-featured_hu8a56287afe6ebd759706bbede29716ba_209832_480x0_resize_catmullrom_3.png
index 000000000,000000000..6a407f470
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.71.0-relnotes/hugo-71-featured_hu8a56287afe6ebd759706bbede29716ba_209832_640x0_resize_catmullrom_3.png
index 000000000,000000000..45836153e
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.72.0-relnotes/hugo-72-featured_hu2851378649aa18f104ac3bb6a49cdd29_256988_480x0_resize_catmullrom_3.png
index 000000000,000000000..2c9364c35
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.72.0-relnotes/hugo-72-featured_hu2851378649aa18f104ac3bb6a49cdd29_256988_640x0_resize_catmullrom_3.png
index 000000000,000000000..95df22ec1
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.73.0-relnotes/hugo-73-featured_hu7b5b76bcc722e972da8ed35f022034d1_186170_480x0_resize_catmullrom_3.png
index 000000000,000000000..98815095d
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.73.0-relnotes/hugo-73-featured_hu7b5b76bcc722e972da8ed35f022034d1_186170_640x0_resize_catmullrom_3.png
index 000000000,000000000..efe210724
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.74.0-relnotes/featured_hu7ff75a56a54dd46c9d2c16ab503af3cf_56047_480x0_resize_catmullrom_3.png
index 000000000,000000000..5b616efae
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.74.0-relnotes/featured_hu7ff75a56a54dd46c9d2c16ab503af3cf_56047_640x0_resize_catmullrom_3.png
index 000000000,000000000..0909f2887
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.75.0-relnotes/featured_hubc6f618a9a95ca518cbd88f6725b3660_125400_480x0_resize_catmullrom_3.png
index 000000000,000000000..e5383f2e8
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.75.0-relnotes/featured_hubc6f618a9a95ca518cbd88f6725b3660_125400_640x0_resize_catmullrom_3.png
index 000000000,000000000..5ec28c669
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.76.0-relnotes/featured_hu7b6a8a3a3ee53d378fbcd68c5150e8db_146539_480x0_resize_catmullrom_3.png
index 000000000,000000000..f6e739cd9
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.76.0-relnotes/featured_hu7b6a8a3a3ee53d378fbcd68c5150e8db_146539_640x0_resize_catmullrom_3.png
index 000000000,000000000..cf144262f
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.77.0-relnotes/featured_hu95e3f73231f4ff78ed176e490b00b665_130926_480x0_resize_catmullrom_3.png
index 000000000,000000000..b93991c4b
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.77.0-relnotes/featured_hu95e3f73231f4ff78ed176e490b00b665_130926_640x0_resize_catmullrom_3.png
index 000000000,000000000..cee090a31
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.78.0-relnotes/featured_hu16cc5f543b4302736ecbd476dcae86cf_47074_480x0_resize_catmullrom_3.png
index 000000000,000000000..86f7f01de
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.78.0-relnotes/featured_hu16cc5f543b4302736ecbd476dcae86cf_47074_640x0_resize_catmullrom_3.png
index 000000000,000000000..b666dbafc
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.79.0-relnotes/featured_hud3f5563b9eabb2fd9dcbcee84e72fe2d_75235_480x0_resize_catmullrom_3.png
index 000000000,000000000..9ecbdaf90
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.79.0-relnotes/featured_hud3f5563b9eabb2fd9dcbcee84e72fe2d_75235_640x0_resize_catmullrom_3.png
index 000000000,000000000..731d42444
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.80.0-relnotes/featured_hu79434c84cc6c2c78f7828eb64a40630a_162027_480x0_resize_catmullrom_3.png
index 000000000,000000000..9f1f270e4
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.80.0-relnotes/featured_hu79434c84cc6c2c78f7828eb64a40630a_162027_640x0_resize_catmullrom_3.png
index 000000000,000000000..23fd2fdeb
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.82.0-relnotes/featured_hu5d8344c080499179dc5edbf7deb421a4_57106_480x0_resize_catmullrom_3.png
index 000000000,000000000..b810beee9
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.82.0-relnotes/featured_hu5d8344c080499179dc5edbf7deb421a4_57106_640x0_resize_catmullrom_3.png
index 000000000,000000000..a0b5e6f18
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.83.0-relnotes/featured_hu95eea831049f54a9a3609e4be0c231b7_82972_480x0_resize_catmullrom_3.png
index 000000000,000000000..6b79864f0
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.83.0-relnotes/featured_hu95eea831049f54a9a3609e4be0c231b7_82972_640x0_resize_catmullrom_3.png
index 000000000,000000000..d37fdd61c
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.84.0-relnotes/featured_hu7c38afe80520529cfcae538ac032ebff_47732_480x0_resize_catmullrom_3.png
index 000000000,000000000..ca153c9c1
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.84.0-relnotes/featured_hu7c38afe80520529cfcae538ac032ebff_47732_640x0_resize_catmullrom_3.png
index 000000000,000000000..5e2dc099e
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.85.0-relnotes/featured_hu8384a805e04f079f5699a02b45800244_67393_480x0_resize_catmullrom_3.png
index 000000000,000000000..de36984ea
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.85.0-relnotes/featured_hu8384a805e04f079f5699a02b45800244_67393_640x0_resize_catmullrom_3.png
index 000000000,000000000..d8d5ba96b
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.86.0-relnotes/featured_hu90f1fa7584e0b08ff867964df5c6b0c6_188476_480x0_resize_catmullrom_3.png
index 000000000,000000000..d79be4458
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/0.86.0-relnotes/featured_hu90f1fa7584e0b08ff867964df5c6b0c6_188476_640x0_resize_catmullrom_3.png
index 000000000,000000000..09cc723df
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/hugo-macos-intel-vs-arm/featured_hu3f81ebb7eadaa5c67f592034ca4c1896_299333_480x0_resize_catmullrom_3.png
index 000000000,000000000..aa63490a0
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/hugo-macos-intel-vs-arm/featured_hu3f81ebb7eadaa5c67f592034ca4c1896_299333_640x0_resize_catmullrom_3.png
index 000000000,000000000..298f5e941
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/lets-celebrate-hugos-5th-birthday/featured_hu30cb938a182ebd06b50ed15d006d8f64_179291_480x0_resize_catmullrom_3.png
index 000000000,000000000..e52af8360
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/lets-celebrate-hugos-5th-birthday/graph-stars_hu169ba15a8bcaf4ddd6a5a1aa8505c448_15599_600x400_fit_catmullrom_3.png
index 000000000,000000000..ac86d8bb7
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/lets-celebrate-hugos-5th-birthday/graph-themes_hu25707bee0ec3007199f71bb29226f30c_16956_600x400_fit_catmullrom_3.png
index 000000000,000000000..eae185e6c
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/news/lets-celebrate-hugos-5th-birthday/sunset-get_hud0ada96a3532fb27dcd0de96bcce0679_358844_600x300_fill_catmullrom_smart1_3.png
index 000000000,000000000..c44d139c0
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..5693ac80c
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_49bfe650c1de878294695391adf48aaa.png
index 000000000,000000000..bb0b5ccc3
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/aether/featured_hu087b0e6f87446792599d3d3535cdd374_275219_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..95a0748c0
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/aether/featured_hu087b0e6f87446792599d3d3535cdd374_275219_f479f94112f3e0c5767e1193b5965779.png
index 000000000,000000000..38644d38c
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/arolla-cocoon/featured-template_hu22aab819ab27e4f878d1ff0b7cf78050_451984_0f50711b225daa7061d1303818804a06.png
index 000000000,000000000..a74dd901b
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/arolla-cocoon/featured-template_hu22aab819ab27e4f878d1ff0b7cf78050_451984_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..4edb7b28b
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/bypasscensorship/featured_hu3be69425780460f51f7c2367ed0f80c1_180903_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..1fab39236
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/bypasscensorship/featured_hu3be69425780460f51f7c2367ed0f80c1_180903_181e8c53a0707a1d676379e9c104188f.png
index 000000000,000000000..4c8e9acef
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/digitalgov/featured_hu45beff20946cd0e416030040cf926cad_65077_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..fc0b2d166
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/digitalgov/featured_hu45beff20946cd0e416030040cf926cad_65077_640x0_resize_catmullrom_3.png
index 000000000,000000000..5eff10f6c
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/digitalgov/featured_hu45beff20946cd0e416030040cf926cad_65077_d61896c74e9bc7f2b53c3d97d582a9f1.png
index 000000000,000000000..b3f048d64
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/fireship/featured_hu3bba74627b7e233d29d5aecb29c8d0f1_136959_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..15e3fcf2f
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/fireship/featured_hu3bba74627b7e233d29d5aecb29c8d0f1_136959_5edc412a1db4f6d277914c0912c74b5c.png
index 000000000,000000000..1929561d7
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/flesland-flis/featured_hue4fd3c0e7519777bd75019750a0f5391_309284_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..8fb6f6030
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/flesland-flis/featured_hue4fd3c0e7519777bd75019750a0f5391_309284_d7cc9cf1d376e0ae23c3a0cab2ded5af.png
index 000000000,000000000..1b618711d
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/forestry/featured_hu77de7d99834fa13b854b7fc62e2912a7_227009_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..4b7c89b11
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/forestry/featured_hu77de7d99834fa13b854b7fc62e2912a7_227009_725a67b586e61748c986b50dbbe425fa.png
index 000000000,000000000..018acbaa7
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/godot-tutorials/featured_hu9debe7d7e6d1a72f19d3b8209a030483_72068_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..bdeaa76b7
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/godot-tutorials/featured_hu9debe7d7e6d1a72f19d3b8209a030483_72068_640x0_resize_catmullrom_3.png
index 000000000,000000000..160cb8e85
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/godot-tutorials/featured_hu9debe7d7e6d1a72f19d3b8209a030483_72068_a08769b8e5d846d6a76f26167353d8a9.png
index 000000000,000000000..d21be2bc5
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/hapticmedia/featured_hu4e9c0830eabb70b93572090b79da0c5d_543922_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..087b4b539
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/hapticmedia/featured_hu4e9c0830eabb70b93572090b79da0c5d_543922_105d4a0f343fbe6352d65c1a7b8f4cac.png
index 000000000,000000000..2190aca22
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..7afc14f1d
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_79cae407703473a6e7dc08af7c3f2ee4.png
index 000000000,000000000..8d93d3ed8
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/keycdn/featured_hub7f38531767be8be63ac710821ebd35e_358740_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..d11036cda
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/keycdn/featured_hub7f38531767be8be63ac710821ebd35e_358740_640x0_resize_catmullrom_3.png
index 000000000,000000000..5fd2a2caf
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/keycdn/featured_hub7f38531767be8be63ac710821ebd35e_358740_9a6d0dc5ff30f831ce7de4092bc0b20e.png
index 000000000,000000000..4615b638d
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/letsencrypt/featured_hu51cfa254cfc1fb105704d2cdd6ae4737_147459_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..28e39854b
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/letsencrypt/featured_hu51cfa254cfc1fb105704d2cdd6ae4737_147459_6a1c30f6ab6e40432bf1424c5e6ff172.png
index 000000000,000000000..f1b5fd678
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/linode/featured_hu61409040ff547ff1513ae0ebae4096c4_90149_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..378479e1b
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/linode/featured_hu61409040ff547ff1513ae0ebae4096c4_90149_36793d2894e4a9a81068e0bcb73a5c46.png
index 000000000,000000000..f0c36f8f8
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/over/featured-over_hu096cafb8a4c371f6c5d5431b68c2978f_194841_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..d84eeb7e9
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/over/featured-over_hu096cafb8a4c371f6c5d5431b68c2978f_194841_ddce0e2306e5863d70ed75a649c2a414.png
index 000000000,000000000..a0ca1bcb1
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..21865e620
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_c9675e38e9a66207ad90299132f2d113.png
index 000000000,000000000..6bb2cc409
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/pharmaseal/featured-pharmaseal_hu0bb31f1d675c2396ecc2e224b6f519a6_769739_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..a2eda1f71
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/pharmaseal/featured-pharmaseal_hu0bb31f1d675c2396ecc2e224b6f519a6_769739_b747523e5c41b99f0dd8843613b74e80.png
index 000000000,000000000..15402e6ff
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..d8d5b56c4
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_169594d2d0a4328d06e82f5d0853bf56.png
index 000000000,000000000..0f191b16f
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..bd21518ac
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_e2fa404529f08876ceb33dd18b993dc7.png
index 000000000,000000000..0cdf218c9
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..33504ce5d
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_abc14a9a939353b46cb8c04bc479591a.png
index 000000000,000000000..2a682d775
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/tomango/featured_hu7e8dbbadbe427cdae3bd5ec313fc9f75_143336_1024x512_fill_catmullrom_top_3.png
index 000000000,000000000..20bc7d9a1
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/tomango/featured_hu7e8dbbadbe427cdae3bd5ec313fc9f75_143336_b055dd23dd6f3a2a98a587590945aa65.png
index 000000000,000000000..acd405d1b
new file mode 100644
Binary files differ