Skip to content

persiancal/cal-events

Repository files navigation

رویدادهای تقویم ایران

Build Status

هدف این مخزن، جمع‌آوری و به روز نگه‌داشتن رویدادهای مهم در تقویم کشورهای پارسی زبان است.

مهم یعنی چه؟

معیار اینکه یک رویداد مهم است یا نیست و باید اینجا اضافه شود یا نه، ویکی‌پدیاست. ما تنها این رویدادها را جمع‌آوری میکنیم، تعیین اینکه آیا یک رویداد به اندازه کافی سرشناس هست که به این مخزن اضافه شود یا نه برمبنای ویکی‌پدیاست، نه تصمیم شخصی یا گروهی افرادی که این مخزن را مدیریت میکنند.

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

برای افزودن یک رویداد یا اصلاح یک رویداد موجود میتوانید یا یک گزارش اشکال پر کنید یا که یک درخواست ادغام ایجاد کنید.

فایلهای موجود در پوشه docs را برای توضیح ساختار ببینید

چگونه از این مخزن دربرنامه‌ام استفاده کنم؟

فایلهای موجود در برنچ master برای استفاده در برنامه شما نیست. فایل‌های نتیجه در برنچ gh-pages هستند و فایلهای برنچ مستر سورس فایل نهایی ساخته شده در برنچ gh-pages است. اگر شما می‌خواهید که از این رویدادها استفاده کنید، لطفا این برنچ را ببینید.[1]

من این رویدادها را با فرمت XXX نیاز دارم

در حال حاضر فرمتهای «خروجی» پشتیبانی شده ‍yaml و ‍json هستند. اگر فرمت دیگری مدنظر شماست میتوانید آن‌را به ابزار ما اضافه کنید (این ابزار با Go نوشته شده است) یا اگر نمی‌توانید یک درخواست جدید ایجاد کنید.

چرا Yaml!

برای ورودی اطلاعات (و نه خروجی)‌ما yaml را انتخاب کردیم به دلایل زیر :

  • این فرمت در مقایسه با json یا xml برای افراد غیر برنامه‌نویس (کسانی که کامپیوتری نیستند) خواناتر است
  • فرمت json را میتوان به هر صورتی نوشت. برای برنامه، چندان فرقی نمیکند، ولی برای فایلی که قرار است توسط انسان نگهداری شود مناسب نیست. در صورتی که yaml حتی تو رفتگی را هم اجبار میکند
  • در نهایت اینکه این ساختار در خروجی تاثیری ندارد و در خروجی همچنان همه فرمتهایی که لازم هستند ایجاد میشوند

[1] به زودی با کمک قابلیت انتشار گیت‌هاب، یک وب سایت استاتیک با لینک دانلود برای رویدادها ایجاد میشود.

About

calendar event database for persian calendar

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published