مولفه‌ها

پوسته لینکیتا چندین مولفه در اختیارتان قرار می‌دهد.

آیا تا به حال درباره مولفه‌ها نشنیده‌اید؟ برای اطلاعات بیشتر مستندات زولا را ببینید.

مولفه Mermaid

برای استفاده از Mermaid در صفحه خود، باید extra.mermaid = true را در فرانت‌متر (frontmatter) صفحه تنظیم کنید.

+++
title = "عنوان صفحه شما"

[extra]
mermaid = true
+++

سپس می‌توانید از مولفه <mermaid> به این شکل استفاده کنید:

{% <mermaid> %}

graph TD;
A-->B;
A-->C;
B-->D;
C-->D;

{% </mermaid> %}

این به شکل زیر نمایش داده می‌شود:

  

graph TD;
A-->B;
A-->C;
B-->D;
C-->D;

علاوه بر این، می‌توانید از بلوک کد در داخل مولفه‌های <mermaid> استفاده کنید و این بلوک کد نادیده گرفته خواهد شد.

بلوک کد مانع از به هم ریختن قالب‌بندی Mermaid توسط فرمت‌کننده‌ها (formatter) می‌شود.

{% <mermaid> -%}

```mermaid
sequenceDiagram
    participant Alice
    participant Bob
    Alice->>John: Hello John, how are you?
    loop Healthcheck
        John->>John: Fight against hypochondria
    end
    Note right of John: Rational thoughts <br/>prevail!
    John-->>Alice: Great!
    John->>Bob: How about you?
    Bob-->>John: Jolly good!
```

{%- </mermaid> %}

این به شکل زیر نمایش داده می‌شود:

  
sequenceDiagram
    participant Alice
    participant Bob
    Alice->>John: Hello John, how are you?
    loop Healthcheck
        John->>John: Fight against hypochondria
    end
    Note right of John: Rational thoughts 
prevail!
    John-->>Alice: Great!
    John->>Bob: How about you?
    Bob-->>John: Jolly good!

اعلان‌ها (Admonition)

مولفه <admonition> بنری را نمایش می‌دهد تا به شما در قرار دادن پیام‌ها و نکات توجه در صفحه‌تان کمک کند.

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

{% <admonition type="tip" title="tip"> %}
اعلان `tip`.
{% </admonition> %}

مولفه اعلان ۱۲ نوع مختلف دارد:

نگارخانه (Gallery)

مولفه <gallery /> یک گالری تصاویر بسیار ساده، کلیک‌پذیر و صرفاً مبتنی بر HTML است که همه تصاویر را از دارایی‌های صفحه نمایش می‌دهد.

این از مستندات زولا برگرفته شده است.

{{ <gallery /> }}

پروژه‌ها (Projects)

مولفه <projects /> به شما امکان می‌دهد صفحه‌ای برای پروژه‌های خود بسازید.

یک فایل به نام content/pages/projects/index.md ایجاد کنید:

+++
title = "My Projects"
description = ""
path = "projects"
+++

{{ <projects path="data.toml" format="toml" /> }}

یک فایل به نام content/pages/projects/data.toml ایجاد کنید:

[[project]]
name = "lorem"
desc = "Lorem ipsum dolor sit."
tags = ["lorem", "ipsum"]
links = [
    { name = "homepage", url = "https://example.com" },
    { name = "source", url = "https://example.com" },
]

این به شکل زیر نمایش داده خواهد شد: