Parish Archive

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.

Play with 4 teams and a soft ball. Explain one rule at a time. 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"]
--
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-tabs with :::block-tab inside.

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>