加入我們

共同構建開源農業知識平台

你可以這樣貢獻

✍️

撰寫新文章

分享你的農業知識、技術心得或案例經驗，幫助更多人學習。

🔍

改進現有文章

修正錯誤、補充案例、優化結構，讓內容更完善。

🐛

回報問題

發現內容錯誤或網站問題？直接開 Issue 告訴我們。

💭

提出建議

建議新的主題、分類或功能，幫助我們改進平台。

快速開始

1

Fork 本 Repository

前往 GitHub 專案頁面 ，點擊 Fork 按鈕，將專案複製到自己的帳號。

2

選擇內容分類

打開 knowledge/ 目錄，選擇相應的分類資料夾：

  • Agri-Basics/ — 農業基礎入門
  • Agri-Advanced/ — 農業進階實務
  • Farm-Management/ — 農場經營管理
  • Crop-Production/ — 作物生產技術
  • Facility-Farming/ — 設施農業
  • Smart-Farming/ — 智慧農業
  • Agri-Marketing/ — 農產品銷售
  • Grants-Planning/ — 計畫撰寫補助
  • Field-Visits/ — 場域交流觀摩
  • Livestock-Health/ — 畜牧健康
3

新增或編輯 Markdown 檔案

建立或編輯 .md 檔案，遵循以下 Frontmatter 模板： 

---
title: '文章標題'
description: '一句話摘要（50 字以內）'
date: 2026-04-18
tags: [國本學堂, 相關標籤]
subcategory: '子分類名稱'
level: '初階'
source: '資料來源'
featured: false
status: 'published'
---

# 文章內容
從這裡開始寫你的內容...
4

測試與驗證

在本地執行以下命令驗證文章：

npm install
npm run test
npm run build

確認沒有錯誤後再提交 PR。

5

提交 Pull Request

將變更 Push 到你的 Fork，然後開啟 Pull Request。 在 PR 描述中簡述：

  • 文章主題與內容概要
  • 為什麼這個主題很重要
  • 是否有相關參考資料或來源
6

維護者審核與發布

維護者會審查你的 PR，可能會提出建議或要求修改。 通過審核後，你的文章就會被合併到主分支並自動發布。

內容準則

📍 與嘉義農業相關

優先涵蓋嘉義地區的農業實務、作物、技術與經營模式。不排斥全台灣或國際案例，但應與嘉義情況對應。

🎯 實用導向

內容應具備實踐價值。避免過度理論化；盡可能舉例、提供步驟、分享技巧。

📚 標明來源

引用他人研究、數據或經驗時，務必註明出處。使用腳註或參考資料欄位。

📝 繁體中文

使用繁體中文撰寫。專有名詞可保留原文（如英文農業術語），但需在首次出現時附註。

🔗 跨文章連結

使用 [[文章標題]] 語法建立連結，例如 [[土壤基礎知識]]。

🖼️ 圖片與媒體

圖片應遵循 CC 授權。如不確定授權狀態，請避免使用或在文章中說明。

Frontmatter 欄位說明

title ✅ 必填

文章標題，簡潔清晰，避免超過 60 個字元。

例：「小番茄栽培技術：從育苗到採收」

description ✅ 必填

一句話摘要，50 字以內，讓讀者快速了解文章內容。

例：「掌握小番茄從選種、育苗、定植到採收的完整流程。」

date ✅ 必填

發布或最後編輯日期，格式：YYYY-MM-DD

例：2026-04-18

tags ✅ 必填

標籤陣列，至少包含「國本學堂」，可添加相關主題。

例：[國本學堂, 小番茄, 栽培技術]

subcategory ✅ 必填

子分類名稱，用來組織同類別下的文章。

例：「育苗技術」（在 Crop-Production 類別下）

level ✅ 必填

難度等級：初階 / 進階 / 卓越

例：進階

source ✅ 必填

內容來源，可為課程、書籍、研究、實務經驗等。

例：「嘉義國本學堂農業課程、農場實驗」

featured 選填

是否在分類首頁特別推薦。true / false

預設：false

status 選填

文章狀態：draft / published / archived

預設：published

crop 選填

相關作物陣列，用於作物相關文章。

例：[小番茄, 百香果]

tech 選填

相關技術或主題陣列。

例：[滴灌系統, 環控技術]

instructor 選填

課程講師或內容貢獻者名稱。

例：「陳建築、王農業」

courseDate 選填

課程日期，格式：YYYY-MM-DD

例：2025-03-15

審核流程

📝

提交 PR

你的 PR 被提交到我們的 GitHub repo。

🔍

格式驗證

自動工具檢查 Frontmatter、Markdown 格式與內容品質。

👥

人工審核

維護者逐字審查內容、準確性與適當性。

💬

反饋與迭代

如有需要，我們會提出修改建議或要求澄清。

✅

合併與發布

通過審核後，PR 被合併，文章自動發布到網站。

需要幫助？

📚 查看範例

瀏覽 knowledge/ 內現有的文章，了解格式與風格。

💌 聯絡我們

有問題或想討論想法？歡迎開啟 GitHub Discussions 。

📖 閱讀 CONTRIBUTING.md

詳細的貢獻指南請見 專案 README 。

準備好貢獻了嗎？

無論你是農業專家、學生或熱愛分享的社群成員，你的貢獻都很重要！

造訪 GitHub 專案 回到首頁