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
isPrimary boolean Optional

Whether this is the user's primary talk, surfaced in profile Highlights. Only reusable talks (not one-off sessions) may be primary.

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 
{
  "description": "Record representing a single reusable presentation (the content), distinct from the occasions on which it is delivered.",
  "key": "tid",
  "record": {
    "properties": {
      "coverImage": {
        "accept": [
          "image/png",
          "image/jpeg",
          "image/webp"
        ],
        "description": "Optional cover image for the presentation. Rendered as the talk-page hero and OpenGraph image. Max 2 MB, PNG, JPEG, or WebP.",
        "maxSize": 2000000,
        "type": "blob",
        "x-skos:exactMatch": [
          "schema:image",
          "foaf:depiction"
        ]
      },
      "createdAt": {
        "description": "Client-declared timestamp when this record was originally created.",
        "format": "datetime",
        "type": "string"
      },
      "description": {
        "description": "Description or abstract of the presentation.",
        "maxGraphemes": 5000,
        "maxLength": 50000,
        "type": "string",
        "x-skos:exactMatch": [
          "bibo:abstract",
          "schema:abstract"
        ]
      },
      "duration": {
        "description": "Typical length of the presentation, a fixed value or a range, in minutes.",
        "ref": "#duration",
        "type": "ref",
        "x-skos:narrowMatch": [
          "schema:timeRequired"
        ],
        "x-skos:note": "The lexicon models a range; schema:timeRequired is a single ISO 8601 duration."
      },
      "intendedAudiences": {
        "description": "Intended audiences for this presentation, open text (e.g. 'Engineering leaders', 'Beginners').",
        "items": {
          "maxGraphemes": 100,
          "maxLength": 1000,
          "type": "string"
        },
        "maxLength": 20,
        "type": "array",
        "x-skos:closeMatch": [
          "schema:audience"
        ]
      },
      "isPrimary": {
        "description": "Whether this is the user's primary talk, surfaced in profile Highlights. Only reusable talks (not one-off sessions) may be primary.",
        "type": "boolean"
      },
      "links": {
        "description": "Canonical links for this content, such as slides or a recording.",
        "items": {
          "ref": "id.sifa.defs#presentationLink",
          "type": "ref"
        },
        "maxLength": 20,
        "type": "array"
      },
      "title": {
        "description": "Title of the presentation.",
        "maxGraphemes": 300,
        "maxLength": 3000,
        "minLength": 1,
        "type": "string",
        "x-skos:exactMatch": [
          "dcterms:title",
          "schema:name"
        ]
      },
      "writeupRef": {
        "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).",
        "ref": "id.sifa.defs#externalRecordRef",
        "type": "ref",
        "x-skos:closeMatch": [
          "dcterms:isReferencedBy",
          "schema:subjectOf"
        ]
      }
    },
    "required": [
      "title",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record",
  "x-skos:closeMatch": [
    "bibo:Slideshow",
    "schema:PresentationDigitalDocument"
  ],
  "x-skos:note": "Neither term carries the \"reusable, deliverable more than once\" semantics of the Sifa record."
}
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 
{
  "description": "A presentation length in minutes: a fixed value (minMinutes only) or a range (minMinutes to maxMinutes).",
  "properties": {
    "maxMinutes": {
      "description": "Upper bound in minutes when the length is offered as a range. Omit for a fixed length.",
      "minimum": 1,
      "type": "integer"
    },
    "minMinutes": {
      "description": "Length in minutes, or the lower bound when the length is offered as a range.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "minMinutes"
  ],
  "type": "object"
}

Lexicon Garden

@