id.sifa.profile.presentation

sifa.id

Documentation

Record representing a single reusable presentation (the content), distinct from the occasions on which it is delivered.

main record

Record representing a single reusable presentation (the content), distinct from the occasions on which it is delivered.

Record Key tid Timestamp-based ID

Properties

coverImage blob Optional

Optional cover image for the presentation. Rendered as the talk-page hero and OpenGraph image. Max 2 MB, PNG, JPEG, or WebP.

maxSize: 2.0 MB
createdAt string datetime Required

Client-declared timestamp when this record was originally created.

description string Optional

Description or abstract of the presentation.

maxLength: 50000 bytesmaxGraphemes: 5000 graphemes
duration ref #duration Optional

Typical length of the presentation, a fixed value or a range, in minutes.

intendedAudiences array of string Optional

Intended audiences for this presentation, open text (e.g. 'Engineering leaders', 'Beginners').

maxLength: 20 items
title string Required

Title of the presentation.

maxLength: 3000 bytesminLength: 1 bytesmaxGraphemes: 300 graphemes
writeupRef ref id.sifa.defs#externalRecordRef Optional

Optional reference to a long-form write-up of this presentation (a pub.leaflet.document or site.standard.document holding video, transcript, or article).

View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "title",
      "createdAt"
    ],
    "properties": {
      "links": {
        "type": "array",
        "items": {
          "ref": "id.sifa.defs#presentationLink",
          "type": "ref"
        },
        "maxLength": 20,
        "description": "Canonical links for this content, such as slides or a recording."
      },
      "title": {
        "type": "string",
        "maxLength": 3000,
        "minLength": 1,
        "description": "Title of the presentation.",
        "maxGraphemes": 300,
        "x-skos:exactMatch": [
          "dcterms:title",
          "schema:name"
        ]
      },
      "duration": {
        "ref": "#duration",
        "type": "ref",
        "description": "Typical length of the presentation, a fixed value or a range, in minutes.",
        "x-skos:note": "The lexicon models a range; schema:timeRequired is a single ISO 8601 duration.",
        "x-skos:narrowMatch": [
          "schema:timeRequired"
        ]
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Client-declared timestamp when this record was originally created."
      },
      "coverImage": {
        "type": "blob",
        "accept": [
          "image/png",
          "image/jpeg",
          "image/webp"
        ],
        "maxSize": 2000000,
        "description": "Optional cover image for the presentation. Rendered as the talk-page hero and OpenGraph image. Max 2 MB, PNG, JPEG, or WebP.",
        "x-skos:exactMatch": [
          "schema:image",
          "foaf:depiction"
        ]
      },
      "writeupRef": {
        "ref": "id.sifa.defs#externalRecordRef",
        "type": "ref",
        "description": "Optional reference to a long-form write-up of this presentation (a pub.leaflet.document or site.standard.document holding video, transcript, or article).",
        "x-skos:closeMatch": [
          "dcterms:isReferencedBy",
          "schema:subjectOf"
        ]
      },
      "description": {
        "type": "string",
        "maxLength": 50000,
        "description": "Description or abstract of the presentation.",
        "maxGraphemes": 5000,
        "x-skos:exactMatch": [
          "bibo:abstract",
          "schema:abstract"
        ]
      },
      "intendedAudiences": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 1000,
          "maxGraphemes": 100
        },
        "maxLength": 20,
        "description": "Intended audiences for this presentation, open text (e.g. 'Engineering leaders', 'Beginners').",
        "x-skos:closeMatch": [
          "schema:audience"
        ]
      }
    }
  },
  "description": "Record representing a single reusable presentation (the content), distinct from the occasions on which it is delivered.",
  "x-skos:note": "Neither term carries the \"reusable, deliverable more than once\" semantics of the Sifa record.",
  "x-skos:closeMatch": [
    "bibo:Slideshow",
    "schema:PresentationDigitalDocument"
  ]
}
duration object

A presentation length in minutes: a fixed value (minMinutes only) or a range (minMinutes to maxMinutes).

Properties

maxMinutes integer Optional

Upper bound in minutes when the length is offered as a range. Omit for a fixed length.

minimum: 1
minMinutes integer Required

Length in minutes, or the lower bound when the length is offered as a range.

minimum: 1
View raw schema 
{
  "type": "object",
  "required": [
    "minMinutes"
  ],
  "properties": {
    "maxMinutes": {
      "type": "integer",
      "minimum": 1,
      "description": "Upper bound in minutes when the length is offered as a range. Omit for a fixed length."
    },
    "minMinutes": {
      "type": "integer",
      "minimum": 1,
      "description": "Length in minutes, or the lower bound when the length is offered as a range."
    }
  },
  "description": "A presentation length in minutes: a fixed value (minMinutes only) or a range (minMinutes to maxMinutes)."
}

Lexicon Garden

@