← بازگشت به خانه

راهنمای مشارکت

نحوه نوشتن مقاله، استانداردهای محتوا و روند ارسال در Iran.md

چگونه مشارکت کنیم

سه راه اصلی برای مشارکت در Iran.md وجود دارد:

۱

نوشتن مقاله جدید

موضوعی درباره ایران انتخاب کنید، با منابع معتبر بنویسید و به صورت Markdown ارسال کنید.

۲

بهبود مقاله‌های موجود

اصلاح خطاها، افزودن منابع جدید، به‌روزرسانی اطلاعات قدیمی یا بهبود نگارش.

۳

ترجمه به انگلیسی

مقاله‌های فارسی را به انگلیسی ترجمه کنید تا مخاطبان بین‌المللی هم دسترسی داشته باشند.

ساختار مقاله

هر مقاله یک فایل Markdown است که با بخش frontmatter شروع می‌شود. الگوی کامل فیلدها:

---
title: "English Title"
title_fa: "عنوان فارسی"
category: history
tags:
  - تگ۱
  - تگ۲
date: 2026-01-15
last_updated: 2026-03-01
summary: "English summary of the article."
summary_fa: "خلاصه فارسی مقاله."
ai_summary: "A single sentence for AI (max 280 chars)."
language: fa
related:
  - slug-of-related-article
sources:
  - title: "Source Title"
    url: "https://example.com"
    access_date: "2026-01-10"
    type: academic
    language: en
license: CC-BY-SA-4.0
---

مدل سه‌لایه عمق محتوا

هر مقاله باید سه سطح خوانش را پوشش دهد:

۱

مرور ۳۰ ثانیه‌ای

خلاصه‌های summary و summary_fa در frontmatter.

۲

خوانش ۵ دقیقه‌ای

پاراگراف‌های ابتدایی هر بخش که مفاهیم اصلی را پوشش می‌دهند.

۳

مقاله کامل

جزئیات، شواهد، نقل‌قول‌ها و تحلیل‌های عمیق‌تر.

نمونه اسکلت مقاله

---
title: "Chelow Kabab"
title_fa: "چلوکباب"
category: food
tags:
  - غذا
  - کباب
date: 2026-02-01
summary: "Chelow kabab is Iran's national dish."
summary_fa: "چلوکباب غذای ملی ایران است."
ai_summary: "Chelow kabab is Iran's iconic dish of saffron rice and grilled meat."
language: fa
sources:
  - title: "Iranian Cuisine - Encyclopaedia Iranica"
    url: "https://www.iranicaonline.org/articles/cuisine"
    access_date: "2026-01-20"
    type: reference
license: CC-BY-SA-4.0
---

## چلوکباب چیست

پاراگراف معرفی کوتاه...

## پیشینه تاریخی

توضیحات تاریخی با ذکر منبع...

## انواع کباب ایرانی

شرح انواع مختلف...

استانداردهای محتوا

  • هر ادعا باید منبع داشته باشد — اعداد، تاریخ‌ها و گزاره‌های واقعی باید با منبع معتبر پشتیبانی شوند.
  • رویکرد چند‌دیدگاهی برای موضوعات بحث‌برانگیز — اگر موضوعی محل اختلاف است، همه دیدگاه‌های اصلی را بیاورید. برای مثال، درباره تاثیر تحریم‌ها بر اقتصاد: هم دیدگاه نهادهای بین‌المللی و هم داده‌های داخلی را ارائه دهید و قضاوت نهایی را به خواننده بسپارید.
  • لحن بی‌طرفانه — بگذارید منابع و داده‌ها سخن بگویند. از عبارات احساسی یا جهت‌دار بپرهیزید.
  • بدون اظهارنظر شخصی — جانب هیچ‌کس را نگیرید. وظیفه مقاله ارائه اطلاعات است، نه متقاعدسازی.

منابع معتبر

منابع آکادمیک و نهادی در اولویت هستند. انواع منابع قابل قبول:

academic

