ショートコード

Linkitaテーマは複数のショートコードを提供します。

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

Mermaid

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

+++
title = "ページのタイトル"

[extra]
mermaid = true
+++

そうすれば、mermaid() ショートコードを次のように使用できます：

{% mermaid() %}

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

{% end %}

これは次のようにレンダリングされます：

  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!
```

{% end %}

これは次のようにレンダリングされます：

  
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!

注意喚起

admonition() ショートコードは、ページ内に注意喚起のバナーを表示します。

admonition() ショートコードは次のように使用できます：

{% admonition(type="tip", title="ヒント") %}
これは `tip` のadmonitionです。
{% end %}

admonitionショートコードには12の異なるタイプがあります：

ギャラリー

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

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

{{ gallery() }}

プロジェクト

projects() ショートコードを使用すると、あなたのプロジェクトを紹介するページを作成できます。

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

+++
title = "私のプロジェクト"
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" },
]

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