deepStateMirrors/tabi
1
0
Fork 1
mirror of https://github.com/welpo/tabi.git synced 2025-11-05 10:30:24 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
tabi/ca/blog/series/index.html
GitHub Actions 9c032744d3 Deploy welpo/tabi to welpo/tabi:gh-pages
2025-11-04 13:26:57 +00:00

164 lines
No EOL
65 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html><html lang=ca><head><meta charset=UTF-8><meta content="default-src 'self';font-src 'self' data: 'self';img-src 'self' https://* data:;media-src 'self' https://cdn.jsdelivr.net/;style-src 'self' 'unsafe-inline';frame-src player.vimeo.com https://www.youtube-nocookie.com;connect-src 'self' https://tabi-stats.osc.garden vhiweeypifbwacashxjz.supabase.co;script-src 'self' https://tabi-stats.osc.garden cdn.jsdelivr.net 'self'" http-equiv=Content-Security-Policy><meta content="width=device-width,initial-scale=1.0" name=viewport><meta content=https://welpo.github.io/tabi name=base><title>
~/tabi • Guia completa sobre sèries</title><link href=https://welpo.github.io/tabi/img/seedling.png rel=icon type=image/png><link href='data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><text y="50%" x="50%" dominant-baseline="central" text-anchor="middle" font-size="88">🌱</text></svg>' rel=icon><link title="~/tabi - Atom Feed" href=https://welpo.github.io/tabi/atom.xml rel=alternate type=application/atom+xml><link href="https://welpo.github.io/tabi/custom_subset.css?h=0b9535a28bc3d5bf2321" rel=stylesheet><link href="https://welpo.github.io/tabi/main.css?h=3716ab3457d2dd050b3c" rel=stylesheet><meta content="light dark" name=color-scheme><meta content=#087e96 name=theme-color><meta content="Aprèn a organitzar les teves publicacions en sèries seqüencials, perfectes per a tutorials, cursos i històries de diverses parts." name=description><meta content="Aprèn a organitzar les teves publicacions en sèries seqüencials, perfectes per a tutorials, cursos i històries de diverses parts." property=og:description><meta content="Guia completa sobre sèries" property=og:title><meta content=article property=og:type><meta content="https://welpo.github.io/tabi/blog/series/social_cards/ca_blog_series.jpg?h=82b63124c532ede70795" property=og:image><meta content=1400 property=og:image:width><meta content=800 property=og:image:height><meta content="https://welpo.github.io/tabi/blog/series/social_cards/ca_blog_series.jpg?h=82b63124c532ede70795" name=twitter:image><meta content=summary_large_image name=twitter:card><meta content=ca_ES property=og:locale:alternate><link href=https://welpo.github.io/tabi/ca/blog/series/ hreflang=ca rel=alternate><meta content=es_ES property=og:locale:alternate><link href=https://welpo.github.io/tabi/es/blog/series/ hreflang=es rel=alternate><meta content=en_GB property=og:locale:alternate><link href=https://welpo.github.io/tabi/blog/series/ hreflang=en rel=alternate><meta content=https://welpo.github.io/tabi/ca/blog/series/ property=og:url><meta content=~/tabi property=og:site_name><noscript><link href=https://welpo.github.io/tabi/no_js.css rel=stylesheet></noscript><script src=https://welpo.github.io/tabi/js/initializeTheme.min.js></script><script defer src=https://welpo.github.io/tabi/js/themeSwitcher.min.js></script><script async data-goatcounter=https://tabi-stats.osc.garden/count src=https://tabi-stats.osc.garden/count.js></script><body><a href=#main-content id=skip-link>Saltar al contingut</a><header><nav class=navbar><div class=nav-title><a class=home-title href=https://welpo.github.io/tabi/ca/>~/tabi</a></div><div class=nav-navs><ul><li><a class="nav-links no-hover-padding" href=https://welpo.github.io/tabi/ca/blog/>blog </a><li><a class="nav-links no-hover-padding" href=https://welpo.github.io/tabi/ca/archive/>arxiu </a><li><a class="nav-links no-hover-padding" href=https://welpo.github.io/tabi/ca/tags/>etiquetes </a><li><a class="nav-links no-hover-padding" href=https://welpo.github.io/tabi/ca/projects/>projectes </a><li class=menu-icons-container><ul class=menu-icons-group><li class=language-switcher><details class=dropdown><summary aria-label="Selecció d'idioma" title="Selecció d'idioma" aria-haspopup=true role=button><div class=language-switcher-icon></div></summary> <div class=dropdown-content role=menu>Català<a aria-label=English href=https://welpo.github.io/tabi/blog/series/ lang=en role=menuitem>English</a><a aria-label=العربية href=https://welpo.github.io/tabi/ar/blog/series/ lang=ar role=menuitem>العربية</a><a aria-label=Español href=https://welpo.github.io/tabi/es/blog/series/ lang=es role=menuitem>Español</a></div></details><li class="theme-switcher-wrapper js"><div aria-label="Canvia el mode obscur" title="Canvia el mode obscur/clar" aria-pressed=false class=theme-switcher role=button tabindex=0></div><div aria-label="Restableix el mode al valor predeterminat" class="theme-resetter arrow" title="Restableix el mode al valor predeterminat" aria-hidden=true role=button tabindex=0></div></ul></ul></div></nav></header><div class=content id=main-content><main><article class=h-entry><h1 class="p-name article-title">Guia completa sobre sèries</h1><a class="u-url u-uid" href=https://welpo.github.io/tabi/ca/blog/series/></a><ul class=meta><li><time class=dt-published datetime=2024-11-08>8 de nov. 2024</time><li title="1735 paraules"><span aria-hidden=true class=separator>•</span>9 mins de lectura<li class=tag><span aria-hidden=true class=separator>•</span>Etiquetes: <li class=tag><a class=p-category href=https://welpo.github.io/tabi/ca/tags/funcionalitat/>funcionalitat</a>, <li class=tag><a class=p-category href=https://welpo.github.io/tabi/ca/tags/tutorial/>tutorial</a>, <li class=tag><a class=p-category href=https://welpo.github.io/tabi/ca/tags/preguntes-frequents/>preguntes freqüents</a>, <li class=tag><a class=p-category href=https://welpo.github.io/tabi/ca/tags/series/>sèries</a></ul><ul class="meta last-updated"><li><time class=dt-updated datetime=2025-02-21>Actualitzat el 21 de febr. 2025</time><li><span aria-hidden=true class=separator>•</span><a class=external href=https://github.com/welpo/tabi/commits/main/content/blog/series/index.ca.md>Veure canvis</a></ul><div class=toc-container><h3>Taula de contingut</h3><ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#inici-rapid>Inici ràpid</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#com-funcionen-les-series>Com funcionen les sèries?</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#saltar-a-les-publicacions>Saltar a les publicacions</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#pagines-de-series-i-ordre>Pàgines de sèries i ordre</a> <ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#opcions-d-ordre>Opcions d’ordre</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#indexacio-de-pagines>Indexació de pàgines</a></ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#plantilles-d-introduccio-i-conclusio>Plantilles d’introducció i conclusió</a> <ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#tipus-de-plantilles>Tipus de plantilles</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#ubicacio-al-contingut>Ubicació al contingut</a></ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#variables>Variables</a> <ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#variables-basiques-de-serie>Variables bàsiques de sèrie</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#variables-de-navegacio>Variables de navegació</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#referencia-al-primer-article>Referència al primer article</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#exemple-de-plantilla>Exemple de plantilla</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#variables-personalitzades>Variables personalitzades</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#us-de-variables-personalitzades>Ús de variables personalitzades</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#exemple-amb-variables-personalitzades>Exemple amb variables personalitzades</a></ul></ul></div><p class=p-summary hidden>Aprèn a organitzar les teves publicacions en sèries seqüencials, perfectes per a tutorials, cursos i històries de diverses parts.<section class="e-content body"><p>Una sèrie organitza publicacions relacionades en ordre seqüencial, similar als capítols d’un llibre. A diferència de les etiquetes, que simplement agrupen contingut relacionat, les sèries suggereixen un ordre específic de lectura de principi a fi.<p>Les publicacions dins d’una sèrie no necessiten publicar-se de forma consecutiva; la funció de sèries reuneix publicacions temàticament vinculades en una seqüència coherent.<p>El següent diagrama il·lustra com les publicacions de la sèrie (3, 5 i 8) existeixen dins del flux principal del blog mentre mantenen la seva pròpia seqüència ordenada dins de Sèrie 1.</p><noscript><strong>⚠️ JavaScript is required to render the diagram.</strong></noscript><pre class="mermaid invertible-image full-width">
flowchart
subgraph main[BLOG]
P1[Post 1]
P2[P2]
P3[P3]
P4[P4]
P5[P5]
P6[P6]
P7[P7]
P8[P8]
P9[P9]
end
subgraph series1[SÈRIE 1]
PS1["Post Sèrie 1 (=P3)"]
PS2["Post Sèrie 2 (=P5)"]
PS3["Post Sèrie 3 (=P8)"]
end
P3 o-.-o PS1
P5 o-.-o PS2
P8 o-.-o PS3
</pre><h2 id=inici-rapid><a aria-label="Anchor link for: inici-rapid" class="header-anchor no-hover-padding" href=#inici-rapid><span aria-hidden=true class=link-icon></span></a> Inici ràpid</h2><ol><li><p>Crea un directori per a la teva sèrie</p><li><p>Crea <code>_index.md</code> al directori de la sèrie</p><li><p>Configura el front matter de <code>_index.md</code>:</p> <pre class="language-toml z-code" data-lang=toml data-name=series/_index.md><code class=language-toml data-lang=toml data-name=series/_index.md><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">title</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>Aprenent Rust<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">template</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>series.html<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">sort_by</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>slug<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">transparent</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-constant z-language z-toml">true</span>
</span><span class="z-source z-toml">
</span><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">series</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-constant z-language z-toml">true</span>
</span></code></pre><li><p>Crea els teus articles de la sèrie en aquest directori</p></ol><p>Vols saber-ne més? Continua llegint!<h2 id=com-funcionen-les-series><a aria-label="Anchor link for: com-funcionen-les-series" class="header-anchor no-hover-padding" href=#com-funcionen-les-series><span aria-hidden=true class=link-icon></span></a> Com funcionen les sèries?</h2><p>Una sèrie és simplement una secció que tabi gestiona de manera especial. Per a més detalls sobre seccions, consulta la <a class=external href=https://www.getzola.org/documentation/content/section/>documentació de Zola</a>.<p>Prenent l’exemple del diagrama anterior, l’estructura de directoris seria així:<pre class="language-txt z-code" data-lang=txt><code class=language-txt data-lang=txt><span class="z-text z-plain">content/
</span><span class="z-text z-plain"> _index.md
</span><span class="z-text z-plain"> blog/
</span><span class="z-text z-plain"> _index.md
</span><span class="z-text z-plain"> post1/
</span><span class="z-text z-plain"> index.md
</span><span class="z-text z-plain"> post2/
</span><span class="z-text z-plain"> index.md
</span><span class="z-text z-plain"> post4/
</span><span class="z-text z-plain"> index.md
</span><span class="z-text z-plain"> post6/
</span><span class="z-text z-plain"> index.md
</span><span class="z-text z-plain"> post7/
</span><span class="z-text z-plain"> index.md
</span><span class="z-text z-plain"> post9/
</span><span class="z-text z-plain"> index.md
</span><span class="z-text z-plain"> serie1/
</span><span class="z-text z-plain"> _index.md
</span><span class="z-text z-plain"> post3/
</span><span class="z-text z-plain"> index.md
</span><span class="z-text z-plain"> post5/
</span><span class="z-text z-plain"> index.md
</span><span class="z-text z-plain"> post8/
</span><span class="z-text z-plain"> index.md
</span></code></pre><p>Per crear una sèrie, necessites:<ol><li>Utilitzar la plantilla <code>series.html</code><li>Establir <code>series = true</code> a la configuració <code>[extra]</code> de la secció<li>Activar <code>transparent = true</code> per integrar les publicacions de la sèrie amb la secció del blog principal</ol><p>La pàgina principal de la sèrie mostra un resum seguit d’una llista de totes les publicacions a la sèrie:<div class=full-width><img alt="una sèrie" src="https://welpo.github.io/tabi/blog/series/img/series_light.webp?h=b263f660f586e7a0978f" class=img-light loading=lazy><img alt="una sèrie" src="https://welpo.github.io/tabi/blog/series/img/series_dark.webp?h=33e658ae352f1e6cb809" class=img-dark loading=lazy></div><h2 id=saltar-a-les-publicacions><a aria-label="Anchor link for: saltar-a-les-publicacions" class="header-anchor no-hover-padding" href=#saltar-a-les-publicacions><span aria-hidden=true class=link-icon></span></a> Saltar a les publicacions</h2><p>Si el contingut d’una sèrie (el Markdown després del frontmatter a <code>_index.md</code>) supera els 2000 caràcters, apareix un enllaç “Salta a les publicacions” al costat del títol de la sèrie.<div class=full-width><img alt="enllaç per saltar a les publicacions de la sèrie" src="https://welpo.github.io/tabi/blog/series/img/jump_to_series_posts_light.webp?h=36a55aa8486a48dcad54" class=img-light loading=lazy><img alt="enllaç per saltar a les publicacions de la sèrie" src="https://welpo.github.io/tabi/blog/series/img/jump_to_series_posts_dark.webp?h=b2050110d2b4ad3f8768" class=img-dark loading=lazy></div><p>Per forçar l’activació o desactivació d’aquesta funció, configura <code>show_jump_to_posts</code> a la secció <code>[extra]</code> de la teva secció de sèries o a <code>config.toml</code>. Aquesta configuració segueix <a href=https://welpo.github.io/tabi/ca/blog/mastering-tabi-settings/#jerarquia-de-configuracio>la jerarquia</a>.<h2 id=pagines-de-series-i-ordre><a aria-label="Anchor link for: pagines-de-series-i-ordre" class="header-anchor no-hover-padding" href=#pagines-de-series-i-ordre><span aria-hidden=true class=link-icon></span></a> Pàgines de sèries i ordre</h2><p>Totes les pàgines a la secció de sèries seran pàgines de sèrie. Les pàgines s’ordenaran segons el <code>sort_by</code> de la secció.<p>Tot i que les sèries mantenen el seu propi ordre intern, romanen independents del flux cronològic de la secció principal (per exemple, <code>blog/</code>) gràcies a la configuració <code>transparent</code>.<h3 id=opcions-d-ordre><a aria-label="Anchor link for: opcions-d-ordre" class="header-anchor no-hover-padding" href=#opcions-d-ordre><span aria-hidden=true class=link-icon></span></a> Opcions d’ordre</h3><p>Tria entre aquests mètodes d’ordre, cadascun amb els seus avantatges:<div class=full-width><table><thead><tr><th><code>sort_by</code><th>avantatges<th>desavantatges<tbody><tr><td><code>slug</code><td>L’ordre de les pàgines és explícit a la ruta (per exemple, <code>example.com/blog/series1/01-series-post-un</code>).<td>Cada pàgina de la sèrie ha de tenir el prefix corresponent.<tr><td><code>weight</code><td>L’ordre de les pàgines és fàcil de configurar de forma transparent.<br>La primera publicació té pes <code>1</code>, la segona pes <code>2</code> i així successivament.<td>Cada pàgina de la sèrie ha de tenir el seu pes configurat.<tr><td><code>date</code><td>L’ordre de les pàgines es pot configurar una sola vegada a la configuració de la secció. No cal fer res a cada pàgina.<td>L’ordre de les pàgines s’ha d’invertir perquè la primera pàgina sol ser la més antiga. Això només es pot aconseguir paginant la secció (<code>paginate_by = 9999</code>) i invertint el seu ordre (<code>paginate_reversed = true</code>).</table></div><div class="admonition danger"><div class="admonition-icon admonition-icon-danger"></div><div class=admonition-content><strong class=admonition-title>Versió de Zola per ordenar per data</strong><p>Per invertir correctament les dates, es requereix Zola v0.19.3+ (no publicada) perquè la informació de paginació estigui disponible a través de la funció <code>get_section</code>. En cas contrari, qualsevol cosa que depengui de l’ordre de les pàgines de la sèrie no serà correcta (per exemple, pàgina anterior/següent, llistes ordenades i no ordenades…) Vegeu <a class=external href=https://github.com/getzola/zola/pull/2653>Zola PR #2653</a>.</div></div><h3 id=indexacio-de-pagines><a aria-label="Anchor link for: indexacio-de-pagines" class="header-anchor no-hover-padding" href=#indexacio-de-pagines><span aria-hidden=true class=link-icon></span></a> Indexació de pàgines</h3><p>Les pàgines en una sèrie s’indexen començant des d’1, seguint el seu ordre <code>sort_by</code>. Per invertir la indexació (fent que la primera pàgina tingui l’índex més alt), afegeix aquesta configuració a <code>_index.md</code> o <code>config.toml</code>:<pre class="language-toml z-code" data-lang=toml><code class=language-toml data-lang=toml><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">post_listing_index_reversed</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-constant z-language z-toml">true</span> <span class="z-comment z-line z-number-sign z-toml"><span class="z-punctuation z-definition z-comment z-toml">#</span> Per defecte és false si no es configura</span>
</span></code></pre><div class=full-width><img alt="una sèrie amb índexs invertits" src="https://welpo.github.io/tabi/blog/series/img/series_reversed_light.webp?h=c87548ebd6afb4dc6f53" class=img-light loading=lazy><img alt="una sèrie amb índexs invertits" src="https://welpo.github.io/tabi/blog/series/img/series_reversed_dark.webp?h=2a7db8e8e3808c5925fd" class=img-dark loading=lazy></div><p>Aquesta configuració segueix <a href=https://welpo.github.io/tabi/ca/blog/mastering-tabi-settings/#jerarquia-de-configuracio>la jerarquia</a>.<h2 id=plantilles-d-introduccio-i-conclusio><a aria-label="Anchor link for: plantilles-d-introduccio-i-conclusio" class="header-anchor no-hover-padding" href=#plantilles-d-introduccio-i-conclusio><span aria-hidden=true class=link-icon></span></a> Plantilles d’introducció i conclusió</h2><p>Els articles d’una sèrie poden tenir seccions automàtiques d’introducció i conclusió. Aquestes es configuren al <code>_index.md</code> de la teva sèrie. Un exemple bàsic:<pre class="language-toml z-code" data-lang=toml data-name=series/_index.md><code class=language-toml data-lang=toml data-name=series/_index.md><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span><span class="z-punctuation z-separator z-table z-toml">.</span><span class="z-entity z-name z-table z-toml">series_intro_templates</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">default</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>Aquest article és part de la sèrie $SERIES_HTML_LINK.<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span><span class="z-source z-toml">
</span><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span><span class="z-punctuation z-separator z-table z-toml">.</span><span class="z-entity z-name z-table z-toml">series_outro_templates</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">default</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>Gràcies per llegir la part $SERIES_PAGE_INDEX de $SERIES_HTML_LINK!<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span></code></pre><p>Les seccions d’introducció i conclusió tenen les seves pròpies classes CSS (<code>series-page-intro</code> i <code>series-page-outro</code>), que et permeten personalitzar la seva aparença mitjançant <a href=https://welpo.github.io/tabi/ca/blog/mastering-tabi-settings/#estils-css-personalitzats>CSS personalitzat</a>.<h3 id=tipus-de-plantilles><a aria-label="Anchor link for: tipus-de-plantilles" class="header-anchor no-hover-padding" href=#tipus-de-plantilles><span aria-hidden=true class=link-icon></span></a> Tipus de plantilles</h3><p>El sistema de sèries utilitza diferents plantilles segons la posició de l’article a la sèrie:<ul><li><code>next_only</code> - Utilitzat per al primer article (té article següent però no anterior)<li><code>middle</code> - Utilitzat per a articles amb articles anterior i següent<li><code>prev_only</code> - Utilitzat per a l’últim article (té article anterior però no següent)<li><code>default</code> - Plantilla per defecte utilitzada quan no existeix una plantilla específica per a la posició</ul><p>El sistema determina automàticament quina plantilla utilitzar segons la posició de l’article. Les plantilles es defineixen a la configuració de la sèrie (<code>_index.md</code>), com <code>extra.series_intro_templates</code> i <code>extra.series_outro_templates</code>:<pre class="language-toml z-code" data-lang=toml data-name=series/_index.md><code class=language-toml data-lang=toml data-name=series/_index.md><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span><span class="z-punctuation z-separator z-table z-toml">.</span><span class="z-entity z-name z-table z-toml">series_intro_templates</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">next_only</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>Benvingut a la part 1! Següent: $NEXT_HTML_LINK<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">middle</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>Anterior: $PREV_HTML_LINK | Següent: $NEXT_HTML_LINK<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">prev_only</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>El capítol final! Anteriorment: $PREV_HTML_LINK<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">default</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>Part $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span></code></pre><p>Totes les plantilles són opcionals. La selecció de plantilles segueix un sistema de prioritat:<ol><li>Si existeix una plantilla específica per a la posició (<code>next_only</code>, <code>middle</code>, o <code>prev_only</code>), s’utilitzarà aquesta<li>Si no, s’utilitza la plantilla <code>default</code><li>Si no es defineix cap plantilla, no es mostrarà informació de la sèrie</ol><p>Mira l’<a href=https://welpo.github.io/tabi/ca/blog/series/#exemple-de-plantilla>exemple de plantilla</a> per veure un exemple més elaborat.<h3 id=ubicacio-al-contingut><a aria-label="Anchor link for: ubicacio-al-contingut" class="header-anchor no-hover-padding" href=#ubicacio-al-contingut><span aria-hidden=true class=link-icon></span></a> Ubicació al contingut</h3><p>Per defecte:<ul><li>Les introduccions de sèrie apareixen a l’inici del teu article<li>La conclusió apareix al final (abans de les notes al peu, si n’hi ha)</ul><p>Pots controlar exactament on apareixen utilitzant <code>&lt;!-- series_intro --></code> i <code>&lt;!-- series_outro --></code> al teu Markdown:<pre class="language-markdown z-code" data-lang=markdown><code class=language-markdown data-lang=markdown><span class="z-text z-html z-markdown"><span class="z-meta z-paragraph z-markdown">Aquest paràgraf apareix abans de la introducció de la sèrie.
</span></span><span class="z-text z-html z-markdown"><span class="z-meta z-paragraph z-markdown">
</span></span><span class="z-text z-html z-markdown"><span class="z-meta z-disable-markdown"><span class="z-comment z-block z-html"><span class="z-punctuation z-definition z-comment z-begin z-html">&lt;!--</span> series_intro <span class="z-punctuation z-definition z-comment z-end z-html">--></span></span></span><span class="z-meta z-disable-markdown">
</span></span><span class="z-text z-html z-markdown">
</span><span class="z-text z-html z-markdown"><span class="z-meta z-paragraph z-markdown">Contingut principal de l'article.
</span></span><span class="z-text z-html z-markdown"><span class="z-meta z-paragraph z-markdown">
</span></span><span class="z-text z-html z-markdown"><span class="z-meta z-disable-markdown"><span class="z-comment z-block z-html"><span class="z-punctuation z-definition z-comment z-begin z-html">&lt;!--</span> series_outro <span class="z-punctuation z-definition z-comment z-end z-html">--></span></span></span><span class="z-meta z-disable-markdown">
</span></span><span class="z-text z-html z-markdown">
</span><span class="z-text z-html z-markdown"><span class="z-meta z-block-level z-markdown"><span class="z-markup z-heading z-2 z-markdown"><span class="z-punctuation z-definition z-heading z-begin z-markdown">##</span> </span><span class="z-markup z-heading z-2 z-markdown"><span class="z-entity z-name z-section z-markdown">Recursos d'aprenentatge</span><span class="z-meta z-whitespace z-newline z-markdown">
</span></span></span></span><span class="z-text z-html z-markdown">
</span><span class="z-text z-html z-markdown"><span class="z-meta z-paragraph z-markdown">Contingut addicional...
</span></span><span class="z-text z-html z-markdown"><span class="z-meta z-paragraph z-markdown">
</span></span><span class="z-text z-html z-markdown"><span class="z-meta z-link z-reference z-def z-footnote z-markdown-extra"><span class="z-punctuation z-definition z-constant z-begin z-markdown">[</span><span class="z-entity z-name z-reference z-link z-markdown">^1</span><span class="z-punctuation z-definition z-constant z-end z-markdown">]</span><span class="z-punctuation z-separator z-key-value z-markdown">:</span> Les notes al peu sempre apareixeran al final.
</span></span></code></pre><h2 id=variables><a aria-label="Anchor link for: variables" class="header-anchor no-hover-padding" href=#variables><span aria-hidden=true class=link-icon></span></a> Variables</h2><p>Les plantilles de sèries utilitzen un sistema flexible de variables que et permet:<ol><li>Fer referència a informació de la sèrie (títol, enllaços)<li>Afegir navegació entre articles<li>Mostrar indicadors de progrés<li>Incloure informació personalitzada utilitzant les teves pròpies variables</ol><p>Les variables són marcadors que comencen amb <code>$</code> i es reemplacen amb contingut real quan es construeix el teu lloc. Per exemple, <code>$SERIES_HTML_LINK</code> es converteix en un enllaç clicable a la pàgina índex de la teva sèrie.<p>Hi ha tres tipus de variables:<ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#variables-basiques-de-serie>Variables bàsiques de sèrie</a>: Informació general sobre la sèrie<li><a href=https://welpo.github.io/tabi/ca/blog/series/#variables-de-navegacio>Variables de navegació</a>: Enllaços a articles anterior/següent<li><a href=https://welpo.github.io/tabi/ca/blog/series/#variables-personalitzades>Variables personalitzades</a>: Els teus propis marcadors per a informació addicional</ul><h3 id=variables-basiques-de-serie><a aria-label="Anchor link for: variables-basiques-de-serie" class="header-anchor no-hover-padding" href=#variables-basiques-de-serie><span aria-hidden=true class=link-icon></span></a> Variables bàsiques de sèrie</h3><div class=full-width><table><thead><tr><th>Variable<th>Disponibilitat<th>Retorna<th>Descripció<th>Exemple d’ús<th>Exemple de sortida<tbody><tr><td><code>$SERIES_TITLE</code><td>Sempre<td>Text<td>Títol de la sèrie en text pla<td><code>Part de $SERIES_TITLE</code><td>Part d’Aprenent Rust<tr><td><code>$SERIES_PERMALINK</code><td>Sempre<td>Text<td>URL a l’índex de la sèrie<td><code>[Veure totes les publicacions]($SERIES_PERMALINK)</code><td><a href=/series/learn-rust>Veure totes les publicacions</a><tr><td><code>$SERIES_HTML_LINK</code><td>Sempre<td>HTML<td>Enllaç llest per usar a la sèrie<td><code>Benvingut a $SERIES_HTML_LINK!</code><td>Benvingut a <a href=/series/learn-rust>Aprenent Rust</a>!<tr><td><code>$SERIES_PAGES_NUMBER</code><td>Sempre<td>Nombre<td>Total d’articles a la sèrie<td><code>Una sèrie de $SERIES_PAGES_NUMBER parts</code><td>Una sèrie de 5 parts<tr><td><code>$SERIES_PAGE_INDEX</code><td>Sempre<td>Nombre<td>Posició de l’article actual<td><code>Part $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER</code><td>Part 3 de 5<tr><td><code>$SERIES_PAGES_OLIST</code><td>Sempre<td>HTML<td>Llista ordenada de tots els articles<td><code>Articles a la sèrie: $SERIES_PAGES_OLIST</code><td>Articles a la sèrie: <ol><li>Article actual<li><a href=...>Altres articles</a></ol><tr><td><code>$SERIES_PAGES_ULIST</code><td>Sempre<td>HTML<td>Llista desordenada de tots els articles<td><code>Articles a la sèrie: $SERIES_PAGES_ULIST</code><td>Articles a la sèrie: <ul><li>Article actual<li><a href=...>Altres articles</a></ul></table></div><p>{{ admonition(type=“tip”, title=“CONSELL: Text personalitzat amb permalinks”, text=‘Els enllaços markdown com <code>[text]($SERIES_PERMALINK)</code> seran marcats (i <a href=https://welpo.github.io/tabi/ca/blog/mastering-tabi-settings/#indicador-d-enllacos-externs>estilitzats</a>) com externs. Si necessites text personalitzat i vols evitar l'estil extern, utilitza HTML: <code>&lt;a href=\"$SERIES_PERMALINK\">el teu text&lt;/a></code>.’) }}<h3 id=variables-de-navegacio><a aria-label="Anchor link for: variables-de-navegacio" class="header-anchor no-hover-padding" href=#variables-de-navegacio><span aria-hidden=true class=link-icon></span></a> Variables de navegació</h3><div class=full-width><table><thead><tr><th>Variable<th>Disponibilitat<th>Retorna<th>Descripció<th>Exemple d’ús<th>Exemple de sortida<tbody><tr><td><code>$PREV_TITLE</code><td>Existeix anterior<td>Text<td>Títol de l’article anterior<td><code>Anteriorment: $PREV_TITLE</code><td>Anteriorment: Configurant el teu entorn<tr><td><code>$PREV_PERMALINK</code><td>Existeix anterior<td>Text<td>URL a l’article anterior<td><code>[← Enrere]($PREV_PERMALINK)</code><td><a href=/series/learn-rust/setup>← Enrere</a><tr><td><code>$PREV_HTML_LINK</code><td>Existeix anterior<td>HTML<td>Enllaç llest per usar a l’anterior<td><code>Llegeix primer $PREV_HTML_LINK</code><td>Llegeix primer <a href=/series/learn-rust/setup>Configurant el teu entorn</a><tr><td><code>$PREV_DESCRIPTION</code><td>Existeix anterior<td>Text<td>Descripció de l’article anterior<td><code>Resum: $PREV_DESCRIPTION</code><td>Resum: Configurant Rust<tr><td><code>$NEXT_TITLE</code><td>Existeix següent<td>Text<td>Títol del següent article<td><code>Següent: $NEXT_TITLE</code><td>Següent: Patrons avançats<tr><td><code>$NEXT_PERMALINK</code><td>Existeix següent<td>Text<td>URL al següent article<td><code>[Continuar →]($NEXT_PERMALINK)</code><td><a href=/series/learn-rust/patterns>Continuar →</a><tr><td><code>$NEXT_HTML_LINK</code><td>Existeix següent<td>HTML<td>Enllaç llest per usar al següent<td><code>Continua amb $NEXT_HTML_LINK</code><td>Continua amb <a href=/series/learn-rust/patterns>Patrons avançats</a><tr><td><code>$NEXT_DESCRIPTION</code><td>Existeix següent<td>Text<td>Descripció del següent article<td><code>Properament: $NEXT_DESCRIPTION</code><td>Properament: Aprèn sobre les característiques avançades de pattern matching en Rust</table></div><h3 id=referencia-al-primer-article><a aria-label="Anchor link for: referencia-al-primer-article" class="header-anchor no-hover-padding" href=#referencia-al-primer-article><span aria-hidden=true class=link-icon></span></a> Referència al primer article</h3><div class=full-width><table><thead><tr><th>Variable<th>Disponibilitat<th>Retorna<th>Descripció<th>Exemple d’ús<th>Exemple de sortida<tbody><tr><td><code>$FIRST_TITLE</code><td>Sempre<td>Text<td>Títol del primer article<td><code>Comença amb $FIRST_TITLE</code><td>Comença amb Introducció a Rust<tr><td><code>$FIRST_HTML_LINK</code><td>Sempre<td>HTML<td>Enllaç llest per usar al primer article<td><code>Comença a $FIRST_HTML_LINK</code><td>Comença a <a href=/series/learn-rust/intro>Introducció a Rust</a></table></div><h3 id=exemple-de-plantilla><a aria-label="Anchor link for: exemple-de-plantilla" class="header-anchor no-hover-padding" href=#exemple-de-plantilla><span aria-hidden=true class=link-icon></span></a> Exemple de plantilla</h3><div class="admonition tip"><div class="admonition-icon admonition-icon-tip"></div><div class=admonition-content><strong class=admonition-title>Variables HTML vs text</strong><p>Utilitza variables HTML (que acaben en <code>_HTML_LINK</code>) quan vulguis enllaços preparats per usar. Utilitza variables de text (que acaben en <code>_TITLE</code> o <code>_PERMALINK</code>) quan vulguis més control sobre el format.</div></div><pre class="language-toml z-code" data-lang=toml data-name=series/_index.md><code class=language-toml data-lang=toml data-name=series/_index.md><span class="z-source z-toml"><span class="z-comment z-line z-number-sign z-toml"><span class="z-punctuation z-definition z-comment z-toml">#</span> Introducció</span>
</span><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span><span class="z-punctuation z-separator z-table z-toml">.</span><span class="z-entity z-name z-table z-toml">series_intro_templates</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">next_only</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"""</span>
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Benvingut a $SERIES_HTML_LINK! Aquesta sèrie de $SERIES_PAGES_NUMBER parts t'ensenyarà Rust des de zero.
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Següent: $NEXT_HTML_LINK - $NEXT_DESCRIPTION
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-end z-toml">"""</span></span>
</span><span class="z-source z-toml">
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">middle</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"""</span>
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">📚 Part $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER a $SERIES_HTML_LINK
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Anterior: $PREV_HTML_LINK
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Següent: $NEXT_HTML_LINK
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-end z-toml">"""</span></span>
</span><span class="z-source z-toml">
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">prev_only</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"""</span>
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Benvingut a l'última part de $SERIES_HTML_LINK!
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Ets nou? Comença amb $FIRST_HTML_LINK per construir una base sòlida.
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Anterior: $PREV_HTML_LINK
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-end z-toml">"""</span></span>
</span><span class="z-source z-toml">
</span><span class="z-source z-toml"><span class="z-comment z-line z-number-sign z-toml"><span class="z-punctuation z-definition z-comment z-toml">#</span> Plantilla de respatller</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">default</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>Aquest article és part de la sèrie $SERIES_HTML_LINK.<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span><span class="z-source z-toml">
</span><span class="z-source z-toml"><span class="z-comment z-line z-number-sign z-toml"><span class="z-punctuation z-definition z-comment z-toml">#</span> Conclusió</span>
</span><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span><span class="z-punctuation z-separator z-table z-toml">.</span><span class="z-entity z-name z-table z-toml">series_outro_templates</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">next_only</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"""</span>
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Gràcies per llegir! 🙌
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Continua el teu viatge amb $NEXT_HTML_LINK, on $NEXT_DESCRIPTION
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">O revisa l'esquema complet de la sèrie [$SERIES_TITLE]($SERIES_PERMALINK).
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-end z-toml">"""</span></span>
</span><span class="z-source z-toml">
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">middle</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"""</span>
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">---
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">📝 Navegació de la sèrie
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">- Anterior: $PREV_HTML_LINK
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">- Següent: $NEXT_HTML_LINK
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">- [Resum de la sèrie]($SERIES_PERMALINK)
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-end z-toml">"""</span></span>
</span><span class="z-source z-toml">
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">prev_only</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"""</span>
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">🎉 Felicitats! Has completat $SERIES_HTML_LINK.
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Vols repassar? Aquí vam començar: $FIRST_HTML_LINK
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">O revisa el que acabem de veure a $PREV_HTML_LINK.
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-end z-toml">"""</span></span>
</span><span class="z-source z-toml">
</span><span class="z-source z-toml"><span class="z-comment z-line z-number-sign z-toml"><span class="z-punctuation z-definition z-comment z-toml">#</span> Respatller.</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">default</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"""</span>
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">---
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Aquest article és la part $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER a $SERIES_HTML_LINK.
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-end z-toml">"""</span></span>
</span></code></pre><h3 id=variables-personalitzades><a aria-label="Anchor link for: variables-personalitzades" class="header-anchor no-hover-padding" href=#variables-personalitzades><span aria-hidden=true class=link-icon></span></a> Variables personalitzades</h3><p>Les plantilles de sèries admeten variables personalitzades per incloure informació addicional a tota la teva sèrie. El procés té dos passos:<ol><li>Primer, defineix els teus <strong>marcadors</strong> a la configuració de la teva sèrie (<code>_index.md</code>):</ol><pre class="language-toml z-code" data-lang=toml data-name=series/_index.md><code class=language-toml data-lang=toml data-name=series/_index.md><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">series</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-constant z-language z-toml">true</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">series_template_placeholders</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-punctuation z-definition z-array z-begin z-toml">[</span><span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>$POSITION<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span><span class="z-punctuation z-separator z-array z-toml">,</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>$TOPIC<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span><span class="z-punctuation z-separator z-array z-toml">,</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>$DIFFICULTY<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span><span class="z-punctuation z-definition z-array z-end z-toml">]</span>
</span></code></pre><ol start=2><li>Després, a cada article de la sèrie, proporciona els valors per a aquests marcadors a <code>series_template_variables</code>:</ol><pre class="language-toml z-code" data-lang=toml data-name=series/article.md><code class=language-toml data-lang=toml data-name=series/article.md><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span><span class="z-punctuation z-separator z-table z-toml">.</span><span class="z-entity z-name z-table z-toml">series_template_variables</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">position</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>primer<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">topic</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>Variables i tipus<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">difficulty</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>Principiant<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span></code></pre><h3 id=us-de-variables-personalitzades><a aria-label="Anchor link for: us-de-variables-personalitzades" class="header-anchor no-hover-padding" href=#us-de-variables-personalitzades><span aria-hidden=true class=link-icon></span></a> Ús de variables personalitzades</h3><p>Pots usar les teves variables personalitzades a qualsevol plantilla, juntament amb les variables integrades:<pre class="language-toml z-code" data-lang=toml data-name=series/_index.md><code class=language-toml data-lang=toml data-name=series/_index.md><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span><span class="z-punctuation z-separator z-table z-toml">.</span><span class="z-entity z-name z-table z-toml">series_intro_templates</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">default</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"""</span>
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Aquest és l'article $POSITION a $SERIES_HTML_LINK.
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Tema d'avui: $TOPIC
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">Nivell de dificultat: $DIFFICULTY
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-end z-toml">"""</span></span>
</span></code></pre><div class="admonition warning"><div class="admonition-icon admonition-icon-warning"></div><div class=admonition-content><strong class=admonition-title>WARNING</strong><p>Encara que els marcadors es defineixen en majúscules (<code>$POSITION</code>), els noms de variables a <code>series_template_variables</code> han d’estar en minúscules (<code>position</code>).</div></div><h3 id=exemple-amb-variables-personalitzades><a aria-label="Anchor link for: exemple-amb-variables-personalitzades" class="header-anchor no-hover-padding" href=#exemple-amb-variables-personalitzades><span aria-hidden=true class=link-icon></span></a> Exemple amb variables personalitzades</h3><pre class="language-toml z-code" data-lang=toml data-name=series/_index.md><code class=language-toml data-lang=toml data-name=series/_index.md><span class="z-source z-toml"><span class="z-comment z-line z-number-sign z-toml"><span class="z-punctuation z-definition z-comment z-toml">#</span> A la configuració de la sèrie.</span>
</span><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">series</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-constant z-language z-toml">true</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">series_template_placeholders</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-punctuation z-definition z-array z-begin z-toml">[</span><span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>$LEARNING_TIME<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span><span class="z-punctuation z-separator z-array z-toml">,</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>$KEY_CONCEPTS<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span><span class="z-punctuation z-definition z-array z-end z-toml">]</span>
</span><span class="z-source z-toml">
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">series_intro_templates</span><span class="z-punctuation z-separator z-key z-toml">.</span><span class="z-entity z-name z-tag z-toml">default</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"""</span>
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">📚 Part $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">⏱️ Temps estimat: $LEARNING_TIME
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml">🔑 Conceptes clau: $KEY_CONCEPTS
</span></span><span class="z-source z-toml"><span class="z-string z-quoted z-triple z-basic z-block z-toml"><span class="z-punctuation z-definition z-string z-end z-toml">"""</span></span>
</span></code></pre><pre class="language-toml z-code" data-lang=toml data-name=series/02-learning-rust/index.md><code class=language-toml data-lang=toml data-name=series/02-learning-rust/index.md><span class="z-source z-toml"><span class="z-comment z-line z-number-sign z-toml"><span class="z-punctuation z-definition z-comment z-toml">#</span> En un article de la sèrie.</span>
</span><span class="z-source z-toml"><span class="z-punctuation z-definition z-table z-begin z-toml">[</span><span class="z-meta z-tag z-table z-toml"><span class="z-entity z-name z-table z-toml">extra</span><span class="z-punctuation z-separator z-table z-toml">.</span><span class="z-entity z-name z-table z-toml">series_template_variables</span></span><span class="z-punctuation z-definition z-table z-end z-toml">]</span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">learning_time</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>30 minuts<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span><span class="z-source z-toml"><span class="z-meta z-tag z-key z-toml"><span class="z-entity z-name z-tag z-toml">key_concepts</span></span> <span class="z-punctuation z-definition z-key-value z-toml">=</span> <span class="z-string z-quoted z-double z-basic z-toml"><span class="z-punctuation z-definition z-string z-begin z-toml">"</span>Funcions, gestió d'errors, coincidència de patrons<span class="z-punctuation z-definition z-string z-end z-toml">"</span></span>
</span></code></pre><p>Això generarà:<pre class="language-txt z-code" data-lang=txt><code class=language-txt data-lang=txt><span class="z-text z-plain">📚 Part 2 de 5
</span><span class="z-text z-plain">⏱️ Temps estimat: 30 minuts
</span><span class="z-text z-plain">🔑 Conceptes clau: Funcions, gestió d'errors, coincidència de patrons
</span></code></pre><div class="admonition warning"><div class="admonition-icon admonition-icon-warning"></div><div class=admonition-content><strong class=admonition-title>Variables que falten</strong><p>Si uses un marcador a les teves plantilles però no proporciones el seu valor a <code>series_template_variables</code>, la compilació fallarà amb un error que llista les variables que falten.</div></div></section><form action="https://vhiweeypifbwacashxjz.supabase.co/rest/v1/rpc/increment_hits?apikey=sb_publishable_EoB7MFJhCmb6PiAk-GPJ4w_PGhQ44Ru" class=iine-form method=post><input name=page_slug type=hidden value=/blog/series/><button aria-label="M'agrada aquesta publicació" title="M'agrada aquesta publicació" class=iine-button data-icon=thumbs_up data-slug=/blog/series/>👍</button></form><nav class="full-width article-navigation"><div></div><div><a aria-describedby=right_title aria-label=Anterior href=https://welpo.github.io/tabi/ca/blog/mastering-tabi-settings/>Anterior <span class=arrow>→</span></a><p aria-hidden=true id=right_title>Domina la configuració de tabi: guia completa</div></nav></article></main><div id=button-container><div id=toc-floating-container><input class=toggle id=toc-toggle type=checkbox><label class=overlay for=toc-toggle></label><label title="Mostrar/ocultar la taula de continguts" class=button for=toc-toggle id=toc-button><svg viewbox="0 -960 960 960" xmlns=http://www.w3.org/2000/svg><path d="M414.82-193.094q-18.044 0-30.497-12.32-12.453-12.319-12.453-30.036t12.453-30.086q12.453-12.37 30.497-12.37h392.767q17.237 0 29.927 12.487 12.69 12.486 12.69 30.203 0 17.716-12.69 29.919t-29.927 12.203H414.82Zm0-244.833q-18.044 0-30.497-12.487Q371.87-462.9 371.87-480.45t12.453-29.92q12.453-12.369 30.497-12.369h392.767q17.237 0 29.927 12.511 12.69 12.512 12.69 29.845 0 17.716-12.69 30.086-12.69 12.37-29.927 12.37H414.82Zm0-245.167q-18.044 0-30.497-12.32t-12.453-30.037q0-17.716 12.453-30.086 12.453-12.369 30.497-12.369h392.767q17.237 0 29.927 12.486 12.69 12.487 12.69 30.203 0 17.717-12.69 29.92-12.69 12.203-29.927 12.203H414.82ZM189.379-156.681q-32.652 0-55.878-22.829t-23.226-55.731q0-32.549 23.15-55.647 23.151-23.097 55.95-23.097 32.799 0 55.313 23.484 22.515 23.484 22.515 56.246 0 32.212-22.861 54.893-22.861 22.681-54.963 22.681Zm0-245.167q-32.652 0-55.878-23.134-23.226-23.135-23.226-55.623 0-32.487 23.467-55.517t56.12-23.03q32.102 0 54.721 23.288 22.62 23.288 22.62 55.775 0 32.488-22.861 55.364-22.861 22.877-54.963 22.877Zm-.82-244.833q-32.224 0-55.254-23.288-23.03-23.289-23.03-55.623 0-32.333 23.271-55.364 23.272-23.03 55.495-23.03 32.224 0 55.193 23.288 22.969 23.289 22.969 55.622 0 32.334-23.21 55.364-23.21 23.031-55.434 23.031Z"/></svg></label><div class=toc-content><div class=toc-container><ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#inici-rapid>Inici ràpid</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#com-funcionen-les-series>Com funcionen les sèries?</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#saltar-a-les-publicacions>Saltar a les publicacions</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#pagines-de-series-i-ordre>Pàgines de sèries i ordre</a> <ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#opcions-d-ordre>Opcions d’ordre</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#indexacio-de-pagines>Indexació de pàgines</a></ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#plantilles-d-introduccio-i-conclusio>Plantilles d’introducció i conclusió</a> <ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#tipus-de-plantilles>Tipus de plantilles</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#ubicacio-al-contingut>Ubicació al contingut</a></ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#variables>Variables</a> <ul><li><a href=https://welpo.github.io/tabi/ca/blog/series/#variables-basiques-de-serie>Variables bàsiques de sèrie</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#variables-de-navegacio>Variables de navegació</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#referencia-al-primer-article>Referència al primer article</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#exemple-de-plantilla>Exemple de plantilla</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#variables-personalitzades>Variables personalitzades</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#us-de-variables-personalitzades>Ús de variables personalitzades</a><li><a href=https://welpo.github.io/tabi/ca/blog/series/#exemple-amb-variables-personalitzades>Exemple amb variables personalitzades</a></ul></ul></div></div></div><a title="Vés a l'inici de la pàgina" class=no-hover-padding href=# id=top-button> <svg viewbox="0 0 20 20" fill=currentColor><path d="M3.293 9.707a1 1 0 010-1.414l6-6a1 1 0 011.414 0l6 6a1 1 0 01-1.414 1.414L11 5.414V17a1 1 0 11-2 0V5.414L4.707 9.707a1 1 0 01-1.414 0z"/></svg> </a></div><script defer src=https://welpo.github.io/tabi/js/mermaid.min.js></script><span class=hidden id=copy-success> Copiat! </span><span class=hidden id=copy-init> Copia el codi al porta-retalls </span><script defer src=https://welpo.github.io/tabi/js/copyCodeToClipboard.min.js></script><script defer src=https://cdn.jsdelivr.net/gh/welpo/iine@main/iine.mini.js></script></div><footer><section><nav class="socials nav-navs"><ul><li><a class="nav-links no-hover-padding social" href=https://welpo.github.io/tabi/ca/atom.xml> <img alt=feed loading=lazy src=https://welpo.github.io/tabi/social_icons/rss.svg title=feed> </a><li class=js><a class="nav-links no-hover-padding social" data-encoded-email=dGFiaUBvc2MuZ2FyZGVu href=#><img alt=email loading=lazy src=https://welpo.github.io/tabi/social_icons/email.svg title=email> </a><li><a class="nav-links no-hover-padding social" rel=" me" href=https://github.com/welpo/> <img alt=github loading=lazy src=https://welpo.github.io/tabi/social_icons/github.svg title=github> </a><li><a class="nav-links no-hover-padding social" rel=" me" href=https://soundcloud.com/oskerwyld> <img alt=soundcloud loading=lazy src=https://welpo.github.io/tabi/social_icons/soundcloud.svg title=soundcloud> </a><li><a class="nav-links no-hover-padding social" rel=" me" href=https://instagram.com/oskerwyld> <img alt=instagram loading=lazy src=https://welpo.github.io/tabi/social_icons/instagram.svg title=instagram> </a><li><a class="nav-links no-hover-padding social" rel=" me" href=https://youtube.com/@oskerwyld> <img alt=youtube loading=lazy src=https://welpo.github.io/tabi/social_icons/youtube.svg title=youtube> </a><li><a class="nav-links no-hover-padding social" rel=" me" href=https://open.spotify.com/artist/5Hv2bYBhMp1lUHFri06xkE> <img alt=spotify loading=lazy src=https://welpo.github.io/tabi/social_icons/spotify.svg title=spotify> </a></ul></nav><nav class=nav-navs><small> <ul><li><a class="nav-links no-hover-padding" href=https://welpo.github.io/tabi/ca/about/> sobre mi </a><li><a class="nav-links no-hover-padding" href=https://welpo.github.io/tabi/ca/privacy/> política de privadesa </a><li><a class="nav-links no-hover-padding" href=https://tabi-stats.osc.garden/> estadístiques del lloc </a><li><a class="nav-links no-hover-padding" href=https://welpo.github.io/tabi/sitemap.xml> mapa del lloc </a></ul> </small></nav><div class=credits><small> Propulsat per <a href=https://www.getzola.org>Zola</a> i <a href=https://github.com/welpo/tabi>tabi</a> • <a href=https://github.com/welpo/tabi> Codi del lloc </a></small></div></section><script async src=https://welpo.github.io/tabi/js/decodeMail.min.js></script></footer>
Reference in a new issue View git blame Copy permalink