sphinx-contrib / youtube

A Sphinx extension to embed videos from YouTube
BSD 3-Clause "New" or "Revised" License
52 stars 38 forks source link
sphinx-extension

sphinxcontrib.youtube

.. image:: https://img.shields.io/badge/License-BSD_3--Clause-orange.svg :alt: license :target: LICENCE

.. image:: https://badge.fury.io/py/sphinxcontrib-youtube.svg :target: https://badge.fury.io/py/sphinxcontrib-youtube :alt: PyPi version

Overview

This module provides support for including YouTube, Vimeo and Peertube videos in Sphinx :code:rst documents.

This module defines directives, :code:youtube, :code:vimeo and :code:peertube which insert videos from the respective platforms. They take a single, required argument, which is the video ID:

.. code-block:: rst

.. youtube:: dQw4w9WgXcQ

.. code-block:: rst

.. vimeo:: 148751763

.. code-block:: rst

.. peertube:: 327a21b3-374e-4373-8b2c-494c9f5e1f19

Custom Server for peertube instances:

.. code-block:: rst

.. peertube:: 327a21b3-374e-4373-8b2c-494c9f5e1f19

  :instance: peertube.tv

For full usage information, please see the web documentation <https://sphinxcontrib-youtube.readthedocs.io>__.