コンポーネント

Linkitaテーマは複数のコンポーネントを提供します。

コンポーネントについてご存知ありませんか？ 詳細は Zolaのドキュメント をご覧ください。

Mermaid コンポーネント

ページでMermaidを使用するには、ページのフロントマターで extra.mermaid = true を設定する必要があります。

+++
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のフォーマットを崩すのを防ぎます。

{% <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 type="tip" title="ヒント"> %}
これは `tip` のadmonitionです。
{% </admonition> %}

admonitionコンポーネントには12の異なるタイプがあります：

ギャラリー

<gallery /> コンポーネントは、ページのassetsからすべての画像を表示する、クリック可能な非常にシンプルなHTMLのみの画像ギャラリーです。

これはZolaのドキュメントからの引用です。

{{ <gallery /> }}

プロジェクト

<projects /> コンポーネントを使用すると、あなたのプロジェクトを紹介するページを作成できます。

content/pages/projects/index.md ファイルを作成します：

+++
title = "私のプロジェクト"
description = ""
path = "projects"
+++

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

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" },
]

これは次のように表示されます：