diff --git a/_vendor/github.com/chef/chef-docs-theme/assets/js/inspec-filter.js b/_vendor/github.com/chef/chef-docs-theme/assets/js/inspec-filter.js
index 24c5dfa2ae..357520c3d6 100644
--- a/_vendor/github.com/chef/chef-docs-theme/assets/js/inspec-filter.js
+++ b/_vendor/github.com/chef/chef-docs-theme/assets/js/inspec-filter.js
@@ -19,4 +19,4 @@ function filterInspecResources() {
// This works with inspec_resources_filter shortcode to filter out inspec resources by name
// on https://docs.chef.io/inspec/resources/
-// The shortcode should be in inspec/inspec/docs-chef-io/layouts/shortcodes/inspec_resources_filter.html
+// The shortcode should be in /layouts/shortcodes/inspec_resources_filter.html
diff --git a/_vendor/github.com/chef/chef-docs-theme/assets/sass/_base.scss b/_vendor/github.com/chef/chef-docs-theme/assets/sass/_base.scss
index 04a88279cd..d2f82a13a9 100644
--- a/_vendor/github.com/chef/chef-docs-theme/assets/sass/_base.scss
+++ b/_vendor/github.com/chef/chef-docs-theme/assets/sass/_base.scss
@@ -6,25 +6,3 @@ body {
font-size: 62.5%;
background-color: $white;
}
-
-h1,
-h2,
-h3,
-h4,
-h5,
-h6 {
- padding-top: 0.5em;
-}
-
-h1:focus,
-h2:focus,
-h3:focus,
-h4:focus,
-h5:focus,
-h6:focus {
- outline: 0;
-}
-
-p {
- margin-top: 0.25rem;
-}
diff --git a/_vendor/github.com/chef/chef-docs-theme/assets/sass/_homepage.scss b/_vendor/github.com/chef/chef-docs-theme/assets/sass/_homepage.scss
index e7f45b4c1e..52fe5f0887 100644
--- a/_vendor/github.com/chef/chef-docs-theme/assets/sass/_homepage.scss
+++ b/_vendor/github.com/chef/chef-docs-theme/assets/sass/_homepage.scss
@@ -2,7 +2,7 @@
background-color: $white;
&-col {
- padding-right: rem-calc(12px);
+ padding: 20px;
min-height: 100vh;
margin-bottom: 30px;
&:focus {
diff --git a/_vendor/github.com/chef/chef-docs-theme/assets/sass/_typography.scss b/_vendor/github.com/chef/chef-docs-theme/assets/sass/_typography.scss
index 517b286259..de2c5aa4d0 100644
--- a/_vendor/github.com/chef/chef-docs-theme/assets/sass/_typography.scss
+++ b/_vendor/github.com/chef/chef-docs-theme/assets/sass/_typography.scss
@@ -1,32 +1,74 @@
+// Font weight variables
$regular: 400;
$semibold: 600;
$bold: 700;
$extrabold: 800;
+// Font family variables
+$font-family-base: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+$font-family-code: 'Source Code Pro', Consolas, 'Monaco', 'Courier New', monospace;
+
+// Enhanced font loading with performance optimizations
@font-face {
font-family: 'Inter';
font-weight: $regular;
- src: url('../fonts/Inter-Regular.ttf');
+ font-display: swap;
+ src: url('../fonts/Inter-Regular.ttf') format('truetype');
}
@font-face {
font-family: 'Inter';
font-weight: $semibold;
- src: url('../fonts/Inter-SemiBold.ttf');
+ font-display: swap;
+ src: url('../fonts/Inter-SemiBold.ttf') format('truetype');
}
@font-face {
font-family: 'Inter';
font-weight: $bold;
- src: url('../fonts/Inter-Bold.ttf');
+ font-display: swap;
+ src: url('../fonts/Inter-Bold.ttf') format('truetype');
}
+// Base body typography
+body {
+ font-family: $font-family-base;
+ font-weight: $regular;
+ -webkit-font-smoothing: antialiased;
+ -moz-osx-font-smoothing: grayscale;
+ text-rendering: optimizeLegibility;
+}
+
+// Enhanced print styles
@media print {
- h2 { page-break-after: avoid; }
- p { page-break-inside: avoid; }
+ * {
+ color: #000 !important;
+ background: transparent !important;
+ }
+
+ h1, h2, h3, h4, h5, h6 {
+ page-break-after: avoid;
+ page-break-inside: avoid;
+ }
+
+ p, li {
+ page-break-inside: avoid;
+ orphans: 3;
+ widows: 3;
+ }
+
+ img {
+ page-break-inside: avoid;
+ max-width: 100% !important;
+ }
@page {
margin: 1in;
+ size: letter;
+ }
+
+ .hide-for-print {
+ display: none !important;
}
}
diff --git a/_vendor/github.com/chef/chef-docs-theme/assets/sass/_variables.scss b/_vendor/github.com/chef/chef-docs-theme/assets/sass/_variables.scss
index c3eb10c471..07e9f6e003 100644
--- a/_vendor/github.com/chef/chef-docs-theme/assets/sass/_variables.scss
+++ b/_vendor/github.com/chef/chef-docs-theme/assets/sass/_variables.scss
@@ -50,6 +50,8 @@ $offcanvas-background: $white;
$tab-content-padding: 0;
$box-shadow: 0 3px 7px 0 $border-dark,0 1px 2px 0 $border-dark;
+$header-font-weight: 600;
+
$callout-font-color: $body-font-color;
$callout-radius: $border-radius-base;
$callout-padding: .5rem 1rem;
@@ -78,22 +80,3 @@ $breakpoints: (
xxlarge: 1440px,
);
$print-breakpoint: small;
-
-$header-styles: (
- 'small': (
- 'h1': ('font-size': 24),
- 'h2': ('font-size': 20),
- 'h3': ('font-size': 18),
- 'h4': ('font-size': 16),
- 'h5': ('font-size': 14),
- 'h6': ('font-size': 14),
- ),
- 'medium': (
- 'h1': ('font-size': 36),
- 'h2': ('font-size': 32),
- 'h3': ('font-size': 24),
- 'h4': ('font-size': 18),
- 'h5': ('font-size': 16),
- 'h6': ('font-size': 16),
- )
-);
diff --git a/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_breadcrumbs.scss b/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_breadcrumbs.scss
index f18cf8ec48..5bb700ab0a 100644
--- a/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_breadcrumbs.scss
+++ b/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_breadcrumbs.scss
@@ -1,7 +1,7 @@
#breadcrumb {
font-size: .8rem;
- margin: 2rem 0 1rem 0;
+ margin: 1rem 0;
ol {
padding-left: 0;
diff --git a/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_foundation.scss b/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_foundation.scss
index 8bff677643..d2ad302114 100644
--- a/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_foundation.scss
+++ b/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_foundation.scss
@@ -7,7 +7,7 @@
ul.accordion,
ul[role="tablist"] {
margin-left: 0;
- margin-bottom: 0;
+ margin-bottom: rem-calc(32);
}
// Tab navigation styling
diff --git a/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_grid.scss b/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_grid.scss
index c00d1230dd..38b861ae7a 100644
--- a/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_grid.scss
+++ b/_vendor/github.com/chef/chef-docs-theme/assets/sass/partials/_grid.scss
@@ -27,11 +27,11 @@
p img {
display: block;
margin: rem-calc(32) auto;
- -webkit-box-shadow: $box-shadow;
box-shadow: $box-shadow;
- border: 1px solid transparent;
- padding: 1rem;
+ border: 1px solid $border;
+ padding: rem-calc(16);
cursor: pointer;
+ border-radius: $border-radius-base;
@include breakpoint(large) {
max-width: 100%;
}
@@ -77,6 +77,51 @@
box-shadow: none;
}
}
+
+ .grid-container {
+ margin-top: 3rem;
+ }
+
+ // Grid cell styling
+ .grid-cell {
+ border: 1px solid $border;
+ border-radius: $border-radius-base;
+ padding: 1rem;
+ box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+ transition: border-color 0.2s ease-in-out, transform 0.2s ease-in-out, box-shadow 0.2s ease-in-out;
+
+ &:hover {
+ border-color: $border-dark;
+ box-shadow: 0 4px 8px rgba(0, 0, 0, 0.15);
+ }
+
+ h2,
+ h3,
+ h4,
+ h5,
+ h6 {
+ margin-top: 0;
+ text-decoration: none !important;
+ color: $blue-darker
+ }
+
+ // Clickable cells (when cell is an anchor tag)
+ &[href] {
+ text-decoration: none !important;
+ color: inherit;
+ display: block;
+
+ &:hover {
+ border-color: $blue-darker;
+ text-decoration: none;
+ }
+
+ &:focus {
+ outline: 3px solid $blue;
+ outline-offset: 2px;
+ }
+ }
+ }
}
.has-sidebar {
diff --git a/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_headings.scss b/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_headings.scss
index 61084c5f1f..7f590a4d74 100644
--- a/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_headings.scss
+++ b/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_headings.scss
@@ -1,91 +1,70 @@
-h1, .h1,
-h2, .h2,
-h3, .h3,
-h4, .h4,
-h5, .h5,
-h6, .h6,{
- margin: 0;
+// Foundation-based heading styles
+h1, h2, h3, h4, h5, h6 {
+ margin: 0;
+ font-family: $header-font-family;
+ font-weight: $header-font-weight;
+ font-style: $header-font-style;
+ color: $header-color;
+ line-height: $header-lineheight;
- // Adjust the anchor position to account for the fixed header
- &:before {
- content: '';
- display: block;
- position: relative;
- width: 0px;
- height: rem-calc(100px);
- margin-top: rem-calc(-100px);
- }
+ svg.svg-link {
+ margin-left: rem-calc(8);
+ opacity: 0.7;
+ transition: all 0.2s ease-in-out;
- & > a {
- color: inherit;
- text-decoration: none;
-
- &:hover {
- color: inherit;
- text-decoration: none;
- }
- }
+ &:hover {
+ opacity: 1;
+ filter: brightness(0) saturate(100%) invert(38%) sepia(99%) saturate(497%) hue-rotate(163deg) brightness(87%) contrast(79%);
+ }
+ }
}
-h1, .h1 {
- @include inter();
- line-height: 1.25;
- font-weight: normal;
- letter-spacing: normal;
- color: $charcoal;
- text-transform: none;
- margin-bottom: 26px;
+h1 {
+ font-size: rem-calc(32);
+ margin-bottom: rem-calc(24);
+ font-weight: $bold;
}
-h2, .h2 {
- @include inter();
- line-height: 1.25;
- font-weight: normal;
- letter-spacing: normal;
- color: $charcoal;
- text-transform: none;
- margin-bottom: 12px;
- margin-top: rem-calc(24px);
+h2 {
+ font-size: rem-calc(26);
+ margin-top: rem-calc(48);
+ margin-bottom: rem-calc(24);
+ font-weight: $semibold;
}
-h3, .h3 {
- @include inter();
- line-height: 1.33;
- font-weight: normal;
- letter-spacing: normal;
- color: $charcoal;
- text-transform: none;
- margin-bottom: 17px;
- margin-top: rem-calc(32px);
+h3 {
+ font-size: rem-calc(21);
+ margin-top: rem-calc(32);
+ margin-bottom: rem-calc(16);
+ font-weight: $semibold;
}
-h4, .h4 {
- @include inter();
- line-height: 1.36;
- font-weight: $bold;
- letter-spacing: normal;
- color: $charcoal;
- text-transform: none;
- margin-bottom: rem-calc(18px);
- margin-top: rem-calc(32px);
+h4 {
+ font-size: rem-calc(18);
+ margin-top: rem-calc(24);
+ margin-bottom: rem-calc(14);
+ font-weight: $semibold;
}
-h5, .h5 {
- @include inter();
- line-height: 1.67;
- font-weight: $bold;
- letter-spacing: normal;
- color: $charcoal;
- text-transform: uppercase;
- margin-bottom: 8px;
+h5 {
+ font-size: rem-calc(16);
+ margin-top: rem-calc(20);
+ margin-bottom: rem-calc(12);
+ font-weight: $semibold;
}
-h6, .h6, {
- @include inter();
- line-height: 1.25;
- font-weight: $bold;
- letter-spacing: normal;
- color: $charcoal;
- text-transform: uppercase;
- margin-bottom: 8px;
+h6 {
+ font-size: rem-calc(14);
+ margin-top: rem-calc(18);
+ margin-bottom: rem-calc(10);
+ font-weight: $bold;
}
+
+// Small header segments
+h1 small, h2 small, h3 small, h4 small, h5 small, h6 small {
+ font-size: $small-font-size;
+ color: $header-small-font-color;
+ font-weight: $regular;
+ text-transform: none;
+ letter-spacing: normal;
+}
\ No newline at end of file
diff --git a/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_links.scss b/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_links.scss
index 29db001916..8509a1a4fb 100644
--- a/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_links.scss
+++ b/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_links.scss
@@ -60,6 +60,11 @@
position: relative;
left: 4px;
bottom: 1px;
- margin-right: 4px;
- filter: invert(51%) sepia(0%) saturate(13%) hue-rotate(142deg) brightness(89%) contrast(83%);
+ margin-right: 4px;
+ filter: invert(51%) sepia(0%) saturate(13%) hue-rotate(142deg) brightness(89%) contrast(83%);
+}
+
+a.broken {
+ color: $alert-color;
+ text-decoration: line-through !important;
}
diff --git a/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_prose.scss b/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_prose.scss
index f3c1b8c966..907c98c083 100644
--- a/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_prose.scss
+++ b/_vendor/github.com/chef/chef-docs-theme/assets/sass/typography/_prose.scss
@@ -1,49 +1,21 @@
.prose {
- h1, h2, h3, h4, h5, h6 {
- svg.svg-link {
- margin-left: .5rem;
-
- &:hover{
- filter: brightness(0) saturate(100%) invert(38%) sepia(99%) saturate(497%) hue-rotate(163deg) brightness(87%) contrast(79%);
- }
- }
- }
-
> p, .p {
@include base-type();
- margin-bottom: .5rem;
+ margin-bottom: 1.2rem;
color: $charcoal;
-
- &.intro {
- font-size: 20px;
- line-height: 1.6;
-
- &-medium {
- font-size: 22px;
- line-height: 1.45;
- }
- }
-
- &.desc {
- font-size: 16px;
- line-height: 1.5;
- }
- }
- p.release-notes-version {
- font-size: 1.24rem;
- line-height: 1.5;
- font-weight: 700;
}
+
.display-none {
display: none;
}
}
#main-content{
- .material-symbols-outlined, .material-icons {
- vertical-align: bottom;
- }
+ .material-symbols-outlined,
+ .material-icons {
+ vertical-align: bottom;
+ }
.index-prose {
li {
margin-bottom: 0;
@@ -52,7 +24,7 @@
margin-top: .5rem;
}
}
- .site-map{
+ .site-map {
p.strong-child{
margin-top: 1rem;
}
@@ -64,13 +36,16 @@
}
.text-recommend{
- background-color: $light-light-gray;
border-radius: $border-radius-base;
+ border-color: $ash;
+ border-style: solid;
+ border-width: 5px;
margin: 1rem 0;
- padding: .5rem;
+
>.recommend-text{
font-weight: bold;
- margin-bottom: 1rem;
+ background-color: $ash;
+ padding: .5rem;
>.svg-inline--fa{
font-size: 1.2rem;
margin-right: .5rem;
@@ -85,8 +60,7 @@
}
}
.recommended-text{
- margin-left: 1rem;
- margin-bottom: 1rem;
+ padding: 1rem;
}
code, pre {
border-color: $code-border;
diff --git a/_vendor/github.com/chef/chef-docs-theme/layouts/_default/_markup/render-image.html b/_vendor/github.com/chef/chef-docs-theme/layouts/_default/_markup/render-image.html
new file mode 100644
index 0000000000..de041d2461
--- /dev/null
+++ b/_vendor/github.com/chef/chef-docs-theme/layouts/_default/_markup/render-image.html
@@ -0,0 +1,175 @@
+{{- /* Last modified: 2025-04-25T11:05:22-07:00 */}}
+
+{{- /*
+See:
+
+- https://gohugo.io/templates/render-hooks/
+- https://www.veriphor.com/articles/link-and-image-render-hooks/
+
+*/ -}}
+
+{{- /*
+Copyright 2025 Veriphor, LLC
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not
+use this file except in compliance with the License. You may obtain a copy of
+the License at
+
+https://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+License for the specific language governing permissions and limitations under
+the License.
+*/}}
+
+{{- /*
+This render hook resolves internal destinations by looking for a matching:
+
+ 1. Page resource (an image in the current page bundle)
+ 2. Section resource (an image in the current section)
+ 3. Global resource (an image in the assets directory)
+
+It skips the section resource lookup if the current page is a leaf bundle, and
+captures external destinations as resources for local hosting.
+
+You must place global resources in the assets directory. If you have placed
+your resources in the static directory, and you are unable or unwilling to move
+them, you must mount the static directory to the assets directory by including
+both of these entries in your site configuration:
+
+ [[module.mounts]]
+ source = 'assets'
+ target = 'assets'
+
+ [[module.mounts]]
+ source = 'static'
+ target = 'assets'
+
+By default, if this render hook is unable to resolve a destination, it passes
+the destination through without modification. To emit a warning or error, set
+the error level in your site configuration:
+
+ [params.render_hooks.image]
+ errorLevel = 'warning' # ignore (default), warning, or error (fails the build)
+
+Image render hooks are also used to:
+
+ - Resize, crop, rotate, filter, and convert images
+ - Build responsive images using srcset and sizes attributes
+ - Wrap images inside of a picture element
+ - Transform standalone images into figure elements
+
+To perform any of these operations, you can “hook” into this render hook with a
+partial template, after the render hook has captured the resource.
+
+@context {map} Attributes The Markdown attributes, available if (a) markup.goldmark.parser.attribute.block is true, and (b) markup.goldmark.parser.wrapStandAloneImageWithinParagraph is false in site configuration.
+@context {string} Destination The image destination.
+@context {bool} IsBlock Returns true if a standalone image is not wrapped within a paragraph element.
+@context {int} Ordinal The zero-based ordinal of the image on the page.
+@context {page} Page A reference to the page containing the image.
+@context {string} PlainText The image description as plain text.
+@context {string} Text The image description.
+@context {string} Title The image title.
+
+@returns {template.html}
+*/}}
+
+{{- /* Initialize. */}}
+{{- $renderHookName := "image" }}
+
+{{- /* Verify minimum required version. */}}
+{{- $minHugoVersion := "0.147.0" }}
+{{- if lt hugo.Version $minHugoVersion }}
+ {{- errorf "The %q render hook requires Hugo v%s or later." $renderHookName $minHugoVersion }}
+{{- end }}
+
+{{- /* Error level when unable to resolve destination: ignore, warning, or error. */}}
+{{- $errorLevel := or site.Params.render_hooks.image.errorLevel "ignore" | lower }}
+
+{{- /* Validate error level. */}}
+{{- if not (in (slice "ignore" "warning" "error") $errorLevel) }}
+ {{- errorf "The %q render hook is misconfigured. The errorLevel %q is invalid. Please check your site configuration." $renderHookName $errorLevel }}
+{{- end }}
+
+{{- /* Determine content path for warning and error messages. */}}
+{{- $contentPath := "" }}
+{{- with .Page.File }}
+ {{- $contentPath = .Path }}
+{{- else }}
+ {{- $contentPath = .Path }}
+{{- end }}
+
+{{- /* Parse destination. */}}
+{{- $u := urls.Parse .Destination }}
+
+{{- /* Set common message. */}}
+{{- $msg := printf "The %q render hook was unable to resolve the destination %q in %s" $renderHookName $u.String $contentPath }}
+
+{{- /* Get image resource. */}}
+{{- $r := "" }}
+{{- if $u.IsAbs }}
+ {{- with try (resources.GetRemote $u.String) }}
+ {{- with .Err }}
+ {{- if eq $errorLevel "warning" }}
+ {{- warnf "%s. See %s" . $contentPath }}
+ {{- else if eq $errorLevel "error" }}
+ {{- errorf "%s. See %s" . $contentPath }}
+ {{- end }}
+ {{- else with .Value }}
+ {{- /* Destination is a remote resource. */}}
+ {{- $r = . }}
+ {{- else }}
+ {{- if eq $errorLevel "warning" }}
+ {{- warnf $msg }}
+ {{- else if eq $errorLevel "error" }}
+ {{- errorf $msg }}
+ {{- end }}
+ {{- end }}
+ {{- end }}
+{{- else }}
+ {{- with .PageInner.Resources.Get (strings.TrimPrefix "./" $u.Path) }}
+ {{- /* Destination is a page resource. */}}
+ {{- $r = . }}
+ {{- else with (and (ne .Page.BundleType "leaf") (.Page.CurrentSection.Resources.Get (strings.TrimPrefix "./" $u.Path))) }}
+ {{- /* Destination is a section resource, and current page is not a leaf bundle. */}}
+ {{- $r = . }}
+ {{- else with resources.Get $u.Path }}
+ {{- /* Destination is a global resource. */}}
+ {{- $r = . }}
+ {{- else }}
+ {{- if eq $errorLevel "warning" }}
+ {{- warnf $msg }}
+ {{- else if eq $errorLevel "error" }}
+ {{- errorf $msg }}
+ {{- end }}
+ {{- end }}
+{{- end }}
+
+{{- /* Determine id attribute. */}}
+{{- $id := printf "h-rh-i-%d" .Ordinal }}
+{{- with .Attributes.id }}
+ {{- $id = . }}
+{{- end }}
+
+{{- /* Initialize attributes. */}}
+{{- $attrs := merge .Attributes (dict "id" $id "alt" .PlainText "title" (.Title | transform.HTMLEscape) "src" $u.String) }}
+
+{{- /* Merge attributes from resource. */}}
+{{- with $r }}
+ {{- $attrs = merge $attrs (dict "src" .RelPermalink) }}
+ {{- if not (eq .MediaType.SubType "svg") }}
+ {{- $attrs = merge $attrs (dict "height" (string .Height) "width" (string .Width)) }}
+ {{- end }}
+{{- end }}
+
+{{- /* Render image element. */ -}}
+
+{{- /**/ -}}
diff --git a/_vendor/github.com/chef/chef-docs-theme/layouts/_default/_markup/render-link.html b/_vendor/github.com/chef/chef-docs-theme/layouts/_default/_markup/render-link.html
index 63263dcdda..27c75cb25b 100644
--- a/_vendor/github.com/chef/chef-docs-theme/layouts/_default/_markup/render-link.html
+++ b/_vendor/github.com/chef/chef-docs-theme/layouts/_default/_markup/render-link.html
@@ -1,7 +1,248 @@
-{{- if eq .Destination "@" -}}
- {{ .Text | safeHTML }}
-{{- else -}}
- {{ .Text | safeHTML }}
-{{- end -}}
+{{- /* Last modified: 2025-04-25T11:05:22-07:00 */}}
+
+{{- /*
+See:
+
+- https://gohugo.io/templates/render-hooks/
+- https://www.veriphor.com/articles/link-and-image-render-hooks/
+
+*/ -}}
+
+{{- /*
+Copyright 2025 Veriphor LLC
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not
+use this file except in compliance with the License. You may obtain a copy of
+the License at
+
+https://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+License for the specific language governing permissions and limitations under
+the License.
+*/}}
+
+{{- /*
+This render hook resolves internal destinations by looking for a matching:
+
+ 1. Content page
+ 2. Page resource (a file in the current page bundle)
+ 3. Section resource (a file in the current section)
+ 4. Global resource (a file in the assets directory)
+
+It skips the section resource lookup if the current page is a leaf bundle.
+
+External destinations are not modified.
+
+You must place global resources in the assets directory. If you have placed
+your resources in the static directory, and you are unable or unwilling to move
+them, you must mount the static directory to the assets directory by including
+both of these entries in your site configuration:
+
+ [[module.mounts]]
+ source = 'assets'
+ target = 'assets'
+
+ [[module.mounts]]
+ source = 'static'
+ target = 'assets'
+
+By default, if this render hook is unable to resolve a destination, including a
+fragment if present, it passes the destination through without modification. To
+emit a warning or error, set the error level in your site configuration:
+
+ [params.render_hooks.link]
+ errorLevel = 'warning' # ignore (default), warning, or error (fails the build)
+
+When you set the error level to warning, and you are in a development
+environment, you can visually highlight broken internal links:
+
+ [params.render_hooks.link]
+ errorLevel = 'warning' # ignore (default), warning, or error (fails the build)
+ highlightBroken = true # true or false (default)
+
+This will add a "broken" class to anchor elements with invalid src attributes.
+Add a rule to your CSS targeting the broken links:
-{{/* See https://gohugo.io/templates/render-hooks/ and https://discourse.gohugo.io/t/automatically-add-id-attribute-to-dt-element/38191 */}}
\ No newline at end of file
+ a.broken {
+ background: #ff0;
+ border: 2px solid #f00;
+ padding: 0.1em 0.2em;
+ }
+
+This render hook may be unable to resolve destinations created with the ref and
+relref shortcodes. Unless you set the error level to ignore you should not use
+either of these shortcodes in conjunction with this render hook.
+
+@context {string} Destination The link destination.
+@context {page} Page A reference to the page containing the link.
+@context {string} PlainText The link description as plain text.
+@context {string} Text The link description.
+@context {string} Title The link title.
+
+@returns {template.html}
+*/}}
+
+{{- /* Initialize. */}}
+{{- $renderHookName := "link" }}
+
+{{- /* Verify minimum required version. */}}
+{{- $minHugoVersion := "0.147.0" }}
+{{- if lt hugo.Version $minHugoVersion }}
+ {{- errorf "The %q render hook requires Hugo v%s or later." $renderHookName $minHugoVersion }}
+{{- end }}
+
+{{- /* Error level when unable to resolve destination: ignore, warning, or error. */}}
+{{- $errorLevel := or site.Params.render_hooks.link.errorLevel "ignore" | lower }}
+
+{{- /* If true, adds "broken" class to broken links. Applicable in development environment when errorLevel is warning. */}}
+{{- $highlightBrokenLinks := or site.Params.render_hooks.link.highlightBroken false }}
+
+{{- /* Validate error level. */}}
+{{- if not (in (slice "ignore" "warning" "error") $errorLevel) }}
+ {{- errorf "The %q render hook is misconfigured. The errorLevel %q is invalid. Please check your site configuration." $renderHookName $errorLevel }}
+{{- end }}
+
+{{- /* Determine content path for warning and error messages. */}}
+{{- $contentPath := .Page.String -}}
+
+{{- /* Parse destination. */}}
+{{- $u := urls.Parse .Destination }}
+
+{{- /* Set common message. */}}
+{{- $msg := printf "The %q render hook was unable to resolve the destination %q in %s" $renderHookName $u.String $contentPath }}
+
+{{- /* Set attributes for anchor element. */}}
+{{- $attrs := dict "href" $u.String }}
+{{- if $u.IsAbs }}
+ {{- /* Destination is a remote resource. */}}
+ {{- $attrs = merge $attrs (dict "rel" "external") }}
+{{- else }}
+ {{- with $u.Path }}
+ {{- /* In `"https://example.org:123/foo?a=6&b=7#bar"` $u.Path is `/foo` */ -}}
+
+ {{- with $p := ( or ($.PageInner.GetPage .) ($.PageInner.GetPage (strings.TrimRight "/" .))) }}
+ {{- /* Destination is a page. */}}
+ {{- $href := .RelPermalink }}
+ {{- with $u.RawQuery }}
+ {{- $href = printf "%s?%s" $href . }}
+ {{- end }}
+ {{- with $u.Fragment }}
+ {{- $ctx := dict
+ "contentPath" $contentPath
+ "errorLevel" $errorLevel
+ "page" $p
+ "parsedURL" $u
+ "renderHookName" $renderHookName
+ }}
+ {{- partial "inline/h-rh-l/validate-fragment.html" $ctx }}
+ {{- $href = printf "%s#%s" $href . }}
+ {{- end }}
+ {{- $attrs = dict "href" $href }}
+ {{- else with $.PageInner.Resources.Get $u.Path }}
+ {{- /* Destination is a page resource; drop query and fragment. */}}
+ {{- $attrs = dict "href" .RelPermalink }}
+ {{- else with (and (ne $.Page.BundleType "leaf") ($.Page.CurrentSection.Resources.Get $u.Path)) }}
+ {{- /* Destination is a section resource, and current page is not a leaf bundle. */}}
+ {{- $attrs = dict "href" .RelPermalink }}
+ {{- else with resources.Get $u.Path }}
+ {{- /* Destination is a global resource; drop query and fragment. */}}
+ {{- $attrs = dict "href" .RelPermalink }}
+ {{- else }}
+ {{- if eq $errorLevel "warning" }}
+ {{- warnf $msg }}
+ {{- if and $highlightBrokenLinks hugo.IsDevelopment }}
+ {{- $attrs = merge $attrs (dict "class" "broken") }}
+ {{- end }}
+ {{- else if eq $errorLevel "error" }}
+ {{- errorf $msg }}
+ {{- end }}
+ {{- end }}
+ {{- else }}
+ {{- with $u.Fragment }}
+ {{- /* Destination is on the same page; prepend relative permalink. */}}
+ {{- $ctx := dict
+ "contentPath" $contentPath
+ "errorLevel" $errorLevel
+ "page" $.Page
+ "parsedURL" $u
+ "renderHookName" $renderHookName
+ }}
+ {{- partial "inline/h-rh-l/validate-fragment.html" $ctx }}
+ {{- $attrs = dict "href" (printf "%s#%s" $.Page.RelPermalink .) }}
+ {{- else }}
+ {{- if eq $errorLevel "warning" }}
+ {{- warnf $msg }}
+ {{- if and $highlightBrokenLinks hugo.IsDevelopment }}
+ {{- $attrs = merge $attrs (dict "class" "broken") }}
+ {{- end }}
+ {{- else if eq $errorLevel "error" }}
+ {{- errorf $msg }}
+ {{- end }}
+ {{- end }}
+ {{- end }}
+{{- end }}
+
+{{- /* Render anchor element. */ -}}
+{{ .Text }}
+
+{{- define "_partials/inline/h-rh-l/validate-fragment.html" }}
+ {{- /*
+ Validates the fragment portion of a link destination.
+
+ @context {string} contentPath The page containing the link.
+ @context {string} errorLevel The error level when unable to resolve destination; ignore (default), warning, or error.
+ @context {page} page The page corresponding to the link destination
+ @context {struct} parsedURL The link destination parsed by urls.Parse.
+ @context {string} renderHookName The name of the render hook.
+ */}}
+
+ {{- /* Initialize. */}}
+ {{- $contentPath := .contentPath }}
+ {{- $errorLevel := .errorLevel }}
+ {{- $p := .page }}
+ {{- $u := .parsedURL }}
+ {{- $renderHookName := .renderHookName }}
+
+ {{- /* Validate. */}}
+ {{- with $u.Fragment }}
+ {{- if $p.Fragments.Identifiers.Contains . }}
+ {{- if gt ($p.Fragments.Identifiers.Count .) 1 }}
+ {{- $msg := printf "The %q render hook detected duplicate heading IDs %q in %s" $renderHookName . $contentPath }}
+ {{- if eq $errorLevel "warning" }}
+ {{- warnf $msg }}
+ {{- else if eq $errorLevel "error" }}
+ {{- errorf $msg }}
+ {{- end }}
+ {{- end }}
+ {{- else }}
+ {{- /* Determine target path for warning and error message. */}}
+ {{- $targetPath := "" }}
+ {{- with $p.File }}
+ {{- $targetPath = .Path }}
+ {{- else }}
+ {{- $targetPath = .Path }}
+ {{- end }}
+ {{- /* Set common message. */}}
+ {{- $msg := printf "The %q render hook was unable to find heading ID %q in %s. See %s" $renderHookName . $targetPath $contentPath }}
+ {{- if eq $targetPath $contentPath }}
+ {{- $msg = printf "The %q render hook was unable to find heading ID %q in %s" $renderHookName . $targetPath }}
+ {{- end }}
+ {{- /* Throw warning or error. */}}
+ {{- if eq $errorLevel "warning" }}
+ {{- warnf $msg }}
+ {{- else if eq $errorLevel "error" }}
+ {{- errorf $msg }}
+ {{- end }}
+ {{- end }}
+ {{- end }}
+{{- end -}}
diff --git a/_vendor/github.com/chef/chef-docs-theme/layouts/_default/data-api.html b/_vendor/github.com/chef/chef-docs-theme/layouts/_default/data-api.html
index 073f212c33..5d65d65d80 100644
--- a/_vendor/github.com/chef/chef-docs-theme/layouts/_default/data-api.html
+++ b/_vendor/github.com/chef/chef-docs-theme/layouts/_default/data-api.html
@@ -15,7 +15,7 @@
{{- end -}}
{{- end }}
-
+
Page Last Modified: {{ dateFormat "January 2, 2006" .Lastmod }}
{{ end }}Copyright © {{ now.Format "2006" }} Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
+Progress and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries. See Trademarks for appropriate markings. All rights in any other trademarks contained herein are reserved by their respective owners and their inclusion does not imply an endorsement, affiliation, or sponsorship as between Progress and the respective owners.
diff --git a/_vendor/github.com/chef/chef-docs-theme/layouts/partials/head.html b/_vendor/github.com/chef/chef-docs-theme/layouts/partials/head.html index ef38c76b0c..cbfef05114 100644 --- a/_vendor/github.com/chef/chef-docs-theme/layouts/partials/head.html +++ b/_vendor/github.com/chef/chef-docs-theme/layouts/partials/head.html @@ -8,7 +8,7 @@ {{- with .Params.st_robots -}} {{- end }} - {{ with .Params.product -}} + {{ with or .Params.product .Params.swiftype_search_product_key $.Site.Params.versions.this_version.swiftype_search_products -}} {{- range $tag := . -}} {{- end -}} @@ -22,5 +22,4 @@