Add support / docs for adding movies to a book

Allow movies from local file.

The documentation here shows that it is possible to add movies (in that case a gif) from the internet (though it does not show how). Movies stored as local files do not seem to be supported though.

![NOT WORKING my local movie](file_example_MOV_480_700kB.mov)

![WORKING giphy](https://media.giphy.com/media/yoJC2A59OCZHs1LXvW/giphy.gif)

![NOT WORKING movie from site](https://file-examples-com.github.io/uploads/2018/04/file_example_MOV_480_700kB.mov)

<div>
<video  loop controls width='420' height='315' preload='none'>
    <source src='file_example_MOV_480_700kB.mov' type='video/webm; codecs="vp8, vorbis"'>
</video>
</div>
<p><em>NOT WORKING Caption and label: <div id="movie"></div></em></p>

Steps to reproduce the behavior:

1. Create a jupyter-book jupyter-book create mybook;
2. Place the code above in a .md file, for example in mybook/intro.md;
3. Download a movie from the internet, e.g. from here;
4. jupyter-book build mybook
5. The movies do not work, only one of the gif does.

Maybe the documentation means that only links to gif can work. In that case this is a feature request.

• Python Version 3.6.9
• Jupyter Book: 0.10.0
• Operating System: Linux Mint

[choldgraf]

Doesn’t YouTube have an embed code that you could use to embed it directly into the book’s markdown?

e.g.

# My title

Some text

<youtube embed code here >

Some more text

I feel like that should work as expected.

(and no progress has been made directly on this, we are a very resource-limited project, sorry that this is not happening quickly)

[parmentelat]

hi folks; as a follow-up on this one:

for the record here are a few related resources

• https://github.com/executablebooks/jupyter-book/issues/1789
• https://mstruwig.com/posts/jupyterbook-video/

and indeed the way I’ve been going forward to get local (as opposed to published on YouTube) videos embedded properly in both notebooks and jupyter-books has been to

• use a raw html <video> tag
• and move all the movies into a _static folder located right under the top of the document folder (that is, the place where jb is launched)

that kind of works, but I have to say there is room for improvement: in particular I have a source tree with a 2 to 3 deep layout, that is made of a collection of exercises/assignments and each exercise is a bundle in itself, so it is truly awkward that each subtree cannot hold its own media files as a consequence every one and again the students don’t get the attached videos because the teacher forgets about that oddity

plus, as this one repo / book is scaling up, this is becoming an issue in terms of namespace as well

---

I guess this is also frustrating because of the difference with image files: I can choose to have a media/ folder under each subfolder, and things work smoothly both in the notebook and in jb; and it is hard to understand why video files should be treated so differently

IIUC the image files work thanks to this

parse:
  myst_enable_extensions:
    - html_image    # for raw <img> tags in markdown

so, would it make sense to imagine a html_video extension that would allow us to deal with both kinds of media in a more uniform way ? in other words how welcome would be a PR in MyST-Parser to add such a feature ?

it looks like the crux of the matter lies around here https://github.com/executablebooks/MyST-Parser/blob/master/myst_parser/mdit_to_docutils/html_to_nodes.py#L72