Slothsoft Schema: Historical Games Night Schema v2.0 R20251104

This document describes the namespace http://schema.slothsoft.net/schema/historical-games-night, conventionally prefixed as ssh.

Changelog

*** Version 2.0 *** R20251104 - added "ported" to <game> - added documentation to <game> attributes R20251017 - renamed "from" to "released" for <game> - renamed "year" to "released" for <read> - renamed "title" to "name" for <read> - renamed "author" to "by" for <read> - added "wiki" to <game> - made "version" required for <index> and <events> *** Version 2.0 *** R20251015 - renamed "xml:id" to "id" in <track> - replaced "xml:id" with "track" in <event> - splitted "date" into "date" and "time" in <event> - added <platforms> - removed "rerun" from <event> *** Version 1.0 *** R20250912 - "gfx" and "manual" attributes must be of type asset-file. R20250716 - initial release.

Elements in namespace http://schema.slothsoft.net/schema/historical-games-night

The element index

Possible child elements:
Possible attributes:

The element tracks

Context in which this element may appear:
Content model:
Possible child elements:
Possible attributes:
-

The element track

Context in which this element may appear:
Content model:
Possible child elements:
Possible attributes:

The element subtrack

Context in which this element may appear:
Content model:
Possible child elements:
-
Possible attributes:

The element platforms

Context in which this element may appear:
Content model:
Possible child elements:
Possible attributes:
-

The element platform

Context in which this element may appear:
Content model:
Possible child elements:
-
Possible attributes:

The element present

Context in which this element may appear:
Content model:
Possible child elements:
Possible attributes:
-

The element event

Context in which this element may appear:
Content model:
Possible child elements:
Possible attributes:

The element req

Context in which this element may appear:
Content model:
Possible child elements:
-
Possible attributes:

The element game

Context in which this element may appear:
Content model:
Possible child elements:
-
Possible attributes:

The element read

Context in which this element may appear:
Content model:
Possible child elements:
-
Possible attributes:

The element past

Context in which this element may appear:
Content model:
Possible child elements:
Possible attributes:
-

The element future

Context in which this element may appear:
Content model:
Possible child elements:
Possible attributes:
-

The element unfinished

Context in which this element may appear:
Content model:
Possible child elements:
Possible attributes:
-

The element unsorted

Context in which this element may appear:
Content model:
Possible child elements:
Possible attributes:
-

The element events

Content model:
Possible child elements:
Possible attributes:

Attributes in namespace http://schema.slothsoft.net/schema/historical-games-night

The attribute version

Required:
Yes
Elements which use this attribute:
Allowed content:
  • "2.0"
The schema version used by instances of a "company" document.

The attribute id

Required:
Yes
Elements which use this attribute:
Content model:
Allowed content:
  • [A-Z]{3}

The attribute name

Required:
Yes
Elements which use this attribute:
Content model:

The attribute color

Required:
Yes
Elements which use this attribute:
Content model:

The attribute id

Required:
Yes
Elements which use this attribute:
Content model:
Allowed content:
  • [A-Z]{3}-[A-Za-z0-9]+

The attribute name

Required:
Yes
Elements which use this attribute:
Content model:

The attribute id

Required:
Yes
Elements which use this attribute:
Content model:
Allowed content:
  • [A-Za-z0-9\-]+

The attribute name

Required:
Yes
Elements which use this attribute:
Content model:

The attribute wiki

Required:
No
Elements which use this attribute:
Content model:
Allowed content:
  • https?://.+

The attribute track

Required:
Yes
Elements which use this attribute:
Content model:
Allowed content:
  • [A-Z]{3}-[A-Za-z0-9]+

The attribute theme

Required:
Yes
Elements which use this attribute:
Content model:

The attribute type

Required:
Yes
Elements which use this attribute:
Content model:
Allowed content:
  • "genre"
  • "series"
  • "platform"
  • "special"
  • "author"
  • "loredump"
  • "longplay"

The attribute date

Required:
No
Elements which use this attribute:
Content model:
Allowed content:
  • (\d{4}-\d{2}-\d{2})|

The attribute time

Required:
No
Elements which use this attribute:
Content model:
Allowed content:
  • (\d{2}:\d{2})|

The attribute moderator

Required:
No
Elements which use this attribute:
Content model:

The attribute gfx

Required:
No
Elements which use this attribute:
Content model:
Allowed content:
  • [^/]+

The attribute twitter

Required:
No
Elements which use this attribute:
Content model:

The attribute theme

Required:
Yes
Elements which use this attribute:
Content model:

The attribute name

Required:
Yes
Elements which use this attribute:
Content model:
The name of the game as it appears in the version that is showcased.
This relates to the "ported" and "on" attributes, i.e., the showcased version was released for platform "on" in the year "ported" by the name of "name".

The attribute released

