Skip to content

maleknejad/obsidian-persian-calendar

Repository files navigation

Obsidian Persian Calendar

This tool lets you see events, add and organize notes from daily to yearly on the Persian calendar, use templates with placeholders, and works with all Obsidian daily plugins.

تقویم فارسی ایسیدین

Usage

  • Can add daily, weekly, monthly, quarterly and yearly notes based on Persian calendar.
  • Modify path for creating notes.
  • Can reference notes by typing @ or selecting them.
  • Can add {{placeholders}} in templates to enrich your templates. Works fine with Templater plugin for note templates.
  • Works fine with all obsidian daily plugins.
  • Works with Georgian and Hijri calendar in one view.
  • Showing events of Iranian official calendar.

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

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

نمای اصلی افزونه تقویم فارسی ابسیدین

قابلیت‌ها

  • ایجاد یادداشت‌های روزانه، هفتگی، ماهانه، فصلی و سالانه
  • برای یادداشت‌های روزانه و هفتگی موجود در فولدری که تعریف شده است یک نقطه زیر آن‌ها نمایش داده می‌شود.
  • سازگاری کامل با افزونه Templater
  • سازگاری با تم‌های اصلی ابسیدین
  • امکان رفرنس دادن به یادداشت‌ها از طریق تایپ کردن '@' یا سلکت کردن عبارت‌ها برای قالب‌ها.
  • امکان قرار دادن {{عبارت‌های معنادار}} در قالب‌ها برای غنی‌تر کردن یادداشت‌ها
  • ذخیره‌سازی فایل‌های روزنوشت به میلادی برای سازگاری بیشتر با افزونه‌های ابسیدین
  • قابلیت نمایش همزمان تقویم میلادی و قمری
  • نمایش رویدادهای تقویم شمسی و میلادی و هجری
  • امکان تنظیم نمایش رویدادها

راهنمای نصب

این افزونه در مخزن افزونه‌های ابسیدین نمایه شده است. برای نصب افزونه کافیست از طریق تنظیمات در بخش Community plugins نام Persian Calendar را جستجو کنید و افزونه را نصب کنید. بعد از فعالسازی افزونه در صورتی که افزونه را در سایدبار سمت چپ نمی‌بینید، با دستور «باز کردن تقویم فارسی» آن را در سایدبار باز کنید. پس از اجرای دستور، افزونه باید در سایدبار سمت چپ بالا به شما نمایش داده شود.

راهنمای استفاده

پس از نصب افزونه اولین کار مهم تعریف مسیرهای ایجاد فایل‌هاست. برای این کار به تنظیمات افزونه رفته و مسیرهای تولید فایل‌ها را مطابق توضیحات درج شده مشخص کنید. قبل از تنظیم مسیر، آن را در ابسیدین ایجاد کنید و برای تعریف کردن مسیر ابتدای آن / نگذارید. مسیر تعریف فایل را از ریشه اصلی ارجاع دهید. پس از مشخص کردن مسیرها برای مشخص کردن قالب تولید افزونه Templater را نصب کنید و مسیر قالب‌ها را مشخص کنید.

تنظیمات افزونه

آموزش استفاده به همراه افزونه Templater

با استفاده از افزونه Templater می‌توانید قالب‌های مشخصی را برای یاداشت‌های روزانه، هفتگی، ماهانه، فصلی و سالانه خود مشخص کنید: کافیست افزونه Templater را نصب کنید و مطابق تصویر زیر برای هر نوع از فایل‌ها یک قالب به افزونه معرفی کنید. در نظر داشته باشید مسیرهایی که به افزونه معرفی می‌کنید با مسیرهای مشخص شده در تنظیمات افزونه یکسان باشد. حتما باید گزینه Trigger Templater on new file creation روشن باشد. برای غنی‌تر کردن قالب‌ها حتما بخش عبارت معنادار این افزونه را مطالعه کنید.

راهنمای استفاده به همراه Templater

امکان درج عبارت معنادار در قالب‌ها

میتوانید با درج عبارت‌های معنادار زیر تاریخ‌ها را در قالب‌ها اضافه کنید:

