blob: 8654f781c25491659fae56dde9fe26fa419c6721 [file] [log] [blame]
README for VP8 Bitstream Guide
==============================
History (June 2010)
-------------------
This document has had a very limited audience for most of its life.
As VP8 is now an open-source project, the document is expected to
undergo very significant change.
Format (September 2010)
------
The complete document is composed of individual text files for each
section, concatenated in filename order.
The text source is designed for transformation to HTML via Markdown [1],
and uses the syntax extensions supported by PHP Markdown Extra [2] as
implemented by kramdown [3].
kramdown 0.10.0 is the recommended text-to-HTML transformer. PDFs may be
generated one-off using PrinceXML [4].
MathML
------
The text source also includes some block-level and span-level MathML
expressions, written in ASCIIMathML syntax [5]. The standard delimiter
for ASCIIMathML expressions is the backtick (`), which unfortunately is
reserved by Markdown, so an alternate delimiter of double square
brackets (plus one space) is used:
This sentence includes a math expression, [[ sin^-1(x) ]],
delimited with double square brackets plus a one-space buffer.
[1]: http://daringfireball.net/projects/markdown/
[2]: http://michelf.com/projects/php-markdown/extra/
[3]: http://kramdown.rubyforge.org/
[4]: http://www.princexml.com/
[5]: http://www1.chapman.edu/~jipsen/mathml/asciimath.html