Files
palette-spec/README.md
T

2.2 KiB

Palette Format Specification

This repository contains the specification for the Palette XML format, a simple format for representing colour palettes. The specification consists of a human-readable document and an XSD schema.

Contents

  • spec.md — The human-readable specification
  • palette.xsd — The XSD schema for document validation

Overview

The Palette format is an XML vocabulary for representing a collection of named colours. Each colour entry carries a name and component values for red, green, blue, and opacity.

Namespace

The XML namespace for this format is:

http://markembling.info/xmlschema/colourchooser/palette/1

This namespace identifies version 1 of the format. A new namespace will be introduced only if a future version of the format introduces breaking changes. Backwards-compatible additions do not result in a new namespace.

Versioning

This specification follows Semantic Versioning:

  • Major version increments correspond to breaking changes and introduce a new namespace.
  • Minor version increments correspond to backwards-compatible additions to the format.
  • Patch version increments correspond to corrections to the schema or specification documents where the format itself has not changed.

The current version is indicated by the version attribute on the root xs:schema element of palette.xsd.

Git tags correspond directly to specification versions and are prefixed with v (e.g. v1.0.0, v1.1.0).

Licence

This specification is copyright Mark Embling and is licensed under Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0).

You are free to share and adapt the specification for any purpose, provided you give appropriate attribution and distribute any derivative specifications under the same licence.

Implementing this Specification

Implementing this specification in software — including commercial software — is explicitly permitted without restriction. The licence terms do not extend to implementations; only to the specification document itself and works derived from it.