راهنمای مشارکت
نحوه نوشتن مقاله، استانداردهای محتوا و روند ارسال در 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 باید کلید انگلیسی باشد.
دستهبندیهایی که بیشتر به مقاله نیاز دارند: اقتصاد، جامعه، علم و فناوری و طبیعت.