跳至內容

參與貢獻

本站所有內容都放在 GitHub 儲存庫,任何人都能參與——小至改錯字,大至寫整篇教學。

最快的方式:直接在 GitHub 編輯

每篇文章底部都有「在 GitHub 上編輯此頁」連結,點進去修改後送出,GitHub 會自動引導你完成 fork 與 Pull Request。

新增一篇文章

  1. Fork 並 clone 儲存庫(記得 --recurse-submodules)

  2. 依內容類型把 Markdown 檔放到對應目錄:

    內容位置
    教學content/docs/guides/
    硬體介紹content/docs/hardware/
    消息、心得content/blog/

  3. 檔名用小寫英文加連字號,例如 solar-node.md;文章需要附圖時改用資料夾形式:solar-node/index.md,圖片放同一個資料夾

  4. 檔案開頭加上 front matter:

    ---
title: "文章標題"
description: "一句話摘要(顯示於列表與搜尋結果)"
date: 2026-08-28
tags: [標籤]
draft: false
---

  5. 本機預覽:hugo server -D,瀏覽 http://localhost:1313

  6. 發 Pull Request,審核合併後網站自動更新

撰寫慣例

  • 使用台灣慣用的繁體中文;技術名詞第一次出現時附上英文
  • 教學文多放截圖,圖片請先壓縮(建議單張 300 KB 以內)
  • 文件區文章以 front matter 的 weight 控制側欄順序,數字小的排前面