This is a Next.js application generated with Create Fumadocs.
Run development server:
npm run dev
# or
pnpm dev
# or
yarn devOpen http://localhost:3000 with your browser to see the result.
文檔裡的截圖用 <Shot src="/images/…" alt="…" /> 嵌入,框線與編號是直接畫進圖片檔的(手機上不會錯位,點圖可放大)。
- 原始截圖放在
shots-src/images/…(不會部署)。 - 框線座標與圖片下方的說明文字寫在
lib/shot-marks.json(座標為原始像素[x, y, 寬, 高];size為座標基準尺寸,crops可只截取某個pick的區域)。 <Shot pick={[2, 3]} />只顯示指定編號的框線,並重新編號(輸出為xxx.p2-3.png)。- 修改後執行
python3 scripts/bake-shots.py(需要 Pillow)重新輸出到public/images/,再用 zopflipng 做無損壓縮:
git status --porcelain | awk '{print $2}' | grep '^public/.*\.png$' | xargs -P 6 -I{} zopflipng -y -m --iterations=15 {} {}沒有框線的圖片,直接放進 public/images/ 並用  或 <Shot src alt /> 即可。
content/docs/gamecloud/ 底下 14 個功能頁(主控台、檔案、版本安裝、單一外掛、模組包、世界上傳與下載、玩家管理、備份、排程、使用者、啟動設定、伺服器設定、網路、告警)是「每一步一張圖+一句說明」的格式。
- 圖片放在
public/images/tutorials/<教學代號>/NN.webp(無損 WebP,像素與原本的 PNG 完全相同,檔案約小 60%)。 - 頁面中
{/* tutorial:start */}與{/* tutorial:end */}之間的步驟是程式產生的,不要手改;標記外的簡介與提示框可以自由編輯。 - 重新拍攝後,把新的教學資料夾(每個資料夾內有
NN-annotated.png與manifest.json)放到任一位置,執行:
python3 scripts/import-tutorials.py /path/to/tutorials # 全部
python3 scripts/import-tutorials.py /path/to/tutorials backups # 只更新一個datapacks(資料包)、newworld(建立新世界)、migrate(從其他主機搬家)三頁的 frontmatter 有 unlisted: true:可以用網址直接開啟,但不在側邊欄與上下頁導覽、不進 sitemap/站內搜尋/llms.txt,並帶有 noindex,也不產生專屬預覽圖。
功能正式上線時:
- 刪掉該頁 frontmatter 的
unlisted: true。 - 把頁面加進
content/docs/meta.json:資料包放在gamecloud/modpacks後、建立新世界放在gamecloud/worlds後、從其他主機搬家放在gamecloud/files後。 - (選用)到
lib/seo.ts的SEO_DESCRIPTIONS補搜尋描述,並執行scripts/gen-og.mjs產生預覽圖。
每個頁面都有專屬的 1200×630 預覽圖(public/og/docs/…,純色版面,PNG 已無損壓縮)。新增頁面或修改標題/描述後重新產生:
OG_FONT=/path/to/NotoSansTC.ttf node scripts/gen-og.mjs # 全部
OG_FONT=/path/to/NotoSansTC.ttf node scripts/gen-og.mjs gamecloud/backups # 只更新一頁字型只在產圖時使用,不會被打包進網站。需要安裝 playwright(PW_MODULE 可指定位置)。沒有圖片的頁面會自動使用 /og/default.png。
To learn more about Next.js and Fumadocs, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
- Fumadocs - learn about Fumadocs