ing.dasl.masl

robin.berjon.com

Documentation

A tile, instantiating MASL metadata into a record

main record

A tile, instantiating MASL metadata into a record

Record Key tid Timestamp-based ID

Properties

cid string cid Required

The DRISL CID of the MASL for the tile

createdAt string datetime Required

Timestamp

View raw schema 
{
  "description": "A tile, instantiating MASL metadata into a record",
  "key": "tid",
  "record": {
    "properties": {
      "cid": {
        "description": "The DRISL CID of the MASL for the tile",
        "format": "cid",
        "type": "string"
      },
      "createdAt": {
        "description": "Timestamp",
        "format": "datetime",
        "type": "string"
      },
      "tile": {
        "description": "The MASL content",
        "ref": "ing.dasl.masl#masl",
        "type": "ref"
      }
    },
    "required": [
      "cid",
      "tile",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}
masl object

MASL metadata as defined in https://dasl.ing/masl.html

Properties

background_color string Optional

A colour for the background of the tile

categories array of string Optional

Tags categorising the tile

description string Optional

Short overview of the content

maxLength: 3000 bytesmaxGraphemes: 300 graphemes
icons array of object Optional

Icons for the tile

name string Required

The name for the tile, can be a title or app name

maxLength: 1000 bytesmaxGraphemes: 100 graphemes
prev cid-link Optional

In case there are multiple versions of this tile, this is the CID of the previous one

resources unknown Required

A mapping of path to object with a CID src and HTTP headers

roots array of cid-link Optional

The CAR roots — avoid using this

screenshots array of object Optional

Screenshots, can be used for banner or card images

short_name string Optional

A name, in case the basic name cannot fit

sizing object Optional

Requesting sizing properties for the content

theme_color string Optional

Theme colour

version integer Optional

The CAR version — avoid using this

View raw schema 
{
  "description": "MASL metadata as defined in https://dasl.ing/masl.html",
  "properties": {
    "background_color": {
      "description": "A colour for the background of the tile",
      "type": "string"
    },
    "categories": {
      "description": "Tags categorising the tile",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "description": {
      "description": "Short overview of the content",
      "maxGraphemes": 300,
      "maxLength": 3000,
      "type": "string"
    },
    "icons": {
      "description": "Icons for the tile",
      "items": {
        "properties": {
          "purpose": {
            "type": "string"
          },
          "sizes": {
            "type": "string"
          },
          "src": {
            "type": "string"
          }
        },
        "required": [
          "src"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "name": {
      "description": "The name for the tile, can be a title or app name",
      "maxGraphemes": 100,
      "maxLength": 1000,
      "type": "string"
    },
    "prev": {
      "description": "In case there are multiple versions of this tile, this is the CID of the previous one",
      "type": "cid-link"
    },
    "resources": {
      "description": "A mapping of path to object with a CID src and HTTP headers",
      "type": "unknown"
    },
    "roots": {
      "description": "The CAR roots — avoid using this",
      "items": {
        "type": "cid-link"
      },
      "type": "array"
    },
    "screenshots": {
      "description": "Screenshots, can be used for banner or card images",
      "items": {
        "properties": {
          "label": {
            "type": "string"
          },
          "sizes": {
            "type": "string"
          },
          "src": {
            "type": "string"
          }
        },
        "required": [
          "src"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "short_name": {
      "description": "A name, in case the basic name cannot fit",
      "type": "string"
    },
    "sizing": {
      "description": "Requesting sizing properties for the content",
      "properties": {
        "height": {
          "mininum": 1,
          "type": "integer"
        },
        "width": {
          "mininum": 1,
          "type": "integer"
        }
      },
      "required": [
        "width",
        "height"
      ],
      "type": "object"
    },
    "theme_color": {
      "description": "Theme colour",
      "type": "string"
    },
    "version": {
      "const": 1,
      "description": "The CAR version — avoid using this",
      "type": "integer"
    }
  },
  "required": [
    "name",
    "resources"
  ],
  "type": "object"
}

Lexicon Garden

@