[i18n/infra] Introduce include feature with fallback (open-telemetry#6309)

Author: chalin

.cspell.yml

@@ -58,3 +58,5 @@ dictionaries:
 words: # Valid words across all locales
   - Docsy
   - htmltest
+  # Hugo
+  - warnf

content/en/docs/languages/js/_includes/browser-instrumentation-warning.md

@@ -0,0 +1,15 @@
+---
+title: # Bogus entry for markdownlint
+_build: { list: never, render: never }
+---
+
+{{% alert-md title=Warning color=warning %}}
+
+Client instrumentation for the browser is **experimental** and mostly
+**unspecified**. If you are interested in helping out, get in touch with the
+[Client Instrumentation SIG][sig].
+
+[sig]:
+  https://docs.google.com/document/d/16Vsdh-DM72AfMg_FIt9yT9ExEWF4A_vRbQ3jRNBe09w
+
+{{% /alert-md %}}

content/en/docs/languages/js/_index.md

@@ -10,8 +10,7 @@ weight: 20
 
 {{% docs/languages/index-intro js /%}}
 
-{{% alert title="Warning" color="warning" %}}
-{{% param notes.browser-instrumentation %}} {{% /alert %}}
+{{% include browser-instrumentation-warning.md %}}
 
 ## Version Support
 

content/en/docs/languages/js/getting-started/browser.md

@@ -5,8 +5,7 @@ description: Learn how to add OpenTelemetry to your browser app
 weight: 20
 ---
 
-{{% alert title="Warning" color="warning" %}}
-{{% param notes.browser-instrumentation %}} {{% /alert %}}
+{{% include browser-instrumentation-warning.md %}}
 
 While this guide uses the example application presented below, the steps to
 instrument your own application should be similar.

content/en/docs/languages/js/instrumentation.md

@@ -335,8 +335,7 @@ above, you have a `TracerProvider` setup for you already. You can continue with
 
 #### Browser
 
-{{% alert title="Warning" color="warning" %}}
-{{% param notes.browser-instrumentation %}} {{% /alert %}}
+{{% include browser-instrumentation-warning.md %}}
 
 First, ensure you've got the right packages:
 

content/pt/docs/languages/js/_includes/browser-instrumentation-warning.md

@@ -0,0 +1,16 @@
+---
+title: # Bogus entry for markdownlint
+_build: { list: never, render: never }
+default_lang_commit: 0dac041dedfe5877f45e36065c1c6fb07490b243
+---
+
+{{% alert-md title=Aviso color=warning %}}
+
+A instrumentação do cliente para o navegador é **experimental** e, em grande
+parte, **não está especificada**. Caso possua interesse em auxiliar, entre em
+contato com o [SIG de Instrumentação do Cliente][sig].
+
+[sig]:
+  https://docs.google.com/document/d/16Vsdh-DM72AfMg_FIt9yT9ExEWF4A_vRbQ3jRNBe09w
+
+{{% /alert-md %}}

content/pt/docs/languages/js/getting-started/browser.md

@@ -6,8 +6,7 @@ weight: 20
 default_lang_commit: 7cb1bd39726fc03698164ee17fe9087afdac054c
 ---
 
-{{% alert title="Aviso" color="warning" %}}
-{{% param notes.browser-instrumentation %}} {{% /alert %}}
+{{% include browser-instrumentation-warning.md %}}
 
 Embora este guia utilize o exemplo de aplicação apresentada abaixo, as etapas
 para instrumentar a sua própria aplicação devem ser similares.

hugo.yaml

@@ -1,4 +1,4 @@
-# cSpell:ignore docsy goldmark linkify netlify wordmark noopener
+# cSpell:ignore bluesky docsy goldmark linkify netlify wordmark noopener
 baseURL: https://opentelemetry.io
 title: OpenTelemetry
 disableKinds: [taxonomy]
@@ -37,14 +37,6 @@ languages:
     languageCode: pt-BR
     params:
       description: Site do Projeto OpenTelemetry
-      notes:
-        browser-instrumentation: |
-          A instrumentação do cliente para o navegador é **experimental** e,
-          em grande parte, **não está especificada**. Caso possua interesse em
-          auxiliar, entre em contato com o [SIG de Instrumentação do
-          Cliente][sig].
-
-          [sig]: https://docs.google.com/document/d/16Vsdh-DM72AfMg_FIt9yT9ExEWF4A_vRbQ3jRNBe09w
   zh:
     languageName: 中文 (Chinese)
     languageCode: zh-cn
@@ -235,12 +227,6 @@ params:
     docker-compose-v2: |
       `docker-compose` is deprecated. For details, see
       [Migrate to Compose V2](https://docs.docker.com/compose/migrate/).
-    browser-instrumentation: |
-      Client instrumentation for the browser is **experimental** and mostly **unspecified**.
-      If you are interested in helping out, get in touch with the
-      [Client Instrumentation SIG][sig].
-
-      [sig]: https://docs.google.com/document/d/16Vsdh-DM72AfMg_FIt9yT9ExEWF4A_vRbQ3jRNBe09w
 
 security:
   funcs: # cspell:disable-line

layouts/_default/_markup/render-link.html

@@ -94,7 +94,4 @@
   {{- .Text | safeHTML -}}
 </a>
 
-{{- /*
-  cSpell:ignore warnf
-  This comment ensures that all trailing whitespace is trimmed.
-*/ -}}
+{{- /* Trim trailing whitespace */ -}}

layouts/shortcodes/alert-md.md

@@ -0,0 +1,14 @@
+{{/* Temporary, from Docsy */ -}}
+
+{{ $color := .Get "color" | default "primary" -}}
+
+<div class="alert alert-{{ $color }}" role="alert">
+{{- with .Get "title" -}}
+  <div class="h4 alert-heading" role="heading">
+    {{- . | safeHTML -}}
+  </div>
+{{/* Do **not** remove this comment! It ends the previous HTML block; see https://spec.commonmark.org/0.30/#html-blocks, 7. */}}
+{{- end -}}
+{{ .Inner -}}
+</div>
+{{/* */ -}}

layouts/shortcodes/include.md

@@ -0,0 +1,27 @@
+{{/* Use to include Markdown snippets. Note that the included content can have
+calls to shortcodes. */ -}}
+
+{{ $path := .Get 0 -}}
+{{ if not (or
+  (strings.HasPrefix $path "/" )
+  (strings.HasPrefix $path "."))
+-}}
+  {{ $path = printf "_includes/%s" $path -}}
+{{ end -}}
+
+{{ template "getPage" (dict "ctx" . "path" $path "page" .Page) -}}
+
+{{ define "getPage" -}}
+  {{ $page_to_include := .page.GetPage .path -}}
+  {{ with $page_to_include -}}
+    {{ .Content -}}
+  {{ else -}}
+    {{ $parent := .page.Parent -}}
+    {{ if $parent -}}
+      {{ template "getPage" (dict "ctx" .ctx "path" .path "page" $parent) -}}
+    {{ else -}}
+      {{ warnf "File not found: %s in page: %s" .path .ctx.Page.Path -}}
+      **ERROR**: File not found: {{ .path }}.
+    {{end -}}
+  {{ end -}}
+{{ end -}}