تنظیمات سفارشی من برای کوارتز

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

26 اردیبهشت کوارتز رو آپدیت کردم. توی این آپدیت این تغییرات رو بهینه تر کردم. قبلا مستقیما کد های اصلی رو ویرایش کرده بودم. الان اغلب سعی کردم تغییرات رو طوری انجام بدم که کد های اصلی کمترین تغییر رو داشته باشن. اینطوری موقع آپدیت با تضاد های کمتری مواجه میشه.

تغییرات قبلی که مربوط به نسخه 4.2.5 کوارتز بود توی این یادداشت نوشته بودم:

quartz customization v4.2.5

پخش اول: صفحه بندی

چینش محتویات صفحه در فایل quartz.layout.ts انجام میشه. چینش رو طوری انجام دادم که برای زبان فارسی راحت تر باشه. یعنی عنوان سایت و فهرست سمت راست. گراف ویو سمت چپ. توی نسخه قبلی کوارتز شکست صفحه از سمت چپ انجام میشد و برای اینکه توی حالت موبایل عنوان سایت به انتهای سایت نره مجبور بودم یه کد اضافه کنم که حهتش معکوس بشه. اما توی آپدیت جدید دیگه نیازی به اینکار نیست. وقتی جهت صفحه رو RTL بذاری سایدبار ها هم خودشون جا به جا میشن.

برای راستچین شدن هم کافیه کد زیر رو به فایل renderPage.tsx اضافه کنید. به این شکل:

components/renderPage.tsx

<html dir="rtl" lang={lang}>

دیگه بقیه تنظیمات این فایل سلیقه ایه. من فهرست مطالب رو در حالت موبایل قبل از body قرار دادم. بک لینک رو از سایدبار به afterBody منتقل کردم.

بخش دوم: استایل‌ها

استایل های کلی

خلاصه استایل هایی که توی فایل custom.scss اضافه کردم:

عنوان footnote: عنوان پخش پاورقی footnote هست که انگلیسیه. از کدی استفاده کردم که فارسی بشه. این ترفند رو از اینجا برداشتم.
استایل فهرست مطالب رو تغییر دادم. بوردر اضافه کردم. یک خط هم سمت راست تیتر های فرعی اضافه کردم که از تیتر اصلی جدا شه.
استایل بک لینک رو تغییر دادم.
به عنوان سایت یک تصویر به عنوان آواتار اضافه کردم.
بلوک کد: در حالت پیشفرض حتی اگر طول یک سطر کوتاه باشه باز هم اسکرول محور افقی نمایش داده می شود. با اضافه کردن کد overflow-x: auto اسکرول تنها در صورتی نمایش داده می‌شود که طول سطر طولانی بوده و خارج از بلوک کد باشد. بقیه تنظیمات مربوط به بک‌گراند، فونت و جهت قرار گفتن متن است.
دکمه: یک استایل برای دکمه سفارشی اضافه کردم.
تایپوگرافی: مقداری سایز متن بدنه و هدینگ ها را افزایش دادم. همینطور فاصله بین خطوط.

کالوت

برای تغییر رنگ کالوت ها می توانید فایل quartz/quartz/styles/callouts.scss رو ویرایش کنید. من قبلا آیکون اختصاصی هم اضافه کرده بودم. اما دیدم باز هم تنوع چندانی نداره. تصمیم گرفتم کالوت هایی بدون آیکون با رنگ های مختلف بسازم. بعد خودم اولش ایموجی اضافه کنم. اینطوری:

👻 شفاف

لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

💾 خاکستری

لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

⚠️ زرد

لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

🔥 نارنجی

لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

🚨 قرمز

لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

🛡️ آبی

لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

🌳 سبز

لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

🔮 بنفش

لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

💼 قهوه‌ای

لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

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

👻 شفاف

👻 لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

💾 خاکستری

💾 لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

⚠️ زرد

⚠️ لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

🔥 نارنجی

🔥 لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

🚨 قرمز

🚨 لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

🛡️ آبی

🛡️ لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

🌳 سبز

🌳 لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

🔮 بنفش

🔮 لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

💼 قهوه‌ای

💼 لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ.

برای اینکه در خود ابسیدین هم این کالوت با آیکون و رنگ اختصاصی نمایش داده شود می توانید از پلاگین Admonition یا Callout Manager استفاده کنید.

چرخش آیکون >

این آیکون در قسمت های مختلف مثل فهرست، اکسپلور و کالوت استفاده شده. جهت این آیکون در حالت بسته باید سمت چپ باشد در حالی که به سمت راست است. برای چرخش آن باید مقدار rotateZ را در فایل های مربوط به هر کدام از منفی90 به مثبت90 تغییر دهید.(+)

فهرست: quartz/components/styles/toc.scss

اکسپلور: quartz/components/styles/explorer.scss

کالوت: quartz/quartz/styles/callouts.scss

به این شکل:

  &.collapsed .fold {
    transform: rotateZ(90deg);
  }

فوتر

