b3ec18c556
modified: doc/README modified: doc/webp-lossless-bitstream-spec.txt Change-Id: I5cbc9c0a4fbbcc049a4d792e1fac367d28acf4a6
36 lines
1.2 KiB
Plaintext
36 lines
1.2 KiB
Plaintext
|
|
Generate libwebp Container Spec Docs from Text Source
|
|
=====================================================
|
|
|
|
HTML generation requires kramdown [1], easily installed as a
|
|
rubygem [2]. Rubygems installation should satisfy dependencies
|
|
automatically.
|
|
|
|
[1]: http://kramdown.rubyforge.org/
|
|
[2]: http://rubygems.org/
|
|
|
|
HTML generation can then be done from the project root:
|
|
|
|
$ kramdown doc/webp-container-spec.txt --template doc/template.html > \
|
|
doc/output/webp-container-spec.html
|
|
|
|
kramdown can optionally syntax highlight code blocks, using CodeRay [3],
|
|
a dependency of kramdown that rubygems will install automatically. The
|
|
following will apply inline CSS styling, and then use perl to strip
|
|
line numbers and unwanted leading whitespace.
|
|
|
|
$ kramdown doc/webp-lossless-bitstream-spec.txt --template \
|
|
doc/template.html --coderay-css style | \
|
|
perl -p -e 's|<span class="no">.*?</span>\s||gm' > \
|
|
doc/output/webp-lossless-bitstream-spec.html
|
|
|
|
Note that code blocks must be immediately followed by a language
|
|
identifier for syntax highlighting to succeed. Example:
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
int block_index = (y >> size_bits) * block_xsize +
|
|
(x >> size_bits);
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
{:lang='c'}
|
|
|