mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-06-01 21:14:49 +00:00
MacRimi
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.
276 lines
13 KiB
TypeScript
276 lines
13 KiB
TypeScript
import type { Metadata } from "next"
|
|
import { getTranslations, getMessages, setRequestLocale } from "next-intl/server"
|
|
import { Link } from "@/i18n/navigation"
|
|
import { DocHeader } from "@/components/ui/doc-header"
|
|
import { Callout } from "@/components/ui/callout"
|
|
import CopyableCode from "@/components/CopyableCode"
|
|
|
|
export async function generateMetadata({
|
|
params,
|
|
}: {
|
|
params: Promise<{ locale: string }>
|
|
}): Promise<Metadata> {
|
|
const { locale } = await params
|
|
const t = await getTranslations({ locale, namespace: "docs.diskManager.formatDisk.meta" })
|
|
return {
|
|
title: t("title"),
|
|
description: t("description"),
|
|
openGraph: {
|
|
title: t("ogTitle"),
|
|
description: t("ogDescription"),
|
|
type: "article",
|
|
url: "https://macrimi.github.io/ProxMenux/docs/disk-manager/format-disk",
|
|
},
|
|
}
|
|
}
|
|
|
|
type StringItem = string
|
|
type ModeRow = { mode: string; part: string; data: string; useCase: string }
|
|
type StepData = { title: string; body?: string; bodyRich?: string }
|
|
type RelatedItem = { href: string; label: string; tail?: string }
|
|
|
|
export default async function FormatDiskPage({
|
|
params,
|
|
}: {
|
|
params: Promise<{ locale: string }>
|
|
}) {
|
|
const { locale } = await params
|
|
setRequestLocale(locale)
|
|
const t = await getTranslations({ locale, namespace: "docs.diskManager.formatDisk" })
|
|
|
|
const messages = (await getMessages({ locale })) as unknown as {
|
|
docs: { diskManager: { formatDisk: {
|
|
visibility: { items: StringItem[]; safetyItems: StringItem[] }
|
|
modes: { rows: ModeRow[]; fullFormatItems: StringItem[] }
|
|
steps: { list: StepData[] }
|
|
related: { items: RelatedItem[] }
|
|
} } }
|
|
}
|
|
const visItems = messages.docs.diskManager.formatDisk.visibility.items
|
|
const safetyItems = messages.docs.diskManager.formatDisk.visibility.safetyItems
|
|
const modeRows = messages.docs.diskManager.formatDisk.modes.rows
|
|
const fullFormatItems = messages.docs.diskManager.formatDisk.modes.fullFormatItems
|
|
const stepList = messages.docs.diskManager.formatDisk.steps.list
|
|
const relatedItems = messages.docs.diskManager.formatDisk.related.items
|
|
|
|
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="storage/format-disk.sh"
|
|
/>
|
|
|
|
<Callout variant="danger" title={t("danger.title")}>
|
|
{t("danger.body")}
|
|
</Callout>
|
|
|
|
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("howRuns.heading")}</h2>
|
|
<p className="mb-4 text-gray-800 leading-relaxed">{t("howRuns.body")}</p>
|
|
|
|
<pre className="bg-gray-100 text-gray-800 p-4 rounded-md overflow-x-auto text-sm my-4 border border-gray-200 leading-snug">
|
|
{`┌─────────────────────────────────────────────┐
|
|
│ PHASE 1 — Filter, choose, confirm │
|
|
│ (nothing touched yet) │
|
|
└──────────────────┬──────────────────────────┘
|
|
▼
|
|
Detect disks on host (lsblk)
|
|
│
|
|
▼
|
|
Visibility filter
|
|
├─ Hidden: root / swap / system-mounted
|
|
├─ Hidden: active ZFS / LVM / RAID members
|
|
├─ Hidden: referenced by any VM/LXC config
|
|
└─ Shown: fully free disks (⚠ for stale sigs)
|
|
│
|
|
▼
|
|
User picks a disk
|
|
│
|
|
▼
|
|
Operation mode
|
|
├─ 1. Wipe all (partitions + sigs)
|
|
├─ 2. Remove FS labels (data preserved)
|
|
├─ 3. Zero all data (partitions kept)
|
|
└─ 4. Full format (new GPT + mkfs)
|
|
│
|
|
▼
|
|
Mode = 4? → extra questions
|
|
├─ Filesystem: ext4 / xfs / exfat / btrfs
|
|
│ └─ if tool missing (mkfs.btrfs,
|
|
│ mkfs.exfat) → abort with hint
|
|
└─ Optional label
|
|
│
|
|
▼
|
|
╔════════════════════════════════════╗
|
|
║ Double confirmation gate ║
|
|
║ (1) yes/no dialog with summary ║
|
|
║ (2) type the full disk path exactly║
|
|
║ (e.g. /dev/sdc) ║
|
|
║ Any mismatch → abort ║
|
|
╚══════════════════╤═════════════════╝
|
|
│
|
|
┌──────── Cancel OR Confirm ────┐
|
|
▼ ▼
|
|
Exit, nothing ┌─────────────────┴─────────────────┐
|
|
was changed │ PHASE 2 — Execute │
|
|
└─────────────────┬─────────────────┘
|
|
▼
|
|
Pre-execution re-validation
|
|
(state may have changed since
|
|
Phase 1 — user just confirmed)
|
|
├─ Disk now hosts system mount?
|
|
│ → hard block, abort
|
|
├─ Disk now in root ZFS pool?
|
|
│ → hard block, abort
|
|
├─ Disk has active swap?
|
|
│ → hard block, abort
|
|
└─ Data partitions still mounted?
|
|
→ auto-unmount; abort if fails
|
|
│
|
|
▼
|
|
Run the selected mode:
|
|
┌─────────────────────────────────┐
|
|
│ 1. Wipe all │
|
|
│ wipefs -af <disk> │
|
|
│ sgdisk --zap-all <disk> │
|
|
├─────────────────────────────────┤
|
|
│ 2. Remove FS labels │
|
|
│ wipefs -af <disk> │
|
|
│ + wipefs -af each partition │
|
|
│ (partition table PRESERVED) │
|
|
├─────────────────────────────────┤
|
|
│ 3. Zero all data │
|
|
│ For each partition: │
|
|
│ dd if=/dev/zero of=<part> │
|
|
│ bs=4M │
|
|
│ (partition table PRESERVED) │
|
|
├─────────────────────────────────┤
|
|
│ 4. Full format │
|
|
│ wipefs -af <disk> │
|
|
│ sgdisk --zap-all <disk> │
|
|
│ sgdisk -n 1:0:0 -t 1:8300 │
|
|
│ <disk> │
|
|
│ mkfs.<fs> [-L <label>] │
|
|
│ <disk>1 │
|
|
└─────────────────────────────────┘
|
|
│
|
|
▼
|
|
Final summary (operation + disk +
|
|
bytes touched if applicable)`}
|
|
</pre>
|
|
|
|
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("visibility.heading")}</h2>
|
|
<p className="mb-4 text-gray-800 leading-relaxed">{t("visibility.intro")}</p>
|
|
<ul className="list-disc pl-6 mb-4 text-gray-800 leading-relaxed space-y-1">
|
|
{visItems.map((_, idx) => (
|
|
<li key={idx}>{t.rich(`visibility.items.${idx}`, { strong, em })}</li>
|
|
))}
|
|
</ul>
|
|
|
|
<Callout variant="warning" title={t("visibility.safetyTitle")}>
|
|
<ul className="mt-2 list-disc list-inside space-y-1">
|
|
{safetyItems.map((_, idx) => (
|
|
<li key={idx}>{t.rich(`visibility.safetyItems.${idx}`, { strong, em })}</li>
|
|
))}
|
|
</ul>
|
|
</Callout>
|
|
|
|
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("modes.heading")}</h2>
|
|
<p className="mb-4 text-gray-800 leading-relaxed">{t("modes.intro")}</p>
|
|
<div className="overflow-x-auto mb-4 rounded-md border border-gray-200">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-gray-50 text-left text-gray-700">
|
|
<tr>
|
|
<th className="px-4 py-2 font-semibold">{t("modes.headerMode")}</th>
|
|
<th className="px-4 py-2 font-semibold">{t("modes.headerPart")}</th>
|
|
<th className="px-4 py-2 font-semibold">{t("modes.headerData")}</th>
|
|
<th className="px-4 py-2 font-semibold">{t("modes.headerUseCase")}</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-gray-200 text-gray-800">
|
|
{modeRows.map((row) => (
|
|
<tr key={row.mode}>
|
|
<td className="px-4 py-2 font-semibold">{row.mode}</td>
|
|
<td className="px-4 py-2">{row.part}</td>
|
|
<td className="px-4 py-2">{row.data}</td>
|
|
<td className="px-4 py-2">{row.useCase}</td>
|
|
</tr>
|
|
))}
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<p className="mb-4 text-gray-800 leading-relaxed">{t.rich("modes.fullFormatOutro", { strong })}</p>
|
|
<ul className="list-disc pl-6 mb-4 text-gray-800 leading-relaxed space-y-1">
|
|
{fullFormatItems.map((_, idx) => (
|
|
<li key={idx}>{t.rich(`modes.fullFormatItems.${idx}`, { strong, code })}</li>
|
|
))}
|
|
</ul>
|
|
|
|
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("steps.heading")}</h2>
|
|
|
|
{stepList.map((step, idx) => (
|
|
<section key={idx} className="mt-8 border-b border-gray-200 pb-8">
|
|
<div className="flex items-center gap-3 mb-3">
|
|
<span className="inline-flex items-center rounded-full border border-blue-200 bg-blue-50 px-2.5 py-0.5 text-xs font-semibold text-blue-800">
|
|
{t("steps.stepLabel")} {idx + 1}
|
|
</span>
|
|
<h3 className="text-lg font-semibold text-gray-900 m-0">{step.title}</h3>
|
|
</div>
|
|
<div className="mb-4 text-gray-800 leading-relaxed">
|
|
{step.bodyRich ? (
|
|
<p>{t.rich(`steps.list.${idx}.bodyRich`, { strong, code })}</p>
|
|
) : step.body && <p>{step.body}</p>}
|
|
</div>
|
|
</section>
|
|
))}
|
|
|
|
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("manual.heading")}</h2>
|
|
<p className="mb-3 text-gray-800 leading-relaxed">{t("manual.body")}</p>
|
|
<CopyableCode code={`# --- mode 1: wipe all (partition table + signatures) ---
|
|
wipefs -af /dev/sdX
|
|
sgdisk --zap-all /dev/sdX
|
|
|
|
# --- mode 2: remove FS labels only (keep partitions + data) ---
|
|
wipefs -af /dev/sdX # clears superblock signatures
|
|
# (do NOT run sgdisk --zap-all; it would wipe the partition table)
|
|
|
|
# --- mode 3: zero all data (keep partition table) ---
|
|
for p in /dev/sdX?*; do
|
|
dd if=/dev/zero of="$p" bs=4M status=progress || true
|
|
done
|
|
|
|
# --- mode 4: full format (new GPT + filesystem) ---
|
|
wipefs -af /dev/sdX
|
|
sgdisk --zap-all /dev/sdX
|
|
sgdisk -n 1:0:0 -t 1:8300 /dev/sdX # one partition, Linux filesystem
|
|
mkfs.ext4 -L mylabel /dev/sdX1 # pick the fs you want`} />
|
|
|
|
<Callout variant="troubleshoot" title={t("troubleshoot.notListedTitle")}>
|
|
{t.rich("troubleshoot.notListedBody", { code })}
|
|
</Callout>
|
|
<Callout variant="troubleshoot" title={t("troubleshoot.busyTitle")}>
|
|
{t.rich("troubleshoot.busyBody", { code })}
|
|
</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>
|
|
)
|
|
}
|