53 lines
2.0 KiB
Markdown
53 lines
2.0 KiB
Markdown
# Palette Format Specification
|
|
|
|
This repository contains the specification for the Palette XML format, a simple
|
|
format for representing colour palettes.
|
|
|
|
## 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](https://semver.org/):
|
|
|
|
- **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`](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)](https://creativecommons.org/licenses/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.
|