THE PROBLEM
使用場景與挑戰
每篇新文章必須交付自包含的 index.html、同目錄獨立的 og-card.png,以及初始 head 的完整分享 metadata。正文單檔不代表分享圖可省略;不得拿本指南的圖冒當別篇的專屬卡。
當每篇筆記都換一種排版,讀者每次都得重新摸索;長篇內容沒有短結論與閱讀路線,找不到自己要的答案;而作者又得一再交代「深藍、清爽、手機可讀、按鈕可複製」。真正需要的是可重用的內容骨架與視覺規則,不只是挑一組漂亮顏色。
這份指南以 〈讓 Grok Bot 自動發布 HTML 筆記〉的實際 HTML/CSS 為基準,本頁自己也沿用相同樣式。目標是一致、好讀、可行動、好分享;它是個人筆記風格指南,不是任何平台的官方設計系統。
原頁實值 代表從參考頁實際 CSS 或結構提取;建議補充 代表為後續重用新增的規範。此頁不宣稱原頁或本頁已通過尚未實測的無障礙等級。
01 / PRINCIPLES
讓設計替閱讀服務
- 先痛點,後路線。Hero 點出對象、情境與短結論;第一張卡片回答「為什麼需要」,之後才出現閱讀路線。這是參考頁更新後的實際順序。
- 一張卡片,一個問題。白色 section 分隔論點;h2 是段落答案,h3 是局部任務,段落不要塞滿全部細節。
- 顏色有職責。深藍承載主視覺與程式碼,teal 提示連結與方向,暖色留給警告與 focus;不靠顏色單獨表達意思。
- 讓人帶走可操作內容。少量比較表、逐步說明、可複製 prompt 與清單,優於全篇抽象口號。
- 信任比裝飾重要。就近來源、查證日期、限制與未知分開說;沒有實測的操作或能力不要寫成已驗證。
第 1–4 點提煉自參考頁;「每張卡片只回答一個問題」及一致執行的寫作檢核屬建議補充,不是原 CSS 的技術限制。
02 / ORIGINAL VALUES
實際 tokens:色票、字體與空間
原頁實值 下列色值取自參考頁,不是另創的新配色。Token 在此指可重用的設計值;原頁使用直接色碼,未宣告 CSS 自訂變數。
#f2f5f6#203744#102d40#f6fbfc#d8e5ed#a3e6d4#076d68#b45a1b#087c73#ffffff#dce6e7#eef8f5#138675#fff7e9#c0842d#c27c21#102b3b#e0f2f3#1d4254#245868#78a8ad#163f50#536976字體與標題比例
| 層級 | 實際值 | 用途 |
|---|---|---|
| 本文 | 17px / 1.85;手機 16px | system-ui, -apple-system, "Noto Sans TC", sans-serif |
| h1 | clamp(29px, 5vw, 46px) / 1.3;字距 -.035em | Hero 主結論 |
| h1 span | .74em;上距 12px | 定位或副標 |
| h2 | 28px / 1.4;手機 24px;字距 -.025em | section 主題 |
| h3 | 20px;上距 30px | 局部步驟 |
| Lead/Meta | 20px(手機18px)/13px | 引言/日期與範圍 |
| Eyebrow | 12px;字距 .16em;字重 750 | 低干擾段落標籤 |
| 程式碼 | 14px / 1.85;手機13px | ui-monospace, SFMono-Regular, Consolas, monospace |
字體名稱是系統 fallback stack,不代表下載了 Noto Sans TC,也不保證每台裝置顯示同一字型。原頁不載入遠端字體。
版寬、間距與圓角
- 頁面:header/main/footer 最大寬 1000px,置中;main 內距 20px 40px。
- Hero:內距 60px 56px 40px;僅底部兩角 28px;lead 最大寬 720px。
- 卡片:section 外距 28px 0,內距 36px,邊框 1px #dce6e7,圓角 18px。
- 節奏:p 外距 14px 0;li 外距 12px 0;h2 外距 5px 0 22px。不是固定 8px 網格,勿聲稱全頁只用同一倍數。
- 次級容器:選項卡與程式碼框圓角 12px,表格與 details 10px,copy 按鈕 6px。
- 導覽:flex 可換行;gap 9px 18px,padding 18px 10px,字級 14px。
03 / WRITING
標題層級與文案:先回答讀者的問題
建議補充 一篇只用一個 h1,h2 → h3 按內容層級排列,不為了字體大小跳級。段落標籤輔助掃讀,不取代可理解的中文標題。
| 避免 | 改寫示例 |
|---|---|
| 全面賦能知識工作流 | 把研究筆記變成同事點得開的網址 |
| 操作方法 | 先確認目標站,再建立預覽版本 |
| 非常安全、永久免費 | 不公開憑證;免費仍受當時額度與政策限制 |
| 已完美支援所有裝置 | 已提供手機 CSS;仍須實測窄螢幕與鍵盤操作 |
每篇內容的最小骨架
- 對誰有用、現在卡在哪裡、這篇給什麼答案。
- 使用場景與挑戰,之後才放閱讀路線。
- 必要原理、具體步驟、可操作示例與限制。
- 發布前清單、具名可點來源、查證日期與未測項目。
可查證的事實優先用官方原始資料,重要限制就近連結。不要把推測、操作建議或資料快照寫成官方保證或自動即時更新。
04 / LIVE COMPONENTS
元件活範例:少量、清楚、有用途
本頁 hero、選項卡、閱讀路線、section、比較表與下列元件,就是沿用原頁 CSS 的實際展示;不用再疊一套不同的視覺語言。
提示與警告
需要保留的限制放在這裡,段落要短。提示使用 #eef8f5 背景、4px #138675 側線、20px 22px 內距。
先確認授權與目標,保留其他文章。警告沿用 #fff7e9 背景與 #c0842d 側線,並寫出明確「警告」語意,不只改顏色。
程式碼與複製
工具列標明這是 Prompt、Command 或示例。命令使用真正可複製的純文字,不混入 shell 的提示符或秘密值。
請先說明使用場景與挑戰,再給閱讀路線。
產出單檔 HTML,保留窄螢幕可讀性與鍵盤 focus。複製按鈕成功或失敗都有狀態提示;Clipboard 被限制時嘗試 fallback,仍失敗則引導手動選取。本頁沒有因複製而送出內容到外部服務。
折疊示例:把次要細節留給需要的人
原頁以原生 details/summary 收納底層指令;本頁也用於完整 CSS。把關鍵限制留在展開外,避免讀者沒打開就錯過風險。
05 / RESPONSIVE & ACCESSIBILITY
手機、鍵盤與列印都要照顧
原頁實值 手機斷點為 @media(max-width:650px),不是另設多套任意裝置尺寸。
- Hero 改 36px 24px、底角20px;選項卡從雙欄變單欄。
- Main 改 10px 12px;section 改 25px 19px、外距20px 0;notice 內距16px。
- 表格原值 min-width:580px,外層 tablewrap 自己 overflow-x:auto;pre 自己橫捲,snippet min-width:0,長行不要把全頁撐寬。
- focus-visible 是 3px solid #c27c21、offset 4px;頁內平滑捲動在 prefers-reduced-motion:reduce 時改 auto。
- 列印改白底深字、本文11pt;隱藏導覽/選項/按鈕/footer,pre 換行、表格解除最小寬;標題避免與後文斷開。
長表格容器可加 tabindex="0" 與可理解的區域名稱,表頭補 scope,方便鍵盤與輔助科技;本指南的表格已加這些語意。此補充不代表原頁已有相同標記。
- 逐一試 Tab/Enter、copy 成功與失敗;檢查窄螢幕及放大後不遮字,橫捲只發生在需要的容器。
- 不要宣稱已達 AA、某個對比數字或全部裝置相容,除非真的用對應方法驗證。
- 列印前展開需要的 details 再看預覽;只設定 details display:block 並不保證其折疊內容一定列印。
06 / REQUIRED SHARE CARD
OG 分享卡(每篇必備)
公開文章不只要在瀏覽器好讀,還要提供分享爬蟲可讀取的標題、說明與預覽圖。本章參考 eli5 風格指南第 7 章的 PNG、中文字體與素材處理經驗,再依 Pahud Notes 的 navy/teal 體系與滿版背景規範訂定本站規範;不是照搬來源站的深色主題、全站雙語或自動索引機制。
MUST:每篇文章的交付門檻
- 滿版深藍,不做外殼:1200×630 全畫布使用 #102d40 不透明深藍底,頂部加全寬青綠細線;除這條線外,側邊與底邊不留白、無透明 padding、不畫淺色外底或整張外層圓角。文字在畫布內保留安全間距。這只針對 OG 圖,不改正文白色卡片的18px圓角。
- 一篇一張專屬圖:同目錄發布
og-card.png,固定 1200×630 PNG。檔案本名仍是 og-card.png,metadata 可加固定內容雜湊版本 query(例如 ?v=內容短雜湊)以區分新版圖片;更新圖後 og:image 與 twitter:image 必須一致。版本 query 不保證社群平台會自動重抓原文章 URL。不得只用 SVG、data URI 或把本指南的 image URL 借給別篇冒當專屬圖。 - 初始 head 就有 metadata:canonical、description;og:title、og:description、og:type、og:url、og:image、og:image:type/width/height/alt;twitter:card=summary_large_image 與 twitter:title/description/image/image:alt。不要等 JavaScript 注入。
- 真實最終 URL:canonical、og:url 與所有 image URL 使用最終公開的絕對 HTTPS,不能留 localhost、暫存預覽網址或未替換佔位字。
- 可讀且誠實:主標、副標、少量 tag、Pahud Notes 識別與簡短網域位置;中文字體實際存在、文字不裁切、不變成方框。縮小看仍能辨認主標,不把整篇文章塞進圖片,不假冒產品官方品牌。
- 圖與頁一起驗證:PNG 尺寸、實際字形、公開 HTTP200/image/png、頁面 HTTP200/text/html 與 bytes match 都要查;發布後檢查索引文章連結與描述。本站索引是靜態列表,新增文章需同步更新,並非自動抓 OG。
本站標準版式:左標題、右真實畫面
每張標準分享卡都採左右雙欄。左欄放 Pahud Notes 眉標、清楚繁中主標兩行、青綠副標、2–3個tag及簡短URL;右欄優先使用與主題直接相關的一手來源、官方報導、官方產品頁,或使用者提供的相關來源網頁真實截圖;沒有清楚且可用的相關來源素材,才退回我們自己報告頁的真實viewport。不製造假介面,不用無關裝飾或AI假截圖。不必為了對齊參考卡強加英文譯文。
| 區域 | 配置 | 要求 |
|---|---|---|
| 左欄 | 約58–60%畫布寬 | 主標約56–64px,副標約28–32px,字長過長先分行 |
| 右欄 | 約35–38%畫布寬 | 優先相關來源網頁真實截圖,無合適來源才用自家報告viewport;等比例fit,不拉伸 |
| 安全間距 | 外距約48–64px、欄間約24–36px | 畫布內留白;可依內容調整,不加白外框 |
| 頂部線 | 全寬青綠線約8–10px | 例如#7de0c7;其餘背景滿版深藍 |
先尋找/取得主題直接相關的來源頁素材,依下列優先序選圖並記錄URL、來源與擷取時間,再以程式讀檔合成。不要預設使用自家報告頁;確認沒有清楚且可用的相關來源圖後,才以自家報告真實viewport作fallback,仍維持雙欄,不退回無關裝飾或虛構畫面。可裁去截圖下緣浮動徽章或捲軸,不改造頁面事實;保持裁後長寬比,縮圖後仍可辨識hero/標題。右欄允許內部深色容器、細青綠框與適度內圓角;禁止的是整張圖的白外框與外層圓角,不是截圖框。
右欄素材優先序:相關來源優先,自家截圖備援
- 優先一手與官方:選與文章主題直接相關的原始報導、研究原文、官方產品頁,或使用者提供的相關來源頁真實截圖。保住可辨識的標題、產品或人物與內容脈絡;不可只裁成無從辨識來源的一張臉。
- 先確認可公開與可用:記錄原頁URL、素材提供者/擷取方式與必要來源標註;有授權、隱私或使用限制時依其要求處理。不要公開登入後私人頁、個資、token或內部畫面;使用者給圖不代表能忽略圖片中的私人內容。
- 無合適來源才fallback:若相關來源圖找不到、太模糊、無法合法公開或無法保留主題識別,才使用本篇報告自己的真實viewport。這是備援,不是每篇預設;不用AI假截圖、拼造官方UI或隨便無關圖片湊版。
所有素材都等比例fit,不刪改畫面標題/作者或編造影片字幕,不把靜態海報當成已觀看影片的證據。縮小後若只能辨識人物與頁面主題,需如實描述,不宣稱小字都清晰可讀。來源截圖內的白色頁底不是整張分享卡的白外框。
建議:沿用自己的配色與留白
自訂設計建議 主視覺必須使用 #102d40 不透明滿版深藍底,頂部加全寬青綠細線,其餘邊緣維持深藍;不畫白框、淺色外底或整張外層圓角。Teal #138675/#a3e6d4 用於文字與內部 tag;平台可能自行裁切,但圖片本身不畫外殼。文字安全間距留在深藍畫布內,不是淺色外框;距畫布邊緣建議至少 64px,主標可從約 64px 起試,副標約 28–40px,tag 控制在 2–3 個;依實際字長調整,勿縮到不可讀。這些不是 X 或其他平台硬限制。
檔案大小以約 1–2MB 以內作自訂目標,能更小更好,但不是平台保證或統一上限。本頁實作約 47KB。平台仍可能裁切或快取;安全邊距只能降低風險,不保證所有預覽長相一致。

