Shortcody
Šablona Linkita poskytuje několik shortcodů.
Nikdy jste o shortcodech neslyšeli? Více informací naleznete v dokumentaci Zoly.
Mermaid
Chcete-li na své stránce použít Mermaid, musíte v její frontmatter části nastavit extra.mermaid = true.
+++
title = "Titulek vaší stránky"
[extra]
mermaid = true
+++
Poté můžete shortcode mermaid() použít takto:
{% mermaid() %}
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
{% end %}
Toto bude vykresleno jako:
graph TD; A-->B; A-->C; B-->D; C-->D;
Kromě toho můžete uvnitř shortcodu mermaid() použít blok kódu, který bude ignorován.
Blok kódu zabraňuje formátovači, aby rozbil formátování diagramu 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 %}
Toto bude vykresleno jako:
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!
Poznámky
Shortcode admonition() zobrazí banner, který vám pomůže umístit na stránku upozornění.
Shortcode admonition() můžete použít takto:
{% admonition(type="tip", title="tip") %}
`tip` poznámka.
{% end %}
Shortcode pro poznámky má 12 různých typů:
note poznámka.
abstract poznámka.
info poznámka.
tip poznámka.
success poznámka.
question poznámka.
warning poznámka.
failure poznámka.
danger poznámka.
bug poznámka.
example poznámka.
quote poznámka.
Galerie
Shortcode gallery() je velmi jednoduchá, klikatelná obrázková galerie (pouze HTML), která zobrazuje všechny obrázky z prostředků stránky (page assets).
Pochází z dokumentace Zoly
{{ gallery(alt="Ukázkový obrázek pro galerii") }}
Projekty
Shortcode projects() vám umožní vytvořit stránku pro vaše projekty.
Vytvořte soubor content/pages/projects/index.md:
+++
title = "Moje projekty"
description = ""
path = "projects"
+++
{{ projects(path="data.toml", format="toml") }}
Vytvořte soubor 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" },
]
Toto bude zobrazeno jako: