docs: version URL and image support baseURL (#5037)

* baseURL Signed-off-by: zirain <[email protected]> * image support baseURL Signed-off-by: zirain <[email protected]> * fix Signed-off-by: zirain <[email protected]> --------- Signed-off-by: zirain <[email protected]>
envoyproxy · Jan 14, 2025 · 213f2e6 · 213f2e6
1 parent 8e24e27
commit 213f2e6
Show file tree

Hide file tree

Showing 3 changed files with 32 additions and 0 deletions.
diff --git a/site/hugo.toml b/site/hugo.toml
@@ -82,6 +82,9 @@ id = "G-DXJEH1ZRXX"
       block = true
     [markup.goldmark.renderer]
       unsafe = true
+    [markup.goldmark.renderHooks]
+      [markup.goldmark.renderHooks.image]
+        enableDefault = true
   [markup.highlight]
     # See a complete list of available styles at https://xyproto.github.io/splash/docs/all.html
     style = "tango"

diff --git a/site/layouts/_default/_markup/render-image.html b/site/layouts/_default/_markup/render-image.html
@@ -0,0 +1,10 @@
+{{ $baseURL := site.BaseURL }}
+{{ $safeURL := .Destination | safeURL }}
+{{ if and (ne $baseURL "/") (not (or (strings.HasPrefix $safeURL "https://") (strings.HasPrefix $safeURL "http://") (strings.HasPrefix $safeURL "mailto:"))) }}
+{{ $safeURL = printf "%s%s" $baseURL $safeURL }}
+{{ end }}
+<img src="{{ $safeURL }}"
+     {{- with .PlainText }} alt="{{ . }}"{{ end -}}
+     {{- with .Title }} title="{{ . }}"{{ end -}}
+>
+{{- /* chomp trailing newline */ -}}
diff --git a/site/layouts/partials/navbar-version-selector.html b/site/layouts/partials/navbar-version-selector.html
@@ -0,0 +1,19 @@
+{{ $baseURL := .Site.BaseURL }}
+<div class="dropdown">
+    <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
+        {{- .Site.Params.version_menu -}}
+    </a>
+    <ul class="dropdown-menu">
+        {{ $path := "" -}}
+        {{ if .Site.Params.version_menu_pagelinks -}}
+        {{ $path = .Page.RelPermalink -}}
+        {{ end -}}
+        {{ range .Site.Params.versions -}}
+        {{ if ne $baseURL "/" }}
+        <li><a class="dropdown-item" href="{{ $baseURL }}{{ .url }}{{ $path }}">{{ .version }}</a></li>
+        {{ else }}
+        <li><a class="dropdown-item" href="{{ .url }}{{ $path }}">{{ .version }}</a></li>
+        {{ end }}
+        {{ end -}}
+    </ul>
+</div>