@ampernic/vitepress-theme-alt-docs 0.1.14 → 0.1.16

package/dist/components/ADExportButton.vue

@@ -0,0 +1,112 @@
+<template>
+  <div v-if="exports.length > 0" class="ad-export">
+    <p class="ad-export-label">Скачать документацию</p>
+    <a
+      v-for="item in exports"
+      :key="item.format"
+      :href="item.url"
+      class="ad-export-link"
+      :title="item.title"
+    >
+      <span class="ad-export-icon" v-html="item.icon" />
+      {{ item.label }}
+    </a>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, ref, onMounted } from 'vue'
+import { useData, useRoute } from 'vitepress'
+
+const { site } = useData()
+const route = useRoute()
+
+interface ExportItem { format: string; url: string; label: string; title: string; icon: string }
+
+const manifest = ref<Record<string, { pdf?: string; epub?: string; html?: string }> | null>(null)
+
+onMounted(async () => {
+  try {
+    const base = site.value.base.replace(/\/$/, '')
+    const res = await fetch(`${base}/export-manifest.json`)
+    if (res.ok) {
+      const data = await res.json()
+      manifest.value = data.versions ?? null
+    }
+  } catch { /* manifest absent — silent */ }
+})
+
+const currentVersion = computed(() => {
+  const base = site.value.base
+  const p = route.path
+  const contentPath = base.length > 1 && p.startsWith(base) ? p.slice(base.length - 1) : p
+  const parts = contentPath.split('/').filter(Boolean)
+  return parts[0] && /^\d+\.\d+/.test(parts[0]) ? parts[0] : null
+})
+
+const exports = computed((): ExportItem[] => {
+  if (!currentVersion.value || !manifest.value) return []
+  const vEntry = manifest.value[currentVersion.value]
+  if (!vEntry) return []
+
+  const base = site.value.base.replace(/\/$/, '')
+  const items: ExportItem[] = []
+
+  if (vEntry.pdf) {
+    items.push({
+      format: 'pdf',
+      url: `${base}/${vEntry.pdf}`,
+      label: 'PDF',
+      title: `Скачать версию ${currentVersion.value} в формате PDF`,
+      icon: '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="12" y1="18" x2="12" y2="12"/><line x1="9" y1="15" x2="15" y2="15"/></svg>',
+    })
+  }
+
+  return items
+})
+</script>
+
+<style scoped>
+.ad-export {
+  padding: 16px 0 8px;
+  border-top: 1px solid var(--vp-c-divider);
+  margin-top: 8px;
+}
+
+.ad-export-label {
+  font-size: 12px;
+  font-weight: 600;
+  color: var(--vp-c-text-2);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  margin-bottom: 8px;
+}
+
+.ad-export-link {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 6px 10px;
+  font-size: 13px;
+  font-weight: 500;
+  color: var(--vp-c-text-1);
+  background: var(--vp-c-default-soft);
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 6px;
+  text-decoration: none;
+  transition: background 0.2s, border-color 0.2s, color 0.2s;
+  width: fit-content;
+}
+
+.ad-export-link:hover {
+  background: var(--vp-c-brand-soft);
+  border-color: var(--vp-c-brand-2);
+  color: var(--vp-c-brand-1);
+}
+
+.ad-export-icon {
+  display: flex;
+  align-items: center;
+  flex-shrink: 0;
+}
+</style>

package/dist/components/ADProductsSidebar.vue

@@ -1,5 +1,5 @@
 <template>
-  <div v-if="isLandingPage && origin" class="products-sidebar">
+  <div v-if="isLandingPage && origin && currentDistro" class="products-sidebar">
     <template v-for="group in groups" :key="group.title">
       <div class="group">
         <p v-if="group.title" class="group-title">{{ group.title }}</p>

package/dist/config/shared.d.ts

@@ -1,6 +1,7 @@
 import { DefaultTheme } from 'vitepress';
 import type { SectionInfo } from '@ampernic/vitepress-plugin-alt-docs-versioning';
