@ampernic/vitepress-theme-alt-docs 0.1.15 → 0.1.18

package/dist/components/ADExportButton.vue

@@ -0,0 +1,228 @@
+<template>
+  <div v-if="exports.length > 0" class="ad-export" ref="rootRef">
+    <p class="ad-export-label">Скачать документацию</p>
+    <div class="ad-export-dropdown">
+      <button
+        class="ad-export-trigger"
+        :class="{ 'is-open': isOpen }"
+        @click="isOpen = !isOpen"
+        :aria-expanded="isOpen"
+      >
+        <svg class="ad-export-dl-icon" xmlns="http://www.w3.org/2000/svg" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round">
+          <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/>
+          <polyline points="7 10 12 15 17 10"/>
+          <line x1="12" y1="15" x2="12" y2="3"/>
+        </svg>
+        Скачать
+        <svg class="ad-export-chevron" xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+          <polyline points="6 9 12 15 18 9"/>
+        </svg>
+      </button>
+
+      <Transition name="ad-dropdown">
+        <div v-show="isOpen" class="ad-export-menu">
+          <a
+            v-for="item in exports"
+            :key="item.format"
+            :href="item.url"
+            :download="item.filename"
+            :title="item.title"
+            class="ad-export-option"
+            @click="isOpen = false"
+          >
+            <span class="ad-export-option-icon" v-html="item.icon" />
+            <span>{{ item.label }}</span>
+          </a>
+        </div>
+      </Transition>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, ref, onMounted, onBeforeUnmount } from 'vue'
+import { useData, useRoute } from 'vitepress'
+
+const { site } = useData()
+const route = useRoute()
+
+interface ExportItem { format: string; url: string; filename: string; label: string; title: string; icon: string }
+
+const manifest = ref<Record<string, { pdf?: string; epub?: string; html?: string }> | null>(null)
+// Base prefix that actually served the manifest — may differ from site.base in vitepress preview
+const resolvedBase = ref('')
+const isOpen = ref(false)
+const rootRef = ref<HTMLElement | null>(null)
+
+onMounted(async () => {
+  try {
+    const base = site.value.base.replace(/\/$/, '')
+    let res = await fetch(`${base}/export-manifest.json`)
+    if (res.ok) {
+      resolvedBase.value = base
+    } else if (base) {
+      // vitepress preview strips base from file paths — try without prefix
+      res = await fetch('/export-manifest.json')
+      if (res.ok) resolvedBase.value = ''
+    }
+    if (res.ok) {
+      const data = await res.json()
+      manifest.value = data.versions ?? null
+    }
+  } catch { /* manifest absent — silent */ }
+
+  document.addEventListener('click', onClickOutside)
+})
+
+onBeforeUnmount(() => {
+  document.removeEventListener('click', onClickOutside)
+})
+
+function onClickOutside(e: MouseEvent) {
+  if (rootRef.value && !rootRef.value.contains(e.target as Node)) {
+    isOpen.value = false
+  }
+}
+
+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 items: ExportItem[] = []
+
+  if (vEntry.pdf) {
+    items.push({
+      format: 'pdf',
+      url: `${resolvedBase.value}/${vEntry.pdf}`,
+      filename: 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-dropdown {
+  position: relative;
+  display: block;
+  width: 100%;
+}
+
+.ad-export-trigger {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 5px;
+  padding: 0 12px;
+  width: 100%;
+  height: 34px;
+  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: 4px;
+  cursor: pointer;
+  transition: border-color 0.25s, background-color 0.25s, color 0.25s;
+  white-space: nowrap;
+  user-select: none;
+}
+
+.ad-export-trigger:hover,
+.ad-export-trigger.is-open {
+  background: var(--vp-c-default-soft);
+  border-color: var(--vp-c-brand-1);
+  color: var(--vp-c-brand-1);
+}
+
+.ad-export-dl-icon {
+  flex-shrink: 0;
+}
+
+.ad-export-chevron {
+  flex-shrink: 0;
+  transition: transform 0.2s;
+}
+
+.ad-export-trigger.is-open .ad-export-chevron {
+  transform: rotate(180deg);
+}
+
+.ad-export-menu {
+  position: absolute;
+  top: calc(100% + 6px);
+  left: 0;
+  right: 0;
+  z-index: 100;
+  min-width: 130px;
+  background: var(--vp-c-bg-elv);
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 8px;
+  box-shadow: var(--vp-shadow-3);
+  overflow: hidden;
+  padding: 4px;
+}
+
+.ad-export-option {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 6px 10px;
+  font-size: 13px;
+  font-weight: 500;
+  color: var(--vp-c-text-1);
+  border-radius: 5px;
+  text-decoration: none;
+  transition: background-color 0.15s, color 0.15s;
+}
+
+.ad-export-option:hover {
+  background: var(--vp-c-default-soft);
+  color: var(--vp-c-brand-1);
+}
+
+.ad-export-option-icon {
+  display: flex;
+  align-items: center;
+  flex-shrink: 0;
+}
+
+.ad-dropdown-enter-active,
+.ad-dropdown-leave-active {
+  transition: opacity 0.15s ease, transform 0.15s ease;
+}
+
+.ad-dropdown-enter-from,
+.ad-dropdown-leave-to {
+  opacity: 0;
+  transform: translateY(-4px);
+}
+</style>

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: {
@@ -45,9 +51,9 @@ function createSharedConfig(options) {
         exclude: ["@nolebase/vitepress-plugin-enhanced-readabilities/client", "vitepress", "@nolebase/ui", "@ampernic/vitepress-theme-alt-docs"]
       },
       ssr: {
-        noExternal: ["@nolebase/vitepress-plugin-enhanced-readabilities", "@nolebase/ui", "@ampernic/vitepress-plugin-alt-docs-versioning", "@ampernic/vitepress-theme-alt-docs"]
+        noExternal: ["@nolebase/vitepress-plugin-enhanced-readabilities", "@nolebase/ui", "@ampernic/vitepress-plugin-alt-docs-versioning", "@ampernic/vitepress-theme-alt-docs", "@ampernic/vitepress-plugin-export"]
       },
-      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: {
@@ -45,11 +51,13 @@ export function createSharedConfig(options) {
           "@nolebase/vitepress-plugin-enhanced-readabilities",
           "@nolebase/ui",
           "@ampernic/vitepress-plugin-alt-docs-versioning",
-          "@ampernic/vitepress-theme-alt-docs"
+          "@ampernic/vitepress-theme-alt-docs",
+          "@ampernic/vitepress-plugin-export"
         ]
       },
       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 ExportButton from "@ampernic/vitepress-plugin-export/components/ExportButton.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),
+    "aside-outline-after": () => h(ExportButton)
   }),
   enhanceApp({ app, router, siteData }) {
     installCrossSiteRouter(router, siteData);

package/dist/styles/print.css

@@ -10,10 +10,10 @@
   .VPSidebar,
   .VPSocialLink,
   .vp-sponsor,
-  
+
   .products-menu,
   .versioning-menu,
-  
+
   .VPDoc .aside,
   .VPDoc .aside-container {
     display: none !important;
@@ -33,4 +33,22 @@
     display: block !important;
     visibility: visible !important;
   }
+
+  /* Keep blocks and elements from splitting across pages */
+  .custom-block,
+  .custom-block-title + p,
+  pre,
+  blockquote,
+  figure,
+  table,
+  img {
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  /* Keep heading with its following content */
+  h1, h2, h3, h4, h5, h6 {
+    break-after: avoid;
+    page-break-after: avoid;
+  }
 }

package/package.json

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