فوتر رو وسط چین کردم. برای لینک ها هم آیکون اضافه کردم. با همون روشی که به لینک های خارجی فاوآیکون اضافه کردم. (+) متن لینک ها رو هم از فایل Footer.tsx مخفی کردم.

دیاگرام

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

flowchart TD
A([عنوان اصلی])
A --- B([فرعی یک])
A --- C([فرعی دو])
A --- D([فرعی سه])

click A "/"

classDef default fill:#fff,stroke:gray, stroke-width:1px,color:#282828;
linkStyle default stroke:gray,stroke-width:1px;

در سایت mermaid تمامی دستورات برای استفاده از آن توضیح داده شده. کد زیر دیاگرام بالا را نشان می دهد:

```mermaid
flowchart TD
A([عنوان اصلی])
A --- B([فرعی یک])
A --- C([فرعی دو])
A --- D([فرعی سه])
 
click A "/"
 
classDef default fill:#fff,stroke:gray, stroke-width:1px,color:#282828;
linkStyle default stroke:gray,stroke-width:1px;
```

تنظیم استایل دیاگرام در خود اون انجام میشه. دو خط آخر کد بالا مربوط به استایل این دیاگرامه. علاوه براین تنظیمات دیگری هم به فایل custom.scss اضافه کردم:

دایرکشن را روی rtl گذاشتم، چون معمولا از فارسی استفاده می کنم.
بک‌گراند را شفاف کردم، چون بک‌گراند code رو خاکستری کرده بودم، دیاگرام هم خاکستری شده بود.
فونت را روی body font گذاشتم.
آیکون «کپی در کلیپ بورد» را مخفی کردم.

custom.scss

.mermaid {
	direction: rtl !important;
}
 
pre:has(>code.mermaid) {
	background-color: transparent;
	.clipboard-button {
		display: none;
	}
	svg {
		margin: auto;
	}
}
 
.nodeLabel {
	font-family: var(--bodyFont);
}

فاوآیکون لینک‌های خارجی

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

🔗 نمونه لینک‌ها

normal

github

twitter

google

youtube

aparat

motamem

لینک عادی

گیت هاب

توییتر

گوگل

یوتیوب

آپارات

متمم

اول فایل external-links.scss رو به پوشه quartz\styles اضافه کنید. بعد این کد رو به ابتدای فایل custom.scss اضافه کنید:

@use "./_external-links.scss";

این ایده رو توی سایت quartz.eilleeenz.com دیدم و کدها رو از اینجا برداشتم.

نمای کارتی

این تنظیم استایل جدول رو به حالت کارت تبدیل می‌کنه. مشابه حالتی که تم minimal برای جدول‌های dataview می‌سازه. یک حالت دیگه هم اضافه کردم که باعث میشه کارت‌ها فقط در یک ردیف نمایش داده بشن و بقیه کارت‌ها با اسکرول کردن قابل مشاهده باشن. برای زمانی که تعداد کارت‌ها زیاد باشه این روش مناسب تره.

برای استفاده از این روش اول فایل زیر رو دانلود و در مسیر quartz/styles قرار بدید:

card-view

بعد کد زیر رو به ابتدای فایل custom.scs اضافه کنید.

@use "./_card-view.scss";

حالا می تونید از دو روش برای اعمال این استایل روی فایل‌هاتون استفاده کنید:

1️⃣ اگر میخواهید روی همه جدول‌های موجود در یادداشت اعمال بشن یک پراپرتی با عنوان cssclasses به یادداشت تون اضافه کنید بعد کلاس دلخواه رو وارد کنید. به این شکل:

---
cssclasses: card-g c-3
---

2️⃣ اگر نمی خواهید این استایل روی همه جدول‌ها اعمال بشه می تونید جدول تون رو در تگ div بذارید و کلاس مورد نظر رو براش تعریف کنید. به این شکل:

<div class="card-g c-2">
| class  | description  |
| ------ | ------------ |
| card-g | grid style   |
| card-s | scroll style |
</div>

راهنمای کامل کلاس ها رو اینجا می تونید ببینید:

📝 راهنمای کلاس‌ها
کلاس های مربوط به حالت گرید

card-g یک نمای کارتی با 4 ستون در ردیف‌های متعدد می‌سازد
c-2 نمایش کارت ها در 2 ستون
c-3 نمایش کارت ها در 3 ستون
c-5 نمایش کارت ها در 5 ستون
c-6 نمایش کارت ها در 6 ستون

کلاس های مربوط به حالت اسکرول

card-s یک نمای کارتی با عرض 150px در یک ردیف میسازد
w100 تنظیم عرض کارت روی 100px
w200 تنظیم عرض کارت روی 200px
w300 تنظیم عرض کارت روی 300px

کلاس های مشترک

nowarp متن را در یک خط نگه داشته و کاراکتر های اضافی را مخفی می‌کند
nowarp2 متن را در دو خط نگه داشته و کاراکتر های اضافی را مخفی می‌کند
c1-1 نسبت تصویر را 1:1 تنظیم می‌کند
c16-1 نسبت تصویر را 16:9 تنظیم می‌کند
c3-4 نسبت تصویر را 3:4 تنظیم می‌کند

💡این کلاس‌ها رو میتویند با هم ترکیب کنید. مثلا من میخوام از حالت گرید استفاده کنم که 3 تا ستون داشته باشه، نسبت تصویر 1:1 باشه و متن هم در دو خط نگه داره. استایل هایی که باید استفاده کنم به این شکله:
---
cssclasses:
  - card-g
  - c-3
  - c1-1
  - nowarp2
---


card-g	یک نمای کارتی با 4 ستون در ردیف‌های متعدد می‌سازد
c-2	نمایش کارت ها در 2 ستون
c-3	نمایش کارت ها در 3 ستون
c-5	نمایش کارت ها در 5 ستون
c-6	نمایش کارت ها در 6 ستون


card-s	یک نمای کارتی با عرض 150px در یک ردیف میسازد
w100	تنظیم عرض کارت روی 100px
w200	تنظیم عرض کارت روی 200px
w300	تنظیم عرض کارت روی 300px


nowarp	متن را در یک خط نگه داشته و کاراکتر های اضافی را مخفی می‌کند
nowarp2	متن را در دو خط نگه داشته و کاراکتر های اضافی را مخفی می‌کند
c1-1	نسبت تصویر را 1:1 تنظیم می‌کند
c16-1	نسبت تصویر را 16:9 تنظیم می‌کند
c3-4	نسبت تصویر را 3:4 تنظیم می‌کند

گالری تصاویر

وقتی از چندتا تصویر استفاده میکنم یک گرید اضافه کردم که کنار هم قرار بگیرند. اینطوری:

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

custom.scss

.img-grid img {
	object-fit: cover;
	margin: 0 auto;
}
 
.img-grid p:has(img) {
display: grid;
margin-block: 0.5rem;
grid-column-gap: 0.5rem;
grid-template-columns: repeat(auto-fit, minmax(0, 1fr));
align-items: stretch;
}

بعد از وارد کردن کد کافیه از کلاس img-grid توی پراپرتی cssclases هر یادداشت استفاده کنید تا این گرید روی تصاویر یادداشت اعمال بشه. بین تصاویر هم یا اسپیس بزنید یا فقط یک اینتر بزنید به این شکل:

example.md

---
cssclasses:
  - img-grid
---
 
✅ با اسپیس
![[image1.jpg]] ![[image1.jpg]]
 
✅ با اینتر
![[image1.jpg]]
![[image1.jpg]]
 
❌ اگر اینطوری اینتر بزنید گرید ساخته نمیشه و هر تصویر یک سطر رو اشغال میکنه:
![[image1.jpg]]
 
![[image1.jpg]]

بخش سوم: امکانات

دکمه‌های شناور

یک مورد جذاب هم در فوتر quartz.eilleeenz.com دیدم که با کلیک کردن روی Random Page یک صفحه تصادفی به کاربر نمایش میده. یک دکمه اسکرول به بالا هم داره. اخیرا این دو مورد رو به صورت دکمه شناور گوشه پایین سایت قرار داده. از اینجا می تونید توضیحات خودش رو مشاهده کنید.

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

بعد باید این کامپوننت رو به فایل Index.ts اضافه کنیم:

components/index.ts

import FloatingButtons from "./_FloatingButtons"
...
  FloatingButtons,

حالا میتونیم این کامپوننت رو در فایل quartz.layout.ts استفاده کنیم. به این شکل:

quartz.layout.ts

right: [
    Component.FloatingButtons(),
  ],

کانتنت متا

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

یه مورد دیگه هم نیاز داشتم که وضعیت رشد یادداشت رو نشون بده. طبق روش دیجیتال گاردن از 🌱نهال، 🪴درختچه، 🌳همیشه‌سبز و 🍂زودگذر باید برای مشخص کردن وضعیت یادداشت استفاده کرد.

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

بعد باید این کامپوننت رو به فایل Index.ts معرفی کنیم. به این شکل:

components/index.ts

import Properties from "./_Properties"
...
  Properties,

حالا میتونیم این کامپوننت رو در فایل quartz.layout.ts استفاده کنیم. به این شکل:

quartz.layout.ts

beforeBody: [
    Component.ConditionalRender({
      component: Component.Properties({ showReadingTime: false, showComma: false }),
      condition: (page) => page.fileData.slug !== "index",
    }),
  ],

(این یک مورد شرطی هست که این کامپوننت رو در همه صفحات نمایش میده به جز صفحه index. این رو اضافه کردم چون معمولا توی این صفحه این موارد نباشه بهتره. من مدت زمان مطالعه رو غیر فعال کردم. همینطور ویرگولی که بین اینها قرار میگرفت.)

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

example.md

---
date: 2025-05-01
lastmod: 2025-06-30
status: 🌱نهال
---

بلاگ فرد

تنظیمات سفارشی من برای کوارتز

فهرست

پخش اول: صفحه بندی

بخش دوم: استایل‌ها

استایل های کلی

کالوت

چرخش آیکون >

فوتر

دیاگرام

فاوآیکون لینک‌های خارجی

نمای کارتی

گالری تصاویر

بخش سوم: امکانات

دکمه‌های شناور

کانتنت متا

بک‌لینک‌ها

نمای گراف

فهرست