-export type { SectionInfo };
+import type { ExportPluginOptions } from '@ampernic/vitepress-plugin-export';
+export type { SectionInfo, ExportPluginOptions };
 export interface SharedConfigOptions {
     /** Distro slug for this VitePress instance, e.g. `'alt-domain'`. */
     distroName: string;
@@ -27,6 +28,11 @@ export interface SharedConfigOptions {
      * @default 'https://altlinux.space/alt-docs/docs-vitepress'
      */
     editLinkRepo?: string;
+    /**
+     * Export plugin options. When provided, generates per-version export bundles
+     * (PDF, etc.) after the build and writes `export-manifest.json` to the dist dir.
+     */
+    export?: ExportPluginOptions;
 }
 /**
  * Creates the shared VitePress config for a single-distro instance.

package/dist/config/shared.js

@@ -11,6 +11,7 @@ var _markdownItKbd = _interopRequireDefault(require("markdown-it-kbd"));
 var _vitepressPluginAltDocsVersioning = require("@ampernic/vitepress-plugin-alt-docs-versioning");
 var _vitepressPluginHtmlImage = require("@ampernic/vitepress-plugin-html-image");
 var _vitepressPluginPagefind = require("@ampernic/vitepress-plugin-pagefind");
+var _vitepressPluginExport = require("@ampernic/vitepress-plugin-export");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function createSharedConfig(options) {
   const base = process.env.VITE_BASE ?? "/";
@@ -23,8 +24,13 @@ function createSharedConfig(options) {
       } : null;
     }
   });
+  const exportInst = options.export ? (0, _vitepressPluginExport.ExportPlugin)(options.export) : null;
   return (0, _vitepress.defineConfigWithTheme)({
     ...pagefind,
+    buildEnd: async () => {
+      await pagefind.buildEnd();
+      await exportInst?.buildEnd();
+    },
     vue: {
       template: {
         transformAssetUrls: {
@@ -47,7 +53,7 @@ function createSharedConfig(options) {
       ssr: {
         noExternal: ["@nolebase/vitepress-plugin-enhanced-readabilities", "@nolebase/ui", "@ampernic/vitepress-plugin-alt-docs-versioning", "@ampernic/vitepress-theme-alt-docs"]
       },
-      plugins: [...pagefind.vite.plugins, (0, _vitepressPluginAltDocsVersioning.VersioningPlugin)({
+      plugins: [...pagefind.vite.plugins, ...(exportInst?.vite.plugins ?? []), (0, _vitepressPluginAltDocsVersioning.VersioningPlugin)({
         distroName: options.distroName,
         allDistros: options.allDistros,
         sections: options.sections

package/dist/config/shared.mjs

@@ -5,6 +5,7 @@ import markdownItKbd from "markdown-it-kbd";
 import { VersioningPlugin } from "@ampernic/vitepress-plugin-alt-docs-versioning";
 import { htmlImagePlugin } from "@ampernic/vitepress-plugin-html-image";
 import { PagefindPlugin } from "@ampernic/vitepress-plugin-pagefind";
+import { ExportPlugin } from "@ampernic/vitepress-plugin-export";
 export function createSharedConfig(options) {
   const base = process.env.VITE_BASE ?? "/";
   const pagefind = PagefindPlugin({
@@ -14,8 +15,13 @@ export function createSharedConfig(options) {
       return m ? { version: m[1] } : null;
     }
   });
+  const exportInst = options.export ? ExportPlugin(options.export) : null;
   return defineConfigWithTheme({
     ...pagefind,
+    buildEnd: async () => {
+      await pagefind.buildEnd();
+      await exportInst?.buildEnd();
+    },
     vue: {
       template: {
         transformAssetUrls: {
@@ -50,6 +56,7 @@ export function createSharedConfig(options) {
       },
       plugins: [
         ...pagefind.vite.plugins,
+        ...exportInst?.vite.plugins ?? [],
         VersioningPlugin({
           distroName: options.distroName,
           allDistros: options.allDistros,

package/dist/index.mjs

@@ -18,6 +18,7 @@ import ADProductsSidebar from "./components/ADProductsSidebar.vue";
 import ADInlineImage from "./components/ADInlineImage.vue";
 import ADAssetLink from "./components/ADAssetLink.vue";
 import ADNavBarSearch from "./components/ADNavBarSearch.vue";
+import ADExportButton from "./components/ADExportButton.vue";
 import "./styles/theme.css";
 import "./styles/custom.css";
 import "./styles/icons.css";
@@ -27,7 +28,8 @@ export const Theme = {
     "nav-bar-content-before": () => h(ADNavBarSearch),
     "nav-bar-content-after": () => h(NolebaseEnhancedReadabilitiesMenu),
     "nav-screen-content-after": () => h(NolebaseEnhancedReadabilitiesScreenMenu),
-    "sidebar-nav-before": () => h(ADProductsSidebar)
+    "sidebar-nav-before": () => h(ADProductsSidebar),
+    "sidebar-nav-after": () => h(ADExportButton)
   }),
   enhanceApp({ app, router, siteData }) {
     installCrossSiteRouter(router, siteData);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampernic/vitepress-theme-alt-docs",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Shared VitePress theme for ALT Linux documentation",
   "license": "GPL-3.0-or-later",
   "author": "Ampernic",
@@ -34,8 +34,9 @@
     "markdown-it-kbd": "^1.0.0",
     "vitepress-plugin-tabs": "^0.6.0",
     "@ampernic/vitepress-plugin-cross-site-router": "0.1.2",
+    "@ampernic/vitepress-plugin-export": "0.1.0",
     "@ampernic/vitepress-plugin-html-image": "0.1.2",
-    "@ampernic/vitepress-plugin-alt-docs-versioning": "0.1.4",
+    "@ampernic/vitepress-plugin-alt-docs-versioning": "0.1.5",
     "@ampernic/vitepress-plugin-pagefind": "0.1.8"
   },
   "devDependencies": {