@ampernic/vitepress-theme-alt-docs 0.1.10 → 0.1.11

package/README.md

@@ -21,16 +21,37 @@ export default Theme
 ### Config helpers
 
 ```ts
-// .vitepress/config.ts
-import { defineConfig } from 'vitepress'
-import { sharedConfig } from '@ampernic/vitepress-theme-alt-docs/config'
+// .vitepress/config/index.mts
+import { defineConfigWithTheme } from 'vitepress'
+import { createSharedConfig } from '@ampernic/vitepress-theme-alt-docs/config'
+import { ru } from './ru'
+
+const shared = createSharedConfig({
+  distroName: 'alt-domain',
+  allDistros: ['alt-domain', 'alt-workstation', 'alt-virtualization-pve', 'group-policy'],
+  // Группировка дистрибутивов в подменю (необязательно):
+  sections: [
+    { name: 'Альт Виртуализация', distros: ['alt-virtualization-pve'] },
+    { name: 'Групповые политики', distros: ['group-policy'] },
+  ],
+})
 
-export default defineConfig({
-  ...sharedConfig,
-  // ... специфичный для сайта конфиг
+export default defineConfigWithTheme({
+  ...shared,
+  locales: { root: { label: 'Русский', ...ru } },
 })
 ```
 
+#### Опции `createSharedConfig`
+
+| Опция | Тип | Описание |
+|-------|-----|----------|
+| `distroName` | `string` | Slug текущего дистрибутива |
+| `allDistros` | `string[]` | Полный список дистрибутивов для переключателя |
+| `sections` | `SectionInfo[]` | Именованные группы дистрибутивов в переключателе продуктов |
+| `hostname` | `string` | Hostname для sitemap |
+| `editLinkRepo` | `string` | URL репозитория для «Предложить правки» |
+
 ## Компоненты
 
 | Компонент | Описание |

package/dist/components/ADProducts.vue

@@ -18,8 +18,14 @@ interface DistroInfo {
   title?: string
 }
 
+interface SectionInfo {
+  name: string
+  distros: string[]
+}
+
 declare const __VERSIONS_DATA__: {
   distros: { [distroName: string]: DistroInfo }
+  sections?: SectionInfo[]
 }
 
 const getSafeVersionsData = (): { distros: { [k: string]: DistroInfo } } => {
@@ -162,11 +168,22 @@ const makeProductItem = (product: string) => {
 }
 
 const menuGroupItem = computed((): DefaultTheme.NavItemWithChildren => {
-  const regular = availableProducts.value.filter((p) => !p.endsWith('-e2k'))
-  const e2k = availableProducts.value.filter((p) => p.endsWith('-e2k'))
+  const sections = versionsData.sections ?? []
+  const sectionedDistros = new Set(sections.flatMap((s) => s.distros))
+
+  const unsectioned = availableProducts.value.filter((p) => !sectionedDistros.has(p))
+  const regular = unsectioned.filter((p) => !p.endsWith('-e2k'))
+  const e2k = unsectioned.filter((p) => p.endsWith('-e2k'))
 
   const items: DefaultTheme.NavItemWithChildren['items'] = regular.map(makeProductItem)
 
+  for (const section of sections) {
+    const sectionDistros = section.distros.filter((d) => availableProducts.value.includes(d))
+    if (sectionDistros.length > 0) {
+      items.push({ text: section.name, items: sectionDistros.map(makeProductItem) })
+    }
+  }
+
   if (e2k.length > 0) {
     items.push({ text: 'Для Эльбрус', items: e2k.map(makeProductItem) })
   }

package/dist/config/shared.d.ts

@@ -1,4 +1,6 @@
 import { DefaultTheme } from 'vitepress';
+import type { SectionInfo } from '@ampernic/vitepress-plugin-alt-docs-versioning';
+export type { SectionInfo };
 export interface SharedConfigOptions {
     /** Distro slug for this VitePress instance, e.g. `'alt-domain'`. */
     distroName: string;
@@ -7,6 +9,17 @@ export interface SharedConfigOptions {
      * When omitted only the current distro appears in the menu — fine for local dev.
      */
     allDistros?: string[];
+    /**
+     * Optional nav groupings for the ADProducts switcher.
+     * Each entry renders as a sub-menu with a display name.
+     *
+     * @example
+     * sections: [
+     *   { name: 'Альт Виртуализация', distros: ['alt-virtualization-pve', 'alt-virtualisation-one'] },
+     *   { name: 'Групповые политики', distros: ['group-policy'] },
+     * ]
+     */
+    sections?: SectionInfo[];
     /** Sitemap hostname, e.g. `'https://docs.altlinux.org'`. */
     hostname?: string;
     /**

package/dist/config/shared.js

@@ -49,7 +49,8 @@ function createSharedConfig(options) {
       },
       plugins: [...pagefind.vite.plugins, (0, _vitepressPluginAltDocsVersioning.VersioningPlugin)({
         distroName: options.distroName,
-        allDistros: options.allDistros
+        allDistros: options.allDistros,
+        sections: options.sections
       })]
     },
     srcDir: "docs",

package/dist/config/shared.mjs

@@ -52,7 +52,8 @@ export function createSharedConfig(options) {
         ...pagefind.vite.plugins,
         VersioningPlugin({
           distroName: options.distroName,
-          allDistros: options.allDistros
+          allDistros: options.allDistros,
+          sections: options.sections
         })
       ]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampernic/vitepress-theme-alt-docs",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "Shared VitePress theme for ALT Linux documentation",
   "license": "GPL-3.0-or-later",
   "author": "Ampernic",
@@ -33,10 +33,10 @@
     "@nolebase/vitepress-plugin-enhanced-readabilities": "^2.14.0",
     "markdown-it-kbd": "^1.0.0",
     "vitepress-plugin-tabs": "^0.6.0",
-    "@ampernic/vitepress-plugin-alt-docs-versioning": "0.1.2",
-    "@ampernic/vitepress-plugin-cross-site-router": "0.1.2",
+    "@ampernic/vitepress-plugin-alt-docs-versioning": "0.1.3",
     "@ampernic/vitepress-plugin-html-image": "0.1.2",
-    "@ampernic/vitepress-plugin-pagefind": "0.1.8"
+    "@ampernic/vitepress-plugin-pagefind": "0.1.8",
+    "@ampernic/vitepress-plugin-cross-site-router": "0.1.2"
   },
   "devDependencies": {
     "builtin-modules": "^3.3.0",