Cards and navigation
Cards with links, tabs, automatic page lists and one page inside another
Cards
A grid of cards, each one a link to a page or a website. Every card can have a title, a description, an icon, a picture, a color and some tags. Icons come from Material Design Icons: write mdi: and the name. Colors: red, orange, amber, yellow, lime, green, teal, blue, indigo, purple, pink.
- Games — Indoor and outdoor games with rules and variants.
- Activities — Single meetings ready to use.
- Vatican News — News from the Pope and the Church.
::block-links-grid{minWidth="240px"}
```yaml
- title: Games
url: /games
description: Indoor and outdoor games with rules and variants.
icon: 'mdi:soccer'
color: green
- title: Activities
url: /activities
description: Single meetings ready to use.
icon: 'mdi:account-group-outline'
color: amber
tags:
- Catechism
- Oratory
- title: Vatican News
url: https://www.vaticannews.va
description: News from the Pope and the Church.
image: /_assets/illustrations/undraw_world.svg
```
::
[block-links-grid, minWidth="240px"]
====
[source,yaml]
----
- title: Games
url: /games
description: Indoor and outdoor games with rules and variants.
icon: 'mdi:soccer'
color: green
- title: Activities
url: /activities
description: Single meetings ready to use.
icon: 'mdi:account-group-outline'
color: amber
tags:
- Catechism
- Oratory
- title: Vatican News
url: https://www.vaticannews.va
description: News from the Pope and the Church.
image: /_assets/illustrations/undraw_world.svg
----
====
<block-links-grid minWidth="240px">
<pre><code class="language-yaml">- title: Games
url: /games
description: Indoor and outdoor games with rules and variants.
icon: 'mdi:soccer'
color: green
- title: Activities
url: /activities
description: Single meetings ready to use.
icon: 'mdi:account-group-outline'
color: amber</code></pre>
</block-links-grid>
| Option | What it does |
|---|---|
minWidth |
Narrowest a card may be, for example 240px. The grid fits as many cards per row as the screen allows |
maxWidth |
Widest a card may be. 1fr (the default) shares the space between the cards |
maxHeight |
Tallest a card may be. A picture is cropped to fit |
Tabs
Tabs put several versions side by side, for example the same game for different ages. A tab set opens with three colons and each tab with two.
:::block-tabs
::block-tab{label="Ages 6-7" icon="mdi:numeric-1-circle-outline"}
Play with 4 teams and a soft ball. Explain one rule at a time.
::
::block-tab{label="Ages 8-11" icon="mdi:numeric-2-circle-outline"}
Play with 6 teams. Add the bonus question at the end of each round.
::
:::
[block-tabs]
====
[block-tab, label="Ages 6-7", icon="mdi:numeric-1-circle-outline"]
--
Play with 4 teams and a soft ball. Explain one rule at a time.
--
[block-tab, label="Ages 8-11", icon="mdi:numeric-2-circle-outline"]
--
Play with 6 teams. Add the bonus question at the end of each round.
--
====
<block-tabs>
<block-tab label="Ages 6-7" icon="mdi:numeric-1-circle-outline">
<p>Play with 4 teams and a soft ball. Explain one rule at a time.</p>
</block-tab>
<block-tab label="Ages 8-11" icon="mdi:numeric-2-circle-outline">
<p>Play with 6 teams. Add the bonus question at the end of each round.</p>
</block-tab>
</block-tabs>
Tip
Every block closes with a line of as many colons as it opened with. To put blocks with their own tabs inside a tab, give the outer set more colons, as this page does:
::::block-tabswith:::block-tabinside.
Automatic list of pages
Lists the pages of a folder or with some tags, and updates itself when pages are added. The section pages of the archive use it.
- Boxes and quotes — Note, tip and warning boxes, quotes with an author, infobox and spoiler
- Cards and navigation — Cards with links, tabs, automatic page lists and one page inside another
- Code — Code blocks with a language, a title, line numbers and highlighted lines
- Custom HTML — Colored boxes, columns, collapsible sections, figures with a caption and icons, written in HTML
- Diagrams — Flowcharts, sequences, timelines, mind maps, Kroki, PlantUML and draw.io
- Formulas — Formulas with KaTeX and MathJax, and formulas inside a sentence
- Inline components — Badges, keyboard keys, progress bars, colors, dates and measures inside a sentence
- Links and images — Links to pages and websites, images, footnotes and the image gallery
- Lists — Bullet lists, numbered lists, checklists, definitions and steps
- Media and widgets — YouTube videos, audio and video files, PDF documents, maps, QR codes and countdowns
- Tables — Simple tables, alignment and formatting inside cells
- Text — Headings, bold, italic, highlight, small letters, abbreviations and lines
::block-index{path="writer-guides" limit="20" orderBy="title" columns="3"}
::
::block-index{tags="game,lent" limit="10" orderBy="updatedAt" orderByDirection="desc" showLastUpdated="true"}
::
[block-index, path="writer-guides", limit="20", orderBy="title", columns="3"]
====
====
<block-index path="writer-guides" limit="20" orderBy="title" columns="3"></block-index>
| Option | What it does |
|---|---|
path |
Folder to list, without the first /. Empty: the whole archive |
tags |
Only pages with all these tags, separated by commas |
limit |
Most pages to list (default 10) |
orderBy |
title, createdAt (newest pages) or updatedAt (last changed) |
orderByDirection |
asc or desc |
depth |
How many sub folders to include. 0 is the folder itself |
columns |
1, 2 or 3 |
showTags, showLastUpdated, showIcons |
true to show them |
One page inside another
Shows a whole page inside this one. Change the original and every page that includes it changes too. Good for a prayer or a rule used in many pages.
::block-include{path="guide/privacy" showTitle="true"}
::
[block-include, path="guide/privacy", showTitle="true"]
====
====
<block-include path="guide/privacy" showTitle="true"></block-include>