OG 圖片建立工具
透過理解你的程式碼庫,自動建立品牌一致、脈絡適當的 Open Graph(OG)圖片。它會分析你的專案,然後使用 Playwright 與現有元件,為每個路由產生符合情境的圖片。
理念:真實性勝於模板
在產生 OG 圖片前,請先確認:
- 這個網站的品牌識別是什麼(顏色、字型、商標、設計語言)?
- 存在哪些路由/頁面,它們的目的是什麼?
- 有哪些元件與素材可以重複使用以確保一致性?
- 哪些頁面類型需要不同的視覺處理?
核心原則:
- 先研究再產生:在建立任何內容前,先了解程式碼庫的結構、路由與品牌
- 真實性勝於模板:使用實際的品牌顏色、字型與元件,而非通用的社交卡片模板
- 脈絡感知設計:首頁、文章、產品與文件需要不同的視覺方法
- 智慧自動化:自動偵測路由並提取品牌資訊,同時允許使用者自訂
工作流程
1. 探索與分析
路由探索:
- 分析專案結構以判斷框架(Next.js、Astro、React 等)
- 根據框架慣例自動偵測路由:
- Next.js:
app/*/page.tsx或pages/*.tsx - Astro:
src/pages/*.astro - React Router:分析路由設定
- Next.js:
- 從頁面中提取路由中繼資料(標題、描述)
- 分類頁面類型(首頁、文章、產品、關於等)
品牌提取:
- 尋找商標/圖示檔案(偏好 SVG)
- 從 CSS/Tailwind 設定中提取色彩調色盤
- 從樣式表或設定中識別主要字型
- 從現有元件中捕捉設計模式
使用 scripts/analyze_codebase.py 自動探索。
2. 設計策略
根據頁面類型決定適當的佈局:
- 首頁:大膽、簡潔,強調價值主張
- 文章/部落格:標題 + 摘要,必要時包含日期/作者
- 產品頁面:產品名稱、主要功能,如有視覺素材可加入
- 文件:主題 + 描述,組織化/結構感
- 關於/公司:品牌導向、專業
佈局原則:
- 充足的留白(避免雜亂)
- 高對比度以確保在分享時可讀
- 品牌色彩作為點綴,而非壓倒性元素
- 與網站相符的層級排版
- 1200x630px(標準 OG 尺寸)
3. 產生圖片
基於元件的產生方式:
- 盡可能重複使用 React 元件以確保一致性
- 使用 Playwright 將元件渲染為圖片
- 套用品牌顏色、字型與素材
- 注入實際的頁面中繼資料(非佔位符)
技術方法:
- 建立包含品牌樣式的簡潔 HTML 模板
- 對每個路由,產生頁面專屬的標記
- 使用 Playwright 在 1200x630 解析度下截圖
- 儲存至
public/og/或適當的靜態目錄 - 更新頁面中繼資料以引用 OG 圖片
使用 scripts/generate_og_images.py 進行自動化。
4. 驗證與最佳化
- 驗證 HTML 中的 OG 圖片中繼資料
- 使用 OG 預覽工具(opengraph.xyz、linkedin inspector)進行測試
- 確保檔案大小合理(建議 <200KB)
- 檢查圖片在不同縮放比例下的顯示效果
各框架專屬指南
Next.js
App Router:
// app/page.tsx
export const metadata = {
openGraph: {
images: ['/og/home.png'],
},
}
Pages Router:
// pages/index.tsx
<Head>
<meta property="og:image" content="/og/home.png" />
</Head>
動態 OG 圖片:考慮使用 Next.js OG Image Generation(@vercel/og)處理動態內容,但為了品牌一致性,建議採用靜態產生。
Astro
---
// src/pages/index.astro
const ogImage = '/og/home.png';
---
<head>
<meta property="og:image" content={ogImage} />
</head>
React SPA
在 public/index.html 中加入 OG 標籤,或使用 react-helmet:
<Helmet>
<meta property="og:image" content="/og/home.png" />
</Helmet>
應避免的反模式
❌ 泛用模板:不要使用忽略網站品牌的現成社交卡片模板
- 為何不好:會造成網站與社群分享體驗之間的斷層
- 更好做法:提取實際的品牌顏色、字型,並一致使用
❌ 單一尺寸適用所有:不要對所有頁面類型使用相同的 OG 圖片設計
- 為何不好:錯失了脈絡適當呈現的機會
- 更好做法:針對首頁、文章、產品等採用不同的佈局
❌ 佔位符內容:不要使用「Lorem ipsum」或泛用文字
- 為何不好:違背了預覽圖片的目的
- 更好做法:使用來自中繼資料的實際頁面標題與描述
❌ 過度擁擠:不要塞入太多文字、圖片或複雜佈局
- 為何不好:在社群動態中縮放後難以閱讀
- 更好做法:聚焦 1-2 個關鍵元素,搭配充足的留白
❌ 忽略現有元件:不要從頭建立 OG 圖片,如果已有現成元件
- 為何不好:破壞了與網站的視覺一致性
- 更好做法:重複使用按鈕樣式、卡片佈局、元件的排版
❌ 手動產生:不要一個接一個手動建立 OG 圖片
- 為何不好:無法擴展,難以維持一致性
- 更好做法:將產生過程腳本化,處理所有路由
變化指引
重要:OG 圖片應根據頁面脈絡有所變化,而非收斂到單一設計。
可變化的維度:
- 佈局:置中 vs 靠左、單欄 vs 雙欄、文字 vs 視覺焦點
- 色彩強調:主要品牌色 vs 中性色、漸層 vs 純色
- 內容層級:大標題 vs 平衡的標題+描述
- 視覺元素:商標大小/位置、裝飾元素、圖示
- 排版:字型大小比例、粗細分布、字型搭配
避免收斂到:
- 所有地方都用相同的漸層背景
- 相同的「標題 + 商標」佈局
- 單一字型大小比例
- 固定的商標位置
由脈絡驅動變化:
- 技術文件 → 簡潔、有組織、以圖示為基礎
- 行銷首頁 → 大膽、色彩豐富、以價值為焦點
- 部落格文章 → 讀者友善、包含作者/日期脈絡
- 產品頁面 → 強調視覺產品
技術需求
相依套件(視需要安裝):
npm install playwright sharp
# 或
pip install playwright Pillow
Playwright 設定:
playwright install chromium
檔案結構:
project/
├── public/og/ # 產生的 OG 圖片
│ ├── home.png
│ ├── about.png
│ └── ...
└── scripts/ # 產生腳本
├── analyze_codebase.py
└── generate_og_images.py
切記
OG 圖片是品牌的延伸,而非泛用的社交卡片。
研究程式碼庫以了解設計語言。提取品牌識別。使用實際的元件與內容。建立看起來像網站原生部分的脈絡適當圖片。
當有人分享你的頁面時,OG 圖片應該像自然的預覽——而不是硬貼上去的模板。
你有能力建立精緻、品牌一致的 OG 圖片,強化而非削弱網站的身份認同。