feat: add RepositoryReference component and update DNS documentation with references

Author: AlixANNERAUD

services/website/.vitepress/theme/components/RepositoryReference.vue

@@ -0,0 +1,33 @@
+<script setup>
+import { computed } from "vue";
+
+const props = defineProps({
+  path: {
+    type: String,
+    required: true,
+  },
+});
+
+const href = computed(() => {
+  return `https://github.com/AlixANNERAUD/Infrastructure/tree/main/${props.path}`;
+});
+const label = computed(() => `<code>${props.path}</code>`);
+</script>
+
+<template>
+  <a :href="href" class="external-reference-link">
+    <slot><span v-html="label"></span></slot>
+  </a>
+</template>
+
+<style scoped>
+.external-reference-link {
+  color: var(--vp-c-brand-1);
+  text-decoration: none;
+}
+
+.external-reference-link:hover {
+  color: var(--vp-c-brand-2);
+  text-decoration: underline;
+}
+</style>

services/website/.vitepress/theme/index.ts

@@ -0,0 +1,29 @@
+import type { Theme } from "vitepress";
+import DefaultTheme from "vitepress/theme";
+import { App } from "vue";
+
+function registerComponents(app: App<any>) {
+  // Auto-register all components in the components directory
+  const components = import.meta.glob("./components/**/*.vue", {
+    eager: true,
+  });
+
+  for (const path in components) {
+    const component = components[path] as any;
+    const componentName = path
+      .split("/")
+      .pop()
+      ?.replace(/\.\w+$/, ""); // Remove file extension
+
+    if (componentName) {
+      app.component(componentName, component.default);
+    }
+  }
+}
+
+export default {
+  extends: DefaultTheme,
+  enhanceApp({ app }) {
+    registerComponents(app);
+  },
+} satisfies Theme;

services/website/.vitepress/theme/utilities/reference.ts

@@ -0,0 +1,75 @@
+export enum ReferenceCrate {
+  Abi_context = "abi_context",
+  Abi_declarations = "abi_declarations",
+  Abi_definitions = "abi_definitions",
+  Authentication = "authentication",
+  Bootsplash = "bootsplash",
+  Device = "device",
+  Executable = "executable",
+  File_system = "file_system",
+  Graphics = "graphics",
+  Host_bindings = "host_bindings",
+  Internationalization = "internationalization",
+  LittleFs = "littlefs",
+  Log = "log",
+  Memory = "memory",
+  Network = "network",
+  Synchronization = "synchronization",
+  Task = "task",
+  Time = "time",
+  Users = "users",
+  VirtualFileSystem = "virtual_file_system",
+  VirtualMachine = "virtual_machine",
+  Xila = "xila",
+}
+
+export enum ReferenceArchitecture {
+  Host = "host",
+  Wasm = "wasm",
+}
+
+export enum ReferenceKind {
+  Structure = "struct",
+  Enumeration = "enum",
+  Function = "fn",
+  Constant = "const",
+  Trait = "trait",
+  Module = "mod",
+  Macro = "macro",
+  Type = "type",
+}
+
+export function getReferencePath(kind: ReferenceKind, symbol: string): string {
+  return `${kind}.${symbol}.html`;
+}
+
+export function getReferenceDisplayName(
+  crate: ReferenceCrate,
+  kind?: ReferenceKind,
+  symbol?: string,
+): string {
+  if (!kind || !symbol) {
+    return `<code>${crate}</code> crate`;
+  }
+
+  switch (kind) {
+    case ReferenceKind.Function:
+      return `<code>${crate}::${symbol}()</code>`;
+    case ReferenceKind.Module:
+      return `<code>${crate}::${symbol}</code>`;
+    case ReferenceKind.Trait:
+      return `<code>${crate}::${symbol}</code>`;
+    case ReferenceKind.Type:
+      return `<code>${crate}::${symbol}</code>`;
+    case ReferenceKind.Constant:
+      return `<code>${crate}::${symbol}</code>`;
+    case ReferenceKind.Macro:
+      return `<code>${crate}::${symbol}!</code>`;
+    case ReferenceKind.Enumeration:
+      return `<code>${crate}::${symbol}</code>`;
+    case ReferenceKind.Structure:
+      return `<code>${crate}::${symbol}</code>`;
+    default:
+      return `<code>${symbol}</code>`;
+  }
+}

services/website/src/documentation/dns.md

@@ -11,4 +11,10 @@ La plupart des services utilisent des enregistrements CNAME pointant vers le ser
 | global.bruxelles.anneraud.fr  | Accès réseau global à Bruxelles  | Public | Bruxelles  | Dynamique   |
 | global.luxembourg.anneraud.fr | Accès réseau global à Luxembourg | Public | Luxembourg | Statique    |
 
-Voir [playbooks/cloudflare/update_dns.yml](../playbooks/cloudflare/update_dns.yml) ou les playbooks de déploiement de services pour la liste complète des enregistrements DNS et leurs configurations.
+Voir:
+
+- <RepositoryReference path="services/cloudflare/update_dns_anneraud.yml" />
+- <RepositoryReference path="services/cloudflare/update_dns_guenola_sahut.yml" />
+- <RepositoryReference path="services/cloudflare/update_dns_mini_train_store.yml" />
+- <RepositoryReference path="services/cloudflare/update_dns_xila.yml" />
+  ou les playbooks de déploiement de services pour la liste complète des enregistrements DNS et leurs configurations.