@f5-sales-demo/docs-theme 4.0.17 → 4.1.0

package/config.ts

@@ -58,6 +58,14 @@ export interface F5xcDocsConfigOptions {
   federatedSearch?: boolean;
   locales?: Record<string, { label: string; lang: string; dir?: 'rtl' }> | false;
   defaultLocale?: string;
+  progressiveCorpus?: {
+    manifest: string;
+    contentRoot: string;
+    assetBaseUrl?: string;
+    title?: string;
+    description?: string;
+    sources?: Record<string, { title?: string; description?: string }>;
+  };
 }
 
 const developerAutomationTranslations = Object.fromEntries(
@@ -252,6 +260,14 @@ export const defaultMegaMenuItems: MegaMenuItem[] = [
               href: 'https://f5-sales-demo.github.io/docs-builder/',
               icon: resolveMegaMenuIcon('f5xc:doc'),
             },
+            {
+              label: 'F5 Docs Corpus',
+              translations: itemLabels['F5 Docs Corpus'],
+              description: 'Machine-readable F5 product documentation',
+              descriptionTranslations: itemDescriptions['Machine-readable F5 product documentation'],
+              href: 'https://f5-sales-demo.github.io/html-to-markdown/',
+              icon: resolveMegaMenuIcon('f5xc:doc'),
+            },
             {
               label: 'Docs Theme',
               translations: itemLabels['Docs Theme'],
@@ -617,6 +633,27 @@ export function createF5xcDocsConfig(options: F5xcDocsConfigOptions = {}) {
 
   const federatedSearch = options.federatedSearch !== false;
   const normalizedBase = base.replace(/\/+$/, '');
+  const progressiveCorpus =
+    options.progressiveCorpus ||
+    (process.env.MACHINE_CORPUS_DIR
+      ? {
+          manifest: path.join(process.env.MACHINE_CORPUS_DIR, 'manifest.json'),
+          contentRoot: process.env.MACHINE_CORPUS_DIR,
+          assetBaseUrl: `${normalizedBase}/snapshot/`,
+          title,
+          description,
+          sources: {
+            'docs-cloud-f5-com': {
+              title: 'F5 Distributed Cloud Documentation',
+              description: 'Official F5 Distributed Cloud product documentation.',
+            },
+            'my-f5-com': {
+              title: 'MyF5 Knowledge',
+              description: 'F5 support and knowledge articles.',
+            },
+          },
+        }
+      : undefined);
   const mergeIndex = federatedSearch
     ? federatedSearchSites
         .filter((s) => `/${s.repo}` !== normalizedBase)
@@ -681,6 +718,7 @@ export function createF5xcDocsConfig(options: F5xcDocsConfigOptions = {}) {
       demote: llmsConfig.demote || ['references*'],
       ...(llmsFederatedSites.length > 0 ? { federatedSites: llmsFederatedSites } : {}),
       ...(llmsFederatedSiteCategories.length > 0 ? { federatedSiteCategories: llmsFederatedSiteCategories } : {}),
+      ...(progressiveCorpus ? { progressiveCorpus } : {}),
     }),
   ];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@f5-sales-demo/docs-theme",
-  "version": "4.0.17",
+  "version": "4.1.0",
   "description": "F5 Distributed Cloud branded Starlight documentation theme",
   "type": "module",
   "engines": {
@@ -139,7 +139,7 @@
     "@anthropic-ai/sdk": "^0.121.0",
     "@astrojs/react": "^6.0.4",
     "@f5-sales-demo/i18n-core": "^1.0.56",
-    "@f5-sales-demo/starlight-llms-txt": "2.0.0",
+    "@f5-sales-demo/starlight-llms-txt": "2.1.0",
     "@f5-sales-demo/starlight-mega-menu": "^3.0.0",
     "gray-matter": "^4.0.3",
     "remark-code-import": "^1.2.0",

package/src/i18n/mega-menu-translations.ts

@@ -450,6 +450,20 @@ export const itemDescriptions: Record<string, I18nString> = {
     hi: 'कंटेनरीकृत Astro बिल्ड सिस्टम',
     th: 'ระบบบิลด์ Astro แบบคอนเทนเนอร์',
   },
+  'Machine-readable F5 product documentation': {
+    fr: 'Documentation produit F5 lisible par machine',
+    es: 'Documentación de productos F5 legible por máquinas',
+    de: 'Maschinenlesbare F5-Produktdokumentation',
+    'pt-BR': 'Documentação de produtos F5 legível por máquina',
+    ja: '機械可読な F5 製品ドキュメント',
+    ko: '기계 판독 가능한 F5 제품 문서',
+    'zh-CN': '机器可读的 F5 产品文档',
+    'zh-TW': '機器可讀的 F5 產品文件',
+    ar: 'وثائق منتجات F5 القابلة للقراءة آليًا',
+    it: 'Documentazione dei prodotti F5 leggibile dalle macchine',
+    hi: 'मशीन-पठनीय F5 उत्पाद दस्तावेज़',
+    th: 'เอกสารผลิตภัณฑ์ F5 ที่เครื่องอ่านได้',
+  },
   'Shared branding and styling': {
     fr: 'Image de marque et styles partagés',
     es: 'Marca y estilos compartidos',
@@ -1094,6 +1108,20 @@ export const itemLabels: Record<string, I18nString> = {
     hi: 'डॉक्स बिल्डर',
     th: 'ตัวสร้างเอกสาร',
   },
+  'F5 Docs Corpus': {
+    fr: 'Corpus de documentation F5',
+    es: 'Corpus de documentación de F5',
+    de: 'F5-Dokumentationskorpus',
+    'pt-BR': 'Corpus de documentação da F5',
+    ja: 'F5 ドキュメントコーパス',
+    ko: 'F5 문서 코퍼스',
+    'zh-CN': 'F5 文档语料库',
+    'zh-TW': 'F5 文件語料庫',
+    ar: 'مجموعة وثائق F5',
+    it: 'Corpus della documentazione F5',
+    hi: 'F5 दस्तावेज़ कॉर्पस',
+    th: 'คลังเอกสาร F5',
+  },
   'Docs Theme': {
     fr: 'Thème de documentation',
     es: 'Tema de documentación',