[FFmpeg-devel] [PATCH] conversion of FFV1 specification from lyx to markdown

[Dave Rice]

Hi,

> On Jul 7, 2015, at 10:35 AM, Michael Niedermayer <michaelni at gmx.at> wrote:
> 
> On Thu, Jul 02, 2015 at 09:50:21AM -0400, Dave Rice wrote:
>> Hi all,
>> Last month I posted a draft of the FFV1 specification formatted in Markdown [1], whereas it currently lives in lyx. From that post there were responses in favor of the use of Markdown formatting and suggestions to not use mathml within a draft targeting an RFC specification and suggestions to update a few urls. I propose to proceed with a format conversion of the FFV1 specification from lyx to Markdown and then I'll file tickets or patches to explore simplifying the mathml expressions and updating the urls. Attached is a patch to convert the formatting (but not meaning) of the FFV1 specification from lyx to markdown.
>> 
>> Best Regards,
>> Dave Rice
>> 
>> [1] http://comments.gmane.org/gmane.comp.video.ffmpeg.devel/193851
>> 
> 
> how can this be edited and converted ?

Via pandoc you can get outputs that are close to the current ffv1.html and ffv1.pdf outputs of ffv1.lyx.

pandoc --mathml -s --number-sections ../ffv1.md -c lyx.css -o ffv1.html
pandoc -s --number-sections ../ffv1.md --latex-engine=xelatex -V geometry:margin=1in -o ffv1.pdf

I can move this info to a readme.

> i tried retext but tables are shown totally messed up
> i tried markdown_py to convert to html but similar its largely messed
> up

We didn't test with markdown_py but were mostly working with pandoc.

> i tried remarkable and again tables are messed up, basically lacking
> linebreaks as in the others above, maybe its overall less broken then
> the others
> thats remarkable 1.41
> 
> and i tried markdown itself but again its all messed up
> looking like:
> 
> (i hope all the odd chars make it intact throug the mail)
> 
> | | | |---------------------------------------------------------------------------|------| | QuantizationTablePerContext(i, j, scale) { | type | |Â Â Â Â v = 0 | | |Â Â Â Â for( k = 0; k \< 128; ) { | | |Â Â Â Â Â Â Â Â len - 1 | sr | |Â Â Â Â Â Â Â Â for( a = 0; a \< len; a++ ) { | | |Â Â Â Â Â Â Â Â Â Â Â Â quant_tables[ i ][ j ][ k ] = scale* v | | |Â Â Â Â Â Â Â Â Â Â Â Â k++ | | |Â Â Â Â Â Â Â Â } | | |Â Â Â Â Â Â Â Â v++ | | |Â Â Â Â } | | |Â Â Â Â for( k = 1; k \< 128; k++ ) { | | |Â Â Â Â Â Â Â Â quant_tables[ i ][ j ][ 256 - k ] = -quant_tables[ i ][ j ][ k ] | | |Â Â Â Â } | | |Â Â Â Â quant_tables[ i ][ j ][ 128 ] = -quant_tables[ i ][ j ][ 127 ] | | |Â Â Â Â len_count[ i ][ j ] = v | | |} | |
> 
> 
> is this in git somewhere? maybe it got trashed through mail or me
> applying it

This is possible. Here is the markdown file: https://github.com/mediaarea/ffv1/tree/markdown <https://github.com/mediaarea/ffv1/tree/markdown>.
Thanks much,
Dave Rice