Differences

This shows you the differences between two versions of the page.

--- misc:zola_tips [2022/12/24 19:16] – [Sections and _index.md] mithat
+++ misc:zola_tips [2022/12/25 22:57] (current) – [Sections and _index.md] mithat
@@ Line 16: / Line 16: @@
 <WRAP center info 80%>
-This whole setup seems like it's more complicated than it needs to be.
+This scheme seems like it's more complicated than it needs to be.
 </WRAP>
 When you create a folder for organizing content, think of it as a **section**. A section of your website typically has an index page and a number of sub-pages. In Zola, the content for the section's index page is specified in ''_index.md''. Other pages have regular names.
-If you fail to have a ''_index.md'' file in a folder, Zola does not formally consider it a section, but the pages defined in it are still accessible.
 ''_index.md'' has special access to information about the section's sub-pages. The typical use case for this is listing blog entries. Also, ''_index.md'' files can (should? must?) specify not just the template they will use but also the (default?) template page used by sub-pages.
+You don't need to have a ''_index.md'' file in a folder (except the root---see below). If you don't, Zola does not formally consider it a section, but the pages defined in it are still accessible. You can define an ''index.md'' file in a folder if you don't need the abilities of a section.
 You can nest sections.
@@ Line 48: / Line 48: @@
   {% endif %}
 </title>
+</code>
+**Better yet**, use the following idiom to set ''current'' to the current context, either ''section'' or ''page'':
+<code twig>
+{% set current = section | default(value=page) %}
+{{ current.title }}
 </code>
 It looks like the root ''_index.md'' file can use a template named something other than ''index.html''. Similarly, it looks like non-root ''_index.md'' files can use templates named ''index.html''.
+===== Custom front matter variables =====
+Custom front matter variables are placed in the ''[extra]'' array:
+<code toml>
+[extra]
+image = "assets/img/12AT7-lum.jpg"
+</code>
+In templates, you can access elements using dot notation:
+<code twig>
+{{ section.extra.image }}
+</code>
+===== Kludging content segments =====
+Many CMSes and some SSGs let you define segments of content that are rendered into named portions in a template.
+<code>
+---
+title: Home
+---
+---heading---
+Custom made noise
+=================
+---lead---
+I build what fashionable people call boutique amplifiers.
+---body---
+Professionally crafted. With heaps of love and soul. [Take a look.]({{pcurl('products')}})
+</code>
+It doesn't look like Zola lets you do this. However, you can kludge this using front matter.
+<code>
++++
+...
+[extra]
+heading = "# Custom made noise"
+lead = "I build what fashionable people call _boutique amplifiers_."
++++
+Professionally crafted with heaps of love and soul. [Take a look.](/products)
+</code>
+And in the template:
+<code twig>
+{{ section.extra.heading | markdown(inline=true) | safe }}
+<div class="lead">
+  {{ section.extra.lead | markdown | safe }}
+</div>
+{{ section.content | safe }}
+{{ section.extra.image }}
+</code>
 ===== Marking a menu item as active =====
+There may be a better way to do this, but selectively adding a class if the relative path matches seems to work.
+<code twig>
+<ul class="nav navbar-nav navbar-right">
+  {# for each of the menu entries, if the relative path leads matches the page, add class="active" #}
+  {% set current = section | default(value=page) %}
+  {% set rpath = current.relative_path %}
+  <li {% if rpath == "_index.md" %} class="active"{% endif %}><a href="/">Home</a></li>
+  <li class="dropdown">
+  <a href="#" class="dropdown-toggle" data-toggle="dropdown">Products <span class="caret"></span></a>
+  <ul class="dropdown-menu" role="menu">
+    <li {% if rpath == "products/_index.md" %} class="active"{% endif %}><a href="/products">Overview</a></li>
+    <li {% if rpath == "products/upcycled.md" %} class="active"{% endif %}><a href="/products/upcycled">Upcycled amps</a></li>
+    <li {% if rpath == "products/classic.md" %} class="active"{% endif %}><a href="/products/classic">Classic amps</a></li>
+  </ul>
+  </li>
+  <li {% if rpath == "about.md" %} class="active"{% endif %}><a href="/about">About</a></li>
+  <li {% if rpath == "contact.md" %} class="active"{% endif %}><a href="/contact">Contact</a></li>
+</ul>
+</code>
+No doubt, there are opportunities to stuff some of this into macros and/or partials and/or similar.
 ===== Breadcrumbs =====
+See this [[https://zola.discourse.group/t/breadcrumb/509/3|forum post]], reproduced and re-formatted here in case it goes away:
+<code twig>
+{% block breadcrumb %}
+<div class="breadcrumb-container">
+  <a class="breadcrumb-path" href="/">Home</a>
+  {% set current = section | default(value=page) %}
+  {% for ancestor in current.ancestors %}
+    {% if loop.first %}
+      {% continue %}
+    {% endif %}
+    <span class="breadcrumb-separator">/</span>
+    {% set section = get_section(path=ancestor) %}
+    <a class="breadcrumb-path" href="{{ section.permalink }}">{{ section.title }}</a>
+  {% endfor %}
+  <span class="breadcrumb-separator">/</span>
+  <a class="breadcrumb-path active" href="{{ current.permalink }}">{{ current.title }}</a>
+</div>
+{% endblock breadcrumb %}
+</code>