撰寫部落格文章
- 完整閱讀
docs/blog-guidelines.md。其規則具有約束力。 - 將
docs/blog-template.md複製到src/content/blog/en/<slug>.md,並撰寫英文版本。 - 在
src/content/blog/de/<german-slug>.md中撰寫德文版本,並使用相同的translationKey。進行在地化處理,使用「Sie」敬稱。 - 僅使用 Fabian 已確認的經驗與範例(來自簡報、專案記憶、他的訊息)。若缺少範例,請詢問他,而不是自行編造。
- 對兩個版本進行 AI 廢話審查(參見指南中的「No AI slop」):刪除任何可套用於任何文章的句子,將通用主張替換為 Fabian 的具體事實,然後朗讀一次。
- 繪製部落格總覽的卡片圖像:在
src/lib/card-drawings.ts中為文章的translationKey新增一個項目(輕量技術繪圖,包含文章事實的英文/德文標籤,請參見指南中的「Card image」)。每篇文章都有一個;缺少它建置就會失敗。 - 當文章準備好時設定
draft: false,然後執行npm run build。修正check-blog.mjs或內容結構的所有訊息。 - 檢視建置完成的文章頁面一次,以及
/blog/上的卡片(頂部的重點摘要框、可折疊 FAQ、作者區塊、包含「預約諮詢」按鈕和底部聯絡表單的聯絡區域)和dist/og/<lang>/<slug>.png中生成的預覽圖片。 當主題適合時,建議加入解說圖表(請參見指南中的 Images)。 - 開啟 Pull Request,並在 PR 或討論串中為 Fabian 加入 2–3 則 LinkedIn 預告草稿。
請勿為了單一文章更改範本元件(src/components/BlogPost.astro、BlogIndex.astro)。版面變更會影響所有文章。