Matroska Specification

This repository holds content related to the official Matroska specification and standard. Discussion of the plans for standardization is regulated on the CELLAR listserv. Approved changes should be submitted to this repository as a pull request. The latest draft published from these specifications can be found at the IETF Datatracker.

About this repository

Local versions of the specification can be generated based on code in the Makefile directory and related dependencies. The dependencies required are mmark, xml2rfc and xsltproc. mmark is a Markdown processor written in Go, available here . Installation instructions for xml2rfc (an XML-to-IETF-draft translator written in Python) are available on the IETF Tools page. xsltproc is a command line tool for applying XSLT stylesheets to XML documents. A bootstrap and Makefile are provided to gather dependencies and generate the RFC documents.

To create local copies of the RFC in .txt, .md, and .html format, run make.

To create a local copy of the website, run make website. This command has additional dependencies. See the “About this site” section below for installing and local rendering.

To remove generated specifications, run make clean.

About this site

This site runs on GitHub Pages powered by Jekyll. Approved changes made to the master branch of this repository can be viewed instantly on the associated webpage.

If this repository is cloned onto a local machine, it can be run locally. Jekyll runs on Ruby. Like many Ruby projects, it will require that Ruby is installed on the machine. Bundler, a popular Ruby package manager gem, can be used to install the other gem-based dependencies. After these are loaded properly, a local preview of any changes can be viewed by running jekyll serve on the command line. Jekyll provides more in-depth options for local usage in their docs.

Code of conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

License

The work in this repository is licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0). See LICENSE.md for details.