Schemas / Story (semantic copy)

rig.story.flow

v0.31.0 · draft 1 field 1 required

Fields

FieldTypeMeaning
blocks array<entity> required Ordered rig.story.paragraph and/or rig.story.table entities

Editorial story - an ordered sequence of copy blocks. Format when present.

Paragraphs and tables in document order. It is not rig.media.text (a positioned canvas run with a face and size). Font, leading, and colour stay off this schema - a host maps named styles at emit time.

Compose rig.meta.named for the story title. Thread the flow through rig.layout.frame entities with rig.layout.frame_chain. Do not parent the flow to a page when frames exist - that is one box per page, not a layout. A snippet has no page.

Do not also list nested table-cell paragraphs here - those live on the cell blocks array. Sibling order is this array, not spatial.relationship.order.

Snippet headers and optical-margin preferences are fulfillment.

JSON Schema

Resolves at https://rig.works/schemas/rig.story.flow.schema.jsonraw file.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://rig.works/schemas/rig.story.flow.schema.json",
  "title": "rig.story.flow",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "blocks": {
      "type": "array",
      "items": {
        "$ref": "./_defs.schema.json#/$defs/entity"
      }
    }
  },
  "required": [
    "blocks"
  ]
}

Seen in

story-flow.json · story-frames.json