林基塔 是一款适用于 左拉 的多语言、搜索引擎优化、简洁优雅的博客主题。 Zola 2026-09-13T00:00:00+00:00 https://salif.github.io/linkita/zh/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/zh/components/ <p>林基塔主题提供了多种组件。</p> <p>没听说过组件？请参阅 <a rel="external" href="https://keats.github.io/tera/#components">Zola 文档</a> 获取更多信息。</p> <h2 id="mermaid-zu-jian">Mermaid 组件</h2> <p>要在页面中使用 Mermaid，您需要在页面的 frontmatter 中设置 <code>extra.mermaid = true</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 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);">您的页面标题</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>然后您可以使用 <code>&lt;mermaid&gt;</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 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>这将被渲染为：</p> <pre class="mermaid bg-inherit" translate="no"> graph TD; A-->B; A-->C; B-->D; C-->D; </pre> <p>此外，您可以在 <code>&lt;mermaid&gt;</code> 组件内使用代码块，代码块将被忽略。</p> <p>代码块可以防止格式化程序破坏 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>{% </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>这将被渲染为：</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="ti-shi-kuang">提示框</h2> <p><code>&lt;admonition&gt;</code> 组件显示一个横幅，帮助您在页面中放置提示。</p> <p>您可以像这样使用组件：</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 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> 提示框。</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>提示框组件有 12 种不同的类型：</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><code>note</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>abstract</strong></span> </div> <div class="pl-4"><p><code>abstract</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>info</strong></span> </div> <div class="pl-4"><p><code>info</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>tip</strong></span> </div> <div class="pl-4"><p><code>tip</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>success</strong></span> </div> <div class="pl-4"><p><code>success</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>question</strong></span> </div> <div class="pl-4"><p><code>question</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>warning</strong></span> </div> <div class="pl-4"><p><code>warning</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>failure</strong></span> </div> <div class="pl-4"><p><code>failure</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>danger</strong></span> </div> <div class="pl-4"><p><code>danger</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>bug</strong></span> </div> <div class="pl-4"><p><code>bug</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>example</strong></span> </div> <div class="pl-4"><p><code>example</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>quote</strong></span> </div> <div class="pl-4"><p><code>quote</code> 提示框。</p> </div> </div> <h2 id="hua-lang">画廊</h2> <p><code>&lt;gallery /&gt;</code> 组件是一个非常简单的纯 HTML 可点击图片画廊，用于显示页面资源中的所有图像。</p> <p>它来自 <a rel="external" href="https://www.getzola.org/documentation/content/image-processing/">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>{{ </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/zh/components/01-zola.png" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/01-zola.ad0a0355240cda2e.png" alt="画廊的演示图片" /> </a> <a href="https://salif.github.io/linkita/zh/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="画廊的演示图片" /> </a> <a href="https://salif.github.io/linkita/zh/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="画廊的演示图片" /> </a> <a href="https://salif.github.io/linkita/zh/components/04-gutenberg.jpg" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/04-gutenberg.1fc322ebc0ee85d5.jpg" alt="画廊的演示图片" /> </a> <a href="https://salif.github.io/linkita/zh/components/05-example.jpg" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/05-example.cc0357d1d2f74077.jpg" alt="画廊的演示图片" /> </a> <a href="https://salif.github.io/linkita/zh/components/06-example.jpg" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/06-example.6d44aa1e3272f516.jpg" alt="画廊的演示图片" /> </a> <a href="https://salif.github.io/linkita/zh/components/07-example.jpg" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/07-example.bc1c6a7baeebcde1.jpg" alt="画廊的演示图片" /> </a> <a href="https://salif.github.io/linkita/zh/components/08-example.jpg" target="_blank"> <img class="rounded-lg" src="https://salif.github.io/linkita/processed_images/08-example.9d29c5def4caf476.jpg" alt="画廊的演示图片" /> </a> </div> <h2 id="xiang-mu">项目</h2> <p><code>&lt;projects /&gt;</code> 组件允许您为您的项目创建一个页面。</p> <p>创建一个 <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 = &quot;我的项目&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>创建一个 <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);"> &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>这将显示为：</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>