makr.dk

Type: Gallery

Changes to how this Type behaves are requested through a GitHub Issue and implemented, together with this reference page, through the repository's normal workflow. See /_docs/posts for how Post Types and Content Types work in general, and docs/Internal/type-doc-templates.md for the Post Type Doc template this file follows.

Any number of images, videos, and audio clips presented together as one matrix.

Schema

Slots:
- images : image | optional | repeatable
- videos : video | optional | repeatable
- audios : audio | optional | repeatable
- intro  : text  | optional | single

images/videos/audios above are wildcard slots (same "any role of this kind" meaning as Article's own images/videos/audios rows — see /_docs/posts) — every Image, Video, and Audio Content Element the Post holds appears in the matrix regardless of its role. There is no special gallery role: an admin can tag Media elements with whatever role fits (or leave the default), and Rank alone controls their position in the matrix.

Content placement (Full rendering)

Every Image/Video/Audio Content Element the resolved Version holds is the Gallery's own primary matrix content — there is no "Additional Information" grouping for Gallery at all (a deliberate departure from every other Post Type, which does render a shared Additional Information section). A Link, Contact, Geospatial, Timeline, or Attachment the Post also holds is still stored and still reachable through the Post's own Metadata page, but is not shown anywhere on the Gallery's public page.

Rendering contracts

Summary (in a list of posts)

A small preview grid of a few Image/Video thumbnails (Rank order; Audio contributes no thumbnail here, same as an Image/Video not yet ready) plus the total item count across all three kinds, and the title.

Full (its own page)

  • The normal compact Post header (title, Published/Updated/Original/History line, Tags).
  • Directly below the header, an S / M / L thumbnail-size control — a plain dropdown, not Post data, remembered only for this browser (see "Thumbnail size control" below).
  • The optional intro Text/Markdown element, rendered once, above the matrix, if present.
  • The matrix itself: every eligible Image/Video/Audio, in Rank order (then stable Version order for a tied Rank) — images, videos, and audio clips interleaved by Rank, not grouped by kind. Each tile reuses that kind's already-established thumbnail/icon representation (an Image's own thumbnail with its existing fullscreen viewer; a Video's poster with its play-affordance badge; a generic Audio icon) — selecting a tile opens that element's own existing behavior (Image: in-page fullscreen viewer; Video/Audio: that element's own Metadata/Info page). Every tile — Image, Video, and Audio alike — also exposes a small "i" information control on pointer hover, keyboard focus, and permanently on touch devices, opening that element's own Metadata/Info page (Video/Audio's tile follows the same pattern Image's tile does). Description, Author/byline, and Via-link are never shown beneath a tile — only a hover/focus accessible name (the element's own Description, when set, else a generic kind label).

Thumbnail size control

S/M/L changes the matrix's responsive column density only — never element order, crop source, metadata, or the underlying Post. The choice may be remembered for the current browser (a plain client-side preference, not sent to the server, not part of the Post or Version). Without JavaScript, or in a print/PDF snapshot, the matrix always renders at the M density with the control itself hidden, since neither context has a way to change it interactively.

Page regions (Full rendering)

  • Header — the Hidden/PrePub/Private banner (if applicable), the title, the compact Published/Updated/Original/History metadata line (see /_docs/article's own "Metadata line" for the full item-by-item detail), and a row of Tag links (if the Version has any — see /_docs/categories's "Tags"). The S/M/L control sits directly below this region, in the same placement a Category's own List/Map control uses.
  • Introduction — the intro text, if present.
  • Main — the media matrix itself.
  • Supplementary, Footer — not currently used by Gallery (its matrix rendering replaced a former Additional Information section that used to occupy Supplementary).

Responsive order: Header, Introduction, Main — unchanged across viewport sizes (Gallery has no reading-column primary presentation).

Public metadata exposure

Title, the intro text, every Image/Video/Audio element's own metadata (caption, etc. — see /_docs/content-image, /_docs/content-video, /_docs/content-audio), Stage, published/updated timestamps, Tags (as JSON-LD keywords) — via the Metadata page and JSON-LD export, same as every Type. A Link/Contact/Geospatial/Timeline/Attachment the Post holds is likewise still exposed through the Metadata page even though it has no public-page presentation of its own (see "Content placement" above).

Admin editor

Every Content Element section is available here, same as every Type. Any Image, Video, or Audio row you add — under any role — appears in the matrix, in Rank order. intro is the optional presentation text shown above it. Anything else you add (a Link, Contact, Geospatial, Timeline, Attachment, or additional Text) is still saved, but Gallery has no Additional Information section to show it in — it remains reachable only via the Post's own Metadata page.

View raw markdown