mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-06-14 04:17:00 +00:00
5ca3463bf6
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.
310 lines
11 KiB
TypeScript
310 lines
11 KiB
TypeScript
import type { Metadata } from "next"
|
|
import { Link } from "@/i18n/navigation"
|
|
import { getTranslations, getMessages, setRequestLocale } from "next-intl/server"
|
|
import {
|
|
Play,
|
|
MessageCircle,
|
|
Users,
|
|
Book,
|
|
Database,
|
|
Code,
|
|
BookOpen,
|
|
Library,
|
|
Star,
|
|
Sparkles,
|
|
ExternalLink,
|
|
} from "lucide-react"
|
|
import Footer from "@/components/footer"
|
|
|
|
export async function generateMetadata({
|
|
params,
|
|
}: {
|
|
params: Promise<{ locale: string }>
|
|
}): Promise<Metadata> {
|
|
const { locale } = await params
|
|
const t = await getTranslations({ locale, namespace: "guides.meta" })
|
|
return {
|
|
title: t("title"),
|
|
description: t("description"),
|
|
keywords: [
|
|
"proxmox guides",
|
|
"proxmox tutorials",
|
|
"proxmox kodi lxc",
|
|
"proxmox nvidia driver",
|
|
"proxmox samba lxc",
|
|
"proxmox cloud backup",
|
|
"proxmox vzdump rclone",
|
|
"proxmox coral tpu",
|
|
"proxmox gpu lxc",
|
|
"proxmox ve 9 guides",
|
|
],
|
|
alternates: { canonical: "https://proxmenux.com/guides" },
|
|
openGraph: {
|
|
title: t("ogTitle"),
|
|
description: t("ogDescription"),
|
|
type: "website",
|
|
url: "https://proxmenux.com/guides",
|
|
siteName: "ProxMenux",
|
|
images: [
|
|
{
|
|
url: "https://raw.githubusercontent.com/MacRimi/ProxMenux/main/web/public/main.png",
|
|
width: 1363,
|
|
height: 735,
|
|
alt: t("ogImageAlt"),
|
|
},
|
|
],
|
|
},
|
|
twitter: {
|
|
card: "summary_large_image",
|
|
title: t("twitterTitle"),
|
|
description: t("twitterDescription"),
|
|
images: [
|
|
"https://raw.githubusercontent.com/MacRimi/ProxMenux/main/web/public/main.png",
|
|
],
|
|
},
|
|
}
|
|
}
|
|
|
|
interface Guide {
|
|
title: string
|
|
description: string
|
|
slug: string
|
|
}
|
|
|
|
interface ExternalCardProps {
|
|
href: string
|
|
title: string
|
|
description: string
|
|
Icon: React.ComponentType<{ className?: string }>
|
|
color: string // tailwind bg + hover classes
|
|
external?: boolean
|
|
}
|
|
|
|
function CardLink({ href, title, description, Icon, color, external = true }: ExternalCardProps) {
|
|
const Inner = (
|
|
<div className={`block p-6 rounded-lg shadow-md transition-colors h-full ${color}`}>
|
|
<div className="flex items-center gap-3 mb-2">
|
|
<Icon className="h-6 w-6 text-white flex-shrink-0" />
|
|
<h3 className="text-xl font-semibold text-white m-0">{title}</h3>
|
|
</div>
|
|
<p className="text-gray-200 text-sm m-0">{description}</p>
|
|
</div>
|
|
)
|
|
|
|
if (external) {
|
|
return (
|
|
<a href={href} target="_blank" rel="noopener noreferrer" className="block h-full">
|
|
{Inner}
|
|
</a>
|
|
)
|
|
}
|
|
return (
|
|
<Link href={href} className="block h-full">
|
|
{Inner}
|
|
</Link>
|
|
)
|
|
}
|
|
|
|
export default async function GuidesPage({
|
|
params,
|
|
}: {
|
|
params: Promise<{ locale: string }>
|
|
}) {
|
|
const { locale } = await params
|
|
setRequestLocale(locale)
|
|
const t = await getTranslations({ locale, namespace: "guides" })
|
|
|
|
const messages = (await getMessages({ locale })) as unknown as {
|
|
guides: { inDepth: { items: Guide[] } }
|
|
}
|
|
const guides = messages.guides.inDepth.items
|
|
|
|
const link = (chunks: React.ReactNode) => (
|
|
<a
|
|
href="https://github.com/MacRimi/ProxMenux/issues"
|
|
target="_blank"
|
|
rel="noopener noreferrer"
|
|
className="text-blue-400 hover:underline inline-flex items-center gap-1"
|
|
>
|
|
{chunks}
|
|
<ExternalLink className="w-3 h-3" />
|
|
</a>
|
|
)
|
|
|
|
return (
|
|
<div className="min-h-screen bg-gradient-to-b from-gray-900 to-gray-800 text-white pt-16 flex flex-col">
|
|
<div className="flex-grow container mx-auto px-4 pt-6 pb-16">
|
|
<div className="mb-10">
|
|
<h1 className="text-4xl font-bold mb-3">{t("header.title")}</h1>
|
|
<p className="text-xl text-gray-200 max-w-3xl">{t("header.tagline")}</p>
|
|
</div>
|
|
|
|
{/* ─────────────────────────── In-depth guides ─────────────────────────── */}
|
|
<section className="mb-16">
|
|
<div className="flex items-center gap-2 mb-6">
|
|
<BookOpen className="h-7 w-7 text-blue-400" />
|
|
<h2 className="text-3xl font-bold m-0">{t("inDepth.heading")}</h2>
|
|
</div>
|
|
<p className="text-gray-300 mb-6 max-w-3xl">{t("inDepth.intro")}</p>
|
|
<div className="grid md:grid-cols-2 gap-6">
|
|
{guides.map((guide) => (
|
|
<Link
|
|
key={guide.slug}
|
|
href={`/guides/${guide.slug}`}
|
|
className="block p-6 bg-white rounded-lg shadow-md hover:shadow-lg transition-shadow"
|
|
>
|
|
<h3 className="text-xl font-semibold mb-2 text-gray-900 m-0">{guide.title}</h3>
|
|
<p className="text-sm text-gray-600 mt-2 mb-0">{guide.description}</p>
|
|
</Link>
|
|
))}
|
|
</div>
|
|
</section>
|
|
|
|
{/* ─────────────────────────── ProxMenux references ─────────────────────────── */}
|
|
<section className="mb-16">
|
|
<div className="flex items-center gap-2 mb-6">
|
|
<Library className="h-7 w-7 text-emerald-400" />
|
|
<h2 className="text-3xl font-bold m-0">{t("references.heading")}</h2>
|
|
</div>
|
|
<p className="text-gray-300 mb-6 max-w-3xl">{t("references.intro")}</p>
|
|
<div className="grid md:grid-cols-2 gap-6">
|
|
<CardLink
|
|
href="/docs/glossary"
|
|
title={t("references.cards.glossary.title")}
|
|
description={t("references.cards.glossary.description")}
|
|
Icon={Sparkles}
|
|
color="bg-emerald-600 hover:bg-emerald-700"
|
|
external={false}
|
|
/>
|
|
<CardLink
|
|
href="/docs/help-info"
|
|
title={t("references.cards.helpInfo.title")}
|
|
description={t("references.cards.helpInfo.description")}
|
|
Icon={Code}
|
|
color="bg-teal-600 hover:bg-teal-700"
|
|
external={false}
|
|
/>
|
|
<CardLink
|
|
href="/guides/linux-resources"
|
|
title={t("references.cards.linuxResources.title")}
|
|
description={t("references.cards.linuxResources.description")}
|
|
Icon={BookOpen}
|
|
color="bg-cyan-600 hover:bg-cyan-700"
|
|
external={false}
|
|
/>
|
|
<CardLink
|
|
href="/docs/external-repositories"
|
|
title={t("references.cards.externalRepos.title")}
|
|
description={t("references.cards.externalRepos.description")}
|
|
Icon={Code}
|
|
color="bg-slate-600 hover:bg-slate-700"
|
|
external={false}
|
|
/>
|
|
</div>
|
|
</section>
|
|
|
|
{/* ─────────────────────────── Official Proxmox resources ─────────────────────────── */}
|
|
<section className="mb-16">
|
|
<div className="flex items-center gap-2 mb-6">
|
|
<Book className="h-7 w-7 text-amber-400" />
|
|
<h2 className="text-3xl font-bold m-0">{t("official.heading")}</h2>
|
|
</div>
|
|
<p className="text-gray-300 mb-6 max-w-3xl">{t("official.intro")}</p>
|
|
<div className="grid md:grid-cols-2 gap-6">
|
|
<CardLink
|
|
href="https://pve.proxmox.com/pve-docs/index.html"
|
|
title={t("official.cards.pveDocs.title")}
|
|
description={t("official.cards.pveDocs.description")}
|
|
Icon={Book}
|
|
color="bg-green-600 hover:bg-green-700"
|
|
/>
|
|
<CardLink
|
|
href="https://pbs.proxmox.com/docs/index.html"
|
|
title={t("official.cards.pbsDocs.title")}
|
|
description={t("official.cards.pbsDocs.description")}
|
|
Icon={Database}
|
|
color="bg-yellow-600 hover:bg-yellow-700"
|
|
/>
|
|
<CardLink
|
|
href="https://www.proxmox.com/en/services/training-courses/videos"
|
|
title={t("official.cards.videoTraining.title")}
|
|
description={t("official.cards.videoTraining.description")}
|
|
Icon={Play}
|
|
color="bg-red-600 hover:bg-red-700"
|
|
/>
|
|
<CardLink
|
|
href="https://forum.proxmox.com/"
|
|
title={t("official.cards.forum.title")}
|
|
description={t("official.cards.forum.description")}
|
|
Icon={MessageCircle}
|
|
color="bg-purple-600 hover:bg-purple-700"
|
|
/>
|
|
</div>
|
|
</section>
|
|
|
|
{/* ─────────────────────────── Community projects & resources ─────────────────────────── */}
|
|
<section className="mb-16">
|
|
<div className="flex items-center gap-2 mb-6">
|
|
<Star className="h-7 w-7 text-pink-400" />
|
|
<h2 className="text-3xl font-bold m-0">{t("community.heading")}</h2>
|
|
</div>
|
|
<p className="text-gray-300 mb-6 max-w-3xl">{t("community.intro")}</p>
|
|
<div className="grid md:grid-cols-2 gap-6">
|
|
<CardLink
|
|
href="https://community-scripts.github.io/ProxmoxVE/"
|
|
title={t("community.cards.helperScripts.title")}
|
|
description={t("community.cards.helperScripts.description")}
|
|
Icon={Code}
|
|
color="bg-indigo-600 hover:bg-indigo-700"
|
|
/>
|
|
<CardLink
|
|
href="https://github.com/Corsinvest/awesome-proxmox-ve"
|
|
title={t("community.cards.awesome.title")}
|
|
description={t("community.cards.awesome.description")}
|
|
Icon={Star}
|
|
color="bg-pink-600 hover:bg-pink-700"
|
|
/>
|
|
</div>
|
|
|
|
<p className="text-sm text-gray-400 mt-6 italic">
|
|
{t.rich("community.suggestRich", { link })}
|
|
</p>
|
|
</section>
|
|
|
|
{/* ─────────────────────────── Discussion ─────────────────────────── */}
|
|
<section className="mb-8">
|
|
<div className="flex items-center gap-2 mb-6">
|
|
<Users className="h-7 w-7 text-orange-400" />
|
|
<h2 className="text-3xl font-bold m-0">{t("discussion.heading")}</h2>
|
|
</div>
|
|
<p className="text-gray-300 mb-6 max-w-3xl">{t("discussion.intro")}</p>
|
|
<div className="grid md:grid-cols-2 lg:grid-cols-3 gap-6">
|
|
<CardLink
|
|
href="https://github.com/MacRimi/ProxMenux/discussions"
|
|
title={t("discussion.cards.proxmenuxDiscussions.title")}
|
|
description={t("discussion.cards.proxmenuxDiscussions.description")}
|
|
Icon={MessageCircle}
|
|
color="bg-blue-600 hover:bg-blue-700"
|
|
/>
|
|
<CardLink
|
|
href="https://forum.proxmox.com/"
|
|
title={t("discussion.cards.proxmoxForum.title")}
|
|
description={t("discussion.cards.proxmoxForum.description")}
|
|
Icon={MessageCircle}
|
|
color="bg-purple-600 hover:bg-purple-700"
|
|
/>
|
|
<CardLink
|
|
href="https://www.reddit.com/r/Proxmox/"
|
|
title={t("discussion.cards.reddit.title")}
|
|
description={t("discussion.cards.reddit.description")}
|
|
Icon={Users}
|
|
color="bg-orange-600 hover:bg-orange-700"
|
|
/>
|
|
</div>
|
|
</section>
|
|
</div>
|
|
<Footer />
|
|
</div>
|
|
)
|
|
}
|