لینکیتا یک پوسته تمیز و شیک وبلاگ برای زولا. لینکیتا بر پایه کیتا و هوگو-پیپر است و چندزبانه و سازگار با سئو می‌باشد. Zola 2026-09-13T00:00:00+00:00 https://salif.github.io/linkita/fa/atom.xml مولفه‌ها 2026-09-13T00:00:00+00:00 2026-09-13T00:00:00+00:00 Default Author https://salif.github.io/linkita/fa/components/ <p>پوسته لینکیتا چندین مولفه در اختیارتان قرار می‌دهد.</p> <p>آیا تا به حال درباره مولفه‌ها نشنیده‌اید؟ برای اطلاعات بیشتر <a rel="external" href="https://keats.github.io/tera/#components">مستندات زولا</a> را ببینید.</p> <h2 id="mwlfh-mermaid">مولفه Mermaid</h2> <p>برای استفاده از Mermaid در صفحه خود، باید <code>extra.mermaid = true</code> را در فرانت‌متر (frontmatter) صفحه تنظیم کنید.</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 توسط فرمت‌کننده‌ها (formatter) می‌شود.</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="lnh-admonition">اعلان‌ها (Admonition)</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>اعلان </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>.</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>مولفه اعلان ۱۲ نوع مختلف دارد:</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="ngrkhnh-gallery">نگارخانه (Gallery)</h2> <p>مولفه <code>&lt;gallery /&gt;</code> یک گالری تصاویر بسیار ساده، کلیک‌پذیر و صرفاً مبتنی بر HTML است که همه تصاویر را از دارایی‌های صفحه نمایش می‌دهد.</p> <p>این از <a rel="external" href="https://www.getzola.org/documentation/content/image-processing/">مستندات زولا</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/fa/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/fa/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/fa/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/fa/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/fa/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/fa/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/fa/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/fa/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="prwjhh-projects">پروژه‌ها (Projects)</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;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>یک فایل به نام <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> مهاجرت به Zola 0.23.4 2026-09-12T00:00:00+00:00 2026-09-12T00:00:00+00:00 Default Author https://salif.github.io/linkita/fa/update-2/ <p>نسخه Zola v0.23 موتور قالب‌ساز خود، Tera، را با یک نسخه اصلی جدید (Tera v2) جایگزین کرد. خود پروژه زولا آن را این‌گونه نامیده است:</p> <blockquote> <p>احتمالاً بیشترین تغییرات شکننده (breaking changes) در تاریخ زولا</p> </blockquote> <p>و قالب‌های لینکیتا نیز برای سازگاری با آن بازنویسی شدند. این صفحه شما را در فرآیند انتقال یک سایت لینکیتا از Zola v0.22.1 به Zola v0.23.4 راهنمایی می‌کند.</p> <h2 id="ntql-mkhzn-gyt">انتقال مخزن گیت</h2> <p>پوسته لینکیتا هم‌زمان از Codeberg به GitHub منتقل شد. اگر همچنان از مخزن Codeberg استفاده می‌کنید، ابتدا باید به مخزن GitHub سوییچ کنید. برای کاربران زیرماژول (submodule)، دستورالعمل‌ها به شرح زیر است:</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="shellscript"><span class="giallo-l"><span style="color: light-dark(#795E26, #FFA657);">git</span><span style="color: light-dark(#A31515, #A5D6FF);"> submodule</span><span style="color: light-dark(#A31515, #A5D6FF);"> init</span></span> <span class="giallo-l"><span style="color: light-dark(#795E26, #FFA657);">git</span><span style="color: light-dark(#A31515, #A5D6FF);"> config</span><span style="color: light-dark(#0000FF, #79C0FF);"> -</span><span style="color: light-dark(#0000FF, #79C0FF);">f</span><span style="color: light-dark(#A31515, #A5D6FF);"> .gitmodules</span><span style="color: light-dark(#A31515, #A5D6FF);"> submodule.</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">themes/linkita</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">.url</span><span style="color: light-dark(#A31515, #A5D6FF);"> https://github.com/salif/linkita.git</span></span> <span class="giallo-l"><span style="color: light-dark(#795E26, #FFA657);">git</span><span style="color: light-dark(#A31515, #A5D6FF);"> config</span><span style="color: light-dark(#0000FF, #79C0FF);"> -</span><span style="color: light-dark(#0000FF, #79C0FF);">f</span><span style="color: light-dark(#A31515, #A5D6FF);"> .gitmodules</span><span style="color: light-dark(#A31515, #A5D6FF);"> submodule.</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">themes/linkita</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">.branch</span><span style="color: light-dark(#A31515, #A5D6FF);"> tera1</span></span> <span class="giallo-l"><span style="color: light-dark(#795E26, #FFA657);">git</span><span style="color: light-dark(#A31515, #A5D6FF);"> submodule</span><span style="color: light-dark(#A31515, #A5D6FF);"> sync</span></span> <span class="giallo-l"><span style="color: light-dark(#795E26, #FFA657);">git</span><span style="color: light-dark(#A31515, #A5D6FF);"> submodule</span><span style="color: light-dark(#A31515, #A5D6FF);"> update</span></span> <span class="giallo-l"><span style="color: light-dark(#795E26, #FFA657);">git</span><span style="color: light-dark(#A31515, #A5D6FF);"> add</span><span style="color: light-dark(#A31515, #A5D6FF);"> .gitmodules</span></span></code></pre><h2 id="chh-khsny-bh-yn-rhnm-nyz-drnd">چه کسانی به این راهنما نیاز دارند؟</h2> <p>این راهنما برای شماست اگر سایت شما هم‌اکنون از لینکیتا روی شاخه <code>tera1</code> (یا روی <code>linkita</code> / <code>v4</code>) با نسخه Zola v0.22.1 یا قدیمی‌تر استفاده می‌کند.</p> <p>اگر هنوز مایل به ارتقای زولا نیستید، نیازی به انجام کاری ندارید – شاخه <code>tera1</code> به کار با نسخه‌های قدیمی زولا ادامه خواهد داد و حذف نخواهد شد.</p> <h2 id="mrhlh-1-rtqy-zwl-bh-v0-23-4">مرحله ۱: ارتقای زولا به v0.23.4</h2> <p>نسخه Zola v0.23.4 یا جدیدتر را نصب کنید. نسخه نصب‌شده خود را بررسی کنید:</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="shellscript"><span class="giallo-l"><span style="color: light-dark(#795E26, #FFA657);">zola</span><span style="color: light-dark(#0000FF, #79C0FF);"> -</span><span style="color: light-dark(#0000FF, #79C0FF);">-version</span></span></code></pre> <p>نسخه Zola v0.23 یک جهش بزرگ است. اگر سایت شما قالب‌های سفارشی فراتر از قالب‌های پیش‌فرض لینکیتا دارد، نگاهی به <a rel="external" href="https://github.com/getzola/zola/blob/master/CHANGELOG.md#0230-2026-08-05">تغییرات Zola v0.23.0</a> بیندازید – بقیه این راهنما صرفاً مواردی را پوشش می‌دهد که در سمت لینکیتا تغییر کرده است.</p> <h2 id="mrhlh-2-tgyyr-bh-shkhh-main">مرحله ۲: تغییر به شاخه <code>main</code></h2> <p>شاخه <code>main</code> لینکیتا اکنون نسخه‌های Zola v0.23.0 به بعد را هدف قرار می‌دهد. شاخه <code>tera1</code> روی موتور قالب قبلی برای Zola v0.22.1 و قدیمی‌تر باقی می‌ماند.</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="shellscript"><span class="giallo-l"><span style="color: light-dark(#795E26, #FFA657);">git</span><span style="color: light-dark(#A31515, #A5D6FF);"> submodule</span><span style="color: light-dark(#A31515, #A5D6FF);"> set-branch</span><span style="color: light-dark(#0000FF, #79C0FF);"> -</span><span style="color: light-dark(#0000FF, #79C0FF);">-branch</span><span style="color: light-dark(#A31515, #A5D6FF);"> main</span><span style="color: light-dark(#A31515, #A5D6FF);"> themes/linkita</span></span> <span class="giallo-l"><span style="color: light-dark(#795E26, #FFA657);">git</span><span style="color: light-dark(#A31515, #A5D6FF);"> submodule</span><span style="color: light-dark(#A31515, #A5D6FF);"> update</span><span style="color: light-dark(#0000FF, #79C0FF);"> -</span><span style="color: light-dark(#0000FF, #79C0FF);">-remote</span><span style="color: light-dark(#A31515, #A5D6FF);"> themes/linkita</span></span></code></pre><h2 id="mrhlh-3-bhrwzrsny-zola-toml-config-toml">مرحله ۳: به‌روزرسانی <code>zola.toml</code> / <code>config.toml</code></h2> <p>موارد زیر را تک به تک بررسی کنید. هیچ‌کدام از این‌ها توسط زولا اجبار نمی‌شوند – باقی ماندن کلیدهای قدیمی مانع ساخت سایت شما نمی‌شود، اما آن‌ها بی‌صدا از کار خواهند افتاد؛ بنابراین ارزش پاک‌سازی و به‌روزرسانی دارند.</p> <h3 id="pywndhy-mnw-w-shbkhhhy-jtm-y-base-url-base">پیوندهای منو و شبکه‌های اجتماعی: <code>$BASE_URL</code> ← <code>@base</code></h3> <p>مقدار <code>$BASE_URL</code> در <code>extra.menus</code>، آدرس‌های وب <code>social</code> در پروفایل، و همچنین <code>extra.footer.license_url</code> اکنون با <code>@base</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" data-name="zola.toml"><span class="giallo-l"><span style="color: light-dark(#008000, #8B949E);">#</span><span style="color: light-dark(#008000, #8B949E);"> قبل</span></span> <span class="giallo-l"><span>[</span><span style="color: light-dark(#000000, #FFA657);">extra</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">menus</span><span>]</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">menu_name</span><span> =</span><span> [</span></span> <span class="giallo-l"><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);">$BASE_URL/blog/</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><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);">بایگانی</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span> }</span><span>,</span></span> <span class="giallo-l"><span>]</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#008000, #8B949E);">#</span><span style="color: light-dark(#008000, #8B949E);"> بعد</span></span> <span class="giallo-l"><span>[</span><span style="color: light-dark(#000000, #FFA657);">extra</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">menus</span><span>]</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">menu_name</span><span> =</span><span> [</span></span> <span class="giallo-l"><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);">@base/blog/</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><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);">بایگانی</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>همین تغییر نام برای ورودی‌های <code>social</code> در نمایه کاربری و <code>extra.footer.license_url</code> نیز اعمال می‌شود. اگر ترجیح می‌دهید، می‌توانید به جای <code>@base</code> از <a rel="external" href="https://www.getzola.org/documentation/content/linking/#internal-links">پیوندهای داخلی زولا</a> (<code>@/...</code>) نیز استفاده کنید.</p> <p>همچنین یک پیشوند جدید به نام <code>@lang</code> برای نشانی‌های اینترنتی منو و شبکه‌های اجتماعی وجود دارد که در صورت نیاز، مسیری را در یک زبان مشخص پیدا می‌کند.</p> <p>توجه داشته باشید که این موضوع در مورد <code>extra.footer.copyright</code> <strong>صدق نمی‌کند</strong> – آن رشته مانند گذشته همچنان از <code>$BASE_URL</code> و <code>$YEAR</code> و <code>$LICENSE_URL</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" data-name="zola.toml"><span class="giallo-l"><span>[</span><span style="color: light-dark(#000000, #FFA657);">extra</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">footer</span><span>]</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">copyright</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">&amp;copy;&amp;nbsp;$YEAR نام شما &amp;vert; [CC BY-SA 4.0]($LICENSE_URL)</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span></span></code></pre><h3 id="nmyhh-sdhszy-tnzymt-open-graph">نمایه‌ها: ساده‌سازی تنظیمات Open Graph</h3> <p>جدول فرعی <code>[extra.profiles.&lt;user&gt;.open_graph]</code> حذف شده است. فیلدهای <code>image</code> و <code>image_alt</code> یک سطح به بالا منتقل شده و تغییر نام داده‌اند؛ فیلد <code>fediverse_creator</code> نیز یک سطح به بالا منتقل شد و فیلدهای اختصاصی فیس‌بوک (<code>first_name</code> و <code>last_name</code> و <code>username</code> و <code>gender</code> و <code>fb_app_id</code> و <code>fb_admins</code>) به همراه بخش ترجمه Open Graph برای هر زبان به طور کامل حذف شدند:</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="toml" data-name="zola.toml"><span class="giallo-l"><span style="color: light-dark(#008000, #8B949E);">#</span><span style="color: light-dark(#008000, #8B949E);"> قبل</span></span> <span class="giallo-l"><span>[</span><span style="color: light-dark(#000000, #FFA657);">extra</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">profiles</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">your_username</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">open_graph</span><span>]</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">image</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">cover.png</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">image_alt</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 style="color: light-dark(#001080, #E6EDF3);">fediverse_creator</span><span> =</span><span> {</span><span style="color: light-dark(#001080, #E6EDF3);"> handle</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">me</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span>,</span><span style="color: light-dark(#001080, #E6EDF3);"> domain</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">mastodon.social</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span> }</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#008000, #8B949E);">#</span><span style="color: light-dark(#008000, #8B949E);"> بعد</span></span> <span class="giallo-l"><span>[</span><span style="color: light-dark(#000000, #FFA657);">extra</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">profiles</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">your_username</span><span>]</span></span> <span class="giallo-l"><span style="color: light-dark(#008000, #8B949E);">#</span><span style="color: light-dark(#008000, #8B949E);"> ...avatar_url و name و bio و social و غیره مانند قبل، به علاوه:</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">og_image</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">cover.png</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">og_image_alt</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 style="color: light-dark(#001080, #E6EDF3);">fediverse_creator</span><span> =</span><span> {</span><span style="color: light-dark(#001080, #E6EDF3);"> handle</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">me</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span>,</span><span style="color: light-dark(#001080, #E6EDF3);"> domain</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">mastodon.social</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span><span> }</span></span></code></pre> <p>اگر به فیلدهای <code>first_name</code> / <code>last_name</code> / <code>gender</code> / <code>fb_app_id</code> / <code>fb_admins</code> یا به تنظیم اختصاصی زبان <code>open_graph.languages.&lt;lang&gt;.image_alt</code> متکی بودید، جایگزین مستقیمی وجود ندارد – این فیلدهای Open Graph دیگر توسط پوسته تولید نمی‌شوند.</p> <h3 id="gzynhhy-zbn-hdhf-locale-w-tgyyr-nhwh-frmt-trykh">گزینه‌های زبان: حذف <code>locale</code> و تغییر نحوه فرمت تاریخ</h3> <p>فیلتر <code>date</code> در زولا دیگر ورودی <code>locale</code> دریافت نمی‌کند؛ بنابراین متغیر <code>extra.languages.&lt;lang&gt;.locale</code> (به عنوان مثال <code>locale = "fr_FR"</code>) حذف شده است. فرمت‌بندی تاریخ از کریت <code>chrono</code> به <code>jiff</code> منتقل شده است، بنابراین رشته‌های <code>date_format</code> اکنون بر اساس <a rel="external" href="https://docs.rs/jiff/latest/jiff/fmt/strtime/index.html#conversion-specifications">مرجع strftime در jiff</a> تفسیر می‌شوند و نه chrono.</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="toml" data-name="zola.toml"><span class="giallo-l"><span style="color: light-dark(#008000, #8B949E);">#</span><span style="color: light-dark(#008000, #8B949E);"> قبل</span></span> <span class="giallo-l"><span>[</span><span style="color: light-dark(#000000, #FFA657);">extra</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">languages</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">fr</span><span>]</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">locale</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">fr_FR</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">date_format</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">%x</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#008000, #8B949E);">#</span><span style="color: light-dark(#008000, #8B949E);"> بعد</span></span> <span class="giallo-l"><span>[</span><span style="color: light-dark(#000000, #FFA657);">extra</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">languages</span><span>.</span><span style="color: light-dark(#000000, #FFA657);">fr</span><span>]</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">date_format</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">%F</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span></span> <span class="giallo-l"><span style="color: light-dark(#001080, #E6EDF3);">num_format</span><span> =</span><span style="color: light-dark(#A31515, #A5D6FF);"> &quot;</span><span style="color: light-dark(#A31515, #A5D6FF);">fr</span><span style="color: light-dark(#A31515, #A5D6FF);">&quot;</span></span></code></pre> <p>اثر عملی: اگر به <code>locale</code> وابسته بودید تا نام ترجمه‌شده ماه‌ها/روزهای هفته (از طریق توکن‌هایی مثل <code>%B</code> یا <code>%A</code>) را چاپ کند، این کار دیگر به صورت خودکار انجام نمی‌شود. توکن‌های <code>date_format</code> خود را با مستندات jiff بررسی کنید – ممکن است بخواهید از فرمت کاملاً عددی استفاده کنید یا بپذیرید که نام ماه‌ها و روزها با خروجی پیش‌فرض jiff برای آن توکن نمایش داده شود. متغیر <code>num_format</code> (برای فرمت‌بندی اعداد، که ارتباطی به تاریخ ندارد) بدون تغییر مانده و همچنان برای هر زبان تنظیم می‌شود.</p> <h3 id="hdhf-disable-javascript">حذف <code>disable_javascript</code></h3> <p>متغیر پیکربندی <code>extra.disable_javascript</code> که به شما اجازه می‌داد جاوااسکریپت پوسته را غیرفعال کرده و با تزریق کد (injects) مجدداً خودتان آن را پیاده‌سازی کنید، حذف شده است.</p> <h3 id="pywndhy-mstndt">پیوندهای مستندات</h3> <p>اگر به مستندات خود لینکیتا پیوند داده‌اید، توجه داشته باشید که صفحه نمایش شورت‌کدها از <code>/shortcodes/</code> به <code>/components/</code> منتقل شده است (برای مثال، ویژگی پروژه‌ها اکنون در نشانی <code>https://salif.github.io/linkita/components/#projects</code> مستند شده است).</p> <p>توضیحات مربوط به تصویر جلد (cover image) شفاف‌سازی شده است تا مشخص شود <code>extra.cover.image</code> یا نام یک فایل از دارایی‌های صفحه و یا یک مسیر سازگار با <code>get_url</code> را می‌پذیرد – این قابلیت قبلاً هم کار می‌کرد، فقط به طور صریح ذکر نشده بود.</p> <h2 id="mrhlh-4-bhrwzrsny-mhtw-shwrtkhdh-khnwn-mwlfh-components-hstnd">مرحله ۴: به‌روزرسانی محتوا – شورت‌کدها اکنون مولفه (Components) هستند</h2> <p>این تغییری است که احتمالاً بیشترین تأثیر را روی نوشته‌های موجود شما می‌گذارد.</p> <p>نسخه Zola v0.23 ویژگی کدهای کوتاه (shortcodes) را به طور کامل حذف کرد. دیگر پوشه‌ای به نام <code>templates/shortcodes/</code> وجود ندارد، و شیوه قبلی فراخوانی شورت‌کد به صورت تابع در متن مارک‌داون (با یا بدون محتوا) منسوخ شده است – هر دو فرم اکنون با خطای "unknown function" یا "unknown tag" بیلد را متوقف می‌کنند. در عوض، فایل‌های <code>.md</code> شما مستقیماً توسط موتور Tera مانند قالب‌های <code>.html</code> قالب‌بندی می‌شوند، و شما <strong>مولفه‌های</strong> داخلی لینکیتا را با ساختار فراخوانی جدید Tera v2 فراخوانی می‌کنید.</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);">component_name</span><span style="color: light-dark(#E50000, #79C0FF);"> arg</span><span>=</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#0000FF, #A5D6FF);">value</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>محتوای متن</span></span> <span class="giallo-l"><span>{% </span><span style="color: light-dark(#800000, #E6EDF3);">&lt;/</span><span style="color: light-dark(#800000, #7EE787);">component_name</span><span style="color: light-dark(#800000, #E6EDF3);">&gt;</span><span> %}</span></span></code></pre> <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);">component_name</span><span style="color: light-dark(#E50000, #79C0FF);"> arg</span><span>=</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#0000FF, #A5D6FF);">value</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#800000, #E6EDF3);"> /&gt;</span><span>}}</span></span></code></pre><h3 id="ln-admonition">اعلان (Admonition)</h3> <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 style="color: light-dark(#800000, #79C0FF);font-weight: bold;">#</span><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;"> قبل</span></span> <span class="giallo-l"><span>{% admonition(type=&quot;note&quot;, title=&quot;یک نکته&quot;) %}</span></span> <span class="giallo-l"><span>این متن یک </span><span style="color: light-dark(#000080, #E6EDF3);font-weight: bold;">**</span><span style="color: light-dark(#000080, #E6EDF3);font-weight: bold;">نکته</span><span style="color: light-dark(#000080, #E6EDF3);font-weight: bold;">**</span><span> است.</span></span> <span class="giallo-l"><span>{% end %}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;">#</span><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;"> بعد</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(#E50000, #79C0FF);"> type</span><span>=</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#0000FF, #A5D6FF);">note</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);">یک نکته</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>این متن یک </span><span style="color: light-dark(#000080, #E6EDF3);font-weight: bold;">**</span><span style="color: light-dark(#000080, #E6EDF3);font-weight: bold;">نکته</span><span style="color: light-dark(#000080, #E6EDF3);font-weight: bold;">**</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><h3 id="ngrkhnh-gallery">نگارخانه (Gallery)</h3> <p>نگارخانه اکنون نیاز دارد <code>page</code> و <code>config</code> به طور صریح به آن فرستاده شوند (مولفه‌های Tera v2 دسترسی ضمنی به page/config مانند شورت‌کدهای قدیمی ندارند – شما آن‌ها را با نام پاس می‌دهید و از آنجا که نام متغیرها با نام پارامترها مطابقت دارد، می‌توانید بنویسید <code>page config</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 style="color: light-dark(#800000, #79C0FF);font-weight: bold;">#</span><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;"> قبل</span></span> <span class="giallo-l"><span>{{ gallery() }}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;">#</span><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;"> بعد</span></span> <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(#E50000, #79C0FF);"> page</span><span style="color: light-dark(#E50000, #79C0FF);"> config</span><span style="color: light-dark(#E50000, #79C0FF);"> alt</span><span>=</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#0000FF, #A5D6FF);">&quot;</span><span style="color: light-dark(#800000, #E6EDF3);"> /&gt;</span><span>}}</span></span></code></pre><h3 id="mermaid">Mermaid</h3> <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 style="color: light-dark(#800000, #79C0FF);font-weight: bold;">#</span><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;"> قبل</span></span> <span class="giallo-l"><span>{% mermaid() %}</span></span> <span class="giallo-l"><span>```</span><span>mermaid</span></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>```</span></span> <span class="giallo-l"><span>{% end %}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;">#</span><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;"> بعد</span></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> <span class="giallo-l"><span>```</span><span>mermaid</span></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>```</span></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>خط‌های تیره تنظیم فواصل سفید را همان‌طور که در بالا نشان داده شده (دقیقاً پس از علامت باز کردن درصد و قبل از علامت بستن درصد) استفاده کنید – بدون آن‌ها، خط خالی ابتدایی قبل از بلوک کد حذف نمی‌شود و نمودار به همراه علامت‌های <code>```mermaid</code> نمایش داده می‌شود به جای اینکه توسط مولفه پاک‌سازی شود.</p> <h3 id="prwjhh-projects">پروژه‌ها (Projects)</h3> <p>مولفه پروژه‌ها نیز اکنون نیاز دارد <code>page</code> و <code>config</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 style="color: light-dark(#800000, #79C0FF);font-weight: bold;">#</span><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;"> قبل</span></span> <span class="giallo-l"><span>{{ projects(path=&quot;data.toml&quot;, format=&quot;toml&quot;) }}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;">#</span><span style="color: light-dark(#800000, #79C0FF);font-weight: bold;"> بعد</span></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(#E50000, #79C0FF);"> page</span><span style="color: light-dark(#E50000, #79C0FF);"> config</span><span style="color: light-dark(#800000, #E6EDF3);"> /&gt;</span><span>}}</span></span></code></pre><h3 id="gr-dr-nwshthhy-khwd-drbrh-skhtr-tera-mynwysyd">اگر در نوشته‌های خود درباره ساختار Tera می‌نویسید</h3> <p>از آنجا که فایل‌های <code>.md</code> اکنون قبل از تجزیه مارک‌داون توسط موتور Tera پردازش می‌شوند، تگ‌های Tera درون یک بلوک کد – مانند مثال‌های بالا – حتی درون علامت‌های سه‌گانه بک‌تیک نیز اجرا خواهند شد و نمایش داده نمی‌شوند. برای نمایش دقیق متن آن‌ها، هر نمونه‌ای از این دست را درون یک بلوک <code>raw</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>{% raw %}</span></span> <span class="giallo-l"><span>...</span></span> <span class="giallo-l"><span>{% endraw %}</span></span></code></pre><h2 id="mrhlh-5-fylhy-zbn-sfrshy">مرحله ۵: فایل‌های زبان سفارشی</h2> <p>اگر فایل سفارشی <code>static/i18n/&lt;lang&gt;.json</code> اضافه کرده‌اید، تغییرات خود را با فایل زبان پیش‌فرض پوسته همگام‌سازی کنید.</p> <h2 id="mrhlh-6-pyshrfth-bznwysy-y-tzryq-qlbhy-sfrshy">مرحله ۶ (پیشرفته): بازنویسی یا تزریق قالب‌های سفارشی</h2> <p>این بخش را نادیده بگیرید مگر اینکه یکی از قالب‌های لینکیتا را خودتان بازنویسی کرده باشید، یا ماکروهای داخلی آن را مستقیماً از قالب‌های خودتان فراخوانی کنید.</p> <p>ماکروهای Tera v1 در Tera v2 حذف شده و با <strong>مولفه‌ها (components)</strong> جایگزین شده‌اند که به صورت عمومی و با نام فراخوانی می‌شوند – دیگر نیازی به <code>{% import %}</code> یا پیشوند <code>self::</code> نیست.</p> <p>سایر تغییرات ساختاری Tera v2 در میان قالب‌ها به صورت زیر است:</p> <ul> <li>متدهای <code>trim_start_matches(pat=...)</code> و <code>trim_end_matches(pat=...)</code> اکنون به <code>trim_start(pat=...)</code> و <code>trim_end(pat=...)</code> تبدیل شده‌اند.</li> <li>متد <code>linebreaksbr</code> به <code>newlines_to_br</code> تغییر یافته است.</li> <li>متد <code>default(value=x)</code> اکنون نیازمند <code>boolean=true</code> است (یعنی <code>default(value=x, boolean=true)</code>) تا رشته‌های خالی یا <code>false</code> را به عنوان «استفاده از مقدار پیش‌فرض» در نظر بگیرد؛ در غیر این صورت تنها مقادیر نامشخص (undefined/null) باعث فراخوانی پیش‌فرض می‌شوند.</li> <li>زنجیره‌سازی اختیاری (<code>?.</code> / <code>?[...]</code>) در دسترس است و برای خواندن مقادیر تنظیمی که ممکن است وجود نداشته باشند به کار می‌رود.</li> <li>زمینه سراسری (<code>page</code>، <code>config</code>، <code>lang</code> و غیره) دیگر مانند گذشته به صورت ضمنی درون مولفه در دسترس نیست – مولفه‌ها باید آن را صراحتاً اعلام و دریافت کنند، به همین دلیل پارامترهای <code>page: map</code> و <code>config: map</code> را در تمام قالب‌های جدید مشاهده می‌کنید.</li> <li>قالب‌های سفارشی <code>templates/sitemap.xml</code> و <code>templates/split_sitemap_index.xml</code> از پوسته حذف شده‌اند. اگر قبلاً هر یک از این‌ها را بازنویسی کرده بودید، بررسی کنید که آیا هنوز به آن‌ها نیاز دارید یا خیر.</li> </ul> <p>برای تصویر کامل تغییرات صورت گرفته در خود Tera، <a rel="external" href="https://github.com/Keats/tera/blob/master/MIGRATION.md">راهنمای مهاجرت Tera v1 به v2</a> را ببینید.</p> <h2 id="mrhlh-7-bzszy-w-brrsy-syt">مرحله ۷: بازسازی و بررسی سایت</h2> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#000000, #E6EDF3); background-color: light-dark(#FFFFFF, #0D1117);" ><code data-lang="shellscript"><span class="giallo-l"><span style="color: light-dark(#795E26, #FFA657);">zola</span><span style="color: light-dark(#A31515, #A5D6FF);"> build</span></span></code></pre> <p>سپس سایت را بررسی کنید، به خصوص:</p> <ul> <li>گزینه‌های منو و نمادهای شبکه‌های اجتماعی به نشانی‌های درست هدایت شوند (تغییر <code>@base</code>).</li> <li>تصویر و توضیحات Open Graph نمایه شما و تگ پیوند تأیید Fediverse در <code>&lt;head&gt;</code> صفحه حاضر باشند.</li> <li>فرمت‌بندی تاریخ در زبان‌های غیر انگلیسی همچنان مناسب باشد (عدم نمایش خودکار نام ماه‌ها/روزها به صورت محلی).</li> <li>اعلان‌ها، نگارخانه‌ها، نمودارهای Mermaid یا صفحه پروژه‌ها به درستی نمایش داده شوند.</li> </ul> <h2 id="rhnmyy-w-pshtybny">راهنمایی و پشتیبانی</h2> <p>اگر موردی با آنچه در اینجا توضیح داده شده مطابقت ندارد، به <a rel="external" href="https://github.com/salif/linkita/blob/main/README.md">README</a> و <a rel="external" href="https://github.com/salif/linkita/blob/main/CHANGELOG.md">CHANGELOG</a> در شاخه <code>main</code> مراجعه کرده یا در بخش <a rel="external" href="https://github.com/salif/linkita/discussions">گفت‌وگوهای گیت‌هاب</a> مطرح کنید.</p> تایپ و صفحه‌بندی ریاضی 2024-11-08T00:00:00+00:00 2024-11-08T00:00:00+00:00 Default Author https://salif.github.io/linkita/fa/math-typesetting/ <p>پوسته لینکیتا از فرمول‌های ریاضی $\LaTeX$ با استفاده از <a rel="external" href="https://katex.org/">KaTeX</a> پشتیبانی می‌کند.</p> راهنمای ساختار نگارش مارک‌داون 2023-10-20T00:00:00+00:00 2023-10-20T00:00:00+00:00 Default Author https://salif.github.io/linkita/fa/markdown-syntax/ <p>این مقاله نمونه‌ای از ساختار نگارش اولیه مارک‌داون (Markdown) را ارائه می‌دهد که می‌تواند در فایل‌های محتوای زولا استفاده شود؛ همچنین نشان می‌دهد که آیا عناصر پایه HTML با CSS در پوسته لینکیتا آراسته شده‌اند یا خیر.</p>