مقالات علمی و پژوهشی

institutional

سازمان‌های بین‌المللی و دولتی

primary

اسناد دست اول و آرشیوی

reference

دایره‌المعارف‌ها و مراجع تخصصی

journalistic

گزارش‌های خبری معتبر (در صورت نبود منبع بهتر)

منابع کلیدی پیشنهادی

  • Encyclopaedia Iranica — دایره‌المعارف جامع ایران‌شناسی
  • UNESCO — میراث فرهنگی و داده‌های آموزشی
  • World Bank — داده‌های اقتصادی و توسعه‌ای
  • Iran Data Portal — آمار و داده‌های دانشگاه پرینستون
  • گنجور (Ganjoor) — آرشیو ادبیات کلاسیک فارسی

فرمت منابع در frontmatter

sources:
  - title: "Nowruz - UNESCO"
    url: "https://ich.unesco.org/en/RL/nowruz-00282"
    access_date: "2026-03-15"
    type: institutional
    language: en
  - title: "نوروز - دایره‌المعارف بزرگ اسلامی"
    url: "https://www.cgie.org.ir/fa/article/12345"
    access_date: "2026-03-15"
    type: reference
    language: fa

نکات فنی فارسی‌نویسی

  • نیم‌فاصله (ZWNJ) را درست استفاده کنیدمی‌خواهم درست است، نه میخواهم یا می خواهم.
  • ی فارسی (ی) به جای ي عربی — حرف «ی» فارسی بدون نقطه زیر است. از «ي» عربی استفاده نکنید.
  • ک فارسی (ک) به جای ك عربی — حرف «ک» فارسی با سرکش بالا نوشته می‌شود. از «ك» عربی استفاده نکنید.
  • ارقام فارسی (۱۲۳) در متن، ارقام لاتین (123) در frontmatter — در متن مقاله از ارقام فارسی استفاده کنید. در فیلدهای frontmatter مانند تاریخ از ارقام ASCII استفاده کنید.
  • بررسی خودکار CI — سیستم CI این موارد را به‌صورت خودکار بررسی می‌کند. اگر خطایی وجود داشته باشد، پیش از ادغام اطلاع داده می‌شود.

روند ارسال

۱

Fork کنید

مخزن Iran.md را در GitHub فورک کنید.

۲

مقاله بسازید

فایل Markdown جدید را در پوشه knowledge/fa/ ایجاد کنید. نام فایل باید slug انگلیسی باشد، مثلا persian-garden.md.

۳

فیلدهای frontmatter را کامل کنید

تمام فیلدهای اجباری را پر کنید. حداقل یک منبع معتبر اضافه کنید.

۴

Pull Request بفرستید

تغییرات را commit کنید و PR بزنید.

۵

بررسی و ادغام

مقاله از نظر دقت محتوا، کیفیت منابع و رعایت استانداردها بررسی می‌شود. در صورت نیاز به اصلاح، بازخورد داده می‌شود.

امنیت مشارکت‌کنندگان

  • مشارکت با نام مستعار کاملا پذیرفته است.
  • نیازی به ارائه نام واقعی یا موقعیت مکانی نیست.
  • از هر نام کاربری GitHub که می‌خواهید استفاده کنید.
  • در موضوعات حساس، احتیاط بیشتری به خرج دهید و از اطلاعات شناسایی‌کننده شخصی خودداری کنید.

۱۲ دسته‌بندی

هر مقاله باید در یکی از دسته‌بندی‌های زیر قرار بگیرد. مقدار فیلد category در frontmatter باید کلید انگلیسی باشد.

تاریخ history
جغرافیا geography
فرهنگ culture
غذا food
هنر art
موسیقی music
علم و فناوری science
طبیعت nature
چهره‌ها people
جامعه society
اقتصاد economy
ادبیات literature

دسته‌بندی‌هایی که بیشتر به مقاله نیاز دارند: اقتصاد، جامعه، علم و فناوری و طبیعت.

شروع مشارکت در GitHub