مقادیر نمونه توضیحات عبارات
1403-08-03‍‍ تاریخ امروز را به شمسی برمی‌گرداند {{امروز}}‍‍
1403-02-01‍‍ تاریخ مرتبط با روزنوشت را به شمسی برمی‌گرداند {{این روز}}
پنج‌شنبه نام روز هفته‌ی امروز را برمی‌گرداند {{روز هفته}}
شنبه نام روز هفته‌ی مرتبط با روزنوشت را برمی‌گرداند {{این روز هفته}}
1403-W32 شماره هفته امروز را به شما برمی‌گرداند {{هفته}}
1403-W6 شماره هفته‌ی مرتبط با روزنوشت را برمی‌گرداند {{این هفته}}
1403-8 شماره ماه را برمی‌گرداند {{ماه}}
1403-2 شماره ماه مرتبط با روزنوشت را برمی‌گرداند {{این ماه}}
1403-Q3 شماره فصل را برمی‌گرداند {{فصل}}
1403-Q1 شماره فصل مرتبط با روزنوشت را برمی‌گرداند {{این فصل}}
1403 سال را برمی‌گرداند {{سال}}
1403 سال مرتبط با روزنوشت را برمی‌گرداند {{این سال}}
32 تعداد روزهای گذشته از ابتدای سال را بر اساس روزنوشت به شما برمی‌گرداند {{روزهای گذشته}}
333 تعداد روزهای باقی‌مانده تا پایان سال را بر اساس روزنوشت به شما برمی‌گرداند {{روزهای باقیمانده}}
1403-01-01 روز اول هفته‌نوشت را به شمسی یا میلادی (بر اساس تنظیمات اعمال شده) برمی‌گرداند. فقط در هفته‌نوشت کار میکند. {{اول هفته}}
1403-01-01 روز آخر هفته‌نوشت را به شمسی یا میلادی (بر اساس تنظیمات اعمال شده) برمی‌گرداند.فقط در هفته‌نوشت کار میکند. {{آخر هفته}}
1403-01-01 روز اول ماه‌نوشت را به شمسی یا میلادی (بر اساس تنظیمات اعمال شده) برمی‌گرداند.فقط در ماه‌نوشت کار میکند. {{اول ماه}}
1403-01-01 روز آخر ماه‌نوشت را به شمسی یا میلادی (بر اساس تنظیمات اعمال شده) برمی‌گرداند.فقط در ماهنوشت کار میکند. {{آخر ماه}}
1403-01-01 روز اول سال‌نوشت را به شمسی یا میلادی (بر اساس تنظیمات اعمال شده) برمی‌گرداند.فقط در سال‌نوشت کار میکند. {{اول سال}}
1403-12-30 روز آخر سال‌نوشت را به شمسی یا میلادی (بر اساس تنظیمات اعمال شده) برمی‌گرداند. فقط در سال‌نوشت کار می‌کند. {{آخر سال}}
متنی که در تولتیپ نمایش داده می‌شود مناسبت‌های هر روز (بر اساس تنظیمات اعمال شده) برمی‌گرداند {{مناسبت‌}}

دقت داشته باشید باید دقیقا این عبارت ها با همین فرمت در روزنوشت‌ها درج شود. این قابلیت افزونه با طور کامل با قابلیت‌های افزونه Templater هماهنگ است و پس از ساخته شدن قالب توسط این افزونه با 500 میلی‌ثانیه تاخیر اجرا می‌شود. placeholders

امکان ارجاع به یادداشت‌ها از طریق تایپ کردن '@' یا انتخاب کردن

میتوانید از طریق تایپ کردن نویسه '@' در وسط نوشته‌ها به یادداشت‌های خود ارجاع دهید. یادداشت‌های پشتیبانی شده تا به امروز:

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

امکان نامگذاری یادداشت‌ها بر اساس تقویم میلادی

بسیاری از افزونه‌های ابسیدین بر اساس تاریخ میلادی فعالیت می‌کنند. در تنظیمات می‌توانید مشخص کنید که یادداشت‌ها به صورت میلادی نام‌گذاری شوند و با استفاده از {{عبارت‌های معنادار}} تقویم شمسی را به آن‌ها اضافه کنید. می‌توانید با انتخاب این موضوع تمامی قابلیت‌های افزونه را هماهنگ با افزونه‌های مختلف ابسیدین که با روزنوشت‌ها کار می‌کنند داشته باشید.

دستورات تعریف شده در افزونه

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

  • دسترسی به روزنوشت، هفته‌نوشت، ماه‌نوشت، فصل‌نوشت و سال‌نوشت جاری
  • ارجاع متن سلکت شده به یادداشت مرتبط
  • تبدیل تاریخ بین شمسی و میلادی به صورت خودکار و با فرمت‌های مختلف از جمله1403/02/01 یا 14030201 یا1403-02-01 . (سال بیشتر 1500 میلادی و کمتر آن شمسی است.این حرکت اشتباه اما کار راه‌اندازتر است!)

دستورات تعریف شده در تقویم

قابلیت نمایش تقویم میلادی

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

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

قابلیت نمایش تقویم قمری و میلادی به صورت همزمان

در تنظیمات تقویم میتوانید مشخص کنید تقویم قمری نمایش داده شود یا خیر. این تنظیمات باعث میشود که بتوانید در کنار تقویم شمسی و میلادی تقویم قمری را هم داشته باشید.

تنظیم نمایش مناسبت‌های در تقویم

مناسبت‌های تقویم ایران به این افزونه اضافه شده است. میتوانید تنظیم کنید در تولتیپ (وقتی موس را روی روز قرار می‌دهید باکسی نمایش داده می‌شود که به آن تولتیپ می‌گویند) چه رویدادهایی را نمایش دهد. به صورت معمول سه دسته رویداد در تقویم ایران وجود دارد:

  • رویدادهای تقویم رسمی: این رویدادها به صورت رسمی در کشور تصویب شده‌اند
  • رویدادهای باستانی:‌ رویدادهای که در تقویم باستانی ایران وجود دارد
  • رویدادهای شیعی: رویدادهایی که در تقویم شیعیان درج شده است و با تقویم هجری تنظیم شده است. تقویم رسمی ایران با برخی از رویدادهای شیعی تقارن دارد. بنابراین اگر مایلید رویدادهای تقویم رسمی ایران را داشته باشید همزمان رویدادهای شیعی را فعال کنید.

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

مسیر مشارکت در توسعه افزونه

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

About

Persian Calendar for Obsidian.md

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •