mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-06-15 04:47:00 +00:00
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.
This commit is contained in:
293
web/app/[locale]/docs/network/page.tsx
Normal file
293
web/app/[locale]/docs/network/page.tsx
Normal file
@@ -0,0 +1,293 @@
|
||||
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,
|
||||
Activity,
|
||||
LineChart,
|
||||
Wrench,
|
||||
ListChecks,
|
||||
Tag,
|
||||
Archive,
|
||||
ShieldCheck,
|
||||
ShieldAlert,
|
||||
Eye,
|
||||
} 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.network.meta" })
|
||||
return {
|
||||
title: t("title"),
|
||||
description: t("description"),
|
||||
keywords: [
|
||||
"proxmox network management",
|
||||
"proxmox bridge configuration",
|
||||
"proxmox bond",
|
||||
"proxmox vlan",
|
||||
"proxmox network repair",
|
||||
"proxmox /etc/network/interfaces",
|
||||
"proxmox network diagnostics",
|
||||
"proxmox persistent interface names",
|
||||
"proxmox network backup",
|
||||
],
|
||||
alternates: { canonical: "https://proxmenux.com/docs/network" },
|
||||
openGraph: {
|
||||
title: t("ogTitle"),
|
||||
description: t("ogDescription"),
|
||||
type: "article",
|
||||
url: "https://proxmenux.com/docs/network",
|
||||
},
|
||||
twitter: {
|
||||
card: "summary",
|
||||
title: t("twitterTitle"),
|
||||
description: t("twitterDescription"),
|
||||
},
|
||||
}
|
||||
}
|
||||
|
||||
type SectionOption = { title: string; description: string }
|
||||
|
||||
const READ_ONLY_CONFIG = [
|
||||
{ Icon: Activity, href: "/docs/network/diagnostics" },
|
||||
{ Icon: LineChart, href: "/docs/network/monitoring" },
|
||||
]
|
||||
const ANALYZE_CONFIG = [
|
||||
{ Icon: Wrench, href: "/docs/network/bridge-analysis" },
|
||||
{ Icon: ListChecks, href: "/docs/network/config-analysis" },
|
||||
]
|
||||
const APPLY_CONFIG = [
|
||||
{ Icon: Tag, href: "/docs/network/persistent-names" },
|
||||
{ Icon: Archive, href: "/docs/network/backup-restore" },
|
||||
]
|
||||
|
||||
function OptionCard({
|
||||
title,
|
||||
description,
|
||||
Icon,
|
||||
href,
|
||||
}: SectionOption & {
|
||||
Icon: React.ComponentType<{ className?: string; "aria-hidden"?: boolean }>
|
||||
href: string
|
||||
}) {
|
||||
return (
|
||||
<Link
|
||||
href={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">
|
||||
{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">{description}</div>
|
||||
</div>
|
||||
</Link>
|
||||
)
|
||||
}
|
||||
|
||||
export default async function NetworkOverviewPage({
|
||||
params,
|
||||
}: {
|
||||
params: Promise<{ locale: string }>
|
||||
}) {
|
||||
const { locale } = await params
|
||||
setRequestLocale(locale)
|
||||
const t = await getTranslations({ locale, namespace: "docs.network" })
|
||||
|
||||
const messages = (await getMessages({ locale })) as unknown as {
|
||||
docs: { network: {
|
||||
tiers: {
|
||||
readOnly: { items: string[] }
|
||||
analyze: { items: string[] }
|
||||
apply: { items: string[] }
|
||||
}
|
||||
readOnlySection: { options: SectionOption[] }
|
||||
analyzeSection: { options: SectionOption[] }
|
||||
applySection: { options: SectionOption[] }
|
||||
} }
|
||||
}
|
||||
const readOnlyTierItems = messages.docs.network.tiers.readOnly.items
|
||||
const analyzeTierItems = messages.docs.network.tiers.analyze.items
|
||||
const applyTierItems = messages.docs.network.tiers.apply.items
|
||||
const readOnlyOptions = messages.docs.network.readOnlySection.options
|
||||
const analyzeOptions = messages.docs.network.analyzeSection.options
|
||||
const applyOptions = messages.docs.network.applySection.options
|
||||
|
||||
const code = (chunks: React.ReactNode) => <code>{chunks}</code>
|
||||
const strong = (chunks: React.ReactNode) => <strong>{chunks}</strong>
|
||||
const em = (chunks: React.ReactNode) => <em>{chunks}</em>
|
||||
|
||||
return (
|
||||
<div>
|
||||
<DocHeader
|
||||
title={t("header.title")}
|
||||
description={t("header.description")}
|
||||
section={t("header.section")}
|
||||
estimatedMinutes={5}
|
||||
scriptPath="menus/network_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("openingMenu.heading")}</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">
|
||||
{t.rich("openingMenu.intro", { strong })}
|
||||
</p>
|
||||
|
||||
<Image
|
||||
src="/network/network-menu.png"
|
||||
alt={t("openingMenu.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("safety.heading")}</h2>
|
||||
<p className="mb-6 text-gray-800 leading-relaxed">{t("safety.body")}</p>
|
||||
|
||||
<div className="grid gap-4 md:grid-cols-1 lg:grid-cols-3 mb-8 not-prose">
|
||||
<a
|
||||
href="#read-only"
|
||||
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">
|
||||
<Eye className="h-5 w-5" aria-hidden />
|
||||
</span>
|
||||
<h3 className="text-lg font-semibold text-gray-900 m-0">{t("tiers.readOnly.title")}</h3>
|
||||
</div>
|
||||
<p className="text-sm text-gray-800 mb-3">{t("tiers.readOnly.body")}</p>
|
||||
<ul className="space-y-1 text-sm text-gray-700 list-disc pl-5 mb-0 marker:text-gray-400">
|
||||
{readOnlyTierItems.map((item, idx) => (
|
||||
<li key={idx}>{item}</li>
|
||||
))}
|
||||
</ul>
|
||||
</a>
|
||||
|
||||
<a
|
||||
href="#analyze"
|
||||
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">
|
||||
<ShieldAlert className="h-5 w-5" aria-hidden />
|
||||
</span>
|
||||
<h3 className="text-lg font-semibold text-gray-900 m-0">{t("tiers.analyze.title")}</h3>
|
||||
</div>
|
||||
<p className="text-sm text-gray-800 mb-3">{t("tiers.analyze.body")}</p>
|
||||
<ul className="space-y-1 text-sm text-gray-700 list-disc pl-5 mb-0 marker:text-gray-400">
|
||||
{analyzeTierItems.map((item, idx) => (
|
||||
<li key={idx}>{item}</li>
|
||||
))}
|
||||
</ul>
|
||||
</a>
|
||||
|
||||
<a
|
||||
href="#apply"
|
||||
className="rounded-lg border-2 border-red-300 bg-red-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-red-100 text-red-700">
|
||||
<ShieldCheck className="h-5 w-5" aria-hidden />
|
||||
</span>
|
||||
<h3 className="text-lg font-semibold text-gray-900 m-0">{t("tiers.apply.title")}</h3>
|
||||
</div>
|
||||
<p className="text-sm text-gray-800 mb-3">{t("tiers.apply.body")}</p>
|
||||
<ul className="space-y-1 text-sm text-gray-700 list-disc pl-5 mb-0 marker:text-gray-400">
|
||||
{applyTierItems.map((item, idx) => (
|
||||
<li key={idx}>{item}</li>
|
||||
))}
|
||||
</ul>
|
||||
</a>
|
||||
</div>
|
||||
|
||||
<Callout variant="warning" title={t("classicTitle")}>
|
||||
{t.rich("classicBody", { strong, code })}
|
||||
</Callout>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("backups.heading")}</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">
|
||||
{t.rich("backups.intro", { code })}
|
||||
</p>
|
||||
<pre className="rounded-md bg-gray-100 p-4 overflow-x-auto text-xs font-mono text-gray-800 leading-relaxed border border-gray-200">{`/var/backups/proxmenux/
|
||||
├── interfaces_backup_2026-04-26_14-30-12
|
||||
├── interfaces_backup_2026-04-26_15-08-44
|
||||
└── interfaces_backup_2026-04-26_18-22-09`}</pre>
|
||||
<p className="mt-4 mb-4 text-gray-800 leading-relaxed">{t("backups.rollbackIntro")}</p>
|
||||
<pre className="rounded-md bg-gray-100 p-4 overflow-x-auto text-xs font-mono text-gray-800 leading-relaxed border border-gray-200">{`cp /var/backups/proxmenux/interfaces_backup_<TIMESTAMP> /etc/network/interfaces
|
||||
systemctl restart networking`}</pre>
|
||||
|
||||
<h2 id="read-only" className="text-2xl font-semibold mt-10 mb-4 text-gray-900 scroll-mt-24">
|
||||
{t("readOnlySection.heading")}
|
||||
</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">
|
||||
{t.rich("readOnlySection.body", { code })}
|
||||
</p>
|
||||
<div className="grid gap-3 md:grid-cols-2 mb-8 not-prose">
|
||||
{readOnlyOptions.map((o, idx) => (
|
||||
<OptionCard
|
||||
key={READ_ONLY_CONFIG[idx].href}
|
||||
title={o.title}
|
||||
description={o.description}
|
||||
Icon={READ_ONLY_CONFIG[idx].Icon}
|
||||
href={READ_ONLY_CONFIG[idx].href}
|
||||
/>
|
||||
))}
|
||||
</div>
|
||||
|
||||
<h2 id="analyze" className="text-2xl font-semibold mt-10 mb-4 text-gray-900 scroll-mt-24">
|
||||
{t("analyzeSection.heading")}
|
||||
</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">
|
||||
{t.rich("analyzeSection.body", { code, strong })}
|
||||
</p>
|
||||
<div className="grid gap-3 md:grid-cols-2 mb-8 not-prose">
|
||||
{analyzeOptions.map((o, idx) => (
|
||||
<OptionCard
|
||||
key={ANALYZE_CONFIG[idx].href}
|
||||
title={o.title}
|
||||
description={o.description}
|
||||
Icon={ANALYZE_CONFIG[idx].Icon}
|
||||
href={ANALYZE_CONFIG[idx].href}
|
||||
/>
|
||||
))}
|
||||
</div>
|
||||
|
||||
<h2 id="apply" className="text-2xl font-semibold mt-10 mb-4 text-gray-900 scroll-mt-24">
|
||||
{t("applySection.heading")}
|
||||
</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">
|
||||
{t.rich("applySection.body", { em })}
|
||||
</p>
|
||||
<div className="grid gap-3 md:grid-cols-2 mb-8 not-prose">
|
||||
{applyOptions.map((o, idx) => (
|
||||
<OptionCard
|
||||
key={APPLY_CONFIG[idx].href}
|
||||
title={o.title}
|
||||
description={o.description}
|
||||
Icon={APPLY_CONFIG[idx].Icon}
|
||||
href={APPLY_CONFIG[idx].href}
|
||||
/>
|
||||
))}
|
||||
</div>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("consoleTitle")}</h2>
|
||||
<Callout variant="danger" title={t("consoleSubTitle")}>
|
||||
{t("consoleBody")}
|
||||
</Callout>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
Reference in New Issue
Block a user