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=0934983529824d819ceaf98df33b30abee7659bc;p=brevno-suite%2Fhugo Merge commit 'bd77f6e1c99e04a476f0b1bb4e44569134e02399' into release-0.87.0 --- 0934983529824d819ceaf98df33b30abee7659bc diff --cc docs/config.toml index 8c648068,00000000..7888579f 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 4c5807f7,00000000..5037beb0 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 8c0dbfa3,00000000..b7fc9e63 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 00000000,00000000..e9967e86 new file mode 100644 Binary files differ diff --cc docs/content/en/news/0.86.0-relnotes/index.md index a36f86de,00000000..4b717ed7 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 4c192638,00000000..5b0d5a6b
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 0d6198c7,00000000..3a37a3bd
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 00000000,00000000..239ea0e5
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 00000000,00000000..ee2d0024
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 00000000,00000000..e7ace9b9
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 00000000,00000000..9820d9c4
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 00000000,00000000..22c8ba28
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 00000000,00000000..a1b57b6b
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 00000000,00000000..3783ab2b
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 00000000,00000000..5cbbd021
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 00000000,00000000..a40afd2e
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 00000000,00000000..8f45f20a
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 00000000,00000000..2b6d9dfd
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 00000000,00000000..6fe5416e
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 00000000,00000000..7d528fe9
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 00000000,00000000..83dd2cba
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 00000000,00000000..f2324824
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 00000000,00000000..18db19eb
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 00000000,00000000..a6294694
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 00000000,00000000..227a0dc1
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 00000000,00000000..e6b3efaf
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 00000000,00000000..69d490e2
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 00000000,00000000..f9f107ef
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 00000000,00000000..a0341e81
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 00000000,00000000..31f1ba53
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 00000000,00000000..74c125bf
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 00000000,00000000..a47d07a1
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 00000000,00000000..46c365c5
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 00000000,00000000..66d08990
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 00000000,00000000..8652b738
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 00000000,00000000..bca6dc8a
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 00000000,00000000..61d552d8
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 00000000,00000000..d864309b
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 00000000,00000000..d9c31fc3
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 00000000,00000000..54bd6b75
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 00000000,00000000..111591c9
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 00000000,00000000..614e0316
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 00000000,00000000..abe222e8
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 00000000,00000000..2dcb46d0
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 00000000,00000000..f4ae0d2a
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 00000000,00000000..b07acd59
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 00000000,00000000..e7b24c5d
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 00000000,00000000..841ea678
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 00000000,00000000..584ddd45
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 00000000,00000000..cd185302
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 00000000,00000000..5dd268c9
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 00000000,00000000..d74203e0
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 00000000,00000000..6a407f47
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 00000000,00000000..45836153
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 00000000,00000000..2c9364c3
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 00000000,00000000..95df22ec
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 00000000,00000000..98815095
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 00000000,00000000..efe21072
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 00000000,00000000..5b616efa
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 00000000,00000000..0909f288
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 00000000,00000000..e5383f2e
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 00000000,00000000..5ec28c66
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 00000000,00000000..f6e739cd
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 00000000,00000000..cf144262
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 00000000,00000000..b93991c4
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 00000000,00000000..cee090a3
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 00000000,00000000..86f7f01d
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 00000000,00000000..b666dbaf
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 00000000,00000000..9ecbdaf9
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 00000000,00000000..731d4244
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 00000000,00000000..9f1f270e
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 00000000,00000000..23fd2fde
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 00000000,00000000..b810beee
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 00000000,00000000..a0b5e6f1
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 00000000,00000000..6b79864f
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 00000000,00000000..d37fdd61
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 00000000,00000000..ca153c9c
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 00000000,00000000..5e2dc099
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 00000000,00000000..de36984e
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 00000000,00000000..d8d5ba96
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 00000000,00000000..d79be445
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 00000000,00000000..09cc723d
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 00000000,00000000..aa63490a
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 00000000,00000000..298f5e94
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 00000000,00000000..e52af836
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 00000000,00000000..ac86d8bb
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 00000000,00000000..eae185e6
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 00000000,00000000..c44d139c
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 00000000,00000000..5693ac80
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_49bfe650c1de878294695391adf48aaa.png
index 00000000,00000000..bb0b5ccc
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 00000000,00000000..95a0748c
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/aether/featured_hu087b0e6f87446792599d3d3535cdd374_275219_f479f94112f3e0c5767e1193b5965779.png
index 00000000,00000000..38644d38
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/arolla-cocoon/featured-template_hu22aab819ab27e4f878d1ff0b7cf78050_451984_0f50711b225daa7061d1303818804a06.png
index 00000000,00000000..a74dd901
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 00000000,00000000..4edb7b28
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 00000000,00000000..1fab3923
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/bypasscensorship/featured_hu3be69425780460f51f7c2367ed0f80c1_180903_181e8c53a0707a1d676379e9c104188f.png
index 00000000,00000000..4c8e9ace
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 00000000,00000000..fc0b2d16
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/digitalgov/featured_hu45beff20946cd0e416030040cf926cad_65077_640x0_resize_catmullrom_3.png
index 00000000,00000000..5eff10f6
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/digitalgov/featured_hu45beff20946cd0e416030040cf926cad_65077_d61896c74e9bc7f2b53c3d97d582a9f1.png
index 00000000,00000000..b3f048d6
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 00000000,00000000..15e3fcf2
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/fireship/featured_hu3bba74627b7e233d29d5aecb29c8d0f1_136959_5edc412a1db4f6d277914c0912c74b5c.png
index 00000000,00000000..1929561d
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 00000000,00000000..8fb6f603
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/flesland-flis/featured_hue4fd3c0e7519777bd75019750a0f5391_309284_d7cc9cf1d376e0ae23c3a0cab2ded5af.png
index 00000000,00000000..1b618711
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 00000000,00000000..4b7c89b1
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/forestry/featured_hu77de7d99834fa13b854b7fc62e2912a7_227009_725a67b586e61748c986b50dbbe425fa.png
index 00000000,00000000..018acbaa
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 00000000,00000000..bdeaa76b
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 00000000,00000000..160cb8e8
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/godot-tutorials/featured_hu9debe7d7e6d1a72f19d3b8209a030483_72068_a08769b8e5d846d6a76f26167353d8a9.png
index 00000000,00000000..d21be2bc
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 00000000,00000000..087b4b53
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/hapticmedia/featured_hu4e9c0830eabb70b93572090b79da0c5d_543922_105d4a0f343fbe6352d65c1a7b8f4cac.png
index 00000000,00000000..2190aca2
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 00000000,00000000..7afc14f1
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_79cae407703473a6e7dc08af7c3f2ee4.png
index 00000000,00000000..8d93d3ed
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 00000000,00000000..d11036cd
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/keycdn/featured_hub7f38531767be8be63ac710821ebd35e_358740_640x0_resize_catmullrom_3.png
index 00000000,00000000..5fd2a2ca
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/keycdn/featured_hub7f38531767be8be63ac710821ebd35e_358740_9a6d0dc5ff30f831ce7de4092bc0b20e.png
index 00000000,00000000..4615b638
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 00000000,00000000..28e39854
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/letsencrypt/featured_hu51cfa254cfc1fb105704d2cdd6ae4737_147459_6a1c30f6ab6e40432bf1424c5e6ff172.png
index 00000000,00000000..f1b5fd67
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 00000000,00000000..378479e1
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/linode/featured_hu61409040ff547ff1513ae0ebae4096c4_90149_36793d2894e4a9a81068e0bcb73a5c46.png
index 00000000,00000000..f0c36f8f
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 00000000,00000000..d84eeb7e
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/over/featured-over_hu096cafb8a4c371f6c5d5431b68c2978f_194841_ddce0e2306e5863d70ed75a649c2a414.png
index 00000000,00000000..a0ca1bcb
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 00000000,00000000..21865e62
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_c9675e38e9a66207ad90299132f2d113.png
index 00000000,00000000..6bb2cc40
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 00000000,00000000..a2eda1f7
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/pharmaseal/featured-pharmaseal_hu0bb31f1d675c2396ecc2e224b6f519a6_769739_b747523e5c41b99f0dd8843613b74e80.png
index 00000000,00000000..15402e6f
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 00000000,00000000..d8d5b56c
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_169594d2d0a4328d06e82f5d0853bf56.png
index 00000000,00000000..0f191b16
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 00000000,00000000..bd21518a
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_e2fa404529f08876ceb33dd18b993dc7.png
index 00000000,00000000..0cdf218c
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 00000000,00000000..33504ce5
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_abc14a9a939353b46cb8c04bc479591a.png
index 00000000,00000000..2a682d77
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 00000000,00000000..20bc7d9a
new file mode 100644
Binary files differ
diff --cc docs/resources/_gen/images/showcase/tomango/featured_hu7e8dbbadbe427cdae3bd5ec313fc9f75_143336_b055dd23dd6f3a2a98a587590945aa65.png
index 00000000,00000000..acd405d1
new file mode 100644
Binary files differ