Before you keep reading...

Runestone Academy can only continue if we get support from individuals like you. As a student you are well aware of the high cost of textbooks. Our mission is to provide great books to you for free, but we ask that you consider a $10 donation, more if you can or less if $10 is a burden.

Support Runestone Academy Today

Before you keep reading...

Making great stuff takes time and $$. If you appreciate the book you are reading now and want to keep quality materials free for other students please consider a donation to Runestone Academy. We ask that you consider a $10 donation, but if you can give more thats great, if $10 is too much for your budget we would be happy with whatever you can afford as a show of support.

Support Runestone Academy Today

YouTube and Vimeo

The youtube directive embeds content from http://www.youtube.com directly in a page.

The vimeo directive embeds content from http://www.vimeo.com directly in a page.

Synopsis

The general format of the youtube directive is:

.. youtube:: youtube video id
   :options:

The general format of the vimeo directive is:

.. vimeo:: vimeo video id
   :options:

Both the vimeo and youtube directives take the same options (with one exception).

Required Arguments

id

This must be the ID defined for this video by YouTube or Vimeo, respectively.

content area

Neither the vimeo or youtube directive use a content area.

Optional Arguments

align

Enumeration. Define video horizontal alignment.

One of left, right, or center is allowed. The default is left.

divid

String. Define a runestone id for this video. YouTube only.

The default divid is the YouTube video id.

This is provides backward compatibility when converting HTML5 hosted videos to the YouTube platform. Or use this if you want to use a different descriptor to reference rather than the YouTube video id.

height

Integer. Define video height in pixels. Default height is 281 pixels.

http

Enumeration. Define default transport.

One of http or https is allowed. The default is http.

width

Integer. Define video width in pixels. Default width is 500 pixels.

Languages supported

tbd.

Sphinx configuration options

No directive specific configuration options exist.

Internationalization

tbd.

Known limitations

The ID can only include the video ID. Adding a time as in &t=3m35s or &start=90s breaks the video.

Can’t loop video or link to youtuberepeater.com.

No way to enable closed captioning on by default.

Examples

.. youtube:: anwy2MPT5RE
    :height: 315
    :width: 560
    :align: left

You have attempted of activities on this page