Files
ProxMenux/web/app/[locale]/docs/disk-manager/page.tsx
T
MacRimi 5ca3463bf6 complete i18n migration to /[locale]/ with EN+ES content
Full rewrite of the docs site under app/[locale]/ with next-intl
in localePrefix:"always" mode. Every page now exists at both
/en/<path> and /es/<path>; the root / shows a meta-refresh + JS
redirect to /<defaultLocale>/ so GitHub Pages serves something
on the apex URL.

Highlights:
- 107 doc pages migrated to file-per-page JSON namespaces under
  messages/en/ and messages/es/. Spanish content is fully
  translated (no copy-of-English placeholders).
- New documentation for the Active Suppressions section in the
  Settings tab and the per-event Dismiss dropdown in the Health
  Monitor modal.
- New screenshots: dismiss-duration-dropdown.png and an updated
  health-suppression-settings.png.
- Pagefind integrated for client-side search; index is built on
  every CI deploy (not committed).
- RSS feeds: per-locale at /<locale>/rss.xml plus root /rss.xml
  for backward compat.
- Removed the dead app/[locale]/guides/[slug]/ route — every
  guide now has its own static page and no markdown source
  remains.
- Fixed orphan link /guides/nvidia -> /guides/nvidia-manual in
  docs/hardware/nvidia-host.
- Removed obsolete components (footer2, calendar, drawer).

Verified locally with `npm ci && npm run build`: 2804 files in
out/, 231 pages indexed by pagefind, root redirect intact, both
locale roots and the new Active Suppressions docs render OK.
2026-05-31 12:41:10 +02:00

233 lines
9.1 KiB
TypeScript

import type { Metadata } from "next"
import { getTranslations, getMessages, setRequestLocale } from "next-intl/server"
import { Link } from "@/i18n/navigation"
import Image from "next/image"
import { ArrowRight, HardDrive, FileDown, Cpu, Boxes, Eraser, Activity, Server, Wrench } from "lucide-react"
import { DocHeader } from "@/components/ui/doc-header"
import { Callout } from "@/components/ui/callout"
export async function generateMetadata({
params,
}: {
params: Promise<{ locale: string }>
}): Promise<Metadata> {
const { locale } = await params
const t = await getTranslations({ locale, namespace: "docs.diskManager.meta" })
return {
title: t("title"),
description: t("description"),
keywords: [
"proxmox disk passthrough",
"proxmox attach disk to vm",
"proxmox import disk",
"proxmox qm importdisk",
"proxmox lxc bind mount disk",
"proxmox smart test",
"proxmox wipe disk",
"proxmox hba passthrough",
"proxmox nvme passthrough",
"qm set scsi",
],
alternates: { canonical: "https://proxmenux.com/docs/disk-manager" },
openGraph: {
title: t("ogTitle"),
description: t("ogDescription"),
type: "article",
url: "https://proxmenux.com/docs/disk-manager",
},
twitter: {
card: "summary",
title: t("twitterTitle"),
description: t("twitterDescription"),
},
}
}
type DiskOption = { icon: string; href: string; title: string; description: string }
type StringItem = string
type RelatedItem = { href: string; label: string; tail?: string }
const ICONS: Record<string, React.ComponentType<{ className?: string; "aria-hidden"?: boolean }>> = {
HardDrive,
FileDown,
Cpu,
Boxes,
Eraser,
Activity,
}
function DiskOptionCard({ option }: { option: DiskOption }) {
const Icon = ICONS[option.icon] || HardDrive
return (
<Link
href={option.href}
className="group flex items-start gap-3 rounded-md border border-gray-200 bg-white p-3 transition-colors hover:border-blue-400 hover:bg-blue-50"
>
<span className="inline-flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-md bg-gray-100 text-gray-600 group-hover:bg-blue-100 group-hover:text-blue-700">
<Icon className="h-4 w-4" aria-hidden />
</span>
<div className="min-w-0 flex-1">
<div className="flex items-center gap-1 text-sm font-medium text-gray-900 group-hover:text-blue-700">
{option.title}
<ArrowRight className="h-3.5 w-3.5 text-gray-400 group-hover:text-blue-600 transition-transform group-hover:translate-x-0.5" />
</div>
<div className="mt-0.5 text-xs text-gray-600 leading-snug">{option.description}</div>
</div>
</Link>
)
}
export default async function DiskManagerOverviewPage({
params,
}: {
params: Promise<{ locale: string }>
}) {
const { locale } = await params
setRequestLocale(locale)
const t = await getTranslations({ locale, namespace: "docs.diskManager" })
const messages = (await getMessages({ locale })) as unknown as {
docs: { diskManager: {
groups: { vmItems: StringItem[]; lxcItems: StringItem[]; utilitiesItems: StringItem[] }
vm: { options: DiskOption[] }
lxc: { options: DiskOption[] }
utilities: { options: DiskOption[] }
safety: { items: StringItem[] }
related: { items: RelatedItem[] }
} }
}
const vmItems = messages.docs.diskManager.groups.vmItems
const lxcItems = messages.docs.diskManager.groups.lxcItems
const utilitiesItems = messages.docs.diskManager.groups.utilitiesItems
const vmOptions = messages.docs.diskManager.vm.options
const lxcOptions = messages.docs.diskManager.lxc.options
const utilityOptions = messages.docs.diskManager.utilities.options
const safetyItems = messages.docs.diskManager.safety.items
const relatedItems = messages.docs.diskManager.related.items
const strong = (chunks: React.ReactNode) => <strong>{chunks}</strong>
return (
<div>
<DocHeader
title={t("header.title")}
description={t("header.description")}
section={t("header.section")}
estimatedMinutes={3}
scriptPath="menus/storage_menu.sh"
/>
<Callout variant="info" title={t("intro.title")}>
{t.rich("intro.body", { strong })}
</Callout>
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("opening.heading")}</h2>
<p className="mb-4 text-gray-800 leading-relaxed">
{t.rich("opening.body", { strong })}
</p>
<Image
src="/disk/disk-manager-menu.png"
alt={t("opening.imageAlt")}
width={900}
height={500}
className="rounded shadow-lg my-6"
/>
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("groups.heading")}</h2>
<p className="mb-6 text-gray-800 leading-relaxed">
{t.rich("groups.intro", { strong })}
</p>
<div className="grid gap-4 md:grid-cols-1 lg:grid-cols-3 mb-8 not-prose">
<a
href="#vm"
className="rounded-lg border-2 border-blue-300 bg-blue-50 p-5 flex flex-col transition-shadow hover:shadow-md"
>
<div className="flex items-center gap-3 mb-3">
<span className="inline-flex h-9 w-9 items-center justify-center rounded-full bg-blue-100 text-blue-700">
<Server className="h-5 w-5" aria-hidden />
</span>
<h3 className="text-lg font-semibold text-gray-900 m-0">{t("groups.vmTitle")}</h3>
</div>
<p className="text-sm text-gray-800 mb-3">{t("groups.vmBody")}</p>
<ul className="space-y-1 text-sm text-gray-700 list-disc pl-5 mb-0 marker:text-gray-400">
{vmItems.map((item, i) => <li key={i}>{item}</li>)}
</ul>
</a>
<a
href="#lxc"
className="rounded-lg border-2 border-emerald-300 bg-emerald-50 p-5 flex flex-col transition-shadow hover:shadow-md"
>
<div className="flex items-center gap-3 mb-3">
<span className="inline-flex h-9 w-9 items-center justify-center rounded-full bg-emerald-100 text-emerald-700">
<Boxes className="h-5 w-5" aria-hidden />
</span>
<h3 className="text-lg font-semibold text-gray-900 m-0">{t("groups.lxcTitle")}</h3>
</div>
<p className="text-sm text-gray-800 mb-3">{t("groups.lxcBody")}</p>
<ul className="space-y-1 text-sm text-gray-700 list-disc pl-5 mb-0 marker:text-gray-400">
{lxcItems.map((item, i) => <li key={i}>{item}</li>)}
</ul>
</a>
<a
href="#utilities"
className="rounded-lg border-2 border-amber-300 bg-amber-50 p-5 flex flex-col transition-shadow hover:shadow-md"
>
<div className="flex items-center gap-3 mb-3">
<span className="inline-flex h-9 w-9 items-center justify-center rounded-full bg-amber-100 text-amber-700">
<Wrench className="h-5 w-5" aria-hidden />
</span>
<h3 className="text-lg font-semibold text-gray-900 m-0">{t("groups.utilitiesTitle")}</h3>
</div>
<p className="text-sm text-gray-800 mb-3">{t("groups.utilitiesBody")}</p>
<ul className="space-y-1 text-sm text-gray-700 list-disc pl-5 mb-0 marker:text-gray-400">
{utilitiesItems.map((item, i) => <li key={i}>{item}</li>)}
</ul>
</a>
</div>
<h2 id="vm" className="text-2xl font-semibold mt-10 mb-4 text-gray-900 scroll-mt-24">{t("vm.heading")}</h2>
<p className="mb-4 text-gray-800 leading-relaxed">{t("vm.intro")}</p>
<div className="grid gap-3 md:grid-cols-2 mb-8 not-prose">
{vmOptions.map((o) => <DiskOptionCard key={o.href} option={o} />)}
</div>
<h2 id="lxc" className="text-2xl font-semibold mt-10 mb-4 text-gray-900 scroll-mt-24">{t("lxc.heading")}</h2>
<p className="mb-4 text-gray-800 leading-relaxed">{t("lxc.intro")}</p>
<div className="grid gap-3 md:grid-cols-2 mb-8 not-prose">
{lxcOptions.map((o) => <DiskOptionCard key={o.href} option={o} />)}
</div>
<h2 id="utilities" className="text-2xl font-semibold mt-10 mb-4 text-gray-900 scroll-mt-24">{t("utilities.heading")}</h2>
<p className="mb-4 text-gray-800 leading-relaxed">{t("utilities.intro")}</p>
<div className="grid gap-3 md:grid-cols-2 mb-8 not-prose">
{utilityOptions.map((o) => <DiskOptionCard key={o.href} option={o} />)}
</div>
<Callout variant="warning" title={t("safety.title")}>
{t("safety.intro")}
<ul className="mt-3 list-disc list-inside space-y-1">
{safetyItems.map((_, idx) => (
<li key={idx}>{t.rich(`safety.items.${idx}`, { strong })}</li>
))}
</ul>
</Callout>
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("related.heading")}</h2>
<ul className="list-disc pl-6 text-gray-800 leading-relaxed space-y-1">
{relatedItems.map((item) => (
<li key={item.href}>
<Link href={item.href} className="text-blue-600 hover:underline">
{item.label}
</Link>
{item.tail}
</li>
))}
</ul>
</div>
)
}