نمونه های کاربردی پلاگین دیتاویو

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

۱. محاسبات

جمع زدن

برای جمع مقادیر موجود در یک پراپرتی می توانید از تابع sum استفاده کنید:

TABLE WITHOUT ID
	sum(rows.yourproperties)
GROUP BY ""

‌

شمردن

با تابع length می توانید فایل ها را بشمارید. فرض کنید می خواهید هر فایلی که تگ book دارد را بشمارید. تابع زیر این کار را انجام می دهد:

TABLE WITHOUT ID
	length(rows) + " جلد کتاب" as count,
FROM #Book 
GROUP BY ""

می توانید نتایج را فیلتر کنید. مثلا فقط پراپرتی هایی جمع آوری شود که مقدار آن برابر با true باشد. تابع زیر این کار را انجام می دهد:

TABLE WITHOUT ID
    length(filter(rows, (r) => r. yourproperties= true))
GROUP BY ""

میانگین، حداکثر، حداقل

با توابع زیر هم میتوانید میانگین، حداکثر و حداقل اعداد را محاسبه کنید:

TABLE WITHOUT ID Count, Total, Average, Minimum, Maximum
GROUP BY ""
FLATTEN length(rows.yourproperties) as Count
FLATTEN sum(rows.yourproperties) as Total
FLATTEN Total / Count as Average
FLATTEN min(rows.yourproperties) as Minimum
FLATTEN max(rows.yourproperties) as Maximum

توضیحات بیشتر

Dataview Sums and Average

رند کردن

از تابع round می توانید برای رند کردن اعداد استفاده کنید. مثلا تابع زیر جمع یک پراپرتی خاص را رند کرده و رقم اعشاری را مخفی میکند:

round(sum(rows.yourproperties))

همچنین می توانید مشخص کنید چند رقم اعشار نمایش داده شود. مثلا تابع زیر فقط دو رقم اعشار را نمایش می دهد:

round(sum(rows.yourproperties),2)

با این تابع میتوانیم واحد جمع زدن را هم مشخص کنیم. فرض کنید در یک پراپرتی مدت زمان را وارد کردید. به این شکل:

file1
---
length: 3h
---
 
file2
---
length: 2h 50min
---
 
 file3...

اگر این مقادیر را جمع بزنیم دیتاویو به طور پیشفرض با افزایش حاصل جمع از واحد های بزرگ تر استفاده میکند. مثلا 25 ساعت را 1 روز 1 ساعت نمایش میدهد. یا 169 ساعت را یک هفته و یک ساعت نشان می دهد و همین طور با ماه و سال. با تابع round می توانیم مشخص کنیم که جمع زدن بر اساس چه واحدی باشد. مثلا تابع زیر حاصل جمع را به ساعت نشان می دهد:

round(sum(rows.length.hours),1)

درصد گرفتن

می خواییم درصد بگیریم. مثلا ببینیم یه کار چه قدر پیشرفت کرده. یا مثلا مشغول مطالعه کتاب هستیم چه قدر از کتاب رو مطالعه کردیم. این صفحه یادداشت شماست:

---
title: your-title
tags: book
current: 150
total: 300
---

تعداد کل صفحات در پراپرتی total می نویسیم و تعداد صفحاتی که خوانده شده را در current. برای درصد گرفتن نیاز به یک ضرب و تقسیم ساده داریم: current÷total×100.

به این شکل:

TABLE WITHOUT ID
    title as Title,
	round(current/total*100) + "%" as Progress
FROM #book

۲. نمایش نوار پیشرفت

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

<progress max=100 value=75> </progress> 75%

به این شکل:

75%

مقدار value و max این نوار پیشرفت تنظیم می‌شود. value درصد تکمیل‌شدن تسک‌ها را نشان می‌دهد و max='100' حداکثر مقدار نوار را به 100 تنظیم می‌کند.

از این نوار پیشرفت برای نمایش موارد مختلفی میشه استفاده کرد اینجا به دو موردش اشاره میکنم:

حالت اول: جمع آوری تسک‌ها

فرض کنید توی یک صفحه تسک های مختلفی ایجاد کردید حالا میخوایید درصد پیشرفت کار رو مشاهده کنید. مثلا این محتوای یادداشت شماست:

- [x] کار یک
- [ ] کار دو
- [ ] کار سه
- [ ] کار چهار

با استفاده از این کد می تونیم درصد پیشرفت کار رو ببینیم:

TABLE WITHOUT ID
	"<progress value='" + (length(filter(this.file.tasks.completed, (t) => t = true)) / length(this.file.tasks)) * 100 + "' max='100'></progress>" + round((length(filter(this.file.tasks.completed, (t) => t = true)) / length(this.file.tasks)) * 100) + "% completed" as "Progress Bar"
GROUP BY ""

نتیجه کار به این شکل خواهد بود:

25%

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

TABLE WITHOUT ID
Total, Complete,  "<progress value='" + (Complete * 100 / Total) + "' max='100'></progress>" AS "Progress Bar", Percent
FROM ""
WHERE file.tasks 
GROUP BY ""
FLATTEN length(sum(rows.file.tasks.status)) as Total
FLATTEN length(filter(sum(rows.file.tasks.status), (t) => t = "A" or t = "x")) as Complete
FLATTEN round(Complete * 100 / Total) + "%" as Percent

نتیجه میشه این:

اگر هم میخوایید خلاصه تر باشه و فقط نوار و درصد رو نشون بده از این استفاده کنید:

TABLE WITHOUT ID
round(Complete * 100 / Total) + "% " + "<progress value='" + (Complete * 100 / Total) + "' max='100'></progress>" AS "Progress Bar"
FROM ""
WHERE file.tasks 
GROUP BY ""
FLATTEN length(sum(rows.file.tasks.status)) as Total
FLATTEN length(filter(sum(rows.file.tasks.status), (t) => t = "A" or t = "x")) as Complete

توضیحات بیشتر

Progress bar for notes (Easy and powerful) with dataview

Progress bar for incomplete/total tasks

Dataview query for all tasks in folder with custom status

حالت دوم: محاسبه پراپرتی‌ها

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

روش اول

اون کد رو مستقیما توی پراپرتی وارد کنید به این شکل:

---
title: your-title
tags: note
progress_bar: <progress max=100 value=0> </progress> 0%
---

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

TABLE WITHOUT ID
    title as Title,
	 progress_bar as "Progress Bar"
FROM #note

نتیجه کار به این شکل خواهد بود:

روش دوم

این روش یه کم پویا تره. به جای اینکه کد نوار پیشرفت رو داخل پراپرتی ها قرار بدیم داخل دیتا ویو قرار میدیم. یعنی داخل پراپرتی فقط عدد(درصد پیشرفت کار) رو وارد می کنیم. بعد با استفاده از دیتا ویو اون عدد رو به صورت نوار پیشرفت نمایش میدیم.

فرض کنید این یادداشت شماست:

---
title: your-title
tags: note
progress_bar: 25
---

اینجا در پراپرتی progress_bar مثلا مشخص کردیم که 25 درصد کار پیش رفته. حالا با کد زیر می تونیم توی دیتا ویو نمایش بدیم:

TABLE WITHOUT ID
    title as Title,
	 "<progress max=100 value=" + progress_bar + "> </progress> " + progress_bar + "%" as "Progress Bar"
FROM #note

نتیجه به این شکل خواهد بود:

25%

روش سوم

بعضی وقتا درصد کار مشخص نیست و میخواییم خود دیتا ویو اون رو محاسبه کنه. فرض کنید در حال مطالعه یک کتاب هستیم. تعداد کل صفحات 300 صفحه است و ما 150 صفحه رو خوندیم حالا می خوایم پیشرفت کار رو بیینیم. توی صفحه یادداشت این موارد رو نیاز داریم:

---
title: your-title
tags: book
current: 150
total: 300
---

بالاتر نحوه محاسبه کردن و درصد گرفتن رو توضیح دادم اینجا عینا از همون کد استفاده می کنیم فقط کد رو باید به نحوی جایگذاری کنیم که نتیجه نهایی به جای نمایش یک عدد یک نوار پیشرفت رو نشون بده. به این شکل:

