Shortcody

KitaSalif

Š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

note poznámka.

abstract
abstrakt

abstract poznámka.

info
info

info poznámka.

tip
tip

tip poznámka.

success
úspěch

success poznámka.

question
otázka

question poznámka.

warning
varování

warning poznámka.

failure
neúspěch

failure poznámka.

danger
nebezpečí

danger poznámka.

bug
chyba

bug poznámka.

example
příklad

example poznámka.

quote
citace

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:

lorem

Lorem ipsum dolor sit.

#lorem #ipsum