ساخت هبیت ترکر در ابسیدین

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

✨ امکانات

• 📅 گزارش‌های خودکار هفتگی، ماهانه و سالانه
• 🔥 تقویم هیت‌مپ، نمودار خطی و آمار دقیق
• 📌 داشبورد روزانه برای مشاهده وضعیت عادت‌ها
• ⛓️ ردیابی زنجیره‌ی فعلی و طولانی‌ترین زنجیره (نمایش جزئیات با هاور کردن)
• 🏆 تعیین دستاورد و نمایش مدال

🚀 نحوه استفاده

📥 دانلود و راه‌اندازی

1. ابتدا وارد صفحه ریپازیتوری شوید.
2. فایل‌ها را دانلود کنید. دو روش برای این کار وجود دارد:
   • روش ساده (دانلود ZIP): روی دکمه سبز رنگ Code کلیک کنید، گزینه Download ZIP را انتخاب کنید، سپس فایل ZIP را در کامپیوترتان ذخیره و Extract (استخراج) کنید.
   • روش حرفه‌ای (Clone با Git): اگر روی سیستم شما Git نصب است، در ترمینال یا CMD دستور زیر را وارد کنید:

git clone https://github.com/fardm/Obsidian-Habit-Tracker.git

3. فولدر پروژه را در ابسیدین از بخش Open folder باز کنید.
4. در اولین اجرا، پنجره‌ای نمایش داده می‌شود، روی گزینه‌ی Trust author and enable plugins کلیک کنید.
5. در سایدبار راست، تقویم قابل مشاهده است. با کلیک روی روزها: یادداشت روزانه ایجاد می‌شود، و با کلیک روی هفته/ماه/سال: گزارش هفتگی، ماهانه یا سالانه ساخته می‌شود.

🛠️ شخصی‌سازی عادت‌ها

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

1. فایل new day را باز کنید و در بخش پراپرتیز، عادت‌های خود را تعریف کنید.
2. فایل new habit را ویرایش کنید تا عادت شما به گزارش‌های هفتگی، ماهانه و سالانه اضافه شود. (🔍 پیشنهاد: از قابلیت Find & Replace برای ویرایش سریع استفاده کنید.)
3. کد مربوط به عادت جدید را در فایل‌های زیر نیز کپی کنید:

• 📅 new week
• 🌑 new month
• 🌏 new year

📂 مسیر ذخیره‌سازی

یادداشت‌های جدید به‌طور پیش‌فرض در پوشه‌ی journal ذخیره می‌شوند. اگر می‌خواهید مسیر را تغییر دهید، باید تنظیمات دو پلاگین را ویرایش کنید:

1. پلاگین Persian Calendar: مسیر روزنوشت، هفته‌نوشت، ماه‌نوشت و سال‌نوشت
2. پلاگین Templater: بخش Folder template

📊 داشبورد

در این تمپلیت یک فایل با عنوان dashboard وجود دارد. این فایل به صورت خودکار اطلاعات را از یادداشت‌های روزانه جمع آوری می‌کند.

⚙️ پیکربندی و شخصی‌سازی داشبورد

ابتدای این فایل، بخشی به نام CONFIG وجود دارد که همه‌ی تنظیمات اصلی در آن قرار دارد:

محل فایل‌ها (from)

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

const from = {
  tags: ["journal"],    //تگ موجود در روزنوشته‌ها
  paths: []             // مسیر پوشه‌هایی که فایل‌ها در آن هستند
};

---

منبع تاریخ (dateSource)

در این بخش مشخص می‌کنید که تاریخ هر یادداشت از کجا خوانده شود. اگر filename باشد، تاریخ از نام فایل (مثل 2025-08-15.md) خوانده می‌شود. اگر frontmatter باشد، تاریخ از یک فیلد در بخش پراپرتیز (frontmatter) یادداشت خوانده می‌شود.

const dateSource = {
  type: "filename",        // filename یا frontmatter
  frontmatterField: "date", // نام فیلد تاریخ در frontmatter
  dateFormat: "YYYY/MM/DD"  // فرمت تاریخ
};

---

تعریف عادت‌ها (habits)

در این بخش لیست عادت ها وارد می شود. هر عادت شامل ویژگی‌های زیر است:

const habits = [
  {
    id: "reading",               // شناسه یکتا عادت
    title: "",                       // نام عادت
    field: "📚reading",    // نام فیلدی که داده در آن ذخیره می‌شود
    type: "numeric",        // نوع داده: numeric یا boolean
    unit: "",                      // واحد اندازه‌گیری
    progressMax: 16,      // بیشترین مقدار برای نوار پیشرفت
 
    completeCondition: {    // شرایط تکمیل عادت
      kind: "gte",                  // نوع مقایسه: eq, gte, lte
      value: 1                       // مقدار مرجع برای تکمیل عادت
    },
 
    chain: {                    // تنظیمات زنجیره
      graceDays: 1,        // تعداد روزهای وقفه مجاز در زنجیره
      cupEvery: 15         // هر چند روز موفقیت کاپ تعلق می‌گیرد
    },
 
    achievement: [                  // محدوده و نشان‌های مدال
      { range: [10, 12], label: "🏅 سوپراستار" }, 
      { range: [7, 9],   label: "🥇 طلا" }, 
      { range: [4, 6],   label: "🥈 نقره" },
      { range: [1, 3],   label: "🥉 برنز" }, 
      { range: [0, 0],   label: "⚪" } 
    ],
 
    lowerIsBetter: false      // آیا مقدار کمتر بهتر است مثل سوشال مدیا
  }
];

روز مهلت (graceDays): این گزینه تعیین می‌کند که در شمارش زنجیره، چند روز وقفه مجاز دارید. اگر 0 باشد: هیچ ارفاقی وجود ندارد و زنجیره با یک روز وقفه قطع می‌شود. اگر 1 باشد: یک روز وقفه مجاز است. یعنی اگر یک روز نتوانستید عادت را انجام دهید، زنجیره همچنان ادامه پیدا می‌کند.

نوع مقایسه(kind):

• eq : مساوی بودن مثلا دقیقا ۳۰ دقیقه (یا مثلا ورزش که باید برابر با true باشد)
• gte : بیشتر یا مساوی بودن مثلا حداقل ۳۰ دقیقه (مناسب برای مطالعه که مقدار بیشتر بهتر است)
• lte : کمتر یا مساوی بودن مثلا حداکثر ۳۰ دقیقه (مناسب برای سوشال مدیا که مقدار کمتر بهتر است)

🎥 آموزش ویدئویی

در این ویدئو می‌توانید آموزش استفاده از این هبیت ترکر را مشاهده کنید.

⚠️ توجه

این ویدئو قبل از آپدیت‌های تمپلیت ضبط شده است. پس این موارد رو در نظر داشته باشید:

• لینک دانلود قبلی(پیکوفایل) وجود ندارد و باید تمپلیت را از گیت هاب دانلود کنید.
• بخش داشبورد بعدا اضافه شده و در ویدئو وجود ندارد.
• در آپدیت جدید Persain Calendar (نسخه 3.0.1) عبارت معنادار اول سال و آخر سال به پلاگین اضافه شده و دیگر نیازی نیست برای ساختن گزارش‌های سالانه تاریخ‌ شروع و پایان سال را به صورت دستی وارد کنید. با کلیک روی سال‌نوشت معادل تاریخ میلادی به طور اتوماتیک وارد می‌شود.