Enum Shortcode 

pub enum Shortcode {
    Subscribe(SubscribeShortcode),
    Buttons(ButtonsShortcode),
    Gallery(GalleryShortcode),
    Hero(HeroShortcode),
    Grid(GridShortcode),
    Recent(RecentShortcode),
    Apply(ApplyShortcode),
}

A typed shortcode block.

Variants:

• Shortcode::Subscribe — inline subscribe form (description + button)
• Shortcode::Buttons — list of action buttons with markdown links
• Shortcode::Gallery — image gallery with optional column count
• Shortcode::Hero — full-width hero section with media + overlay
• Shortcode::Grid — flexible multi-cell layout
• Shortcode::Recent — recent-posts query with fallback markdown
• Shortcode::Apply — inline apply / membership-request form

Phase B migrations add one variant per commit.

Variants

Subscribe(SubscribeShortcode)

:::subscribe — inline newsletter signup form.

Configuration is via attributes (placeholder, button); body must be empty under the unified grammar. Description text and any framing prose live in the surrounding markdown.

Buttons(ButtonsShortcode)

:::buttons {.classname} — list of action buttons.

Body is one markdown link per line ([text](url)). The first button gets the primary class; subsequent buttons get secondary. Optional {.classname} extra classes attach to the wrapping div.

URLs flow through Url::Unresolved at parse time; crate::ast::visit::visit_urls_mut (or src-tauri’s apply_typed_shortcodes) classifies them into Url::Resolved before rendering. The resolver-bypass class is closed by construction: RenderHooks::render_shortcode reads Url::Resolved, so a missing visitor is a debug-time crash.

Gallery(GalleryShortcode)

:::gallery N {.classname} — image gallery with optional columns.

N (positional integer) sets --moss-gallery-columns CSS variable. Body is one image reference per line: ![alt](path), bare path.jpg, or path|attrs for media attributes (passed through to the renderer’s inline style).

Hero(HeroShortcode)

:::hero {image=path} — full-width hero section with media + overlay.

New grammar: image attribute carries the path. Backward-compat: when image is absent, the extractor scans the first non-empty body line for a media reference (![[path]], ![alt](path), or bare media filename).

The pipeline hoists the rendered hero HTML into the article template’s hero slot — it does NOT render inline.

Grid(GridShortcode)

:::grid {cols=N} or :::grid N — flexible multi-cell layout.

Cells are split on +++ (new grammar) or --- (legacy moss-releases backward-compat — Step 3 of #613 rewrites these to +++). Each cell stores its raw markdown source; the renderer is responsible for any nested-shortcode extraction and markdown processing per cell.

Recent(RecentShortcode)

:::recent since=... last=... count=... — list of recent posts scoped to the page’s top-level folder (its scope).

Body (between the opening and closing :::) is reserved for fallback content rendered when the query returns zero matches. Empty body means no fallback (the shortcode renders nothing).

Apply(ApplyShortcode)

:::apply — inline membership/contributor application form.

Posts to the moss-seta /apply endpoint with fields email, matters, publish, scope, and website (honeypot). Configuration is via attributes (placeholder, button); body must be empty. One-of {matters, publish} is server-enforced. Succeeds terminally (no auto-revert) via data-revert="false".

Implementations

impl Shortcode

pub fn kind(&self) -> ShortcodeKind

Return the ShortcodeKind of this shortcode.

Trait Implementations

impl Clone for Shortcode

fn clone(&self) -> Shortcode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Shortcode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Shortcode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Shortcode

impl PartialEq for Shortcode

fn eq(&self, other: &Shortcode) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Shortcode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Shortcode