Linkita - salif
Pura kaj eleganta bloga temo por Zola. Linkita baziĝas sur Kita kaj Hugo-Paper kaj estas plurlingva kaj SEO-amika.
Zola
2025-04-20T00:00:00+00:00
https://salif.github.io/linkita/eo/authors/salif/atom.xml
Gvidilo pri Markdown-Sintakso
2022-10-20T00:00:00+00:00
2024-10-24T00:00:00+00:00
sample_username
https://salif.github.io/linkita/eo/markdown-syntax/
<p>Ĉi tiu artikolo proponas ekzemplon de baza Markdown-sintakso, kiu uzeblas en Zola-enhavo-dosieroj, kaj ankaŭ montras ĉu bazaj HTML-elementoj estas ornamitaj per CSS en Linkita temo.</p>
Matematika Kompostado
2022-10-20T00:00:00+00:00
2024-10-24T00:00:00+00:00
sample_username
https://salif.github.io/linkita/eo/math-typesetting/
<p>La temo Linkita subtenas $\LaTeX$ matematikajn formulojn per <a rel="external" href="https://katex.org/">KaTeX</a>.</p>
Mallongigoj
2022-10-20T00:00:00+00:00
2025-04-20T00:00:00+00:00
sample_username
https://salif.github.io/linkita/eo/shortcodes/
<p>La temo Linkita provizas plurajn mallongigojn.</p>
<p>Ĉu vi neniam aŭdis pri mallongigoj? Vidu la <a rel="external" href="https://www.getzola.org/documentation/content/shortcodes/">dokumentaron de Zola</a> por pli da informoj.</p>
<h2 id="mermaid-header">Mermaid</h2>
<p>Por uzi Mermaid en via paĝo, vi devas agordi <code>extra.mermaid = true</code> en la antaŭaĵo (frontmatter) de la paĝo.</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);">Titolo</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>Tiam vi povas uzi la mallongigon <code>mermaid()</code> jene:</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>Ĉi tio estos montrata tiel:</p>
<pre class="mermaid bg-inherit" translate="no">
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
</pre>
<p>Krome, vi povas uzi kodblokon ene de la mallongigo <code>mermaid()</code> kaj la kodbloko estos ignorata.</p>
<p>La kodbloko malhelpas ke la formatilo rompu la formatadon de Mermaid.</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>Ĉi tio estos montrata tiel:</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="admono">Admono</h2>
<p>La mallongigo <code>admonition()</code> montras rubandon por helpi vin meti atentigon en vian paĝon.</p>
<p>Vi povas uzi la mallongigon <code>admonition()</code> jene:</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="konsileto") %}</span></span>
<span class="giallo-l"><span>La admono </span><span style="color: light-dark(#800000, #79C0FF);">`</span><span style="color: light-dark(#800000, #79C0FF);">konsileto</span><span style="color: light-dark(#800000, #79C0FF);">`</span><span>.</span></span>
<span class="giallo-l"><span>{% end %}</span></span></code></pre>
<p>La mallongigo <code>admonition</code> havas 12 diversajn tipojn:</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>noto</strong></span>
</div>
<div class="pl-4"><p>La admono <code>noto</code>.</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>resumo</strong></span>
</div>
<div class="pl-4"><p>La admono <code>resumo</code>.</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>informo</strong></span>
</div>
<div class="pl-4"><p>La admono <code>informo</code>.</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>konsileto</strong></span>
</div>
<div class="pl-4"><p>La admono <code>konsileto</code>.</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>sukceso</strong></span>
</div>
<div class="pl-4"><p>La admono <code>sukceso</code>.</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>demando</strong></span>
</div>
<div class="pl-4"><p>La admono <code>demando</code>.</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>averto</strong></span>
</div>
<div class="pl-4"><p>La admono <code>averto</code>.</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>malsukceso</strong></span>
</div>
<div class="pl-4"><p>La admono <code>malsukceso</code>.</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>danĝero</strong></span>
</div>
<div class="pl-4"><p>La admono <code>danĝero</code>.</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>cimo</strong></span>
</div>
<div class="pl-4"><p>La admono <code>cimo</code>.</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>ekzemplo</strong></span>
</div>
<div class="pl-4"><p>La admono <code>ekzemplo</code>.</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>citaĵo</strong></span>
</div>
<div class="pl-4"><p>La admono <code>citaĵo</code>.</p>
</div>
</div>
<h2 id="galerio">Galerio</h2>
<p>La mallongigo <code>gallery()</code> estas tre simpla nur-HTML-a klakebla bildgalerio, kiu montras ĉiujn bildojn el la paĝaj aktivaĵoj (assets).</p>
<p>Ĝi estas el la <a rel="external" href="https://www.getzola.org/documentation/content/image-processing/">dokumentaro de Zola</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/eo/shortcodes/01-zola.png" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/01-zola.b673627618ae4d9e.png" alt="Demobildo por la galerio" />
</a>
<a href="https://salif.github.io/linkita/eo/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="Demobildo por la galerio" />
</a>
<a href="https://salif.github.io/linkita/eo/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="Demobildo por la galerio" />
</a>
<a href="https://salif.github.io/linkita/eo/shortcodes/04-gutenberg.jpg" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/04-gutenberg.870b88ab978bdf22.jpg" alt="Demobildo por la galerio" />
</a>
<a href="https://salif.github.io/linkita/eo/shortcodes/05-example.jpg" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/05-example.fa7cb105347c93cf.jpg" alt="Demobildo por la galerio" />
</a>
<a href="https://salif.github.io/linkita/eo/shortcodes/06-example.jpg" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/06-example.eb57cde378878205.jpg" alt="Demobildo por la galerio" />
</a>
<a href="https://salif.github.io/linkita/eo/shortcodes/07-example.jpg" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/07-example.6ba4bc34b155528f.jpg" alt="Demobildo por la galerio" />
</a>
<a href="https://salif.github.io/linkita/eo/shortcodes/08-example.jpg" target="_blank">
<img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/08-example.13c3f7440797b6ed.jpg" alt="Demobildo por la galerio" />
</a>
</div>
<h2 id="projektoj">Projektoj</h2>
<p>La mallongkodo <code>projects()</code> ebligas al vi krei paĝon por viaj projektoj.</p>
<p>Kreu dosieron <code>content/pages/projects/index.md</code>:</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 = "Miaj Projektoj"</span></span>
<span class="giallo-l"><span>description = ""</span></span>
<span class="giallo-l"><span>path = "projects"</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>Kreu dosieron <code>content/pages/projects/data.toml</code>:</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>Ĉi tio estos montrata jene:</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>