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

[Michael Niedermayer]

On Fri, Jul 10, 2015 at 07:47:46PM +0200, Michael Niedermayer wrote:
> On Fri, Jul 10, 2015 at 11:52:24AM +0200, Michael Niedermayer wrote:
> > On Thu, Jul 09, 2015 at 02:14:36PM -0400, Dave Rice wrote:
> > > 
> > > > On Jul 9, 2015, at 1:53 PM, Michael Niedermayer <michaelni at gmx.at> wrote:
> > > > 
> > > > On Tue, Jul 07, 2015 at 11:03:39AM -0400, Dave Rice wrote:
> > > >> 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.
> > > > 
> > > > please do
> > > 
> > > Sure. Would you prefer a patch on ffmpeg-devel or a PR in github?
> > 
> > whatever you prefer
> 
> generated files like pdf should not be checked into git.
> instead add a Makefile to generate them, so a simple
> make
> or
> make ffv1.pdf
> generates the file

also the readme should document which version of markdown/pandoc
this needs
and something should check for that version ideally so the user
is nt left wondering why "make" produces broken tables

[...]
-- 
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

Rewriting code that is poorly written but fully understood is good.
Rewriting code that one doesnt understand is a sign that one is less smart
then the original author, trying to rewrite it will not make it better.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 181 bytes
Desc: Digital signature
URL: <http://ffmpeg.org/pipermail/ffmpeg-devel/attachments/20150710/3adb88fa/attachment.sig>