ویژگیها به شما امکان سازماندهی اطلاعات مربوط به یک یادداشت را میدهند. ویژگیها شامل دادههای ساختاریافتهای مانند متن، پیوندها، تاریخها، کادرهای انتخاب و اعداد هستند. ویژگیها همچنین میتوانند در ترکیب با [[افزونههای انجمن]] استفاده شوند که قادرند کارهای مفیدی با دادههای ساختاریافته شما انجام دهند.
## افزودن ویژگیها به یادداشت
چندین روش برای افزودن ویژگی به یادداشت وجود دارد:
- استفاده از [[فرماندان|دستور]] **افزودن ویژگی پرونده**.
- استفاده از [[میانبرها|میانبر صفحهکلید]] **`Cmd/Ctrl+;`**.
- انتخاب **افزودن ویژگی پرونده** از منوی **اقدامات بیشتر** (که با آیکون سه نقطه یا با کلیک راست روی زبانه ظاهر میشود).
- تایپ `---` در ابتدای فایل.
پس از افزودن یک ویژگی، یک ردیف در بالای فایل با دو ورودی ظاهر میشود: _نام_ ویژگی و _مقدار_ ویژگی.
برای نام، میتوانید هر چیزی که میخواهید انتخاب کنید. Obsidian چندین ویژگی پیشفرض ارائه میدهد: `tags`، `cssclasses` و `aliases`.
پس از انتخاب نام ویژگی، میتوانید مقداری به آن اختصاص دهید.
### نوعهای ویژگی
علاوه بر نام و مقدار، ویژگیها یک _نوع_ نیز دارند. نوع ویژگی تعیین میکند که چه نوع مقادیری میتواند ذخیره کند و Obsidian چگونه با آنها رفتار میکند. برای تغییر نوع یک ویژگی، روی آیکون نوع در کنار نام ویژگی کلیک کنید و گزینه دیگری را انتخاب کنید. همچنین میتوانید نوعهای ویژگی را با استفاده از افزونهٔ اصلی [[نمای ویژگیها]] مدیریت کنید.
Obsidian از نوعهای ویژگی زیر پشتیبانی میکند:
- **[[#متن]]**
- **[[#فهرست]]**
- **[[#شماره]]**
- **[[#کادر انتخاب]]**
- **[[#تاریخ]]**
- **[[#تاریخ و زمان]]**
- **[[#برچسبها]]**
هنگامی که یک نوع ویژگی به نام ویژگی اختصاص داده شود، تمام ویژگیهایی با آن نام در سراسر گاوصندوق شما از همان نوع استفاده خواهند کرد.
## کاربردهای پیشرفته
### جستجوی ویژگیها
ویژگیها [[جستجو|سینتکس جستجوی]] مخصوص به خود دارند که میتوانید آن را همراه با دیگر عبارتها و عملگرهای جستجو استفاده کنید. [[جستجو#جستجوی ویژگیها|سینتکس جستجو برای ویژگیها را ببینید]].
### الگوها
میتوانید ویژگیها را به [[الگوها]] اضافه کنید.
هنگامی که یک قالب را در یادداشت فعال درج میکنید، تمام ویژگیهای قالب به یادداشت اضافه میشوند. Obsidian همچنین هر ویژگیای که در یادداشت شما وجود دارد را با ویژگیهای قالب ادغام میکند. ^templates-properties
### تغییر نام ویژگیها
میتوانید با کلیک راست روی ویژگی در [[نمای ویژگیها|نمای همهی ویژگیها]]، نام آن را تغییر دهید.
### حالتهای نمایش
میتوانید نحوه نمایش ویژگیها در یادداشت خود را با رفتن به **[[تنظیمات]] ← ویرایشگر ← ویژگیها در سند** تغییر دهید. گزینهها عبارتند از:
- **آشکار** (پیشفرض) – ویژگیها را در بالای یادداشت نمایش میدهد، اگر وجود داشته باشند.
- **پنهان** – ویژگیها را پنهان میکند، اما همچنان میتوان آنها را از طریق [[نمای ویژگیها]] در نوار کناری نمایش داد.
- **منبع** – ویژگیها را در قالب YAML متن ساده نمایش میدهد.
### تکهکدهای CSS
میتوانید از [[تکهکدهای CSS]] برای تغییر ظاهر یادداشتهای خاص استفاده کنید.
### موارد پشتیبانینشده
چند ویژگی در حال حاضر در Obsidian پشتیبانی نمیشوند:
- **ویژگیهای تودرتو**: برای مشاهده ویژگیهای تودرتو، استفاده از [[نماها و حالت ویرایش#حالت منبع|حالت منبع]] را توصیه میکنیم.
- **ویرایش دستهای ویژگیها**: برای ویرایش دستهای عمیقتر خارج از [[نمای ویژگیها]]، استفاده از ابزارهای ویرایش دستهای مانند VSCode، اسکریپتها و افزونههای انجمن را توصیه میکنیم.
- **Markdown در ویژگیها**: این یک محدودیت عمدی است زیرا ویژگیها برای بخشهای کوچک و اتمی اطلاعات طراحی شدهاند که هم برای انسان و هم برای ماشین قابل خواندن باشند.
## میانبرها
### افزودن ویژگی
| عمل | میانبر صفحهکلید |
|---|---|
|افزودن ویژگی جدید|`Cmd + ;`|
### پیمایش بین ویژگیها
هنگامی که یک ویژگی متمرکز (فوکوس) است
| عمل | میانبر صفحهکلید |
|---|---|
|تمرکز روی ویژگی بعدی|`Down arrow` یا `Tab`|
|تمرکز روی ویژگی قبلی|`Up arrow` یا `Shift+Tab`|
|پرش به ویرایشگر|`Alt+Down arrow`|
### انتخاب ویژگیها
| عمل | میانبر صفحهکلید |
|---|---|
|گسترش انتخاب به بالا|`Shift+Up arrow`|
|گسترش انتخاب به پایین|`Shift+Down arrow`|
|انتخاب همه|`Cmd+A`|
### ویرایش ویژگیها
| عمل | میانبر صفحهکلید |
|---|---|
|ویرایش نام ویژگی|`Left arrow`|
|ویرایش مقدار ویژگی|`Right arrow`|
|تمرکز روی ویژگی|`Escape`|
|حذف ویژگی|`Cmd+Backspace`<br><br>اگر ویژگیهایی انتخاب شده باشند، به جای آن انتخاب حذف میشود.|
|واگرد|`Cmd+Z`|
|انجام دوباره|`Cmd+Shift+Z`|
### Vim (پیشرفته)
| عمل | میانبر صفحهکلید |
|---|---|
|حرکت به پایین|`j`|
|حرکت به بالا|`k`|
|تمرکز روی کلید|`h`|
|تمرکز روی مقدار|`l`|
|تمرکز روی مقدار (نشانگر در انتها)|`A`|
|تمرکز روی مقدار (نشانگر در ابتدا)|`i`|
|ایجاد ویژگی جدید|`o`|
## قالب ویژگیها
ویژگیها در قالب [YAML](https://yaml.org/) در بالای فایل ذخیره میشوند. YAML یک قالب محبوب است که هم برای انسان و هم برای کامپیوتر به آسانی قابل خواندن است.
نام ویژگیها با یک دونقطه و سپس یک فاصله از مقدارشان جدا میشوند:
```yaml
---
name: value
---
```
در حالی که ترتیب هر جفت نام-مقدار اهمیتی ندارد، هر نام باید در یک یادداشت یکتا باشد. برای مثال، نمیتوانید بیش از یک ویژگی `tags` داشته باشید.
مقادیر میتوانند [[#متن|متن]]، [[#شماره|اعداد]]، [[#کادر انتخاب|کادرهای انتخاب]]، [[#تاریخ|تاریخها]]، [[#تاریخ و زمان|تاریخ و زمانها]] یا [[#فهرست|فهرستها]] باشند.
### متن
ویژگیهای متنی شامل یک خط متن هستند. قالببندی Markdown در ویژگیهای متنی رندر نمیشود. هشتگها هنگام استفاده در ویژگیهای متنی برچسب ایجاد نمیکنند.
ویژگیهای متنی میتوانند شامل URLها و [[پیوندهای داخلی]] با استفاده از سینتکس `[[Link]]` باشند. [[پیوندهای داخلی]] در ویژگیهای متنی باید در علامت نقلقول محصور شوند. Obsidian اگر پیوندهای داخلی را به صورت دستی در ویژگیها وارد کنید، به طور خودکار آنها را اضافه میکند، اما هنگام استفاده از افزونههای قالببندی مراقب باشید آنها را اضافه کنید.
```yaml
---
title: A New Hope
link: "[[Episode IV]]"
url: https://www.example.com
---
```
### فهرست
ویژگیهای فهرستی شامل چندین مقدار هستند. هر مقدار در فهرست در خط جداگانهای ظاهر میشود که با یک خط تیره (-) و یک فاصله شروع میشود.
مقادیر فهرست میتوانند شامل متن، اعداد و [[پیوندهای داخلی]] باشند. هنگام استفاده از [[پیوندهای داخلی]] در ویژگیهای فهرستی، آنها را در علامت نقلقول محصور کنید.
```yaml
---
cast:
- Mark Hamill
- Harrison Ford
- Carrie Fisher
links:
- "[[Link]]"
- "[[Link2]]"
---
```
### شماره
ویژگیهای نوع عددی همیشه باید یک عدد لفظی باشند، نه یک عبارت با عملگرها. اعداد صحیح و اعشاری هر دو مجاز هستند.
```yaml
---
year: 1977
pie: 3.14
---
```
### کادر انتخاب
ویژگیهای کادر انتخاب یا `true` هستند یا `false`. در پیشنمایش زنده، این به صورت یک کادر انتخاب نمایش داده میشود.
```yaml
---
favorite: true
reply: false
last: # مقدار نامشخص؛ اغلب به عنوان false در نظر گرفته میشود
```
### تاریخ
ویژگیهای تاریخ در قالب زیر ذخیره میشوند:
```yaml
---
date: 2020-08-21
---
```
انتخابگر تاریخ از قالب پیشفرض تاریخ و زمان سیستمعامل شما پیروی میکند. میتوانید آن را در تنظیمات سیستم خود تغییر دهید:
> [!info]- ویندوز
> **[[تنظیمات]] ← Time & Language ← Language & Region ← Regional Format ← Change Formats**
>
> ![[Windows-OS-DateTime.png#interface]]
> [!info]- مک
> **System Preferences ← Language and Region ← Date format**
>
> ![[Mac-OS-DateTime.png|450]]
با فعال بودن افزونه [[روزنوشتها]]، ویژگی تاریخ به طور اضافی به عنوان یک پیوند داخلی به یادداشت روزانه متناظر با آن تاریخ عمل میکند.
![[روزنوشتها#^daily-notes-date]]
### تاریخ و زمان
ویژگیهای تاریخ و زمان شامل تاریخ و زمان مشخصی هستند و در قالب زیر ذخیره میشوند:
```yaml
---
time: 2020-08-21T10:30:00
---
```
مانند [[#تاریخ|ویژگیهای تاریخ]]، انتخابگر تاریخ و زمان از قالب پیشفرض سیستمعامل شما پیروی میکند. میتوانید آن را در تنظیمات سیستم خود تغییر دهید.
### برچسبها
ویژگیهای برچسبها نوع ویژگی خاصی هستند که منحصراً توسط ویژگی `tags` استفاده میشوند. این نوع ویژگی نمیتواند به ویژگیهای دیگر اختصاص داده شود.
ویژگیهای برچسبها به صورت فهرست قالببندی میشوند، که هر برچسب در خط جداگانهای با یک خط تیره (-) و یک فاصله قرار میگیرد.
```yaml
---
tags:
- journal
- personal
- draft
---
```
ویژگی `tags` یکی از [[#ویژگیهای پیشفرض]] Obsidian است. برای اطلاعات بیشتر درباره استفاده از برچسبها در Obsidian به [[برچسبها]] مراجعه کنید.
### ویژگیهای JSON
در حالی که استفاده از YAML برای تعریف ویژگیها را توصیه میکنیم، میتوانید ویژگیها را با [JSON](https://www.json.org/) نیز تعریف کنید:
```json
---
{
"tags": ["journal"],
"publish": false
}
---
```
توجه داشته باشید که بلوک JSON خوانده، تفسیر و به صورت YAML ذخیره خواهد شد.
## ویژگیهای پیشفرض
Obsidian مجموعهای از ویژگیهای پیشفرض دارد:
| ویژگی | نوع | توضیحات |
| ------------ | ---- | ------------------------------------------------------------ |
| `tags` | فهرست | به [[برچسبها]] مراجعه کنید. |
| `aliases` | فهرست | به [[دگرنام]] مراجعه کنید. |
| `cssclasses` | فهرست | به شما امکان میدهد یادداشتهای خاص را با استفاده از [[تکهکدهای CSS]] سبکدهی کنید. |
### ویژگیها برای Obsidian Publish
ویژگیهای پیشفرض زیر میتوانند با [[مقدمهای بر Obsidian Publish|Obsidian Publish]] استفاده شوند:
| ویژگی | توضیحات |
| ------------- | ---------------------------------------------------------------------------------------------------------- |
| `publish` | به [[انتشار محتوا#انتخاب خودکار دادهها برای نشر\|انتخاب خودکار دادهها برای نشر]] مراجعه کنید. |
| `permalink` | به [[پیوندهای ثابت\|پیوندهای ثابت]] مراجعه کنید. |
| `description` | به [[پیشنمایش پیوند در شبکههای اجتماعی#توضیحات\|توضیحات]] مراجعه کنید. |
| `image` | به [[پیشنمایش پیوند در شبکههای اجتماعی#تصویر\|تصویر]] مراجعه کنید. |
| `cover` | به [[پیشنمایش پیوند در شبکههای اجتماعی#تصویر\|تصویر]] مراجعه کنید. |
### ویژگیهای منسوخشده
این ویژگیها در Obsidian 1.4 منسوخ شدهاند و باید با معادلهای جدید جایگزین شوند. پشتیبانی از آنها به عنوان [[#ویژگیهای پیشفرض]] در Obsidian 1.9 حذف شده است.
| ویژگی | توضیحات |
|-|-|
| `tag` | نام مستعار منسوخ برای `tags`. |
| `alias` | نام مستعار منسوخ برای `aliases`. |
| `cssclass` | نام مستعار منسوخ برای `cssclasses`. |
> [!tip] اگر نیاز دارید فایلهای گاوصندوق خود را به قالب [[#ویژگیهای پیشفرض]] تبدیل کنید، میتوانید از [[واردکنندهی قالب مارکداون]] برای تغییر دستهجمعی گاوصندوق خود استفاده کنید.