Linkita
Puhdas ja elegantti blogiteema Zolalle. Linkita perustuu Kitaan ja Hugo-Paperiin ja on monikielinen sekä SEO-ystävällinen.
Zola
2025-04-20T00:00:00+00:00
https://salif.github.io/linkita/fi/atom.xml
Markdown-syntaksin opas
2022-10-20T00:00:00+00:00
2022-10-20T00:00:00+00:00
sample_username
https://salif.github.io/linkita/fi/markdown-syntax/
<p>Tämä artikkeli tarjoaa esimerkin perus-Markdown-syntaksista, jota voidaan käyttää Zolan sisältötiedostoissa. Lisäksi se näyttää, kuinka perus-HTML-elementit on muotoiltu CSS:llä Linkita-teemassa.</p>
Matemaattinen ladonta
2022-10-20T00:00:00+00:00
2022-10-20T00:00:00+00:00
sample_username
https://salif.github.io/linkita/fi/math-typesetting/
<p>Linkita-teema tukee $\LaTeX$-matematiikkakaavoja <a rel="external" href="https://katex.org/">KaTeXin</a> avulla.</p>
Pikakoodit
2022-10-20T00:00:00+00:00
2025-04-20T00:00:00+00:00
sample_username
https://salif.github.io/linkita/fi/shortcodes/
<p>Linkita-teema tarjoaa useita pikakoodeja.</p>
<p>Etkö ole koskaan kuullut pikakoodeista? Katso lisätietoja <a rel="external" href="https://www.getzola.org/documentation/content/shortcodes/">Zolan dokumentaatiosta</a>.</p>
<h2 id="mermaid-header">Mermaid</h2>
<p>Käyttääksesi Mermaidia sivullasi, sinun tulee asettaa <code>extra.mermaid = true</code> sivun frontmatter-osioon.</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);"> "</span><span style="color: light-dark(#A31515, #A5D6FF);">Sivusi otsikko</span><span style="color: light-dark(#A31515, #A5D6FF);">"</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>Sitten voit käyttää <code>mermaid()</code>-pikakoodeja näin:</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>{% mermaid() %}</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span>graph TD;</span></span>
<span class="giallo-l"><span>A-->B;</span></span>
<span class="giallo-l"><span>A-->C;</span></span>
<span class="giallo-l"><span>B-->D;</span></span>
<span class="giallo-l"><span>C-->D;</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span>{% end %}</span></span></code></pre>
<p>Tämä renderöidään seuraavasti:</p>
<pre class="mermaid bg-inherit" translate="no">
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
</pre>
<p>Lisäksi voit käyttää koodilohkoa <code>mermaid()</code>-pikakoodien sisällä, jolloin koodilohko jätetään huomiotta.</p>
<p>Koodilohko estää muotoilutyökalua rikkomasta Mermaidin muotoilua.</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>{% mermaid() %}</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->>John: Hello John, how are you?</span></span>
<span class="giallo-l"><span> loop Healthcheck</span></span>
<span class="giallo-l"><span> John->>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 <br/>prevail!</span></span>
<span class="giallo-l"><span> John-->>Alice: Great!</span></span>
<span class="giallo-l"><span> John->>Bob: How about you?</span></span>
<span class="giallo-l"><span> Bob-->>John: Jolly good!</span></span>
<span class="giallo-l"><span>```</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span>{% end %}</span></span></code></pre>
<p>Tämä renderöidään seuraavasti:</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="huomautukset">Huomautukset</h2>
<p><code>admonition()</code>-pikakoodi näyttää bannerin, jonka avulla voit lisätä huomautuksia sivullesi.</p>
<p>Voit käyttää <code>admonition()</code>-pikakoodia näin:</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>{% admonition(type="tip", title="vinkki") %}</span></span>
<span class="giallo-l"><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>-huomautus.</span></span>
<span class="giallo-l"><span>{% end %}</span></span></code></pre>
<p>Huomautus-pikakoodilla on 12 eri tyyppiä:</p>
<link rel="stylesheet" href="https://salif.github.io/linkita/admonition.css?h=98c1477488c4b2c9d71a" type="text/css">
<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>huomautus</strong></span>
</div>
<div class="pl-4"><p><code>note</code>-huomautus.</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>tiivistelmä</strong></span>
</div>
<div class="pl-4"><p><code>abstract</code>-huomautus.</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><code>info</code>-huomautus.</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>vinkki</strong></span>
</div>
<div class="pl-4"><p><code>tip</code>-huomautus.</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>onnistuminen</strong></span>
</div>
<div class="pl-4"><p><code>success</code>-huomautus.</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>kysymys</strong></span>
</div>
<div class="pl-4"><p><code>question</code>-huomautus.</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>varoitus</strong></span>
</div>
<div class="pl-4"><p><code>warning</code>-huomautus.</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>virhe</strong></span>
</div>
<div class="pl-4"><p><code>failure</code>-huomautus.</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>vaara</strong></span>
</div>
<div class="pl-4"><p><code>danger</code>-huomautus.</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>bugi</strong></span>
</div>
<div class="pl-4"><p><code>bug</code>-huomautus.</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>esimerkki</strong></span>
</div>
<div class="pl-4"><p><code>example</code>-huomautus.</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>lainaus</strong></span>
</div>
<div class="pl-4"><p><code>quote</code>-huomautus.</p>
</div>
</div>
<h2 id="galleria">Galleria</h2>
<p><code>gallery()</code>-pikakoodi on hyvin yksinkertainen, vain HTML:ää käyttävä klikattava kuvagalleria, joka näyttää kaikki kuvat sivun resursseista.</p>
<p>Se on <a rel="external" href="https://www.getzola.org/documentation/content/image-processing/">Zolan dokumentaatiosta</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>{{ gallery() }}</span></span></code></pre><div class="not-prose flex flex-wrap gap-2">
<a href="https://salif.github.io/linkita/fi/shortcodes/01-zola.png" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/01-zola.b673627618ae4d9e.png" alt="Demonstraatiokuva gallerialle" />
</a>
<a href="https://salif.github.io/linkita/fi/shortcodes/02-zola-manet.png" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/02-zola-manet.6cacdaa0a00675f4.png" alt="Demonstraatiokuva gallerialle" />
</a>
<a href="https://salif.github.io/linkita/fi/shortcodes/03-zola-cezanne.png" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/03-zola-cezanne.7278afdd982f9c0d.png" alt="Demonstraatiokuva gallerialle" />
</a>
<a href="https://salif.github.io/linkita/fi/shortcodes/04-gutenberg.jpg" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/04-gutenberg.870b88ab978bdf22.jpg" alt="Demonstraatiokuva gallerialle" />
</a>
<a href="https://salif.github.io/linkita/fi/shortcodes/05-example.jpg" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/05-example.fa7cb105347c93cf.jpg" alt="Demonstraatiokuva gallerialle" />
</a>
<a href="https://salif.github.io/linkita/fi/shortcodes/06-example.jpg" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/06-example.eb57cde378878205.jpg" alt="Demonstraatiokuva gallerialle" />
</a>
<a href="https://salif.github.io/linkita/fi/shortcodes/07-example.jpg" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/07-example.6ba4bc34b155528f.jpg" alt="Demonstraatiokuva gallerialle" />
</a>
<a href="https://salif.github.io/linkita/fi/shortcodes/08-example.jpg" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/08-example.13c3f7440797b6ed.jpg" alt="Demonstraatiokuva gallerialle" />
</a>
</div>
<h2 id="projektit">Projektit</h2>
<p><code>projects()</code>-pikakoodin avulla voit luoda sivun projekteillesi.</p>
<p>Luo <code>content/pages/projects/index.md</code>-tiedosto:</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 = "Projektini"</span></span>
<span class="giallo-l"><span>description = ""</span></span>
<span class="giallo-l"><span>path = "projektit"</span></span>
<span class="giallo-l"><span>+++</span></span>
<span class="giallo-l"></span>
<span class="giallo-l"><span>{{ projects(path="data.toml", format="toml") }}</span></span></code></pre>
<p>Luo <code>content/pages/projects/data.toml</code>-tiedosto:</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);"> "</span><span style="color: light-dark(#A31515, #A5D6FF);">lorem</span><span style="color: light-dark(#A31515, #A5D6FF);">"</span></span>
<span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">desc</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> "</span><span style="color: light-dark(#A31515, #A5D6FF);">Lorem ipsum dolor sit.</span><span style="color: light-dark(#A31515, #A5D6FF);">"</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);">"</span><span style="color: light-dark(#A31515, #A5D6FF);">lorem</span><span style="color: light-dark(#A31515, #A5D6FF);">"</span><span>,</span><span style="color: light-dark(#A31515, #A5D6FF);"> "</span><span style="color: light-dark(#A31515, #A5D6FF);">ipsum</span><span style="color: light-dark(#A31515, #A5D6FF);">"</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);"> "</span><span style="color: light-dark(#A31515, #A5D6FF);">homepage</span><span style="color: light-dark(#A31515, #A5D6FF);">"</span><span>,</span><span style="color: light-dark(#001080, #E6EDF3);"> url</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> "</span><span style="color: light-dark(#A31515, #A5D6FF);">https://example.com</span><span style="color: light-dark(#A31515, #A5D6FF);">"</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);"> "</span><span style="color: light-dark(#A31515, #A5D6FF);">source</span><span style="color: light-dark(#A31515, #A5D6FF);">"</span><span>,</span><span style="color: light-dark(#001080, #E6EDF3);"> url</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> "</span><span style="color: light-dark(#A31515, #A5D6FF);">https://example.com</span><span style="color: light-dark(#A31515, #A5D6FF);">"</span><span> }</span><span>,</span></span>
<span class="giallo-l"><span>]</span></span></code></pre>
<p>Tämä näytetään seuraavasti:</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>