A clean and elegant blog theme for Zola. Linkita is based on Kita and Hugo-Paper and is multilingual and SEO friendly. Zola 2026-09-13T00:00:00+00:00 https://salif.github.io/linkita/tags/components/atom.xml 2026-09-13T00:00:00+00:00 2026-09-13T00:00:00+00:00 Default Author https://salif.github.io/linkita/components/ <p>The Linkita theme providers multiple components.</p> <p>Never heard of components? See <a rel="external" href="https://keats.github.io/tera/#components">Zola documentation</a> for more information.</p> <h2 id="mermaid-component">Mermaid component</h2> <p>To use Mermaid in your page, you have to set <code>extra.mermaid = true</code> in the frontmatter of page.</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="toml"><span class="giallo-l"><span style="color: light-dark(#CD3131, #FFA198);">+++</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">title</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">Your page title</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span>[</span><span style="color: light-dark(#000000, #FFA657);">extra</span><span>]</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">mermaid</span><span> =</span><span style="color: light-dark(#0000FF, #79C0FF);"> true</span></span> <span class="giallo-l"><span style="color: light-dark(#CD3131, #FFA198);">+++</span></span></code></pre> <p>Then you can use the <code>&lt;mermaid&gt;</code> component like:</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="markdown"><span class="giallo-l"><span>{% </span><span style="color: light-dark(#800000, #E6EDF3);">&lt;</span><span style="color: light-dark(#800000, #7EE787);">mermaid</span><span style="color: light-dark(#800000, #E6EDF3);">&gt;</span><span> %}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span>graph TD;</span></span> <span class="giallo-l"><span>A--&gt;B;</span></span> <span class="giallo-l"><span>A--&gt;C;</span></span> <span class="giallo-l"><span>B--&gt;D;</span></span> <span class="giallo-l"><span>C--&gt;D;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span>{% </span><span style="color: light-dark(#800000, #E6EDF3);">&lt;/</span><span style="color: light-dark(#800000, #7EE787);">mermaid</span><span style="color: light-dark(#800000, #E6EDF3);">&gt;</span><span> %}</span></span></code></pre> <p>This will be rendered as:</p> <pre class="mermaid bg-inherit" translate="no"> graph TD; A-->B; A-->C; B-->D; C-->D; </pre> <p>In addition, you can use code block inside <code>&lt;mermaid&gt;</code> components and the code block will be ignored.</p> <p>The code block prevents formatter from breaking mermaid's formatting.</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="markdown"><span class="giallo-l"><span>{% </span><span style="color: light-dark(#800000, #E6EDF3);">&lt;</span><span style="color: light-dark(#800000, #7EE787);">mermaid</span><span style="color: light-dark(#800000, #E6EDF3);">&gt;</span><span> -%}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span>```</span><span>mermaid</span></span> <span class="giallo-l"><span>sequenceDiagram</span></span> <span class="giallo-l"><span> participant Alice</span></span> <span class="giallo-l"><span> participant Bob</span></span> <span class="giallo-l"><span> Alice-&gt;&gt;John: Hello John, how are you?</span></span> <span class="giallo-l"><span> loop Healthcheck</span></span> <span class="giallo-l"><span> John-&gt;&gt;John: Fight against hypochondria</span></span> <span class="giallo-l"><span> end</span></span> <span class="giallo-l"><span> Note right of John: Rational thoughts &lt;br/&gt;prevail!</span></span> <span class="giallo-l"><span> John--&gt;&gt;Alice: Great!</span></span> <span class="giallo-l"><span> John-&gt;&gt;Bob: How about you?</span></span> <span class="giallo-l"><span> Bob--&gt;&gt;John: Jolly good!</span></span> <span class="giallo-l"><span>```</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span>{%- </span><span style="color: light-dark(#800000, #E6EDF3);">&lt;/</span><span style="color: light-dark(#800000, #7EE787);">mermaid</span><span style="color: light-dark(#800000, #E6EDF3);">&gt;</span><span> %}</span></span></code></pre> <p>This will be rendered as:</p> <pre class="mermaid bg-inherit" translate="no"> 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! </pre> <h2 id="admonition">Admonition</h2> <p>The <code>&lt;admonition&gt;</code> component displays a banner to help you put notice in your page.</p> <p>You can use the component like:</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="markdown"><span class="giallo-l"><span>{% </span><span style="color: light-dark(#800000, #E6EDF3);">&lt;</span><span style="color: light-dark(#800000, #7EE787);">admonition</span><span style="color: light-dark(#E50000, #79C0FF);"> type</span><span>=</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#0000FF, #A5D6FF);">tip</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#E50000, #79C0FF);"> title</span><span>=</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#0000FF, #A5D6FF);">tip</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#800000, #E6EDF3);">&gt;</span><span> %}</span></span> <span class="giallo-l"><span>The </span><span style="color: light-dark(#800000, #79C0FF);">`</span><span style="color: light-dark(#800000, #79C0FF);">tip</span><span style="color: light-dark(#800000, #79C0FF);">`</span><span> admonition.</span></span> <span class="giallo-l"><span>{% </span><span style="color: light-dark(#800000, #E6EDF3);">&lt;/</span><span style="color: light-dark(#800000, #7EE787);">admonition</span><span style="color: light-dark(#800000, #E6EDF3);">&gt;</span><span> %}</span></span></code></pre> <p>The admonition component has 12 different types:</p> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-note);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/note.svg);" > note </div> <span><strong>note</strong></span> </div> <div class="pl-4"><p>The <code>note</code> admonition.</p> </div> </div> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-abstract);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/abstract.svg);" > abstract </div> <span><strong>abstract</strong></span> </div> <div class="pl-4"><p>The <code>abstract</code> admonition.</p> </div> </div> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-info);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/info.svg);" > info </div> <span><strong>info</strong></span> </div> <div class="pl-4"><p>The <code>info</code> admonition.</p> </div> </div> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-tip);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/tip.svg);" > tip </div> <span><strong>tip</strong></span> </div> <div class="pl-4"><p>The <code>tip</code> admonition.</p> </div> </div> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-success);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/success.svg);" > success </div> <span><strong>success</strong></span> </div> <div class="pl-4"><p>The <code>success</code> admonition.</p> </div> </div> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-question);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/question.svg);" > question </div> <span><strong>question</strong></span> </div> <div class="pl-4"><p>The <code>question</code> admonition.</p> </div> </div> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-warning);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/warning.svg);" > warning </div> <span><strong>warning</strong></span> </div> <div class="pl-4"><p>The <code>warning</code> admonition.</p> </div> </div> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-failure);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/failure.svg);" > failure </div> <span><strong>failure</strong></span> </div> <div class="pl-4"><p>The <code>failure</code> admonition.</p> </div> </div> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-danger);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/danger.svg);" > danger </div> <span><strong>danger</strong></span> </div> <div class="pl-4"><p>The <code>danger</code> admonition.</p> </div> </div> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-bug);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/bug.svg);" > bug </div> <span><strong>bug</strong></span> </div> <div class="pl-4"><p>The <code>bug</code> admonition.</p> </div> </div> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-example);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/example.svg);" > example </div> <span><strong>example</strong></span> </div> <div class="pl-4"><p>The <code>example</code> admonition.</p> </div> </div> <div class="my-4 flex flex-col rounded-lg bg-(--admonition-bg)" style="--admonition-bg: var(--admonition-quote);" > <div class="flex items-center rounded-t-lg bg-(--admonition-bg) p-1"> <div class="mx-2 h-4 w-4 text-[0px] [background:var(--url)_center_center_no-repeat] dark:invert" style="--url: url(icons/quote.svg);" > quote </div> <span><strong>quote</strong></span> </div> <div class="pl-4"><p>The <code>quote</code> admonition.</p> </div> </div> <h2 id="gallery">Gallery</h2> <p>The <code>&lt;gallery /&gt;</code> component is very simple html-only clickable picture gallery that displays all images from the page assets.</p> <p>It's from <a rel="external" href="https://www.getzola.org/documentation/content/image-processing/">Zola documentation</a></p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="markdown"><span class="giallo-l"><span>{{ </span><span style="color: light-dark(#800000, #E6EDF3);">&lt;</span><span style="color: light-dark(#800000, #7EE787);">gallery</span><span style="color: light-dark(#800000, #E6EDF3);"> /&gt;</span><span> }}</span></span></code></pre><div class="not-prose flex flex-wrap gap-2"> <a href="https://salif.github.io/linkita/components/01-zola.png" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/01-zola.ad0a0355240cda2e.png" alt="Demo image for the gallery" /> </a> <a href="https://salif.github.io/linkita/components/02-zola-manet.png" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/02-zola-manet.548154e0c09eec14.png" alt="Demo image for the gallery" /> </a> <a href="https://salif.github.io/linkita/components/03-zola-cezanne.png" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/03-zola-cezanne.860a70a4e0777688.png" alt="Demo image for the gallery" /> </a> <a href="https://salif.github.io/linkita/components/04-gutenberg.jpg" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/04-gutenberg.1fc322ebc0ee85d5.jpg" alt="Demo image for the gallery" /> </a> <a href="https://salif.github.io/linkita/components/05-example.jpg" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/05-example.cc0357d1d2f74077.jpg" alt="Demo image for the gallery" /> </a> <a href="https://salif.github.io/linkita/components/06-example.jpg" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/06-example.6d44aa1e3272f516.jpg" alt="Demo image for the gallery" /> </a> <a href="https://salif.github.io/linkita/components/07-example.jpg" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/07-example.bc1c6a7baeebcde1.jpg" alt="Demo image for the gallery" /> </a> <a href="https://salif.github.io/linkita/components/08-example.jpg" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/08-example.9d29c5def4caf476.jpg" alt="Demo image for the gallery" /> </a> </div> <h2 id="projects">Projects</h2> <p>The <code>&lt;projects /&gt;</code> component allows you to make a page for your projects.</p> <p>Create a <code>content/pages/projects/index.md</code> file:</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="markdown"><span class="giallo-l"><span>+++</span></span> <span class="giallo-l"><span>title = &quot;My Projects&quot;</span></span> <span class="giallo-l"><span>description = &quot;&quot;</span></span> <span class="giallo-l"><span>path = &quot;projects&quot;</span></span> <span class="giallo-l"><span>+++</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span>{{ </span><span style="color: light-dark(#800000, #E6EDF3);">&lt;</span><span style="color: light-dark(#800000, #7EE787);">projects</span><span style="color: light-dark(#E50000, #79C0FF);"> path</span><span>=</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#0000FF, #A5D6FF);">data.toml</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#E50000, #79C0FF);"> format</span><span>=</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#0000FF, #A5D6FF);">toml</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#800000, #E6EDF3);"> /&gt;</span><span> }}</span></span></code></pre> <p>Create a <code>content/pages/projects/data.toml</code> file:</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="toml"><span class="giallo-l"><span>[[</span><span style="color: light-dark(#000000, #FFA657);">project</span><span>]]</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">name</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">lorem</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">desc</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">Lorem ipsum dolor sit.</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">tags</span><span> =</span><span> [</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">lorem</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span>,</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">ipsum</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span>]</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">links</span><span> =</span><span> [</span></span> <span class="giallo-l"><span> {</span><span style="color: light-dark(#001080, #E6EDF3);"> name</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">homepage</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span>,</span><span style="color: light-dark(#001080, #E6EDF3);"> url</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">https://example.com</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span> }</span><span>,</span></span> <span class="giallo-l"><span> {</span><span style="color: light-dark(#001080, #E6EDF3);"> name</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">source</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span>,</span><span style="color: light-dark(#001080, #E6EDF3);"> url</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">https://example.com</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span> }</span><span>,</span></span> <span class="giallo-l"><span>]</span></span></code></pre> <p>This will be displayed as:</p> <div class="not-prose text-base leading-7 block-bg my-4 flex w-full flex-col rounded-lg px-5 py-1.5"> <h2 class="my-2 text-xl font-bold text-black dark:text-white">lorem</h2> <p>Lorem ipsum dolor sit.</p> <div class="my-2 flex flex-wrap items-center justify-between"> <div class="flex flex-wrap gap-x-2 text-sm opacity-80"> <span>#lorem</span> <span>#ipsum</span> </div> <div class="flex flex-wrap gap-x-2"> <a class="underline" href="https://example.com" target="_blank" >homepage</a> <a class="underline" href="https://example.com" target="_blank" >source</a> </div> </div> </div>