TABLE WITHOUT ID
    title as Title,
    "<progress max=" + pages + " value=" + current + "> </progress> " + round(current/pages*100) + "%" as Progress
FROM #book

نتیجه به این شکل خواهد بود:

50%

۳. نمایش تصاویر

اگر توی پراپرتی ها لینک تصویر رو گذاشته باشید با دیتا ویو میشه اون رو نمایش داد. اینجا سه حالت وجود داره:

حالت اول: لینک خارجی

زمانی که از لینک خارجی تصویر استفاده کردید یعنی به این شکل:

---
cover: https://www.example.com/imagelink
---

میتونید از این کد استفاده کنید:

table without id 
	"![cover|100](" + cover + ")" as cover,
	file.link as Title

حالت دوم: لینک داخلی

زمانی که از تصویر ذخیره شده روی حافظه محلی (داخل والت) استفاده کردید به این شکل:

---
cover: yourimage.png   /  [[yourimage.png]]
---

(فرقی هم نمیکنه فقط اسم فایل رو داخل پراپرتی بنویسید یا اینکه داخل دو تا براکت قرار بدید.)

میتونید از این کد استفاده کنید:

table without id 
	embed(cover) as cover,
	file.link as Title

اندازه عکس رو هم اینطوری میتونید تنظیم کنید:

embed(link(image, "200"))

حالت سوم: ترکیب خارجی و داخلی

اگر هم از لینک خارجی استفاده کردید هم از لینک داخلی، یعنی یکسری از فایلها لینک خارجی دارند، یکسری دیگه لینک داخلی، میتونید از این کد استفاده کنید:

table without id EmbededCover, file.link
FLATTEN choice(typeof(cover)="link", embed(link(meta(choice(typeof(cover)="link", cover, this.file.link ) ).path)), "![](" + cover + ")") AS EmbededCover

این یک تابع شرطی است که مقادیر موجود در فیلد cover رو بررسی میکنه. اگر لینک داخلی باشه دستور embed(link(meta(...).path)) اجرا میشه. اگر لینک خارجی باشه دستور "![](" + cover + ") اجرا میشه.

توضیحات بیشتر

Display images in a dataview table

Functions

۴. نمایش شرطی

فرض کنید میخواییم یک هبیت ترکر بسازیم و گزارش هفتگی از عادت هامون بگیریم. مثلا در این فایل فعالیت ها رو به صورت تسک داخل پراپرتی ها تعریف کردیم:

---
exercise: true
reading: false
---

حالا با این کد میتونیم اطلاعاتشو استخراج کنیم:

Table without ID
	file.link as "تاریخ",
	choice(exercise=false, "⬜", "✅") as 🏋️,
	choice(reading=false, "⬜", "✅") as 📚
FROM #journal
WHERE file.name >= ("2024-04-23") AND file.name <= ("{{2024-04-30}}")
SORT file.link Asc

این میشه نتیجه نهایی. اگر تسک انجام شده باشه ✅ نمایش میده اگر انجام نشده باشه ⬜ نمایش میده

تاریخ	🏋️	📚
2024-08-03	✅	✅
2024-08-04	⬜	⬜
2024-08-05	✅	⬜
2024-08-06	⬜	⬜
2024-08-07	✅	✅
2024-08-08	⬜	⬜
2024-08-09	✅	✅

توضیحات بیشتر

Super Simple Habit Tracker Template For Obsidian

مطالب مرتبط

نوشته‌های مرتبط با این موضوع را می‌توانید در 🔮 نرم‌افزار ابسیدین مشاهده کنید.

نمای گراف

بک‌لینک‌ها

نمونه های کاربردی پلاگین دیتاویو

فهرست

۱. محاسبات

جمع زدن

شمردن

میانگین، حداکثر، حداقل

رند کردن

درصد گرفتن

۲. نمایش نوار پیشرفت

حالت اول: جمع آوری تسک‌ها

حالت دوم: محاسبه پراپرتی‌ها

روش اول

روش دوم

روش سوم

۳. نمایش تصاویر

حالت اول: لینک خارجی

حالت دوم: لینک داخلی

حالت سوم: ترکیب خارجی و داخلی

۴. نمایش شرطی

وبلاگ فرد

فهرست