條件適用:雙語與產品圖
- 文章本身雙語時:兩種語言烤在同一張圖,不依賴頁面切換;分享爬蟲不會替你操作語言按鈕。本網站以繁中為主,不強制每篇加英文譯文。
- 產品素材選用,真實畫面為標準:標準左文字/右真實畫面雙欄適用全站OG;按上述來源優先序選取相關官方產品頁/素材,沒有合適來源圖才使用自家報告viewport,保留原圖長寬比、不壓字。以程式讀檔轉 data URI 嵌入中間 SVG,再轉 PNG,不手貼 base64;只有中間製圖步驟可用 data URI,公開 og:image 仍須是獨立 PNG URL。
- 先檢查背景:讀圖 metadata/透明度並取樣四角。若是不透明白底照片,不要強行去背以免挖掉白色產品細節;可在深藍滿版畫布內放淺色產品素材區,保留 navy/teal 識別;不可為了融入白底照片,把整張 OG 畫成白色外框或淺色外殼。
中文轉圖與實際目視
製圖端需真的安裝繁中文字體,例如 Noto Sans CJK TC;SVG→PNG 前可用 fontconfig 確認對應,或像本頁用 Pillow 指定實際 TC 字體。本頁使用本機 Noto Sans CJK TC 產製,轉出後須目視 PNG,另縮小檢查留白、裁切與字形;網頁系統字體 stack 不代表製圖工具也有該字體。
可複製:本指南真實 head 範例
下面是本頁自己的完整 OG/Twitter 範例。新文章必須替換所有標題、說明、alt、頁面與圖片 URL,不能照抄本頁網址。
<link rel="canonical" href="https://pahud-notes.netlify.app/gudelines/">
<meta name="description" content="Pahud Notes 的繁中 HTML 風格指南:真實 CSS、寫作骨架、元件範例與每篇必備的 1200×630 OG 分享卡。">
<meta property="og:title" content="HTML 筆記風格指南:可重用的設計、寫作與實作規範">
<meta property="og:description" content="Pahud Notes 的繁中 HTML 風格指南:真實 CSS、寫作骨架、元件範例與每篇必備的 1200×630 OG 分享卡。">
<meta property="og:type" content="article">
<meta property="og:url" content="https://pahud-notes.netlify.app/gudelines/">
<meta property="og:image" content="https://pahud-notes.netlify.app/gudelines/og-card.png?v=506b2ef3f943">
<meta property="og:image:type" content="image/png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="HTML 筆記風格指南:左側標題、設計寫作實作與標籤,右側為真實指南頁面截圖。">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="HTML 筆記風格指南:可重用的設計、寫作與實作規範">
<meta name="twitter:description" content="Pahud Notes 的繁中 HTML 風格指南:真實 CSS、寫作骨架、元件範例與每篇必備的 1200×630 OG 分享卡。">
<meta name="twitter:image" content="https://pahud-notes.netlify.app/gudelines/og-card.png?v=506b2ef3f943">
<meta name="twitter:image:alt" content="HTML 筆記風格指南:左側標題、設計寫作實作與標籤,右側為真實指南頁面截圖。">先查頁面 metadata、圖檔、權限與內容類型,再視需要用對應平台 debugger 要求重抓;不同平台可能快取、裁切或延遲,不能未查原因就歸咎某一平台快取,也不能保證重新抓取一定立即出卡。
07 / IMPLEMENTATION
可重用的單檔 HTML 實作
先保留內容骨架,再使用原 CSS;CSS 不依賴框架、CDN 或外部字型。所謂「單檔 HTML」指正文的 CSS/JS 自包含、沒有遠端執行依賴;供分享爬蟲抓取的 og-card.png 必須另檔同目錄發布,不能以 data URI 或僅 SVG 代替。這不是完整元件函式庫,新增元件時仍需檢查溢出與語意。
HTML 骨架:複製後填入自己的內容
<!doctype html>
<html lang="zh-Hant">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="description" content="一句話說清楚讀者可得到什麼">
<title>主題:讀者可採取的行動</title>
<!-- 必填佔位:發布前替換 YOUR-SITE、YOUR-SLUG 與所有本篇文案 -->
<link rel="canonical" href="https://YOUR-SITE.netlify.app/YOUR-SLUG/">
<meta property="og:title" content="請替換:本篇主標">
<meta property="og:description" content="請替換:本篇摘要">
<meta property="og:type" content="article">
<meta property="og:url" content="https://YOUR-SITE.netlify.app/YOUR-SLUG/">
<meta property="og:image" content="https://YOUR-SITE.netlify.app/YOUR-SLUG/og-card.png">
<meta property="og:image:type" content="image/png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="請替換:本篇圖片說明">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="請替換:本篇主標">
<meta name="twitter:description" content="請替換:本篇摘要">
<meta name="twitter:image" content="https://YOUR-SITE.netlify.app/YOUR-SLUG/og-card.png">
<meta name="twitter:image:alt" content="請替換:本篇圖片說明">
<style>/* 貼入下方原頁 CSS;不引用遠端樣式 */</style>
</head>
<body>
<header class="hero">
<p class="eyebrow">PRACTICAL GUIDE</p>
<h1>一句主標<span>一句定位</span></h1>
<p class="lead">讀者場景、痛點與短結論。</p>
<div class="meta">查證日期與範圍</div>
</header>
<main>
<section id="problem"><h2>使用場景與挑戰</h2><p>為何需要這篇?</p></section>
<nav aria-label="文章目錄"><b>閱讀路線</b><a href="#steps">開始操作</a></nav>
<section id="steps"><h2>具體步驟</h2><p>內容與就近引用。</p></section>
<section id="sources"><h2>參考來源</h2><p>可點擊的原始來源。</p></section>
</main>
<footer>獨立筆記;限制與未測項目如實標示。</footer>
</body>
</html>
<!-- 同目錄另附本篇專屬 1200×630 og-card.png;正文 CSS/JS 仍自包含。 -->原頁完整 CSS:可直接複製的實際基線
以下為參考頁 CSS 原值,未把本指南新增的色票網格樣式冒充為原規格。
*{box-sizing:border-box}html{scroll-behavior:smooth;scroll-padding-top:20px}body{margin:0;background:#f2f5f6;color:#203744;font:17px/1.85 system-ui,-apple-system,"Noto Sans TC",sans-serif}a{color:#076d68;text-underline-offset:4px}a:hover{color:#b45a1b}button,a,summary{-webkit-tap-highlight-color:transparent}:focus-visible{outline:3px solid #c27c21;outline-offset:4px}header,main,footer{max-width:1000px;margin:auto}.hero{background:#102d40;color:#f6fbfc;padding:60px 56px 40px;border-radius:0 0 28px 28px}.eyebrow{font-size:12px;letter-spacing:.16em;font-weight:750;color:#087c73}.hero .eyebrow{color:#7de0c7}h1{font-size:clamp(29px,5vw,46px);line-height:1.3;letter-spacing:-.035em;margin:15px 0 24px}h1 span{display:block;color:#a3e6d4;font-size:.74em;margin-top:12px}.lead{font-size:20px;max-width:720px;color:#d8e5ed}.meta{font-size:13px;color:#afc6d4}.choices{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin-top:30px}.choices a{color:#fff;border:1px solid #4d7484;border-radius:12px;padding:16px 20px;text-decoration:none;background:#183d50}.choices b,.choices span{display:block}.choices span{font-size:14px;color:#bfe1e5}main{padding:20px 40px}nav{display:flex;flex-wrap:wrap;gap:9px 18px;padding:18px 10px;border-bottom:1px solid #cfdddf;font-size:14px}section{margin:28px 0;background:#fff;border:1px solid #dce6e7;border-radius:18px;padding:36px}h2{font-size:28px;line-height:1.4;margin:5px 0 22px;letter-spacing:-.025em}h3{font-size:20px;margin-top:30px}p{margin:14px 0}li{margin:12px 0}ol,ul{padding-left:25px}strong{color:#123f50}.small{font-size:14px;color:#536976}.tablewrap{max-width:100%;overflow-x:auto;border:1px solid #d7e4e6;border-radius:10px}table{border-collapse:collapse;width:100%;min-width:580px;font-size:15px}caption{text-align:left;padding:12px 18px;font-weight:bold;background:#edf5f4}th,td{text-align:left;vertical-align:top;padding:13px 16px;border-bottom:1px solid #dce6e7}thead th{background:#163f50;color:#fff}tbody th{white-space:nowrap;background:#f3f7f7}.notice{background:#eef8f5;border-left:4px solid #138675;padding:20px 22px;margin:24px 0;border-radius:0 10px 10px 0}.notice p{margin-bottom:0}.danger{background:#fff7e9;border-color:#c0842d}.snippet{margin:20px 0;border:1px solid #315165;border-radius:12px;overflow:hidden;min-width:0;background:#102b3b;color:#e0f2f3}.codebar{display:flex;justify-content:space-between;align-items:center;gap:10px;background:#1d4254;padding:10px 14px;font-size:13px}.codebar button{border:1px solid #78a8ad;color:#fff;background:#245868;padding:6px 13px;border-radius:6px;font:inherit;cursor:pointer;flex-shrink:0}.codebar button:hover{background:#087b72}pre{font:14px/1.85 ui-monospace,SFMono-Regular,Consolas,monospace;margin:0;padding:20px;overflow-x:auto;tab-size:2}p code,li code{font-size:.85em;background:#eaf1f2;padding:2px 5px;border-radius:4px;overflow-wrap:anywhere}pre code{background:none}.ref{font-size:12px;margin-left:4px;white-space:nowrap}.closing{margin-top:30px;padding:22px;background:#143d4e;color:white;border-radius:10px}.sources{font-size:15px;overflow-wrap:anywhere}details{border:1px solid #d7e4e6;border-radius:10px;padding:15px}summary{cursor:pointer;font-weight:650}.checklist{list-style:"✓ ";padding-left:26px}.checklist li::marker{color:#087c73}footer{text-align:center;padding:25px 25px 50px;color:#5c7180;font-size:13px}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}@media(max-width:650px){body{font-size:16px}.hero{padding:36px 24px;border-radius:0 0 20px 20px}.lead{font-size:18px}.choices{grid-template-columns:1fr}main{padding:10px 12px}section{padding:25px 19px;margin:20px 0}h2{font-size:24px}.notice{padding:16px}pre{padding:15px;font-size:13px}nav{gap:10px 15px}}@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}}@media print{body{background:#fff;color:#111;font-size:11pt}.hero{background:#fff;color:#111;padding:20px}.hero .eyebrow,h1 span,.lead,.meta{color:#333}main{padding:0}section{border:0;padding:10px 15px;break-inside:auto}.choices,nav,button,footer{display:none}h2,h3{break-after:avoid}.snippet{color:#111;background:#f5f5f5;border-color:#aaa}.codebar{background:#eee;color:#111}pre{white-space:pre-wrap;overflow-wrap:anywhere}table{min-width:0}thead th{background:#eee;color:#111}a{color:#111}details{display:block}.notice,.closing{background:#f5f5f5;color:#111}.tablewrap{overflow:visible}}可選重構:將實值抽成 CSS variables
/* 建議補充:將原頁實際色值抽成變數;原頁本身未用 CSS variables */
:root {
--page: #f2f5f6;
--ink: #203744;
--navy: #102d40;
--link: #076d68;
--surface: #ffffff;
--border: #dce6e7;
--focus: #c27c21;
--content-max: 1000px;
--card-radius: 18px;
}
/* 新文章採用時逐步替換,勿誤稱原頁已使用這些 token 名稱。 */複製互動 JS:連同狀態區與按鈕使用
按鈕加 data-copy="目標ID",pre 使用相同 id;頁尾加 id="copy-status"、role="status"、aria-live="polite" 的 sr-only 元素。所有 ID 必須唯一。
document.querySelectorAll('[data-copy]').forEach(function(button){button.addEventListener('click',async function(){const text=document.getElementById(button.dataset.copy).textContent;let ok=false;try{if(navigator.clipboard&&window.isSecureContext){await navigator.clipboard.writeText(text);ok=true;}}catch(error){}if(!ok){const area=document.createElement('textarea');area.value=text;area.style.position='fixed';area.style.opacity='0';document.body.appendChild(area);area.focus();area.select();try{ok=document.execCommand('copy');}catch(error){}area.remove();button.focus();}button.textContent=ok?'已複製':'請手動選取複製';document.getElementById('copy-status').textContent=ok?'內容已複製到剪貼簿。':'瀏覽器未允許複製,請選取程式碼區內容手動複製。';window.setTimeout(function(){button.textContent='複製';},2500);});});08 / COPY & REUSE
直接複製給 Grok Bot 的完整 prompt
先填主題、讀者與行動。這份 prompt 會把視覺、寫作、查證與安全發布要求一起帶走;不會自動授權公開任何新內容。
請依照這份獨立風格指南製作繁體中文 HTML 筆記:
https://pahud-notes.netlify.app/gudelines/
參考原實作:https://pahud-notes.netlify.app/grok-bot-public-notes/
主題:[填入主題];讀者:[填入對象];希望讀者採取的行動:[填入行動]。
先閱讀指南,不把它當官方平台規格。保留 navy/teal、適中版寬、白色圓角卡片、清楚閱讀路線、原頁字級與行距。
內容順序:hero短結論與使用情境 → 使用場景與挑戰 → 閱讀路線 → 核心解釋與具體步驟 → 適量比較表/提示/範例 → 可複製指令或prompt → 檢查清單 → 來源。
先說讀者痛點,再給路線;一個h1,依序h2/h3,不以大段行話或裝飾取代結論。
對可查證事實優先閱讀官方原始來源,重要限制就近引用,標記查證日期;區分事實、建議、未知與未實測,不造數字、引用或無障礙達標宣稱。
交付正文自包含的單檔HTML,另附本篇專屬1200×630 PNG og-card.png;圖片獨立同目錄公開,不用data URI或僅SVG,也不借別篇圖片URL。
初始head必須有canonical、description、og:title/description/type/url/image及image:type/width/height/alt,以及twitter:card=summary_large_image、twitter:title/description/image/image:alt;頁與圖片網址用最終絕對HTTPS,不等JS注入。
OG卡必須標準左右雙欄:左約58–60%放品牌、繁中兩行大標、副標、少量tag及URL;右約35–38%優先放主題直接相關的一手原文/官方報導/產品頁,或使用者提供相關source頁的真實截圖;找不到清楚、可用且可公開的相關來源圖,才fallback本篇報告真實viewport,不預設使用自家頁。記錄來源URL、擷取方式與時間,必要時標註;不得公開登入私人頁或個資。保留主題標題/產品/人物識別,保比例、不壓字,不偽造UI、不編造字幕、不用無關裝飾或AI假截圖。尺寸比例是本站建議非平台硬限制。使用#102d40不透明滿版深藍底與頂部全寬青綠細線,無整張白框/淺色外底/外層圓角;右欄內部深色容器可有細框及適度內圓角。文字安全間距留在深藍畫布內,本站navy/teal配色、清楚主副標、少量tag與Pahud Notes識別,適度留白;確保真實繁中文字體、無裁切/方框並目視PNG。僅雙語文章需兩語同圖,產品照選用且保比例;白底素材不強去背。
正文CSS/JS內嵌、無CDN/遠端字體/追蹤/表單;使用語意標籤、精確title/description/canonical、unique IDs、可點錨點、鍵盤focus、減少動態效果。
程式碼及長表格只在自身區域橫捲,手機<=650px改單欄;提供列印CSS。複製按鈕須有成功/失敗提示與Clipboard不可用時的fallback,內容本身可手動選取。
檢查JS語法、錨點、copy targets、遠端依賴與手機CSS;瀏覽器未測項目如實標註。
若本次另有明確發布授權,只部署指定網站及路徑;先讀目前production完整檔案並保留原首頁與所有文章,合併完整乾淨快照,draft驗證後再production,正式發布前檢查deploy ID避免並行覆蓋。
無法確認舊內容完整保留就停止。未授權發布則只交付HTML,不自行公開。
憑證僅用合法授權安全機制;不在HTML、聊天、命令列明文、來源碼或公開log放token/claim連結/私人資料。
發布後驗證精確URL的HTTP200、text/html、bytes match及其他檔案hash不變;回報本地檔、公開URL、PNG路徑、deploy ID與QA,不聲稱未做的瀏覽器測試。
發布前檢查頁與圖HTTP200及text/html、image/png、PNG解析尺寸、metadata唯一、bytes match與索引;分享平台可能快取或裁切,不保證即時出卡。
圖片本名維持og-card.png,可用固定內容hash的?v=版本query降低舊圖快取;og:image/twitter:image一致,正文圖預覽也更新。這不保證社群重抓原文章URL。白底產品圖可放內部素材區,不能因此加整張白外框。09 / BEFORE YOU PUBLISH
發布前 checklist
- 首屏能說清楚對象、痛點與短結論;「使用場景與挑戰」在閱讀路線之前。
- 保持 navy/teal、原頁版寬與字級節奏;原值與建議補充標記清楚。
- 一個 h1、語意標籤、唯一 ID、有效錨點;每個 copy 按鈕找到正確目標。
- 正文 HTML 的 CSS/JS 自包含;同目錄另附本篇專屬 1200×630 og-card.png,無遠端字體、框架執行依賴、追蹤或憑證。
- OG/Twitter metadata 在初始 head 完整且唯一,canonical、頁與圖是本篇最終絕對 HTTPS;圖片含正確 alt,不留佔位、不借別篇圖。
- 檢查 PNG 的1200×630全畫布:#102d40不透明深藍,頂部全寬青綠細線,其餘邊緣無白框、無淺色外底或整張外層圓角;metadata與預覽版本query一致,文字安全間距留在畫布內。
- 標準左標題/右真實畫面:先找直接相關一手/官方/使用者提供來源頁圖,沒有清楚可用來源才fallback自家報告viewport;記錄來源URL與擷取方式,必要時標註,不公開私人登入頁。保主題識別、保比例不壓字,不偽造UI或字幕;右欄內部容器與圓角不等於整張白框。
- 目視 PNG:繁中文字形正常、無裁切,縮小主標仍可讀;產品圖保比例,雙語規則只在需要時套用。
- 長表與程式碼在局部橫捲;檢查手機、鍵盤、focus、減少動態與列印預覽。
- 官方來源已閱讀、限制就近引用;日期、事實、建議與未測項目分清楚。
- 只有明確授權才公開;保留整站原檔,先 draft,再檢查並行更新後 production。
- 頁與 PNG 回 HTTP200、text/html/image/png、bytes match,尺寸1200×630;索引連結與文案確認,其他文章 hash 不變,私密控制紀錄不部署。
沿用骨架、色彩職責與安全底線,讓內容決定需要哪些表格、提示與示例;不要為了湊元件把短筆記拉成長報告。
REFERENCE & SCOPE
依據與適用範圍
新增參考:eli5 風格指南第 7 章・OG 分享卡 ↗(2026-11-08 EST 閱讀)。採納圖片尺寸、中文轉圖目視與素材處理經驗;不照搬其配色、自動索引、全站雙語與對快取原因的概括說法。
參考原頁:讓 Grok Bot 自動發布 HTML 筆記 ↗
本指南於2026-11-08 EST從上述頁面的實際原始 HTML/CSS 提煉,基準是本次生成時的頁面;未來原文更新不會自動同步此指南。色票網格、原值/建議標籤、表格鍵盤區域與本頁內容為指南新增,主體風格與複製互動沿用原實作。
本頁沒有提供色彩對比數字或無障礙等級保證。程式化 QA 與瀏覽器視覺/操作測試是不同階段,不能互相替代。發布教學請回原文,這份文件專注設計與寫作規範。