Required:
Yes
Elements which use this attribute:
Content model:
Allowed content:
  • \d{4}|TBD
The year of the game's first publication. Games that undergo early access releases or public alpha/beta testing still use the date of their eventual ("final") release.

The attribute ported

Required:
No
Elements which use this attribute:
Content model:
Allowed content:
  • \d{4}|TBD
The year of publication of the version of the game that is showcased. If omitted, it is assumed to be identical to the "released" date.
This relates to the "name" and "on" attributes, i.e., the showcased version was released for platform "on" in the year "ported" by the name of "name".

The attribute by

Required:
Yes
Elements which use this attribute:
Content model:
The name of the developer(s) or the development studio that made the game. Multiple names are separated by comma.

The attribute on

Required:
Yes
Elements which use this attribute:
Content model:
Allowed content:
  • [A-Za-z0-9\-]+
The ID of the platform that runs the showcased version of the game.
This relates to the "name" and "ported" attributes, i.e., the showcased version was released for platform "on" in the year "ported" by the name of "name".

The attribute country

Required:
Yes
Elements which use this attribute:
Content model:
Allowed content:
  • [A-Z]{2}|\?
The country of origin for the developers listed under the "by" attribute.
Must be a valid ISO 3166-1 alpha-2 country code, or "ww" for "worldwide", or "?" for "unknown".

The attribute href

Required:
No
Elements which use this attribute:
Content model:
Allowed content:
  • https?://.+
A URL that leads to a playable version of the game.

The attribute wiki

Required:
No
Elements which use this attribute:
Content model:
Allowed content:
  • https?://.+
A URL that leads to a wikipedia article of the game. If omitted, the English wikipedia is searched with the "name" attribute used as query.

The attribute wanted

Required:
No
Elements which use this attribute:
Content model:
The person who owns or supplys the showcased version of the game. If set to the empty string, indicates that we do not currently have access to the game.

The attribute manual

Required:
No
Elements which use this attribute:
Content model:
Allowed content:
  • [^/]+
The file name of the manual of the game, omitting the ".pdf" extension.

The attribute version

Required:
No
Elements which use this attribute:
Content model:
The specific version number of the game that is showcased. Usually only used to sync the versions of a game that requires multiple installations to showcase.

The attribute name

Required:
Yes
Elements which use this attribute:
Content model:

The attribute released

Required:
Yes
Elements which use this attribute:
Content model:
Allowed content:
  • \d{4}|TBD

The attribute by

Required:
Yes
Elements which use this attribute:
Content model:

The attribute href

Required:
Yes
Elements which use this attribute:
Content model:
Allowed content:
  • https?://.+

Content models in namespace http://schema.slothsoft.net/schema/historical-games-night

The content model track-list

Elements which use this content model:
Possible child elements:
Possible attributes:
-

The content model track

Elements which use this content model:
Possible child elements:
Possible attributes:

The content model subtrack

Elements which use this content model:
Possible child elements:
-
Possible attributes:

The content model event-list

Elements which use this content model:
Possible child elements:
Possible attributes:
-

The content model event

Elements which use this content model:
Possible child elements:
Possible attributes:

The content model platform-list

Elements which use this content model:
Possible child elements:
Possible attributes:
-

The content model platform

Elements which use this content model:
Possible child elements:
-
Possible attributes:

The content model game

Elements which use this content model:
Possible child elements:
-
Possible attributes:

The content model read

Elements which use this content model:
Possible child elements:
-
Possible attributes:

The content model req

Elements which use this content model:
Possible child elements:
-
Possible attributes:

The content model country-code

Attributes which use this content model:
This content model extends:
Allowed content:
  • [A-Z]{2}|\?

The content model asset-file

Attributes which use this content model:
This content model extends:
Allowed content:
  • [^/]+

The content model platform-id

Attributes which use this content model:
This content model extends:
Allowed content:
  • [A-Za-z0-9\-]+

The content model track-id

Attributes which use this content model:
This content model extends:
Allowed content:
  • [A-Z]{3}

The content model subtrack-id

Attributes which use this content model:
This content model extends:
Allowed content:
  • [A-Z]{3}-[A-Za-z0-9]+

The content model date

Attributes which use this content model:
This content model extends:
Allowed content:
  • (\d{4}-\d{2}-\d{2})|

The content model time

Attributes which use this content model:
This content model extends:
Allowed content:
  • (\d{2}:\d{2})|

The content model event-type

Attributes which use this content model:
This content model extends:
Allowed content:
  • "genre"
  • "series"
  • "platform"
  • "special"
  • "author"
  • "loredump"
  • "longplay"

The content model release-date

Attributes which use this content model:
This content model extends:
Allowed content:
  • \d{4}|TBD

The content model http-url

Attributes which use this content model:
This content model extends:
Allowed content:
  • https?://.+