An open API service indexing awesome lists of open source software.

https://github.com/sphinx-contrib/youtube

A Sphinx extension to embed videos from YouTube
https://github.com/sphinx-contrib/youtube

sphinx-extension

Last synced: about 1 month ago
JSON representation

A Sphinx extension to embed videos from YouTube

Awesome Lists containing this project

README

        

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
`__.