Write your content here in Markdown. Update title, summary, category, subcategory, tags, and date as needed. This template helps keep sorting and grouping consistent.

Adding external images

Simple Markdown:

![Alt text describing the image](https://example.com/path/to/image.jpg)

Figure with caption and lazy load:

<figure>
  <img src="https://example.com/path/to/image.jpg"
       alt="Alt text describing the image"
       loading="lazy"
       style="max-width: 720px; width: 100%; height: auto; border-radius: 10px;" />
  <figcaption>Optional caption here.</figcaption>
</figure>

Using the include (create _includes/external-image.html if you haven’t yet):

{% include external-image.html
   src="https://example.com/path/to/image.jpg"
   alt="Alt text"
   max="800px"
   caption="Optional caption" %}

Liquid basics (Jekyll templating)

  • Output with filters: {{ variable | filter: 'arg' }} (common: default, escape, slugify, relative_url, date: "%Y-%m-%d", strip_html, truncate: 120, join: ', ', size).
  • Assign/capture: {% assign latest = site.wiki | sort: 'date' | last %}; {% capture note %}multi-line text{% endcapture %}.
  • Conditionals: {% if page.category == 'cisco' %}...{% elsif page.tags contains 'linux' %}...{% else %}...{% endif %}; {% unless condition %}; {% case var %}{% when 'a' %}...{% endcase %}.
  • Loops: {% for post in site.posts limit:6 %}...{% endfor %}; forloop.first/last/index/length; {% break %} {% continue %}.
  • Collections helpers: | where: "category", "cisco", | where_exp: "p", "p.tags contains 'linux'", | group_by: "subcategory", | group_by_exp: "p", "p.category | default: 'General'", | sort: "date" | reverse, | uniq.
  • Includes: {% include external-image.html src="..." alt="..." max="800px" caption="..." %}; inside includes, access params via include.var.

Quick page/post checklist

  • Front matter (wiki): title, summary, category, subcategory, tags, date, layout: wiki.
  • Optional front matter: parent: slug (reference only), hide_in_index: true (omit child pages from /wiki/), permalink: /wiki/parent/child/ for nested URLs.
  • Front matter (blog): title, date, tags, optional categories, layout: post.
  • Internal link: [text](/wiki/slug/) or [text]() inside loops.
  • Images: ![alt](https://...) or {% include external-image.html src="https://..." alt="..." max="800px" caption="..." %}.
  • Code: fenced blocks like ruby …; tables and blockquotes work via Markdown.
  • Sorting: date drives ordering (newest first); set date: in front matter.
  • Tags: tags: [tag1, tag2] show as pills and on /tags/.